Mi-Create小米表盘制作实战指南【免费下载链接】Mi-CreateUnofficial watchface creator for Xiaomi wearables ~2021 and above项目地址: https://gitcode.com/gh_mirrors/mi/Mi-Create在线编辑器导出的 .fprj 装不上手表wfDef.json 里又是一堆看不懂的 JSON 字段表盘编辑没有入口。Mi-Create 是面向 2021 年及以后小米穿戴设备的一款非官方表盘制作工具从绘制到导出二进制全部在它里面完成。克隆仓库并跑通第一个表盘先装环境git clone https://gitcode.com/gh_mirrors/mi/Mi-Create cd Mi-Create pip install -r requirements.txt依赖里是 PyQt6 图形框架、pillow、BeautifulSoup4、requests 等平台相关的包由 pip 自动选择Python 需要 3.12 以上。启动只有 1 条命令python src/main.py首次启动会弹语言选择框中文在列表里之后不用再管。接下来整条主线是一条线走完的欢迎页里新建项目选好目标设备型号、填项目名工程以 .fprj 文件夹落盘。型号列表来自src/data/devices.json覆盖 Color 系列、S 系列到 Redmi 系列每个型号写死了屏幕宽、高、圆角三个数值画布按这三个数绘制设备外框你不用自己画表盘轮廓。这张图告诉你工具覆盖的对象2021 年后的小米手表与手环每个型号的屏幕参数决定画布尺寸。项目打开后工作区分三块左侧资源列表、中间画布、右侧属性面板。点资源列表上方的按钮把背景图png/jpeg加入项目从列表拖到画布上再从菜单里创建数字、模拟指针、图片列表、弧线进度这几类元素。选中任意组件属性面板出现它的位置、尺寸和数据来源比如把数字组件绑定到时间源。图层树可以直接拖拽排序预览模式下指针会实时走动。这就是打开项目后的三栏工作状态资源在左、画布居中、参数在右预览里的指针正在实时转动。导出前有个卡点管理项目里必须填好表盘名称和缩略图否则编译器直接拒绝启动。填好后点 Build它调用src/compiler/下的第三方编译器产出与项目同名的 .face 文件放在项目同级的 output 目录里通过小米运动健康安装即可。反过来已有的 .face 也能用 Unpack 菜单反编译回工程二次编辑。找素材并管理工程文件左侧资源列表只读工程里的一个图片目录增删图片后列表自动刷新顶部有按文件名过滤的搜索框。src/data/default/内置一套起步素材3 根指针 png、10 个数字 png 和 1 张默认图新项目可以先拷过去用。src/locales/存放 7 国语言的 .po 文案src/themes/存放深、浅两套主题样式。设备外框、圆角和裁剪参数全部读自 devices.json换型号不需要改任何代码。排查最频繁的 4 类构建现象Linux 下 Build 报 Wine was not found。编译器是 Windows 程序compile.exeLinux 上靠 wine 执行。装好 wine 再编译。Build 被拦截提示先设置名称和缩略图。工程配置里这两项为空。去管理项目里补齐再按构建。程序异常却找不到 app.log。只有编译安装版才写日志文件从源码运行只输出到控制台。Windows 安装版日志在C:\Users\{用户名}\AppData\Local\Programs\Mi Create\data\app.log提交 bug 时带上它。打开中国区 GMF 工程wfDef.json后行为偶发不对。该格式标记为实验性建议转成 .fprj 编辑交付国内生态时再用src/utils/exporter.py里的 FprjConverter 转回 wfDef 格式。挑一条进阶路径写一个插件插件目录放src/plugins/下一个 config.ini 加一个入口脚本即可脚本必须实现 register() 函数。插件通过src/plugins/libs/plugin_api/里的 PluginAPI 拿到主窗口句柄调用对话框和工程接口tools/plugin-toolkit.py可以帮你搭骨架。补一份翻译src/locales/下每个语言目录有 3 个 .po 源文件编译产物在 LC_MESSAGES。新增语言照现有目录结构复制一份就能走通。跟进 next 分支新功能先落在 next 分支README 明确写了它不稳定。提交 PR 时小修进 main 分支独立的大功能进 next。注意随包的编译器是第三方闭源组件重新分发编译产物时要按项目要求用 Nuitka 打包。下一步动作确认 Python 3.12 以上克隆仓库并首次启动。【免费下载链接】Mi-CreateUnofficial watchface creator for Xiaomi wearables ~2021 and above项目地址: https://gitcode.com/gh_mirrors/mi/Mi-Create创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
