{"meta":{"title":"コンパイル済み言語の CodeQL ビルド オプションと手順","intro":"C/C++、C#、Go、Java、Kotlin、Rust、Swift で使用可能なビルド モードや言語固有の自動ビルド動作など、CodeQL がコンパイルされた言語をビルドする方法について説明します。","product":"セキュリティとコードの品質","breadcrumbs":[{"href":"/ja/code-security","title":"セキュリティとコードの品質"},{"href":"/ja/code-security/reference","title":"リファレンス"},{"href":"/ja/code-security/reference/code-scanning","title":"コード スキャン"},{"href":"/ja/code-security/reference/code-scanning/codeql","title":"CodeQL"},{"href":"/ja/code-security/reference/code-scanning/codeql/build-options-for-compiled-languages","title":"コンパイル済み言語のビルド オプション"}],"documentType":"article"},"body":"# コンパイル済み言語の CodeQL ビルド オプションと手順\n\nC/C++、C#、Go、Java、Kotlin、Rust、Swift で使用可能なビルド モードや言語固有の自動ビルド動作など、CodeQL がコンパイルされた言語をビルドする方法について説明します。\n\n## コンパイル型言語のオートビルドステップ\n\nGitHub でホストされるランナーは、常に `autobuild` で必要なソフトウェアを使用して実行されます。\n\nGitHub Actionsにセルフホステッド ランナーを使用する場合は、`autobuild` プロセスを使用するために追加のソフトウェアのインストールが必要になる場合があります。 さらに、リポジトリに特定のバージョンのビルドツールが必要な場合は、手動でインストールする必要があります。\n\n> \\[!NOTE]\n> ワークフローで `language` マトリックスを使っている場合、`autobuild` はマトリックスに列記された各コンパイル型言語のビルドを試行します。 マトリックスがない場合、`autobuild` は、サポートされているコンパイル型言語で、リポジトリ内のソース ファイルの数が最も多いもののビルドを試みます。 Go を除いて、明示的にビルドコマンドを使用しない限り、リポジトリにある他のコンパイル型言語の解析は失敗します。\n\n## C/C++ のビルド\n\nCodeQL は、C/C++ コード `none`、 `autobuild` 、または `manual` のビルド モードをサポートします。\n\nC/C++ コードを含むリポジトリに対して既定のセットアップを有効にすると、ビルド モードは自動的に `none` に設定されます。\n\n### C/C++ 用のビルドなし\n\nCodeQL は、ソース ファイル拡張子を使用して C/C++ コンパイル ユニットを推論します。 見つかったソース ファイルごとに、コンパイル フラグとインクルード パスは、動作するビルド コマンドを必要とせずにコードベースを調べることによって推論されます。\n\n#### C/C++ のビルドを伴わない分析の精度\n\nビルドなしで CodeQL C/C++ データベースを作成すると、場合によっては、 `autobuild` または手動のビルド手順を使用する場合よりも精度の低い結果が得られる場合があります。たとえば、次のような場合です。\n\n* このコードは、既存のヘッダーでは使用できないカスタム マクロ/定義に大きく依存します\n* コードベースには多くの外部依存関係があります\n\n次の手順を実行すると、より正確な解析を行うことができます。\n\n* 関連するソース ファイルに含まれるヘッダー ファイルにカスタム マクロと定義を配置する\n* システムインクルードディレクトリまたはワークスペースで外部依存関係（ヘッダーファイル）が利用可能であることを確認する\n* ターゲット プラットフォームで抽出を実行します。 たとえば、Windows ランナーを選択して Windows プロジェクトを分析し、プラットフォーム固有のヘッダーとコンパイラにアクセスできるようにします。\n\n### C/C++ の自動ビルドの概要\n\n| サポートされているシステムの種類 | システム名                                                                                                                  |\n| ---------------- | ---------------------------------------------------------------------------------------------------------------------- |\n| オペレーティング システム    | Windows、macOS、Linux                                                                                                    |\n| ビルドシステム          | Windows: MSbuild スクリプトと build スクリプト<br/>Linux と macOS: Autoconf、Make、CMake、qmake、Meson、Waf、SCons、Linux Kbuild、ビルドスクリプト |\n\n`autobuild` ステップの動作は、抽出を実行するオペレーティング システムによって異なります。\n\n### Windows自動検出\n\nWindowsでは、`autobuild` ステップは、次の方法を使用して、C/C++ に適したビルド メソッドの自動検出を試みます。\n\n1. ルートに最も近いソリューション (`MSBuild.exe`) またはプロジェクト (`.sln`) ファイルで `.vcxproj` を呼び出します。\n\n`autobuild` が最上位ディレクトリから同じ (最短) 深度で複数のソリューションまたはプロジェクト ファイルを検出した場合、それらすべてのビルドが試みられます。\n\n1. ビルド スクリプトのように見えるスクリプト、つまり *build.bat*、*build.cmd*、*build.exe* を、この順番で呼び出します。\n\n### Linux と macOS の自動検出\n\nLinux と macOS の `autobuild` ステップでは、リポジトリ内にあるファイルが確認されて、使われているビルド システムが特定されます。\n\n1. ルートディレクトリでビルドシステムを探します。\n2. 何も見つからない場合は、C/C++ のビルドシステムで一意のディレクトリをサブディレクトリで検索します。\n3. 適切なコマンドを実行してシステムを設定します。\n\n#### C/C++ のランナー要件\n\nUbuntu Linux ランナー上で `autobuild` を使うと、検出された構成とビルド ステップに必要な依存関係を自動的にインストールしようとする場合があります。 既定では、この動作は GitHubホストランナーで有効になり、セルフホステッド ランナーでは無効になります。 この機能を明示的に有効または無効にするには、環境内の `CODEQL_EXTRACTOR_CPP_AUTOINSTALL_DEPENDENCIES` に `true` あるいは `false` を設定します。 環境変数の定義の詳細な情報については、「[変数に情報を格納する](/ja/actions/how-tos/write-workflows/choose-what-workflows-do/use-variables#defining-environment-variables-for-a-single-workflow)」を参照してください。\n\nセルフホステッド ランナーの場合、依存関係の自動インストールが有効になっていない限り、`gcc` コンパイラをインストールする必要があり、特定のプロジェクトでは、`clang` または `msvc` の実行可能ファイルへのアクセスも必要になる場合があります。 また、プロジェクトが依存するビルド システム (`msbuild`、`make`、`cmake`、`bazel` など) とユーティリティ (`python`、`perl`、`lex`、`yacc` など) をインストールする必要もあります。\n依存関係の自動インストールを有効にする場合は、ランナーで Ubuntu を使っていること、パスワードなしで `sudo apt-get` を実行できることを確認する必要があります。\n\nWindows ランナーは`powershell.exe`を`PATH`に置く必要があります。\n\n## C# のビルド\n\nCodeQL では、C# コードのビルド モード `none`、 `autobuild` 、または `manual` がサポートされています。\n\nC# コードを含むリポジトリに対してデフォルトのセットアップを有効にすると、ビルド モードは自動的に `none` に設定されます。\n\n### C# のビルドなし\n\nCodeQL は、すべてのソース ファイルと依存関係からデータベースを作成する前に、より正確な結果を得るために、依存関係を復元し、いくつかの追加のソース ファイルを生成します。\n\n依存関係は、複数のヒューリスティックと戦略を使用して復元されます。 情報の主なソースは、`*.csproj`、`*.sln`、`nuget.config`、`packages.config`、`global.json`、`project.assets.json` です。\nプライベート NuGet フィードが組織に対して定義されている場合は、これも使用されます。 [プライベート レジストリへの既定のセットアップ アクセスをスキャンするコード](/ja/code-security/how-tos/secure-at-scale/configure-organization-security/manage-usage-and-access/giving-org-access-private-registries#code-scanning-default-setup-access-to-private-registries) と、 [既定のセットアップをスキャンするコードがプライベート レジストリを使用したかどうかを判断する](/ja/code-security/reference/code-scanning/code-scanning-logs#diagnostic-information-for-private-package-registries)方法を参照してください。\n\n次の生成されたソース ファイルは省略可能ですが、 CodeQL データベースの正確性が大幅に向上します。\n\n* `global`生成された `using` ディレクティブにより、MSbuild の暗黙的な `using` 機能を処理します。\n* コア ビュー ファイル ASP.NET、`.cshtml` ファイルは `.cs` ファイルに変換されます。\n\n依存関係アセンブリ名、生成されたソース ファイル、 プライベート フィードに格納されている依存関係からの情報、 リポジトリ内のソース ファイルがコンパイルされ、 CodeQL データベースの作成に使用されます。\n\n#### C# のビルド解析なしの正確性\n\n完全なコードをビルドせずに CodeQL データベースを作成するには、依存関係を復元できることと、リポジトリ内のソース ファイルをまとめてコンパイルできることに依存します。 依存関係の復元またはソース コードのコンパイルで問題が発生した場合、 CodeQL データベースの精度と code scanning 分析結果に影響する可能性があります。\n\n次の手順を実行すると、より正確な解析を行うことができます。\n\n* パブリック インターネットへのアクセスを提供するか、プライベート NuGet フィードへのアクセスが使用可能であることを確認しますプライベート [レジストリへの既定のセットアップ アクセスをスキャンするコード](/ja/code-security/how-tos/secure-at-scale/configure-organization-security/manage-usage-and-access/giving-org-access-private-registries#code-scanning-default-setup-access-to-private-registries)を参照してください。\n* リポジトリに同じ NuGet 依存関係の複数のバージョンが必要かどうかをチェックします。\n  CodeQL は 1 つのバージョンのみを使用でき、通常は複数のバージョンがある新しいバージョンを選択します。 この方法は、すべてのリポジトリでは機能しない場合があります。\n* .NETの複数のバージョン (`net48`、`net5.0`、`netstandard1.6`など) が参照されているかどうかを確認します。\n  CodeQL は 1 つのバージョンのみを使用でき、精度に影響する可能性があります。\n* クラス名の競合を避けてください。競合すると、メソッド呼び出しターゲットが見つからない可能性があり、データフロー解析に影響を及ぼします。\n\n### C の自動ビルドの概要\\#\n\n| サポートされているシステムの種類 | システム名                   |\n| ---------------- | ----------------------- |\n| オペレーティング システム    | Windows、macOS、Linux     |\n| ビルドシステム          | .NETとMSBuild並びにビルドスクリプト |\n\n#### Windows自動検出\n\n`autobuild` プロセスは、次の方法を使って C# に適したビルド方法の自動検出を試みます。\n\n1. ルートに最も近いソリューション (`dotnet build`) またはプロジェクト (`.sln`) ファイルで `.csproj` を呼び出します。\n2. ルートに最も近いソリューションまたはプロジェクトファイルで `MSBuild.exe` を呼び出します。\n\n`autobuild` が最上位ディレクトリから同じ (最短) 深度で複数のソリューションまたはプロジェクト ファイルを検出した場合、それらすべてのビルドが試みられます。\n\n1. ビルド スクリプトのように見えるスクリプト `build.bat`、`build.cmd`、`build.exe` を、この順番で呼び出します。\n\n#### Windowsでの C# のランナー要件\n\nセルフホステッド ランナーでの .NET Core アプリケーション開発では、.NET SDK が必要です (`dotnet`の場合)。\n\n.NET Framework アプリケーションの開発には、Microsoft Build Tools (`msbuild` 用) と NuGet CLI (`nuget` 用) が必要です。\n\nWindows ランナーは`powershell.exe`を`PATH`に置く必要があります。\n\nCodeQLを使用して`build-mode: none`データベースを作成する場合は、パブリック インターネットへのアクセスも提供する必要があります。また、プライベート NuGet フィードへのアクセスを確実に使用できるようにする必要があります。\n\n#### Linux と macOS の自動検出\n\n1. ルートに最も近いソリューション (`dotnet build`) またはプロジェクト (`.sln`) ファイルで `.csproj` を呼び出します。\n2. ルートに最も近いソリューションまたはプロジェクトファイルで `MSbuild` を呼び出します。\n\n`autobuild` が最上位ディレクトリから同じ (最短) 深度で複数のソリューションまたはプロジェクト ファイルを検出した場合、それらすべてのビルドが試みられます。\n\n1. ビルド スクリプトのように見えるスクリプト `build`、`build.sh` を、この順番で呼び出します。\n\n#### Linux および macOS での C# のランナー要件\n\nセルフホステッド ランナーでの .NET Core アプリケーション開発では、.NET SDK が必要です (`dotnet`の場合)。\n\n.NET Framework アプリケーション開発では、Mono ランタイム (`mono`、`msbuild`、または `nuget`) が必要です。\n\nCodeQLを使用して`build-mode: none`データベースを作成する場合は、パブリック インターネットへのアクセスも提供する必要があります。また、プライベート NuGet フィードへのアクセスを確実に使用できるようにする必要があります。\n\n### 手動ビルド用に CodeQL によって挿入された C# コンパイラ フラグ\n\nCodeQL トレーサーを使用すると、ビルド プロセスをインターセプトし、関連するCodeQL言語エクストラクターに情報を転送することで、コンパイルされたすべての言語を抽出できます。 トレーサーは、C# コンパイラ呼び出しに特定のフラグを挿入して、すべてのコンポーネントがビルドされ、 CodeQL データベースに含まれていることを確認します。これにより、C# コードが、 CodeQL 分析中に想定とは異なる方法でビルドされる可能性があります。\n\n#### `/p:MvcBuildViews=true`\n\nこのオプションを `true` に設定すると、ASP.NET model-view-controller (MVC) プロジェクトのビューがビルド プロセスの一部としてプリコンパイルされ、エラーをキャッチしてパフォーマンスを向上させることができます。 トレーサーは、このフラグを挿入して、 CodeQL がこれらのビューから生成されたコードを介してデータフローを伴う可能性のあるセキュリティの問題を検出して強調表示することを確認します。 詳細については、Microsoft Learn の「[MVC アプリケーションへのビューの追加](https://learn.microsoft.com/en-us/aspnet/mvc/overview/getting-started/introduction/adding-a-view)」を参照してください。\n\n#### `/p:UseSharedCompilation=false`\n\nこのオプションを `false` に設定すると、共有コンパイル機能の使用が無効になります。これにより、ビルド時間が遅くなる可能性があります。\n`/p:UseSharedCompilation=false` が指定されて**いない**場合、`msbuild` によりコンパイラ サーバー プロセスが開始され、その 1 つのプロセスによってすべてのコンパイルが実行されます。 ただし、 CodeQL トレーサーは、新しく作成されたプロセスの引数の検査に依存します。\n\n#### `/p:EmitCompilerGeneratedFiles=true`\n\nこのオプションを `true` に設定すると、ビルド プロセス中にコンパイラによって生成されたファイルが出力されます。 このオプションにより、正規表現のサポートの強化、シリアル化、Web アプリケーション ビューの作成などの機能のサポートに使用される追加のソース ファイルがコンパイラにより生成されます。 これらの生成されたアーティファクトは、通常、コンパイラによってディスクに書き込まれるのではなく、オプションを `true` に設定すると、強制的にファイルがディスクに書き込まれるので、エクストラクターがファイルを処理できます。\n\n一部のレガシ プロジェクトや、`.sqlproj` ファイルを使用するプロジェクトでは、挿入された `/p:EmitCompilerGeneratedFiles=true` プロパティによって、`msbuild` で予期しない問題が発生する場合があります。 このトラブルシューティングの詳細については、「[C# コンパイラの予期せぬ失敗](/ja/code-security/reference/code-scanning/troubleshoot-analysis-errors/c-sharp-compiler-unexpectedly-failing)」を参照してください。\n\n## Go のビルド\n\nCodeQL は、Go コードのビルド モード `autobuild` または `manual` をサポートしています。\n\n### Go の自動ビルドの概要\n\n| サポートされているシステムの種類 | システム名                                                       |\n| ---------------- | ----------------------------------------------------------- |\n| オペレーティング システム    | Windows、macOS、Linux                                         |\n| ビルドシステム          | Go モジュール、`dep`、Glide、および Makefile や Ninja スクリプトを含むビルド スクリプト |\n\n### Go の自動検出\n\n`autobuild` プロセスは、すべての `.go` ファイルを抽出する前に、Go リポジトリで必要な依存関係をインストールする適切な方法の自動検出を試みます。\n\n1. `make`、`ninja`、`./build`、または `./build.sh` を順番に呼び出し、これらのいずれかのコマンドが成功した場合は、続けて `go list ./...` を呼び出してください。その `go list ./...` も成功すれば、必要な依存関係がインストールされたことを意味します。\n2. これらのコマンドがいずれも成功しなかった場合は、`go.mod`、`Gopkg.toml`、または `glide.yaml` を探し、それぞれの `go get` (ベンダーが使用していない場合)、`dep ensure -v`、または `glide install` を実行して、依存関係のインストールを試みます。\n3. 最後に、これらの依存関係マネージャーの構成ファイルが見つからない場合は、`GOPATH` に追加するのに適したリポジトリ ディレクトリ構造に調整し直し、`go get` を使って依存関係をインストールします。 抽出が完了すると、ディレクトリ構造は通常に戻ります。\n4. `go build ./...` を実行するのと同じようにして、リポジトリ内のすべての Go コードを抽出します。\n\n> \\[!NOTE]\n> 既定のセットアップを使用すると、互換性のあるバージョンの Go 言語を自動的にインストールする `go.mod` ファイルが検索されます。\n\n### Go のエクストラクター オプション\n\n既定では、テスト コード (`_test.go` で終わるファイル内のコード) は分析されません。 これは、`--extractor-option extract_tests=true`を使用する場合、または環境変数CodeQL CLIを`CODEQL_EXTRACTOR_GO_OPTION_EXTRACT_TESTS`に設定することで、`true`オプションでオーバーライドできます。\n\nさらに、 `vendor` ディレクトリは既定で CodeQL Go 分析から除外されます。 これをオーバーライドするには、`--extractor-option extract_vendor_dirs=true`を使用するときに CodeQL CLI オプションを渡すか、環境変数`CODEQL_EXTRACTOR_GO_OPTION_EXTRACT_VENDOR_DIRS`を`true`に設定します。\n\n## Javaと Kotlin の構築\n\nCodeQL では、次のビルド モードがサポートされています。\n\n* Java: `none`、`autobuild`、または `manual`\n* Kotlin: `autobuild` または `manual`\n\nリポジトリの既定のセットアップを最初に有効にすると、Javaコードのみが検出された場合、ビルド モードは `none` に設定されます。 Kotlin またはJavaコードと Kotlin コードの組み合わせが検出された場合、ビルド モードは `autobuild` に設定されます。\n\n後で、 `none` ビルド モードを使用するリポジトリに Kotlin コードを追加した場合、 CodeQL 分析では、Kotlin がサポートされていないことを説明する警告メッセージが報告されます。 既定のセットアップを無効にして、再度有効にする必要があります。 既定のセットアップを再度有効にすると、両方の言語を分析できるようにビルド モードが `autobuild` に変更されます。 または、高度なセットアップに変更することもできます。 詳細については、「[警告: ビルドなしでは処理できない X Kotlin ファイルがプロジェクト内で検出されました](/ja/code-security/reference/code-scanning/troubleshoot-analysis-errors/kotlin-detected-in-no-build)」を参照してください。\n\n### Javaのビルドなし\n\nCodeQL は、存在するすべてのJava ファイルからデータベースを作成する前に、Gradle または Maven を実行して正確な依存関係情報を抽出しようとします (ただし、ビルドを呼び出すものではありません)。 すべてのルート Maven または Gradle プロジェクト ファイル (上位ディレクトリにビルド スクリプトが存在しないビルド スクリプト) では依存関係情報の照会が行われ、競合がある場合は、より新しい依存関係バージョンが優先されます。 Maven または Gradle を実行するためのランナーの要件については、[Java 用ランナーの要件](#runner-requirements-for-java)を参照してください。\n\nプライベート Maven レジストリが組織に対して定義されている場合は、これも使用されます。 [プライベート レジストリへの既定のセットアップ アクセスをスキャンするコード](/ja/code-security/how-tos/secure-at-scale/configure-organization-security/manage-usage-and-access/giving-org-access-private-registries#code-scanning-default-setup-access-to-private-registries) と、 [既定のセットアップをスキャンするコードがプライベート レジストリを使用したかどうかを確認](/ja/code-security/reference/code-scanning/code-scanning-logs#diagnostic-information-for-private-package-registries)する方法を参照してください。\n\n#### Javaのビルド分析なしの精度\n\nビルドなしで CodeQL Java データベースを作成すると、次の場合に `autobuild` または手動のビルド手順を使用するよりも、精度の低い結果が得られる場合があります。\n\n* Gradle または Maven ビルド スクリプトで依存関係情報を照会することはできません。依存関係の推測 (Java パッケージ名に基づく) は不正確です。\n* 通常、リポジトリはビルド プロセス中にコードを生成します。 これは、別のモードを使用して CodeQL データベースを作成した場合に分析されます。\n\n次の手順を実行すると、より正確な解析を行うことができます。\n\n* パブリック インターネットへのアクセスを提供するか、プライベート成果物リポジトリへのアクセスが使用可能であることを確認しますプライベート [レジストリへの既定のセットアップ アクセスをスキャンするコード](/ja/code-security/how-tos/secure-at-scale/configure-organization-security/manage-usage-and-access/giving-org-access-private-registries#code-scanning-default-setup-access-to-private-registries)を参照してください。\n* リポジトリに同じ依存関係の複数のバージョンが必要かどうかをチェックします。\n  CodeQL は 1 つのバージョンのみを使用でき、通常は複数のバージョンがある新しいバージョンを選択します。 この方法は、すべてのリポジトリでは機能しない場合があります。\n* 異なるソース Java ファイルで複数のバージョンの JDK API が必要かどうかを確認します。 複数のバージョンが表示された場合、 CodeQL は任意のビルド スクリプトに必要な最高のバージョンを使用します。 これは、より低いバージョンの JDK を必要とする一部のファイルが部分的に分析されることを意味する場合があります。 たとえば、一部のファイルで JDK 8 が必要だが、JDK 17 の要件が 1 つ以上のビルド スクリプトで見つかった場合、 CodeQL は JDK 17 を使用します。 JDK 8 を必要とし、JDK 17 を使用してビルドできなかったファイルは、部分的に分析されます。\n* クラス名の競合を避けてください (たとえば、`org.myproject.Test` を定義している複数のファイル)。競合すると、メソッド呼び出しターゲットが見つからない可能性があり、データフロー解析に影響を及ぼします。\n\n### Javaの自動ビルドの概要\n\n| サポートされているシステムの種類 | システム名                      |\n| ---------------- | -------------------------- |\n| オペレーティング システム    | Windows、macOS、Linux (制限なし) |\n| ビルドシステム          | Gradle、Maven、Ant           |\n\n### Javaの自動検出\n\n`autobuild` プロセスは、次の戦略を適用して、Javaコードベースのビルド システムを決定しようとします。\n\n1. ルートディレクトリでビルドファイルを検索します。 Gradle、Maven、Ant の各ビルドファイルを確認します。\n2. 最初に見つかったビルドファイルを実行します。 Gradle ファイルと Maven ファイルの両方が存在する場合は、Gradle ファイルが使用されます。\n3. それ以外の場合は、ルートディレクトリの直接サブディレクトリ内でビルドファイルを検索します。 1 つのサブディレクトリにのみビルドファイルが含まれている場合は、そのサブディレクトリで識別された最初のファイルを実行します（1 と同じ環境設定を使用）。 複数のサブディレクトリにビルドファイルが含まれている場合は、エラーを報告します。\n\n### Java用ランナーの要件\n\nセルフホステッド ランナーを使用している場合は、Javaの必要なバージョンが存在する必要があります。\n\n* 1 つのバージョンのJavaを必要とするリポジトリの分析にランナーを使用する場合は、適切な JDK バージョンをインストールし、PATH 変数に存在する必要があります (`java` と `javac` を見つけることができます)。\n\n* 複数のバージョンのJavaを必要とするリポジトリの分析にランナーを使用する場合は、適切な JDK バージョンをインストールする必要があり、`toolchains.xml` ファイルを使用して指定できます。 これは、通常 Apache Maven によって使用される構成ファイルで、ツールの場所、ツールのバージョン、およびツールの使用に必要な追加の構成を指定できます。 詳細については、Apache Maven ドキュメントの「[Guide to Using Toolchains](https://maven.apache.org/guides/mini/guide-using-toolchains.html)」(ツールチェーンの使用ガイド) を参照してください。\n\n次の実行可能ファイルは、一連のJava プロジェクトに必要になる可能性があり、PATH 変数に存在する必要がありますが、すべてのケースで必須であるとは限りません。\n\n* `mvn` (Apache Maven)\n* `gradle` (Gradle)\n* `ant` (Apache Ant)\n\nまた、プロジェクトが依存するビルド システム (`make`、`cmake`、`bazel` など) とユーティリティ (`python`、`perl`、`lex`、`yacc` など) をインストールする必要があります。\n\nWindows ランナーは`powershell.exe`を`PATH`に置く必要があります。\n\n## Rust の構築\n\nCodeQL では、Rust コードのビルド モード `none` がサポートされています。\n\n### Rust 用のビルドなし\n\nCodeQL では、 `rust-analyzer` を使用してビルド スクリプト (`build.rs` ファイル) をコンパイルして実行し、マクロ コードをコンパイルしますが、完全なビルドは呼び出しません。 存在するすべての Rust ファイルからデータベースが作成されます。\n`Cargo.toml`または`rust-project.json` ファイルが存在する必要があります。\n\n### Rust のランナー要件\n\nRust 分析では、 `rustup` と `cargo` をインストールする必要があります。\n\n## Swift のビルド\n\nCodeQL では、Swift コードのビルド モード `autobuild` または `manual` がサポートされています。\n\n### Swift の自動ビルドの概要\n\n| サポートされているシステムの種類 | システム名 |\n| ---------------- | ----- |\n| オペレーティング システム    | macOS |\n| ビルドシステム          | Xcode |\n\nこの `autobuild` プロセスは 、Xcode プロジェクトまたはワークスペースから最大のターゲットを構築しようとします。\n\nSwift コードのコード スキャンでは、既定で macOS ランナーが使用されます。\n\nGitHub ホスト型 macOS ランナーは、Linux および Windows ランナーよりもコストが高いので、分析するコードのみをビルドすることをお勧めします。\nGitHub-hosted runners の料金の詳細については、 [GitHub Actions の課金](/ja/billing/concepts/product-billing/github-actions) を参照してください。\n\nCode scanning ARC ランナーは Linux のみを使用し、Swift は macOS ランナーを必要とするため、 Actions Runner Controller (ARC) の一部であるランナーでは Swift コードの使用はサポートされていません。 ただし、ARC ランナーとセルフホスト型 macOS ランナーを混在させることもできます。 詳しくは、「[アクション ランナー コントローラー](/ja/actions/concepts/runners/actions-runner-controller)」をご覧ください。\n\n### CodeQL 分析ワークフロー で Swift コンパイルをカスタマイズする\n\n`xcodebuild` と `swift build` はどちらも Swift ビルドでサポートされています。 ビルド中は 1 つのアーキテクチャのみを対象にすることをお勧めします。 たとえば、`ARCH=arm64`は `xcodebuild`、`--arch arm64`は `swift build` です。\n\n`archive` と `test` オプション を `xcodebuild` に渡すことができます。 ただし、標準の `xcodebuild` コマンドは、スキャンを成功させるために必要なすべてをCodeQLが満たすべきであり、最も高速であると推奨されます。\n\nSwift 分析では、 CodeQL データベースを生成する前に、CocoaPods または Carthage によって管理される依存関係を常に明示的にインストールする必要があります。"}