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

在 Linux 上设置 Android ​

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

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

要安装Node，请按照适用于您的 Linux 发行版的说明进行操作。我们建议使用最新版本，但是Node 12以上版本应该都可以。

注意

我们在Ubuntu 20.04上完成了这些步骤，并记下了我们使用的命令，但是根据您的 Linux 发行版，命令可能会有所不同。我们无法为所有可能的 Linux 发行版提供命令，因此请参考链接的文档以找到您需要运行的正确命令。

cli
# On Ubuntu 20.04, we used the following command to install latest node
$ curl -fsSL https://deb.nodesource.com/setup_15.x | sudo -E bash -
$ sudo apt-get install -y nodejs

要确认Node是否已正确安装，请运行

cli
$ node -v
$ npm -v
# Should print something like
$:v15.x.x
7.x.x

需要JDK 版本 8 或更高版本，您可以选择以下几种方式：

  1. OpenJDK - Adoptium——可以从Adoptium或您的系统软件包管理器下载。
  2. OpenJDK - AdoptOpenJDK——可以从AdoptOpenJDK或您的系统软件包管理器下载。
  3. Oracle JDK——可以从官网直接下载或通过系统软件包管理器下载。
cli
# On Ubuntu 20.04, we used the following command to install OpenJDK 14
sudo apt-get install -y openjdk-14-jdk

要确认JDK是否已正确安装，请运行

cli
$ java --version
$ javac --version
# Should print something like
$:openjdk 14.0.2 2020-07-14
OpenJDK Runtime Environment (build 14.0.2+12-Ubuntu-120.04)
OpenJDK 64-Bit Server VM (build 14.0.2+12-Ubuntu-120.04, mixed mode, sharing)

javac 14.0.2

注意

NativeScript 使用 Gradle 进行 Android 构建。Gradle 的不同版本依赖于某些版本的 Java 才能工作。如果构建失败，请检查系统上安装的 Java 版本是否与 NativeScript 使用的 Gradle 版本兼容。NativeScript 使用的 Gradle 版本可以在构建日志或源代码中查看。

如果您是 Android 开发的新手，那么设置 Android 开发环境可能会让人望而生畏，但是仔细按照以下步骤操作，您很快就能开始使用。

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

  • Android SDK
  • Android SDK 平台
  • Android 虚拟设备

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

Android Studio 默认安装最新的 Android SDK，在大多数情况下，这应该是构建 NativeScript 应用程序所需的一切。

配置ANDROID_HOME环境变量，以便 NativeScript 能够找到 Android SDK，并将所需的工具添加到路径中。

将以下行添加到您的 shell 配置文件中，通常是~/.bash_profile或~/.bashrc，或者如果您使用的是zsh，则为~/.zshrc配置文件

shell
export ANDROID_HOME=$HOME/Android/Sdk
export PATH=$PATH:$ANDROID_HOME/platform-tools

全局安装 NativeScript CLI

cli
npm install -g nativescript
您可能会看到 npm 发出的弃用和安全警告，这些警告可以忽略。阅读更多...

NativeScript CLI 依赖于过去几年可能已被弃用的第三方软件包。我们正在逐渐用更新、受支持的替代方案替换这些依赖项以解决这些警告，但是通常可以忽略它们，因为 CLI 永远不会公开，并且仅用于本地开发，在本地开发中，大多数安全问题都不适用。

注意

根据您安装Node的方式，在尝试安装全局软件包时，您可能会收到EACCESS: permission denied错误。通常不建议使用sudo运行npm，请参阅本指南了解解决 EACCESS 权限错误的方法。

验证环境 ​

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

cli
ns doctor android

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

在 Linux 上设置 iOS ​

❌ 不支持

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