华米ZeppOS推出的时间不算长，网上配置环境的教程也不多。本人在配置环境过程中，前后花了两三天时间，踩了很多坑，特此写一篇教程，希望能帮助到想尝试ZeppOS小程序开发的朋友。

由于配套的开发工具还处于较快迭代阶段，本教程可能不适用于未来的版本，当前时间点为：2022.4

本教程发布于博客园，转载请先征得同意！

教程概要：

一、安装Ubuntu虚拟机

二、虚拟机内安装ZeppOS模拟器

三、宿主机安装vscode

四、宿主机安装zeos cli

五、在vscode内结合cli编写代码并调试

六、一些踩坑记录

一、安装Ubuntu虚拟机

进行小程序开发，调试是必不可少的。如果你有支持zeppos的设备，当然可以用设备实机调试。我估摸有设备的人应该是少数，所以需要安装模拟器。

目前，官方的模拟器仅支持Ubuntu系统，据说未来会有跨平台的模拟器。

如果你也爱折腾，可能会问：为什么不用Win10自带的wsl？为什么不装双系统？答案是：很可能折腾不好！很久以前刚接触Linux时，我尝试过双系统，然而放弃了；这两天在反复装了三次wsl2的Ubuntu之后，才终于搞好，容易有奇怪的问题，建议也别耗费这个时间。（当然wsl还是很好用的，只是模拟器暂时没有很好地适配。不支持systemctl命令等原因，使得wsl和独立安装的Ubuntu有所不同）

1. 下载虚拟机软件

个人习惯于用VMware Workstation 16 Player运行各种虚拟机，player版能免费用于非商业用途。官网

安装过程中，不要点得太快，看清楚了再下一步——因为如果你的win10开启了hyper-v功能，需要额外勾选一个自动安装WHP的复选框，才能让vmware正常运行。

2. 下载Ubuntu系统镜像

国内可去清华镜像站等处快速下载，建议下载lts版本。

3. 打开vmware，用镜像新建一个虚拟机

我的配置如图下图。网络连接模式，经测试桥接模式和NAT模式都可以连接到模拟器。该配置在安装完成后仍然可以修改。

4. 修改虚拟机apt源，加快下载

　　打开终端，sudo su切到root，将/etc/apt/sources.list修改为：

 1 deb https://mirrors.ustc.edu.cn/ubuntu/ focal main restricted universe multiverse
 2 deb-src https://mirrors.ustc.edu.cn/ubuntu/ focal main restricted universe multiverse
 3 deb https://mirrors.ustc.edu.cn/ubuntu/ focal-updates main restricted universe multiverse
 4 deb-src https://mirrors.ustc.edu.cn/ubuntu/ focal-updates main restricted universe multiverse
 5 deb https://mirrors.ustc.edu.cn/ubuntu/ focal-backports main restricted universe multiverse
 6 deb-src https://mirrors.ustc.edu.cn/ubuntu/ focal-backports main restricted universe multiverse
 7 deb https://mirrors.ustc.edu.cn/ubuntu/ focal-security main restricted universe multiverse
 8 deb-src https://mirrors.ustc.edu.cn/ubuntu/ focal-security main restricted universe multiverse
 9 deb https://mirrors.ustc.edu.cn/ubuntu/ focal-proposed main restricted universe multiverse
10 deb-src https://mirrors.ustc.edu.cn/ubuntu/ focal-proposed main restricted universe multiverse

5. 更新软件

1 apt update
2 apt upgrade

二、虚拟机内安装ZeppOS模拟器

　　是的，终于开始安装模拟器了，首先依照官网说明下载所需文件：

相关依赖​

下载依赖安装脚本文件，并执行，等待相关依赖下载安装完成

模拟器安装​

下载ZeppOS模拟器安装包，并安装

下载了setup.sh和deb安装包两个文件之后，以root身份运行setup.sh

sudo sh setup.sh

然后用dpkg安装simulator的deb包（包名换成你下载的版本

sudo dpkg -i simulator_1.0.7_amd64.deb

安装完成后，系统会出现一个叫simulator的应用，即为我们安装的zeppos模拟器。可以将图标固定到左侧导航栏方便使用。至此模拟器安装完成。点击即可打开模拟器，效果如下：

三、宿主机安装vscode

 这一步请直接百度

四、宿主机安装zeos cli

1. 安装nodejs和npm

安装包可至官网下载。不难，搞不好请自行百度。

需要注意的是，nodejs版本得高于12（还是10来着，记不清了），所以尽量下载更新的nodejs安装包。

安装完成后，检查nodejs和npm版本：

node -v
npm -v

我的node和npm版本如下：

2. 使用npm安装zeus cli

在终端内输入：

npm i @zeppos/zeus-cli -g

如果速度太慢，可以尝试使用cnpm替代npm，具体方法自行百度。有时网络问题会导致安装出错，需要重复几次安装。

3. 使用cli创建项目

这里直接引用官方文档：

创建任务前，记得先将终端定位到想要创建项目的目录里。template那个选项选择helloworld，即可创建helloworld项目：

五、在vscode内结合cli编写代码并调试

 在刚刚新建的项目目录下打开vscode，并在vscode内新建终端：（下图中代码已非原始代码）

回到虚拟机内，打开终端，输入ifconfig，在如下位置找到虚拟机的ip，并复制：

在vscode终端输入：

zeus dev

启动调试，即可在虚拟机内的模拟器上运行自己创建的应用。初次启动时，会提示输入模拟器的ip，此时将刚刚在虚拟机里复制到的IP粘过来。

以后需要修改模拟器IP时，可使用如下命令：

//查看当前所有配置
zeus config list
//修改模拟器IP
zeus config set simulator_host=【刚刚复制的IP地址】

在模拟器中，按下键盘上home键解锁，进入应用列表，拖动到最下方即可见到自己的创建的应用：

至此，我们成功在Win10内用vscode连接到了Ubuntu虚拟机内的zeppos模拟器，并运行了自己创建的应用！

六、一些踩坑记录

1. 如果在虚拟机内因为一些意外情况关了模拟器再重启，可能7650端口仍然会被占用。此时，用 lsof -i:7650查看占用端口进程的pid，再用kill -9 【pid】即可解除占用，再重新打开simulator。
2. 在zeus dev运行起来后，一旦你的源文件有了改动，zeus就会自动构建、刷新模拟器。但在我的虚拟机中，如果源代码中出现错误，模拟器会闪退。此时即使在vscode里修正了错误并手动点击按钮打开模拟器，里面的应用很可能还是原来的，没刷新。这时只需要再稍动一下源代码，让zeus自己刷新就行。
3. 增加新页面后，记得在app.json内注册，否则无法跳转。
4. 如果增加了新的UI控件却没有显示，大概率是样式参数有错，需要细心检查
5. 虚拟机的内存得大一些，经测试，4G内存时模拟器比较卡顿，5G内存或以上时比较流畅