程序员经验分享-hwhale

【小米手环7】使用 Zeus + 表盘自定义工具 为小米手环7开发和安装小程序

2023-05-16

有关 Zepp OS

Zepp OS 是华米开发的一个 RTOS，运行在手表、手环等设备上。
最新发布的小米手环7 / 7NFC 搭载的就是由华米研发的 Zepp OS。相比与之前小米手环搭载的 RTOS，Zepp OS 提供了更多的功能，同时支持 安装应用程序 。

为 Zepp OS 编写应用程序

为小米手环7编写程序，本质上就是为 Zepp OS 编写应用程序。
实际上，华米官方提供了 Zepp OS 应用程序的 开发文档 ，但是因为某些原因，在 搭载Zepp OS设备的列表 中，并没有看见小米手环7的身影，这将为后续的开发带来一些阻碍，但是作者会在下文给出解决办法。

配置开发环境

华米为 Zepp OS 开发的开发工具称为 Zeus ，可以在Zepp OS 的 Zeus CLI 文档 中找到并下载。

按照官方给定的操作下载并配置完成后，在终端输入 zeus 将输出这样的内容：

$ zeus
Usage: zeus <command> [args?]

Commands:
  main.js init                  Init a new project in current directory.
  main.js create <projectName>  Named the <projectName> project and add to the
                                current directory.
  main.js login                 Login to your account.
  main.js logout                Sign out of your account.
  main.js dev                   Run this project in development mode.
  main.js preview               Preview this project in your device.
  main.js build                 Build this project for production.
  main.js status                View information such as login and emulator
                                connection status.
  main.js bridge                Connect the online App or Simulator for
                                development and debugging.
  main.js config                Operation config value.
                                e.g.
                                set <key>=<value> [<key>=<value> ...]
                                get <key> [<key> ...]
                                delete <key> [<key> ...]
                                list [--json]

Base Options
  -h, --help     Display help information.                             [boolean]
  -v, --version  Display version number.                               [boolean]

For more information, see https://docs.zepp.com/

A command is required. Pass --help to see all available commands and options.

安装 VSCode 插件 （可选）

安装 VS Code 插件的好处在于可以方便地在编辑器内进行调试操作。VSC
VSC

安装模拟器

想要调试编写的小程序有两种办法，一种是直接安装在手表/手环上运行，另一种是在开发设备上运行 Zepp OS 模拟器进行调试，显然后者是更为方便的选择。
按照 官方文档 安装配置完成 simulator 之后，打开模拟器将出现如下界面：
simulator
第一次安装模拟器需要安装 Zepp OS 映像：
downloads
可以发现并没有找到小米手环7的设备名 Smart Band 7 ，看起来官方并没有打算让用户为小米手环7开发应用程序。这里我们可以选择 GTR 3 Pro v1.0.0 作为临时调试系统使用，等到构建项目的时候再使用小米手环7的构建配置。

编写并调试程序

配置完开发环境和模拟器之后，就可以着手开发程序了。由于篇幅有限，本文就不讲有关小程序设计的内容了，具体的开发文档可以查阅 Zepp OS 官方文档 ，本部分重点聊如何调试程序。

这里只讲作者自己的程序调试方式，还有很多便利的调试方式等大家探索。

进行调试之前，首先将模拟器打开，选择下载好的 Zepp OS 映像，单击 Simulator Zepp OS 仿真程序。
click
emulator

接下来是设置 Zeus 调试器：

Zeus 提供了一个类似 watchdog 的调试机制，当以

$ zeus dev

的方式运行 zeus 之后，将会进入到 zeus 的侦察调试模式（这名是作者自己取的）：

$ zeus dev

╭──────────────────────────────────────────────────────╮
│                                                      │
│               New version available!                 │
│   Changelog: https://api.huami.com/t/zeus-cli-doc    │
│   Run `npm install @zeppos/zeus-cli -g` to update!   │
│                                                      │
╰──────────────────────────────────────────────────────╯

