快速入门

在 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

下一步

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