クイックスタート

Windows パソコンで Android Game Development Extension をセットアップし、Android デバイスまたはエミュレータで Visual Studio C++ のサンプル プロジェクトを実行します。

前提条件

このセクションの手順に沿って、拡張機能をインストールするために Windows パソコンを準備します。

1. サポートされている Visual Studio のバージョンのいずれかをダウンロードしてインストールします。

   • Visual Studio 2017 バージョン 15.4.0（2017 年 10 月 9 日）以上。
   • Visual Studio 2019 バージョン 16.0.0 以上。
   • Visual Studio 2022 バージョン 17.0.0 以降。

2. .NET Core SDK 2.2 をダウンロードしてインストールします。

3. Android Studio 3.5 以上は必須ではなく、代わりに Android Game Development Extension を使用して Android SDK と NDK をインストールすることもできます。

4. AGDE 23.1.82 以降の場合は JDK 17、AGDE 22.2.71 以前の場合は JDK 11 をダウンロードしてインストールし、JAVA_HOME 環境変数を設定します。

拡張機能をインストールする

このセクションの手順に沿って、Android Game Development Extension をダウンロードしてインストールします。

1. Visual Studio のすべてのインスタンスを閉じます。

2. ダウンロード ページから、最新の拡張機能インストーラとサンプルをダウンロードします。

3. ダウンロード場所から、インストーラをダブルクリックします。インストーラが完了するまでに数分かかります。

4. 複数のバージョンの Visual Studio がインストールされている場合は、この拡張機能をインストールするバージョンを選択してください。

5. [Finish] をクリックしてインストールを完了します。

Android SDK と NDK をインストールする

Android SDK と Android Native Development Kit（NDK）は、Android Studio または Android Game Development Extension でインストールできます。拡張機能から SDK と NDK をインストールするには、Visual Studio の拡張機能ツールバーにある SDK Manager を使用します。

NDK をインストールする場合は、拡張機能が位置を特定できるように [NDK (Side by side)] チェックボックスを使用してください。拡張機能でサポートされている NDK バージョンをインストールする必要があります（NDK の変更履歴をご覧ください）。

SDK をデフォルトと異なる場所にインストールするには、コンピュータ上で ANDROID_SDK_ROOT 環境変数を設定します。

1. Visual Studio が閉じていることを確認します。
2. Windows Search で「環境変数（Environment Variables）」を検索します。
3. [システム環境変数の編集] を選択します。
4. [環境変数] をクリックします。
5. [ユーザー環境変数] で [新規] をクリックします。
6. [変数名] ボックスに「ANDROID_SDK_ROOT」と入力します。
7. [変数値] ボックスに Android SDK のパスを入力します。
8. パソコンを再起動します。

この環境変数が SDK の場所に関する唯一の信頼できる情報源であるため、SDK Manager ウィンドウを使用して SDK の場所を変更することはできません。

サンプルを実行する

このセクションの手順に沿って、提供されたサンプルをエミュレータで実行した後、実際の Android デバイスで実行します。

プラットフォームを構成する

1. サンプルの zip ファイルを任意のディレクトリに解凍します。次のサンプルが含まれています。

   • endless-tunnel
   • HelloJNI
   • Teapot（試験運用版の Ninja ビルド統合を使用）

2. Visual Studio がまだ実行されていない場合は起動します。

3. サンプルのディレクトリに移動します。[File] > [Open] > [Project/Solution] を選択し、.sln ファイルに移動します。

4. Android プラットフォームを選択します。

   1. [Build] > [Configuration Manager] を選択します。
   2. [Active Solution platform] で [Android-x86_64] を選択します。

   このサンプルでは、Android プラットフォームはすでに構成されています（プラットフォームを追加するには、Android プラットフォームを追加するをご覧ください）。

   注: 一般的なエミュレータ イメージは x86 または x86_64 の ABI を使用します。

