Mi-Create部署指南：从源码运行到Nuitka打包发布的完整流程

Mi-Create部署指南从源码运行到Nuitka打包发布的完整流程【免费下载链接】Mi-CreateUnofficial watchface creator for Xiaomi wearables ~2021 and above项目地址: https://gitcode.com/gh_mirrors/mi/Mi-CreateMi-Create是一款开源的小米穿戴设备表盘制作工具支持2021年前后发布的所有小米/红米手表手环让你像搭积木一样可视化设计、预览并编译表盘。本文是一份面向新手的完整部署指南带你走完「源码运行→ 界面验证 →Nuitka打包发布」全流程哪怕零基础也能顺利跑起来。1️⃣ 部署前准备了解平台支持情况在开始之前先确认你的系统是否在支持范围内。项目官方对三大平台的说明如下详见 README.md平台支持情况部署方式 Windows 10 (1809) / 11仅64位✅ 完整支持官方安装包 或 源码运行 Linux✅ 完整支持仅源码运行暂无官方二进制 macOS⚠️ 未测试理论可行无保证内置的设备数据库src/data/devices.json覆盖了 Xiaomi Watch Color、S1/S2/S3/S4、Redmi Watch 3 等数十款机型每款都标注了屏幕分辨率与圆角半径预览时会真实还原屏幕形状。2️⃣ 一键获取源码克隆仓库部署的第一步是拿到项目源码。打开终端执行以下命令克隆仓库git clone https://gitcode.com/gh_mirrors/mi/Mi-Create克隆完成后你会看到这样的目录结构核心部分src/main.py — 程序主入口src/data/ — 设备库、属性定义等运行数据src/compiler/ — 内置表盘编译器compile.exe/unpack.exe用于编译和解包.fprj表盘二进制requirements.txt — Python 依赖清单3️⃣ 源码运行Python 3.12 环境搭建步骤按照官方说明源码运行只需 4 步最快几分钟即可完成① 安装 Python 3.12 或更高版本项目不兼容旧版本。② 创建虚拟环境可选但强烈推荐避免污染系统 Pythonpython -m venv venv # Windows 激活 venv\Scripts\activate # Linux/macOS 激活 source venv/bin/activate③ 安装依赖。打开 requirements.txt 可以看到核心依赖包括PyQt6图形界面、pillow图像处理、lxml/xmltodictXML 解析等并按平台自动附加pywin32Windows或pyobjcmacOSpip install -r requirements.txt④ 运行主程序python src/main.py程序启动时会先显示一张简洁的启动画面Splash Screen随后进入欢迎页 小技巧src/main.py 支持命令行参数例如加--debug可开启调试菜单直接传入项目文件路径可启动即打开指定表盘工程。4️⃣ 验证运行成功第一次进入主界面如果一切顺利你会看到如图所示的主界面——左侧是资源面板管理表盘用的图片素材中间是画布实时预览表盘效果右侧上方是图层浏览器下方是属性面板调整位置、透明度等进入后第一次会弹出语言选择框项目内置中、英、西、俄、葡等 7 种语言翻译文件位于 src/locales/。之后就可以新建一个.fprj工程拖入图片、添加指针/数字时间等组件并实时预览运行效果。一个重要的部署细节源码运行与编译运行在日志行为上不同。程序通过检查 Nuitka 注入的__compiled__全局变量来区分两种模式见 src/main.py源码运行日志直接输出到控制台没有日志文件编译运行日志写入data/app.logWindows 下位于C:\Users\{用户名}\AppData\Local\Programs\Mi Create\data\app.log。遇到问题时记得附上日志这对排查故障非常有帮助。5️⃣ Nuitka打包发布从源码到安装包的流程项目 README 明确说明跨平台编译必须使用 Nuitka因为程序内部含有专门针对 Nuitka 的编译检测逻辑即上文提到的__compiled__检查同时 Nuitka 相比 PyInstaller 等方案还能带来额外的性能收益。参考打包命令在激活的虚拟环境中执行python -m nuitka --standalone --onefile --include-pluginpyqt6 --windows-icon-from-resourcesrc/resources/MiCreate.png src/main.py打包时需要注意两点数据文件必须随行程序依赖data/、locales/、themes/等目录最终分发包中要完整保留编译器是第三方闭源组件src/compiler/compile.exe 用于把工程编译成设备可运行的表盘二进制文件它不开源分发时请遵守其授权约定项目本身则采用 GPL-3 许可。打包产物在 Windows 10/11 上应能正常启动并自动启用日志文件模式——这正是验证「编译检测逻辑」生效的最直接方式。6️⃣ 常见问题快速排查症状解决方法启动闪退 / 报错先看控制台日志源码模式或data/app.log编译模式ModuleNotFoundError确认已激活虚拟环境并执行pip install -r requirements.txt想尝鲜新功能项目提供next分支包含未稳定完成的新特性仅供参考测试部署完成后欢迎页里点击「新建工程」选择你的小米设备型号一块专属表盘就此诞生。祝创作愉快⌚✨【免费下载链接】Mi-CreateUnofficial watchface creator for Xiaomi wearables ~2021 and above项目地址: https://gitcode.com/gh_mirrors/mi/Mi-Create创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考