Skip to main content
版本：v3

1. 环境准备

在本章节中，我们将完成以下环境准备工作

  • Node.js (v >= 16.0)
  • npm
  • Zeus CLI
  • TUN/TAP Network for simulator

我们提供了两种方式来完成环境准备，建议使用 Zepp OS 官方提供的 env-setup-script 脚本来实现一键安装，或者根据文档提示，手动完成环境准备。

使用 env-setup-script 脚本安装环境​

下载 env-setup-script 安装包​

开发者根据不同操作系统，下载对应安装包。

执行脚本​

在这一步骤中，不同操作系统的操作有差异，请参考操作系统对应的内容进行操作。

执行脚本，即可完成环境安装，当脚本出现以下提示表明安装成功。

Environment

Windows​

在 Windows 中推荐使用系统内置的 PowerShell 终端来执行命令，以管理员方式运行。

进入 /win10-11 目录中，执行 .\env-helper.ps1 命令。

.\env-helper.ps1
信息

如果遇到了这样的错误提示消息

File .\env-helper.ps1 cannot be loaded because running scripts is disabled on this system. For more information, see about_Execution_Policies at http://go.microsoft.com/fwlink/?LinkID=135170.

+ CategoryInfo : SecurityError: (:) [], ParentContainsErrorRecordException
+ FullyQualifiedErrorId : UnauthorizedAccess

The script doesn’t run because the PowerShell Execution Policy is set to the default of Restricted.

请先在终端执行如下命令

Set-ExecutionPolicy -ExecutionPolicy RemoteSigned

之后重新执行 .\env-helper.ps1 命令

macOS​

警告

如果使用的是搭载 Apple 芯片的 Mac，不适用此脚本，请参考 手动安装。

如何确定 Mac 是否搭载 Apple 芯片？

  1. 点击桌面左上角 Apple 图标
  2. 点击「关于本机」
  3. 在「概览」Tab 浏览处理器信息，如果显示 Apple 则为搭载 Apple 芯片的 Mac

如果已经执行过安装脚本，则需要执行以下命令卸载相关文件，之后直接进行手动安装的最后一步，模拟器 - 安装与启动。

sudo rm -rf /Library/Extensions/tun.kext
sudo rm -rf /Library/Extensions/tap.kext

sudo rm -f /Library/LaunchDaemons/*tun.plist
sudo rm -f /Library/LaunchDaemons/*tap.plist

在 macOS 中推荐使用系统内置的 Terminal 或者 iTerm2 终端来执行命令。

进入 /macOS 目录下，执行脚本。

cd macOS
bash env-helper.sh
信息
  • 如果提示输入密码，输入当前用户的密码并确认
Extension with identifiers xxxxxx not approved to load. Please approve using System Preferences.
  • 如果收到这样的错误提示，在「系统偏好设置」的「隐私与安全性」中手动授予权限

Debian​

我们只提供为基于 Debian 的 Linux 发行版的自动安装脚本（使用了 apt）， 如果您要在其他 Linux 发行版中使用，请移步手动安装

在 Ubuntu 中推荐使用系统内置的 Terminal 终端执行命令。

进入 /linux 目录下，执行脚本。

cd linux
bash env-helper.sh

手动安装​

请参考以下文档，完成环境准备