快速入门

在 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. 下载并安装适用于 AGDE 23.1.82 或更高版本的 JDK 17，或适用于 AGDE 22.2.71 及更早版本的 JDK 11，并设置您的 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 会将此名称传递给应用的 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

下一步

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