? simulator host (127.0.0.1): (127.0.0.1)

这里将询问调试的 IP 地址，一般直接选择默认即可（按下回车键即可）。接下来 zeus 将检查项目目录，搜索是否有多个构建目标，若有，则会进行下面的提示，使用方向键选择构建目标，按下回车进行下一步操作，若只有一个构建目标，则不会进行下面的提示。
prompt
当完成选择之后，就可以进行侦察调试了。
debug
所谓侦察调试，就是 zeus 将监视整个开发目录，当项目内的文件发生改动，则会重新构建项目，并刷新仿真器，重新运行程序：
vsc
（在 vscode 中开启侦察调试模式）
btn
(开启/停停止侦察调试模式的按钮)

构建应用

zeus 使用如下命令进行应用程序：

zeus build

前面提到，zeus 将根据构建配置文件来构建应用程序 （虽然使用如 GTR 3 Pro 的配置文件构建出来的程序可以在小米手环上运行，但是会出现一些兼容性问题） ，而官方并未公布小米手环7相关的构建配置，因此我们需要自己寻找。

小米手环7 应用程序结构

为了铺垫下面的内容，这里简单插入讲一下小米手环7的应用程序结构。
首先，无论是表盘还是应用程序，在 Zepp OS 中都具有相似的结构。当我们拿到一个表盘或应用程序的文件的时候，可以发现其一般以 bin 作为后缀，实际上这是一个压缩文件，可以用类似 winrar, unzip 这样的工具解压。

例如，某个官方的表盘文件解压后得到如下的目录结构：

.
├── app.bin
├── app.js
├── app.json
├── assets
│   ├── 1.png
│   ├── 10.png
│   ├── 11.png
│   ├── 12.png
│   ├── 13.png
         (...)
│   ├── 88.png
│   ├── 89.png
│   ├── 9.png
│   └── 90.png
└── watchface
    └── smart-band-7
        ├── index.bin
        └── index.js

如下是某个小程序解压之后的目录结构：

│  app.bin
│  app.json
│
├─assets
│      icon.png
│
└─page
        detail.bin
        index.bin

其中 app.json 内包含了应用程序的配置文件，一般是这样的：

{
  "configVersion": "v2",
  "app": {
    "appId": 25394,
    "appName": "课程表",
    "appType": "app",
    "version": {
      "code": 1,
      "name": "1.0.1"
    },
    "icon": "icon.png",
    "vender": "Laomo",
    "description": "schedule for college students"
  },
  "permissions": [],
  "runtime": {
    "apiVersion": {
      "compatible": "1.0.0",
      "target": "1.0.1",
      "minVersion": "1.0.0"
    }
  },
  "targets": {
    "480x480-gtr-3-pro": {
      "module": {
        "page": {
          "pages": [
            "page/index",
          ]
        }
      },
      "platforms": [
        {
          "name": "gtr3-pro",
          "deviceSource": 229
        },
        {
          "name": "gtr3-pro-w",
          "deviceSource": 230
        }
      ],
      "designWidth": 480
    }
  },
  "i18n": {
    "zh_CN": {
      "appName": "课程表"
    }
  },
  "defaultLanguage": "zh_CN"
}

这个文件在执行 zeus create 的时候就被创建出来了，里面的大部分内容如 appName , description 都可以按需更改。而我们所要更改的构建配置文件则在 "targets" 中：

  "targets": {
    "480x480-gtr-3-pro": {
      "module": {
        "page": {
          "pages": [
            "page/index",
          ]
        }
      },
      "platforms": [
        {
          "name": "gtr3-pro",
          "deviceSource": 229
        },
        {
          "name": "gtr3-pro-w",
          "deviceSource": 230
        }
      ],
      "designWidth": 480
    }
  },