5. サンプル プロジェクトに Android SDK と NDK のプロパティが構成されていることを確認します。

   

   図 1.Android プラットフォーム プロパティ

   • [ソリューション エクスプローラ] でプロジェクトを右クリックして、[プロパティ] を選択します。

   • [General] プロパティタブを選択し、Android の [Platform] プロパティを確認します。

   注: インストールされている NDK を選択してください。

6. [Android Packaging] プロパティタブを選択します。

   

   図 2.Android パッケージング プロパティ

   このタブから、出力 APK の名前とディレクトリを変更できます。一部の Android 構成プロパティはプロパティ ページで定義され、Gradle に渡されます。たとえば、APK 名プロパティ MSBUILD_ANDROID_OUTPUT_APK_NAME は、この名前をアプリの build.gradle ファイルに渡します。

エミュレータをセットアップする

1. Visual Studio の拡張機能ツールバーから、AVD Manager を起動します。 仮想デバイスを構成してから、Android Emulator で実行します。

   1. Android Virtual Device Manager で、[Create Virtual Device] をクリックします。
   2. デバイス定義（Pixel 2 など）を選択します。
   3. システム イメージを選択します。このアーキテクチャはエミュレータでより高速に処理できるため、x86_64 ABI を選択する必要があります。
   4. 構成を確認して [Finish] をクリックします。

2. Android Virtual Device Manager で 実行ボタン をクリックして仮想デバイスを起動します。

3. Visual Studio で、[Start Debugging] ツールバー ボタンの横に仮想デバイスが表示されます。[Start Debugging] をクリックして、デバイス上でサンプルアプリを起動します。デバッガがアプリにアタッチされるまでに数分かかることがあります。Teapot サンプルを実行している場合は、マウスカーソルを上でドラッグすることで、ティーポットを回転できます。

   
   図 3. Android エミュレータで動作する Teapot サンプル

デバイスをセットアップする

1. 実際の Android デバイスでサンプルを実行する場合、プロジェクト内に新しい Android プラットフォームを作成する必要があります。このプラットフォームは、デバイスのアーキテクチャと一致している必要があります。新しいプラットフォームを作成するには、Visual Studio で次の手順に沿って操作します。

   1. [Build] > [Configuration Manager] を選択します。
   2. [Active solution platform] で [<New>] を選択します。

   3. 新しいプラットフォームについて、次のいずれかを入力します。

      • Android-armeabi-v7a
      • Android-arm64-v8a
      • Android-x86
      • Android-x86_64

   4. [Copy settings from] ボックスで、別の既存の Android プラットフォームを選択します（Android プラットフォームがまだない場合は [None] を選択します）。[Create new project platform] が有効であることを確認します。

2. USB ケーブルを使用して Android デバイスをパソコンに接続します。[Start Debugging] ツールバー ボタンの横にデバイスタイプが表示されます。

   
   図 4. [Start Debugging] ツールバー ボタンの横に表示された接続済み Android デバイス

   デバイスが表示されない場合は、次の点を確認してください。

   • プラットフォームの選択が、デバイスの ABI と一致している。
   • デバイスで開発者向けオプションと USB デバッグが有効になっている。
   • デバイスが USB ケーブルでパソコンに接続されている。
   • USB ケーブルが、電源だけでなくデータ接続にも対応している。

3. [Start Debugging] ツールバー ボタンをクリックして、デバイス上のサンプルアプリを起動します。デバッガがアプリにアタッチされるまで少し時間がかかる場合があります。接続が終わると、デバイス上のアプリを操作できるようになります。

よくある質問

Android Game Development Extension に関するよくある質問を次に示します。

プラグインのログはどこにありますか？

プラグインのログファイルを開くには、Android Game Development Extension ツールバーの [Open Logs] アイコンを使用します。

プラグインはどのような環境変数を使用しますか？

プラグインは、次の環境変数を使用します。

• ANDROID_SDK_ROOT
• ANDROID_SDK_HOME
• TEMP
• GOOGLE_ANDROID_LOG_DIR

次のステップ

拡張機能で独自のプロジェクトを使用するには、プロジェクト設定に関するガイドに沿ってプロジェクトを設定する必要があります。