CleanupCode コマンドラインツール

--profile — 実行するクリーンアップタスクを一覧表示するコードクリーンアッププロファイル。

デフォルトでは、CleanupCode はビルトイン: 完全クリーンアッププロファイルで指定されたコードクリーンアップタスクを適用します。これは、ファイルヘッダーの更新を除くすべての利用可能なクリーンアップタスクです。

さらに 2 つの組み込みプロファイルがあります。コードフォーマット設定 のみを適用するビルトイン: コードの整形と、コードフォーマット設定とコード構文スタイルを適用するビルトイン: 再フォーマットして構文スタイルを適用です。

これらのプロファイルの 1 つまたは任意のカスタムプロファイルを使用するには、--profile パラメーターを介してプロファイル名を渡します（例: --profile="Built-in: Reformat Code" YourSolution.sln）。

--include/--exclude — クリーンアップ中に含める / 除外するファイルを定義するファイルマスク。--include と --exclude の両方が定義され、同じファイルセットをカバーする場合、--exclude が優先されます。

ファイルマスクで Ant スタイルのワイルドカード(英語)を使用できます。

• ディレクトリ区切り文字を除く単一文字に一致する ?

• ディレクトリ区切り文字を除く 0 文字以上に一致する *

• ディレクトリ区切り文字を含む任意の数の文字に一致する **

• OS パス形式に関係なくディレクトリ区切り文字と一致する / または \

たとえば、パターン **Test?\**.* は次のファイルと一致します。

• C:\Projects\MyTestX\data\file_one.txt

• /home/projects/TestY/file_two.xml

だがしかし:

• C:\Projects\Test\data\file_one.txt

• /home/projects/TestY/file_two

複数のパスまたはワイルドカードを指定するには、セミコロン ; で区切るか、--include/--exclude パラメーターを複数回使用します。

--properties — MSBuild のプロパティを上書きできます。各プロパティを個別に設定するか（--properties:prop1=val1 --properties:prop2=val2）、セミコロンを使用して複数のプロパティ --properties:prop1=val1;prop2=val2 を区切ることができます。

セミコロンは値の内側では使用できないことに注意してください（例: --properties:ReferencePath="r:\reference1\;r:\reference2\"）。そのような場合、別の --properties パラメーターを使用して各値を個別に追加します。値は結合されます。

指定されたプロパティは、分析されたすべてのプロジェクトに適用されます。現在、特定のプロジェクトのみにプロパティを設定する直接的な方法はありません。回避策は、このプロジェクトでカスタムプロパティを作成し、それを目的のプロパティに割り当ててから、CleanupCode パラメーターでカスタムプロパティを使用することです。

--toolset — このオプションを使用して、正確な MSBuild バージョンを指定します。たとえば、12.0: --toolset=12.0 です。デフォルトでは、利用可能な最高の MSBuild バージョンが使用されます。同じバージョンのインストールが複数ある場合、このオプションは機能しない可能性があります (たとえば、Visual Studio の 16.0、.NET Core 3.x の 2019 および 16.0)。

--toolset-path — このオプションを使用して、MSBuild への正確なパスを指定します。カスタム MSBuild インストールがあり、それを CleanupCode で使用する場合に役立ちます (例: --toolset-path="c:\tools\msbuild\bin\MsBuild.exe")。

--dotnetcore — デフォルトでは、.NET インストールは自動検出されます。自動検出で競合が発生した場合は、このオプションを使用して特定の .NET インストールを指定できます。.NET Core を無視するには、引数なしで使用します。例: --dotnetcore=/usr/local/share/dotnet/dotnet

--dotnetcoresdk — このオプションを使用して、MSBuild を提供する .NET SDK バージョンを指定します。例: .NET を SDK 5.0.100 および 6.0.302 とともにインストールした場合、CleanupCode は 6.0.302 (プレビューバージョンを含む最新版) を優先します。CleanupCode を .NET SDK 5.0.100 とともに実行する場合は、コマンドラインに --dotnetcoresdk=5.0.100 を追加します。

--mono — デフォルトでは、Mono のインストールは自動検出されます。自動検出によって競合が発生した場合は、このオプションを使用して、特定の Mono インストールを指すことができます。Mono を無視するには、引数なしで使用してください。例: --mono=/Library/Frameworks/Mono.framework/Versions/Current/bin/mono

--targets-for-references — プロジェクトの参照アセンブリを取得するために実行されるカスタム MSBuild ターゲットの名前。ターゲットは、プロジェクトファイルまたは .targets ファイルで定義されます。複数の値はセミコロンで区切られます。例: --targets-for-references="GetReferences"

--targets-for-items — プロジェクトの他の項目 (たとえば、コンパイル項目) を取得するために実行されるカスタム MSBuild ターゲットの名前。ターゲットは、プロジェクトファイルまたは .targets ファイルのいずれかで定義されます。複数の値はセミコロンで区切られます。例: --targets-for-items="GetCompileItems"

