8.7 发布—WinterCG 兼容性第一部分
了解更多

在 Windows 上设置 Android ​

您需要 Node、JDK（Java 开发工具包）、Android Studio 和 NativeScript CLI（命令行界面）。

Android Studio 不是严格必需的 — 但它为安装和管理 Android SDK 提供了一个易于使用的界面。

我们建议使用 Chocolatey 来安装所需的依赖项 — Windows 上一个流行的包管理器。

如果您是 Android 开发的新手，设置 Android 开发环境可能很令人生畏，但仔细按照以下步骤操作，您很快就能上手。

安装 Node ​

要安装 Node，我们建议使用 Node 版本管理器，例如 nvm-windows、nvs 或您喜欢的任何其他 Node 版本管理器。在这些文档中，我们将使用 nvm-windows，但您可以随意使用其他 Node 版本管理器。

  1. 请按照 nvm-windows 存储库中的安装说明 操作。我们建议使用安装程序，但如果您对自己的需求有更深入的了解，您也可以选择手动安装。
  2. 运行并按照 nvm-setup.exe 的说明操作。
  3. 安装完成后，打开新的命令提示符并验证您是否可以运行 nvm ls。
  4. 使用以下命令安装最新的 Node 版本
    cli
    nvm install node
  5. 验证安装是否成功并运行
    cli
    node -v
npm -v

故障排除

如果上述任何操作失败，我们建议查看 Microsoft Docs 设置 Node 的文档，或在 我们的社区 Discord 中寻求帮助。

安装 JDK ​

要安装 JDK（使用来自 Adoptium 的预构建 OpenJDK 二进制文件），请打开管理员命令提示符（右键单击并选择“以管理员身份运行”），并运行以下命令

cli
choco install -y temurin11

安装完成后，您可能需要将其添加到 Path 中。首先，通过打开新的命令提示符并运行以下命令来检查是否需要将其添加到 Path 中

cli
javac --version

如果您看到打印的版本号，则可以继续进行 安装 Android Studio，否则您需要将 JDK 二进制文件添加到您的系统环境 Path 中

  1. 在 Windows 搜索中搜索“编辑系统环境变量”并选择
  2. 单击底部角落的“环境变量...”
  3. 在“用户变量...”下，选择 Path 变量并单击 编辑...
  4. 单击 新建并将 JDK 二进制文件文件夹路径添加到列表中。默认位置是
    %LOCALAPPDATA%\???

安装 Android Studio ​

下载并安装 Android Studio。在安装向导中，确保选中以下组件（如果您选择 自定义 选项，应该会显示此列表）

设置可能需要一些时间，但完成后会显示欢迎屏幕。

Android Studio 默认安装最新的 Android SDK，在大多数情况下，这足以构建 NativeScript 应用程序。

配置 ANDROID_HOME 和 PATH ​

配置 ANDROID_HOME 环境变量，以便 NativeScript 能够找到 Android SDK。

  1. 在 Windows 搜索中搜索“编辑系统环境变量”并选择
  2. 单击底部角落的“环境变量...”
  3. 在“用户变量...”下，单击 新建... 创建指向 Android SDK 路径的 ANDROID_HOME 用户变量

New User Variable (ANDROID_HOME)

SDK 默认位于

%LOCALAPPDATA%\Android\Sdk

要在 Android Studio 的 设置 中找到实际位置，请导航到 外观和行为 › 系统设置 › Android SDK 并复制 Android SDK 位置。

接下来，将 Android platform-tools 添加到路径

  1. 在 Windows 搜索中搜索“编辑系统环境变量”并选择
  2. 单击底部角落的“环境变量...”
  3. 在“用户变量...”下，选择 Path 变量并单击 编辑...
  4. 单击 新建并将 platform-tools 路径添加到列表中。默认位置在 Android SDK 的 platform-tools 文件夹内
    %LOCALAPPDATA%\Android\Sdk\platform-tools

安装 NativeScript CLI ​

全局安装 NativeScript CLI

cli
npm install -g nativescript
您可能会看到来自 npm 的弃用和安全警告，这些警告可以忽略。了解更多...

NativeScript CLI 依赖于第三方包，这些包可能在过去几年中已过时。我们正在逐步用更新、受支持的替代方案替换这些依赖项来解决这些警告，但通常可以忽略这些警告，因为 CLI 从未公开，并且仅用于本地开发，在大多数情况下，安全问题并不适用。

验证环境 ​

要验证安装是否成功，请打开新的命令提示符窗口（以确保加载新的环境变量）并运行

cli
ns doctor android

如果您看到 未检测到任何问题，则说明您已成功设置系统。

最后，您还需要 设置 Android 设备或模拟器。

故障排除

如果上述任何操作失败，我们建议在 我们的社区 Discord 中寻求帮助。

在 Windows 上设置 iOS ​

❌ 不支持

构建使用原生 iOS 代码的项目需要 Mac。可以使用 NativeScript 预览 测试更简单的应用程序。