快速入门

在 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 Game Development Extension 用来安装 Android SDK 和 NDK

  4. 下载并安装 JDK 17(适用于 AGDE 23.1.82 或更高版本)或 JDK 11(适用于 AGDE 22.2.71 或更低版本),然后设置 JAVA_HOME 环境变量。

安装扩展程序

按照本部分中的步骤下载并安装 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 原生开发套件 (NDK)。如需通过该扩展程序安装 SDK 和 NDK,请使用 Visual Studio 扩展程序工具栏中的 SDK 管理器

安装 NDK 时,请务必勾选 NDK (Side by side) 复选框,以便该扩展程序可以找到它。您必须安装该扩展程序支持的 NDK 版本(请参阅 NDK 修订历史记录)。

如需将 SDK 安装到与默认位置不同的其他位置,请在计算机上设置 ANDROID_SDK_ROOT 环境变量:

  1. 确保 Visual Studio 已关闭。
  2. 在 Windows 搜索中,搜索 Environment Variables
  3. 选择编辑系统环境变量
  4. 点击环境变量
  5. User Variables 下,点击 New
  6. 变量名称框中,输入 ANDROID_SDK_ROOT
  7. 变量值框中,输入 Android SDK 的路径。
  8. 重新启动计算机。

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

运行示例

请按照本部分中的步骤运行提供的示例,先在模拟器上运行,然后在实体 Android 设备上运行。

配置平台

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

  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 会将此名称传递给应用 build.gradle 文件。

设置模拟器

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

    1. 在 Android 虚拟设备管理器中,点击 Create Virtual Device
    2. 选择设备定义(例如 Pixel 2)。
    3. 选择系统映像。您应选择 x86_64 ABI,因为此架构在模拟器中执行速度较快。
    4. 验证配置,然后点击 Finish
  2. 通过点击 Android 虚拟设备管理器中的 Run “Run”图标 按钮来启动虚拟设备。

  3. 在 Visual Studio 中,虚拟设备应显示在启动调试工具栏按钮旁边。点击启动调试以在设备上启动示例应用。调试程序连接到该应用可能需要一些时间。如果运行的是 Teapot 示例,您可以通过将鼠标光标拖过茶壶来使其旋转。

    在模拟器上运行的 Teapot 示例
    图 3. 在 Android 模拟器上运行的 Teapot 示例

设置设备

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

    1. 依次选择生成 > 配置管理器
    2. Active solution platform 下,选择 <New>
    3. 为新平台输入以下某一项:

      • Android-armeabi-v7a
      • Android-arm64-v8a
      • Android-x86
      • Android-x86_64
    4. 从此处复制设置框中,选择其他现有 Android 平台(如果尚无任何 Android 平台,请选择)。确保您已启用创建新的项目平台

  2. 使用 USB 线将 Android 设备连接到您的计算机。设备类型应显示在启动调试工具栏按钮旁边。

    Visual Studio 中的“运行”按钮
    图 4. 连接的 Android 设备显示在启动调试工具栏按钮旁边

    如果未显示设备,请检查以下各项:

    • 平台的选择是否与设备的 ABI 匹配。
    • 是否在设备上启用了开发者选项和 USB 调试
    • USB 线是否从设备连接到计算机。
    • USB 线是否支持数据连接(而不仅仅是电源)。
  3. 点击启动调试工具栏按钮,以在设备上启动示例应用。调试程序连接到该应用可能需要一些时间。连接好后,您就可以在设备上与该应用互动了。

常见问题解答

下面是有关 Android Game Development Extension 的一些常见问题解答。

该插件的日志位于何处?

您可以使用 Android Game Development Extension 工具栏中的 Open Logs 图标打开该插件的日志文件。

该插件使用哪些环境变量?

该插件使用以下环境变量:

  • ANDROID_SDK_ROOT
  • ANDROID_SDK_HOME
  • TEMP
  • GOOGLE_ANDROID_LOG_DIR

后续说明

如需在您自己的项目中使用该扩展程序,您必须根据项目配置指南对其进行配置。