--verbosity — デフォルトでは、CleanupCode は出力にエラーメッセージのみを表示します。このパラメーターを使用して、出力に書き込まれる情報の量を次のレベルで変更します (順序は少ないものから詳細なものへ): [OFF, FATAL, ERROR, WARN, INFO, VERBOSE, TRACE]

--LogLevel — このパラメーターを使用して、--LogFile または --LogFolder で指定された、ログファイルに書き込まれる情報の量を制御します。次のレベルがあります (順序は少ないものから詳細なものへ): [OFF, FATAL, ERROR, WARN, INFO, VERBOSE, TRACE] .

例: CleanupCode で問題が発生した場合は、JetBrains Rider サポートに連絡して、すべての TRACE メッセージとログファイルを共有できます: --LogLevel=TRACE

--LogFile — このパラメーターを使用して、CleanupCode からのメッセージのログファイルへの絶対パスを指定します。MSBuild および Roslyn からのログも必要な場合は、代わりに --LogFolder パラメーターを使用します。

--LogFolder — このパラメーターを使用して、CleanupCode からのログと MSBuild および Roslyn からのログを書き込むディレクトリへの絶対パスを指定します。CleanupCode からのログのみが必要な場合は、代わりに --LogFile パラメーターを使用します。

--caches-home — CleanupCode がキャッシュするデータのカスタムの場所を指定できます。デフォルトでは、設定ファイルがない限り、%LOCALAPPDATA% ディレクトリが使用されます。設定ファイルがある場合は、そこで指定されたものが使用されます。このパラメーターは、キャッシュに高速 SSD ディスクを使用する場合、またはすべてのビルド処理データを 1 か所に保存する場合に役立ちます。

--config-create および --config - これらのオプションを使用すると、構成ファイルで上記のパラメーターを渡すことができます。最初のオプションは現在のパラメーターに従って設定ファイルを作成します。2 番目のオプションはこのファイルからパラメーターをロードするために使用されます。

--debug (-d) — このオプションを使用して、CleanupCode の実行の詳細を出力に追加します。CleanupCode に問題がある場合は、これらの詳細がサポートチーム(英語)に連絡するときに役立ちます。

--eXtensions (-x) — 指定されたプラグインをインストールして有効にします。

プラグインは ID で指定されます。ID は JetBrains マーケットプレイス(英語)のプラグインページで確認できます。目的のプラグインを見つけて、概要タブの一番下までスクロールします。

例: JetBrains による StyleCop(英語) プラグインのプラグイン ID は StyleCop.StyleCop であり、このプラグインで CleanupCode を実行するには、コマンドラインに -x=StyleCop.StyleCop を追加する必要があります。

複数のプラグインを指定するには、それらの ID をセミコロンで区切ります。

--source — プラグインをインストールするカスタムパッケージソースを指定できます。これは、プラグインを含む .nupkg ファイルが配置されているディレクトリです（例: --source="C:\plugins"）。何も指定されていない場合、CleanupCode は JetBrains マーケットプレイスでプラグインを検索します。

--measure — 特定のターゲットソリューションを使用する特定のハードウェアでツールを実行するときに、最適ではないパフォーマンスが発生した場合に役立つ診断オプション。このオプションを次のいずれかの引数 [sampling | timeline (Windows-only) | memory] とともに使用して、プロファイリングの種類を定義します。例:

実行が終了すると、CleanupCode は実行スナップショットを作成し、スナップショットファイルへのパスを表示します。JetBrains ツールを使用してスナップショットを調べることができます。

• サンプリングまたはタイムラインプロファイリング: 結果の .zip ファイルを分析するには、それを解凍し、サンプリングスナップショットファイル (.dtp) またはタイムラインスナップショットファイル (.dtt) を JetBrains dotTrace で開きます。

• メモリプロファイリング: 結果の dotMemory ワークスペースファイル (.dmw) を分析するには、JetBrains dotMemory で開きます。

--version (-v) — このオプションを使用して、ツールの現在のバージョンを表示して終了します。

--no-updates — デフォルトでは、CleanupCode は実行ごとに更新をチェックします。更新のチェックを無効にするには、このオプションを使用します。

--settings — デフォルトでは、CleanupCode は、デフォルト設定を「ソリューションチーム共有」レイヤー SolutionName.DotSettings の ReSharper 設定でオーバーライドします（存在する場合）。必要に応じて、このパラメーターを使用して、他のすべての設定をオーバーライドする別の .DotSettings ファイルを指定できます。元:

.

--disable-settings-layers (-dsl) — 指定された設定レイヤーを無効にします。許容値: GlobalAll、GlobalPerProduct、SolutionShared、SolutionPersonal

--no-buildin-settings — グローバル、ソリューション、プロジェクト設定レイヤーからの設定を抑制します。--disable-settings-layers: GlobalAll; GlobalPerProduct; SolutionShared; SolutionPersonal; ProjectShared; ProjectPersonal と同等