快速入門導覽課程

在 Windows 電腦上設定 Android Game Development Extension,並在 Android 裝置或模擬器上執行 Visual Studio C++ 專案範例。

必要條件

按照本節的步驟操作,為 Windows 電腦安裝擴充功能做好準備:

  1. 下載並安裝系統支援的 Visual Studio 版本:

  2. 下載並安裝 .NET Core SDK 2.2

  3. Android Studio 3.5 以上版本是選用項目,不過可用於安裝 Android SDK 和 NDK,而非 Android Game Development Extension。

安裝擴充功能

按照本節的步驟下載並安裝 Android Game Development Extension:

  1. 關閉所有 Visual Studio 執行個體。

  2. 在「Downloads」頁面,下載最新的擴充功能安裝程式和範例。

  3. 從下載位置按兩下安裝程式。安裝程式需要幾分鐘才能完成。

  4. 如果安裝了多個版本的 Visual Studio,請選取要安裝擴充功能的版本。

  5. 按一下「Finish」以完成安裝程序。

安裝 Android SDK 和 NDK

您可以使用 Android Studio 或 Android Game Development Extension,安裝 Android SDK 和 Android Native Development Kit (NDK)。如要從擴充功能安裝 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. 選取「Edit the system environment variables」
  4. 按一下「Environment Variables」。
  5. 在「User Variables」下方,按一下「New」
  6. 在「Variable Name」方塊中輸入 ANDROID_SDK_ROOT
  7. 在「Variable Value」方塊中,輸入 Android SDK 的路徑。
  8. 重新啟動電腦

這個環境變數是 SDK 位置的唯一真實資訊來源,因此無法使用 SDK Manager 視窗修改 SDK 的位置。

執行範例

按照本節的步驟,在模擬器和實體 Android 裝置上執行 Teapot 範例。

設定平台

  1. 啟動 Visual Studio (如果尚未執行的話)。

  2. 將範例 ZIP 檔案解壓縮至您選擇的目錄。下列範例包含:

    • Teapot
    • endless-tunnel
    • HelloJNI
  3. 開啟範例目錄。依序選取「File」>「Open」>「Project/Solution」,然後前往 Teapot.sln

  4. 選取 Android 平台:

    1. 依序選取「Build」>「Configuration Manager」
    2. 在「Active solution platform」下方,選取「Android x86」

    範例中已設定了兩個 Android 平台 (您之後可以新增更多 Android 平台)。

  5. 確認範例專案已設定 Android SDK 和 NDK 屬性:

    圖 1. Android 平台屬性
    • 在「Solution Explorer」中,在「GameApplication」上按一下滑鼠右鍵,然後選取「Properties」

    • 選取「General」 屬性分頁標籤,找出 Android 的「平台」屬性。

  6. 選取「Android Packaging」屬性分頁標籤。

    圖 2. Android 封裝屬性

    您可以在這個分頁中變更輸出 APK 名稱和目錄。請注意,部分 Android 設定屬性於屬性頁面中定義,並傳送至 Gradle。舉例來說,APK 名稱屬性 MSBUILD_ANDROID_OUTPUT_APK_NAME 會將這個名稱傳送至應用程式的 build.gradle 檔案。

設定模擬器

  1. 從 Visual Studio 的擴充功能工具列中啟動 AVD Manager。 設定虛擬裝置,然後在 Android Studio 模擬器中執行

    1. 在 Android 虛擬裝置管理員中,按一下「Create Virtual Device」
    2. 選擇裝置定義 (例如 Pixel 2)。
    3. 選取系統映像檔。建議選擇 x86 ABI,因為這個架構在模擬器中運作地更快。
    4. 確認設定正確無誤,然後按一下「Finish」
  2. 按一下 Android 虛擬裝置管理員中的「Run」執行圖示 按鈕,來啟動虛擬裝置。

  3. 在 Visual Studio 中,虛擬裝置類型會顯示在「Start Debugging」 工具列按鈕旁邊。按一下「Start Debugging」,在裝置上啟動 Teapot 範例應用程式。偵錯工具可能需要幾分鐘的時間才能附加至應用程式,您可以將游標拖曳來旋轉茶壺。

    在模擬器中執行的 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」方塊中選取「None」

  2. 使用 USB 傳輸線將 Android 裝置連接到電腦。裝置類型會顯示在「Start Debugging」工具列按鈕旁邊。

    Visual Studio 中的執行按鈕
    圖 4. 顯示在「Start Debugging」工具列按鈕旁的已連線 Android 裝置

    如果未顯示裝置類型,請檢查下列事項:

  3. 按一下「Start Debugging」工具列按鈕,在裝置上啟動範例 Teapot 應用程式。偵錯工具可能需要幾分鐘的時間才能附加至應用程式。附加完成後,可以用手指拖曳來旋轉茶點。

常見問題

以下是有關 Android Game Development Extension 的一些常見問題。

外掛程式的記錄檔位於何處?

您可以使用「Android Game Development Extension」工具列中的「Open Logs」圖示,開啟外掛程式的記錄檔。

為什麼外掛程式在 ADB 中尋找到錯誤的位置?

外掛程式會使用下列邏輯尋找 SDK 的位置:

public static string GetAndroidSdk() =>
    Environment.GetEnvironmentVariable("ANDROID_SDK_ROOT") ??
    Environment.GetEnvironmentVariable("LocalAppData").Resolve(@"Android\Sdk");

這個外掛程式會使用哪些環境變數?

這個外掛程式會使用下列環境變數:

  • ANDROID_SDK_ROOT
  • ANDROID_SDK_HOME
  • TEMP
  • GOOGLE_ANDROID_LOG_DIR

後續步驟

如要將擴充功能用在自己的專案,請按照專案設定指南進行設定。