zepp-os-fundamentals
Installation
SKILL.md
Zepp OS Fundamentals
Context: all four runtimes (this skill defines them) API_LEVEL: 2.0+ (the API_LEVEL system itself is a 2.0 concept)
Overview
A Zepp OS project is one package containing up to four separate programs, wired together in app.json. Each runs in a different place with a different API surface — mixing them up is the #1 source of errors. The API is versioned by API_LEVEL (not OS version): you target a minimum API_LEVEL and the system guarantees newer firmware stays backward-compatible.
The four runtime contexts
| Context | Runs on | app.json module key |
Entry | API surface |
|---|---|---|---|---|
| Device App (Mini Program) | the watch | page |
page/**/index.page.js |
@zos/* |
| Watchface | the watch | watchface |
watchface entry | @zos/* (+ legacy hmUI/hmSensor) |
| Side Service (companion) | the phone (Zepp app, background JS) | app-side |
app-side/index.js |
messaging / fetch / transfer (no @zos/ui) |
| Settings App | the phone (Zepp app, settings UI) | setting |
setting/index.js |
Settings UI components + settings-storage |
Plus optional modules: app-service (Background Service, configVersion v3), app-widget/secondary-widget (shortcut cards and secondary widgets), app-event (System Event Listening, configVersion v3).