我们需要在这里填入小米手环7的 target 配置。在对官方表盘的解包中，我们得到了这样的配置：

    "platforms": [
        {
            "name": "smart-band-7",
            "deviceSource": 260
        },
        {
            "name": "smart-band-7",
            "deviceSource": 261
        },
        {
            "name": "smart-band-7",
            "deviceSource": 262
        },
        {
            "name": "smart-band-7",
            "deviceSource": 263
        },
        {
            "name": "smart-band-7",
            "deviceSource": 264
        },
        {
            "name": "smart-band-7",
            "deviceSource": 265
        },
        {
            "name": "smart-band-7",
            "deviceSource": 266
        }
    ],

这段配置文件是来自构建后的bin文件的，构建过程中，zeus 对 app.json 文件进行了修改，因此若需要将这段配置应用到我们的 app.json ，需要进行更改，更改后得到下面的内容：

    "smart-band-7": {
      "module": {
        "page": {
          "pages": [
            "page/index",
          ]
        }
      },
      "platforms": [
        {
            "name": "smart-band-7",
            "deviceSource": 260
        },
        {
            "name": "smart-band-7",
            "deviceSource": 261
        },
        {
            "name": "smart-band-7",
            "deviceSource": 262
        },
        {
            "name": "smart-band-7",
            "deviceSource": 263
        },
        {
            "name": "smart-band-7",
            "deviceSource": 264
        },
        {
            "name": "smart-band-7",
            "deviceSource": 265
        },
        {
            "name": "smart-band-7",
            "deviceSource": 266
        }
      ],
      "designWidth": 192
    }

将这段配置文件加入到 app.json 中，得到下面的文件：

{
  "configVersion": "v2",
  "app": {
    "appId": 25394,
    "appName": "课程表",
    "appType": "app",
    "version": {
      "code": 1,
      "name": "1.0.1"
    },
    "icon": "icon.png",
    "vender": "Laomo",
    "description": "schedule for college students"
  },
  "permissions": [],
  "runtime": {
    "apiVersion": {
      "compatible": "1.0.0",
      "target": "1.0.1",
      "minVersion": "1.0.0"
    }
  },
  "targets": {
    "480x480-gtr-3-pro": {
      "module": {
        "page": {
          "pages": [
            "page/index",
          ]
        }
      },
      "platforms": [
        {
          "name": "gtr3-pro",
          "deviceSource": 229
        },
        {
          "name": "gtr3-pro-w",
          "deviceSource": 230
        }
      ],
      "designWidth": 480
    },
    "smart-band-7": {
      "module": {
        "page": {
          "pages": [
            "page/index",
          ]
        }
      },
      "platforms": [
        {
            "name": "smart-band-7",
            "deviceSource": 260
        },
        {
            "name": "smart-band-7",
            "deviceSource": 261
        },
        {
            "name": "smart-band-7",
            "deviceSource": 262
        },
        {
            "name": "smart-band-7",
            "deviceSource": 263
        },
        {
            "name": "smart-band-7",
            "deviceSource": 264
        },
        {
            "name": "smart-band-7",
            "deviceSource": 265
        },
        {
            "name": "smart-band-7",
            "deviceSource": 266
        }
      ],
      "designWidth": 192
    }
  },
  "i18n": {
    "zh_CN": {
      "appName": "课程表"
    }
  },
  "defaultLanguage": "zh_CN"
}

至此，我们在进行 zeus build 的时候，选择 smart-band-7 就可以构建了。

但是！ 这样构建会出现图标丢失的问题，原因在于我们选择了smart-band-7 这个 target，而我们的 assets/ 文件夹中并不存在属于 smart-band-7 的文件夹，只需要在 assets 文件夹中添加 smart-band-7 文件夹，并将制作好的 icon.png 放入此文件夹中即可。

安装小程序

得到小程序文件

