In this section, we will complete the following environment preparations.
- Node.js (v >= 16.0)
- Zeus CLI
- TUN/TAP Network for simulator
We provide two ways to prepare the environment. We recommend using the env-setup-script provided by Zepp OS for one-click installation, or following the documentation to prepare the environment manually.
Install the environment using the env-setup-script script
Download the env-setup-script project
The developer downloads the corresponding installation packages according to different operating systems.
During this phase, the procedure varies depending on the operating system being used. Therefore, please refer to the relevant sections for your specific operating system.
Execute the script, you can complete the installation of the environment, when the script appears the following prompt indicates that the installation is successful.
In Windows, it is recommended to use the built-in
PowerShell terminal to execute commands as an administrator.
Go to the
/win10-11 directory and execute the
. \env-helper.ps1 command.
If you encounter an error message like this.
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.
Please execute the following command in the terminal first:
Set-ExecutionPolicy -ExecutionPolicy RemoteSigned
And then run the script again.
If you are using a Mac with an Apple chip, this script is not applicable. Please refer to Manual Installation.
How to know if a Mac is equipped with an Apple chip?
- Click the Apple icon in the upper left corner of the desktop
- Select About This Mac
- In the “Overview” tab, look for “Processor” or “Chip”. Check if it says “Apple”
If the installation script has already been executed, you need to execute the following command to uninstall the relevant files, and then proceed directly to the final step of manual installation, Simulator - Installation and Startup.
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
In macOS, it is recommended to use the built-in
iTerm2 to execute commands.
Go to the
/macOS directory and execute the script.
- If prompted for a password, enter the current user's password and confirm it.
Extension with identifiers xxxxxx not approved to load. Please approve using System Preferences.
- If you get this error, manually grant permissions in Privacy and Security in System Preferences.
- For Apple Silicon models, please refer to the Enable System Extensions or Kernel Extension on Apple Silicon Mac for setup first.
We only provide installation script for Debian-based which use apt. If you want to use it with other Linux distribution, you can see Manual Installation
In Ubuntu, it is recommended to use the built-in
Terminal terminal to execute commands.
Go to the
/linux directory and execute the script.
Please refer to the following documents to complete the environment preparation.