快速入门

在 Windows 计算机上设置 Android 游戏开发扩展，并在 Android 设备或模拟器上运行 Visual Studio C++ 示例项目。

先决条件

按照本节中的步骤准备您的 Windows 计算机以安装扩展

  1. 下载并安装受支持的 Visual Studio 版本之一

  2. 下载并安装 .NET Core SDK 2.2.

  3. Android Studio 3.5 或更高版本 是可选的，但可以替代 Android 游戏开发扩展来安装 Android SDK 和 NDK。

  4. 下载并安装 JDK 17（适用于 AGDE 23.1.82 或更高版本），或 JDK 11（适用于 AGDE 22.2.71 或更低版本），并设置您的 JAVA_HOME 环境变量。

安装扩展

按照本节中的步骤下载并安装 Android 游戏开发扩展

  1. 关闭所有 Visual Studio 实例。

  2. 从 下载 页面下载最新的扩展安装程序和示例。

  3. 从下载位置双击安装程序。安装程序需要几分钟才能完成。

  4. 如果您安装了多个版本的 Visual Studio，请选择您希望为其安装扩展的版本。

  5. 单击**完成**以完成安装。

安装 Android SDK 和 NDK

您可以使用 Android Studio 或 Android 游戏开发扩展安装 Android SDK 和 Android 原生开发套件 (NDK)。要从扩展安装 SDK 和 NDK，请使用**SDK 管理器**，它位于 Visual Studio 的扩展工具栏中。

安装 NDK 时，请务必使用**NDK（并排）**复选框，以便扩展可以找到它。您必须安装扩展支持的 NDK 版本（请参阅 NDK 版本历史记录）。

要将 SDK 安装到与默认位置不同的位置，请在您的计算机上设置 ANDROID_SDK_ROOT 环境变量

  1. 确保 Visual Studio 已关闭。
  2. 在 Windows 搜索中，搜索 环境变量。
  3. 选择**编辑系统环境变量**。
  4. 单击**环境变量**。
  5. 在**用户变量**下，单击**新建**。
  6. 在**变量名**框中，键入 ANDROID_SDK_ROOT。
  7. 在**变量值**框中，输入 Android SDK 的路径。
  8. 重新启动计算机。

SDK 的位置无法使用 SDK 管理器窗口修改，因为此环境变量是 SDK 位置的唯一可靠来源。

运行示例

按照本节中的步骤在模拟器上运行提供的示例，然后在物理 Android 设备上运行。

配置平台

  1. 将示例 zip 文件解压缩到您选择的目录中。包含以下示例

    • endless-tunnel
    • HelloJNI
    • Teapot

  2. 如果 Visual Studio 未运行，请启动它。

  3. 打开示例目录。选择**文件 > 打开 > 项目/解决方案**，然后导航到 .sln 文件。

  4. 选择 Android 平台

    1. 选择**生成 > 配置管理器**。
    2. 在**活动解决方案平台**下，选择**Android-x86_64**。

    Android 平台已在示例中配置（有关添加平台，请参阅 添加更多 Android 平台）。

  5. 确保示例项目已配置 Android SDK 和 NDK 属性

    图 1. Android 平台属性

    • 在**解决方案资源管理器**中，右键单击项目并选择**属性**。

    • 选择**常规**属性选项卡，然后查找 Android 的**平台**属性。

  6. 选择**Android 打包**属性选项卡。

    图 2. Android 打包属性

    您可以从此选项卡更改输出 APK 名称和目录。请注意，某些 Android 配置属性是在属性页中定义的，并传递给 Gradle。例如，APK 名称属性 MSBUILD_ANDROID_OUTPUT_APK_NAME 将此名称传递给 app build.gradle 文件。

设置模拟器

  1. 从 Visual Studio 中的扩展工具栏启动 AVD 管理器。配置虚拟设备，然后 在 Android 模拟器中运行它。

    1. 在 Android 虚拟设备管理器中，单击**创建虚拟设备**。
    2. 选择设备定义（例如，Pixel 2）。
    3. 选择系统映像。您应该选择 x86_64 ABI，因为此架构在模拟器中性能更高。
    4. 验证配置并单击**完成**。

  2. 通过单击 Android 虚拟设备管理器中的**运行** 运行图标 按钮启动虚拟设备。

  3. 在 Visual Studio 中，虚拟设备应该会出现在**开始调试**工具栏按钮旁边。单击**开始调试**以在设备上启动示例应用。调试器可能需要几分钟才能附加到应用。如果您正在运行 Teapot 示例，可以通过在茶壶上拖动鼠标光标来旋转茶壶。

    Teapot sample running on an emulator
    图 3. 在 Android 模拟器上运行的 Teapot 示例

设置设备

  1. 要在物理 Android 设备上运行示例，您可能需要在项目中创建一个新的 Android 平台。此平台必须与设备的架构匹配。要在 Visual Studio 中创建新平台，请执行以下操作

    1. 选择**生成 > 配置管理器**。
    2. 在**活动解决方案平台**下，选择**<新建>**。

    3. 为新平台键入以下内容之一

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

    4. 在**从复制设置**框中，选择另一个现有的 Android 平台（如果您还没有任何 Android 平台，则选择**无**）。确保您启用了**创建新项目平台**。

  2. 使用 USB 线将 Android 设备连接到您的电脑。设备类型应显示在**开始调试**工具栏按钮旁边。

    Run button in Visual Studio
    图 4. 连接的 Android 设备显示在**开始调试**工具栏按钮旁边

    如果未显示设备，请检查以下内容

    • 平台选择与您设备的 ABI 匹配。
    • 开发者选项和 USB 调试已在设备上启用。
    • USB 线已从设备连接到电脑。
    • USB 线支持数据连接（不仅仅是供电）。

  3. 点击**开始调试**工具栏按钮，在设备上启动示例应用。调试器可能需要几秒钟才能连接到应用。连接后，您可以在设备上与应用交互。

常见问题

以下是一些关于 Android 游戏开发扩展的常见问题。

插件的日志位于哪里？

您可以使用**Android 游戏开发扩展**工具栏中的**打开日志**图标打开插件的日志文件。

插件使用哪些环境变量？

插件使用以下环境变量

  • ANDROID_SDK_ROOT
  • ANDROID_SDK_HOME
  • TEMP
  • GOOGLE_ANDROID_LOG_DIR

后续步骤

要将您自己的项目与扩展一起使用，您必须根据项目配置指南对其进行配置。