经过 zeus build 构建出来的文件存放在 dist/ 文件夹中，其中的 .zab 文件是 Zepp OS 应用程序的发布包，这个包包含了除主程序之外的其他内容，如小米手环7不支持的伴生服务。为了得到我们需要的应用程序文件，我们需要对此 .zab 进行解压，可以发现有 manifest.json 文件和一个 zpk 后缀的文件：
unzip
进一步解压 zpk 文件，得到下面两个文件：
unzip2
其中的 device.zip 就是我们需要的文件了。我们可以将其后缀改成 bin ，也可以不改（改的话可能更有逼格点吧）。

安装小程序

在得到我们的 device.zip 之后，就可以进行安装了。我们使用来自 米坛社区 的 表盘自定义工具 进行应用程序安装。
wftool
请添加图片描述
可以通过蓝牙安装和替换表盘安装，以上两种安装方式在应用内部已经写清楚，这里就不多阐述了，

总结

以上就是小米手环7应用程序开发和安装的过程了。相信在小米手环使用了 Zepp OS 之后，会有越来越多有趣的应用程序出现，让小米手环的功能愈发强大。

本文内容由网友自发贡献，版权归原作者所有，本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容，请联系:hwhale#tublm.com(使用前将#替换为@)

【小米手环7】使用 Zeus + 表盘自定义工具 为小米手环7开发和安装小程序 的相关文章

  • KPI自动化异常检测系统——Opprentice

    论文 xff1a Opprentice Towards Practical and Automatic Anomaly Detection Through Machine Learning 文章目录 问题设计思想算法细节 问题 KPI类型很

  • 特征提取和深度学习的KPI异常检测方法—组合模型

    文章目录 简介挑战总体设计数据预处理特征提取数据均衡模型训练模型综合 方案来自于首届AIops挑战赛亚军团队 简介 问题场景就是运维中kpi异常检测 xff0c 希望可以提高检测的准确率 该团队的思路是提取特征然后用集成学习的方法将异常检测

  • docker 安装、升级

    docker 安装 升级 服务器版本 Centos 7 9 1 有外网情况下 docker 升级 镜像下载地址 xff1a https download docker com linux centos 7 x86 64 stable Pac

  • stty 命令说明及使用讲解

    UNIX系统的命令很多 xff0c 但是巧妙使用命令的方法更多 随着经验的积累和观察学习其他用户的实践 xff0c 我们也可学会解决特殊问题的方法 这里谈谈自己使用UNIX系统中stty命令的一些体会 xff0c 希望能与你共享 1 xff

  • Opencv3.4.1+contrib3.4.1+vs2017配置（主要解决了编译的时候找不到.lib文件的问题）

    一般出现找不到 lib库文件都是环境变量配置没弄好或者是依赖项或包含库没设置好 xff0c 下面是我的步骤 xff0c 大家可以参考以下 xff08 大家一定要注意环境变量哪里的bin别弄成lib xff0c 2天不断重装的血泪教训 xff

  • PX4概念

    本文针对多选翼飞行器 MANUAL ACRO 飞行器的输入作用于roll pitch和yaw的速率 油门直接作用于输出 RATTITUDE 如果飞行器的输入大于该模式下的阈值 xff0c 那么飞行器的输入将作用于roll pitch和yaw

  • 一道js编程题：用js实现栈的出栈，入栈等操作

    这是4月份某公司前端实习笔试的一道编程题 xff0c 要求是实现 xff1a 入栈 xff1a NumberStack push num 出栈 xff1a NumberStack pop 找出栈中第n大的数 xff1a NumberStac

  • MPU6050误差分析

    MPU6050模块 xff0c 如图 1所示 该模块集成了一片MPU6050芯片和一片STM8S003F3P6单片机 xff0c 具有串口和I2C接口 MPU6050中的DMP xff08 数字运动处理器 xff09 对姿态进行融合 xff

  • 为什么面试要问底层原理自我看法

    每次面试时别人都会问一些底层问题 但如果面试上后 xff0c 去公司写的还是业务代码 为什么要这样呢 xff0c 我面试过很多公司 xff0c 但是很少有面试官知道为什么要去问底层 只是他们知道别人都在问 xff0c 那我也要问 xff0c

  • 有意思的字符串查找函数strchr,strrchr,strstr,strrstr

    通过一段时间对字符串的了解 xff0c 我发现了许多有意思的字符串函数 xff0c 下面我们就以常见的字符串查找函数 strchr strrchr strstr strrstr为例来模拟实现这些有意思的字符串查找函数吧 xff01 strc

  • Gazebo相关内容学习

    什么是Gazebo和ros 以及二者的关系 xff1f Gazebo是一个不错的仿真工具 xff0c 它使用物理引擎模拟真实的世界 xff0c 使得我们可以通过仿真的方式从原理上验证算法 xff0c 计算负载和受力情况 xff0c 进而指引

  • SLAM_ROS算法包运行---gazebo仿真和实际场景

    SLAM学习交流可加群 xff1a 248085206 1 rtabmap算法简介 rtabmap全名是Real Time Appearance Based Mapping 是一个基于RGB D Stereo和雷达的Graph Based

  • 【Ubuntu】aptitude命令详解

    aptitude aptitude 与 apt get 一样 xff0c 是 Debian 及其衍生系统中功能极其强大的包管理工具基于大名鼎鼎的APT机制 整合了 dselect 和 apt get 的所有功能 并提供的更多特性 特别是在依

  • PCIE2.0/PCIE3.0/PCIE4.0/PCIE5.0接口的带宽、速率计算

    一 PCIE接口速率 xff1a 二 PCIE相关概念 xff1a 传输速率为每秒传输量GT s xff0c 而不是每秒位数Gbps xff0c 因为传输量包括不提供额外吞吐量的开销位 xff1b 比如 PCIe 1 x和PCIe 2 x使

  • git子模块使用-添加，更新，删除

    git子模块使用 添加 xff0c 更新 xff0c 删除 前言添加子模块初始化子模块更新子模块删除子模块更新子模块 前言 刚刚入职新公司 xff0c 老大说我们公司用git子模块 xff0c 说让我研究一下这个 xff0c 当时我就蒙蔽了

  • ARM和STM32的区别

    STM32与通常ARM的区别 经常有人问到 STM32和ARM以及ARM7是什么关系这样的问题 xff0c 其实ARM是一个做芯片标准的公司 xff0c 它负责的是芯片内核的架构设计 xff0c 而 TI xff0c ST这样的公司 xff

  • 动态目标检测与跟踪

    目标跟踪学习1 文章目录 目标跟踪学习1前言一 安装软件1 Visual Studio2019安装2 opencv的安装 二 使用步骤1 项目配置2 配置HCNetSDKV和ffmpeg以及videoinput2 程序运行 总结 前言 随着

  • FreeROTS了解（三）

    1 中断 xff08 1 xff09 先优先级分组 3位作为抢占优先级 xff0c 1位作为子优先级 0 7是抢占优先级的数值 xff0c 0 1是子优先级的数值 NVIC SetPriorityGrouping 4 xff08 2 xff

  • 论文仿真心得

    最近在做论文仿真 xff0c 有点让人头疼 xff0c 感觉要实现一篇论文的算法不是那么容易 根据近期的经验 xff0c 总结如下 xff1a 1 首先上网搜搜 有没有已经实现的代码 xff0c 能够搜到则会让你轻松很多 xff1b 2 在

  • zed双目摄像头使用--sdk的安装

    刚开始安装的时候 xff0c 需要cuda xff0c 这个看你选择了哪一个版本的sdk xff0c 可以在官网上下载 因为在windows上试了一下 xff0c 我使用了优盘上cuda7 5的版本的 xff0c 结果安装上 xff0c 没

随机推荐

热门标签