diff --git a/.DS_Store b/.DS_Store index ff21cdc..65b4526 100644 Binary files a/.DS_Store and b/.DS_Store differ diff --git a/.~OBOT开发版G型--用户手册.docx b/.~OBOT开发版G型--用户手册.docx new file mode 100644 index 0000000..23dc7f5 Binary files /dev/null and b/.~OBOT开发版G型--用户手册.docx differ diff --git a/BUILD_GUIDE.md b/BUILD_GUIDE.md deleted file mode 100644 index 7e1bcfb..0000000 --- a/BUILD_GUIDE.md +++ /dev/null @@ -1,131 +0,0 @@ -# MRobot 打包说明 - -## 问题原因 - -之前使用 `--onefile` 模式和 `--add-data` 添加 assets 导致的问题： -1. `--onefile` 将所有文件打包进 exe，运行时解压到临时目录 `sys._MEIPASS` -2. 更新代码时下载到 `exe目录/assets` -3. 但读取时从 `sys._MEIPASS/assets` 读取（每次都是打包时的原始文件） -4. 结果：更新成功但读不到新文件 - -## 解决方案：使用 `--onedir` 模式 - -### 方法一：使用提供的脚本（推荐） - -**macOS/Linux:** -```bash -./build.sh -``` - -**Windows:** -```cmd -build.bat -``` - -### 方法二：手动执行命令 - -```bash -# 清理旧文件 -rm -rf build dist *.spec - -# 打包（不要添加 --add-data） -pyinstaller MRobot.py \ - --onedir \ - --windowed \ - --icon=assets/logo/M.ico \ - --name=MRobot \ - --clean -``` - -### 创建安装程序 - -打包完成后，使用 Inno Setup 编译 `MRobot.iss` 创建安装程序。 - -## 打包模式对比 - -### `--onedir` 模式（推荐）✅ -- **优点：** - - assets 文件夹在 exe 同级目录，可以被更新覆盖 - - 更新代码库后能正确读取新文件 - - 文件结构清晰，便于调试 -- **缺点：** - - 需要分发整个文件夹（但可以用 Inno Setup 打包成单个安装程序） - -### `--onefile` 模式（不推荐）❌ -- **优点：** - - 单个 exe 文件 -- **缺点：** - - 外部资源文件无法更新（因为每次都从 exe 内部解压） - - 启动较慢（需要解压） - - 不适合需要更新资源的应用 - -## 文件结构 - -### 打包后（onedir 模式） -``` -dist/MRobot/ -├── MRobot.exe # 主程序 -├── _internal/ # PyInstaller 依赖库 -└── assets/ # 由 Inno Setup 安装时复制 - ├── logo/ - ├── User_code/ - └── mech_lib/ -``` - -### 安装后 -``` -%APPDATA%\MRobot\ # 或 {userappdata}\MRobot -├── MRobot.exe -├── _internal/ -└── assets/ # 可以被更新覆盖 - ├── logo/ - ├── User_code/ # 👈 更新代码库会更新这里 - └── mech_lib/ -``` - -## 工作原理 - -1. **首次运行：** - - 代码检测到 `exe目录/assets` 不存在 - - 从 `sys._MEIPASS/assets` 复制初始资源（如果存在） - - 但在 onedir 模式下，Inno Setup 已经安装了 assets，所以直接使用 - -2. **更新代码库：** - - 下载最新代码到 `exe目录/assets/User_code` - - 清除缓存 - - 重新读取 `exe目录/assets/User_code`（能看到新模块如 oid） - -3. **重新打开软件：** - - 直接读取 `exe目录/assets`（包含更新后的文件） - -## 注意事项 - -1. **不要使用 `--add-data "assets;assets"`** - - 这会将 assets 打包进 exe，导致无法更新 - -2. **Inno Setup 负责安装 assets** - - ISS 文件会将 assets 复制到安装目录 - - 这样 assets 就在 exe 同级目录，可以被更新 - -3. **代码已经优化** - - `CodeGenerator.get_assets_dir()` 优先使用 `exe目录/assets` - - 更新和读取使用相同路径 - - 首次运行时自动初始化（如果需要） - -## 测试步骤 - -1. 运行 `build.bat` 或 `build.sh` 打包 -2. 使用 Inno Setup 编译 `MRobot.iss` 创建安装程序 -3. 安装并运行 MRobot -4. 点击"选择项目路径"，选择一个 CubeMX 项目 -5. 点击"更新代码库" -6. 检查是否能看到新的模块（如 oid） -7. 关闭软件，重新打开 -8. 再次进入项目，确认新模块仍然存在 - -## 版本更新 - -修改 `MRobot.iss` 中的版本号： -```ini -AppVersion=1.0.9 ; 更新这里 -``` diff --git a/MROBOT.docx b/MROBOT.docx new file mode 100644 index 0000000..7cb8dc2 Binary files /dev/null and b/MROBOT.docx differ diff --git a/MROBOT开发版G型--用户手册.docx b/MROBOT开发版G型--用户手册.docx new file mode 100644 index 0000000..d93fd1c Binary files /dev/null and b/MROBOT开发版G型--用户手册.docx differ diff --git a/MROBOT开发版G型--用户手册.pdf b/MROBOT开发版G型--用户手册.pdf new file mode 100644 index 0000000..70a93e9 Binary files /dev/null and b/MROBOT开发版G型--用户手册.pdf differ diff --git a/assets/.DS_Store b/assets/.DS_Store index 78d0e24..8c7d3d4 100644 Binary files a/assets/.DS_Store and b/assets/.DS_Store differ diff --git a/build.bat b/build.bat deleted file mode 100644 index 06d987c..0000000 --- a/build.bat +++ /dev/null @@ -1,51 +0,0 @@ -@echo off -chcp 65001 > nul -echo ========================================== -echo MRobot 打包脚本 -echo ========================================== -echo. - -REM 清理旧的构建文件 -echo 1. 清理旧的构建文件... -if exist build rmdir /s /q build -if exist dist rmdir /s /q dist -if exist MRobot.spec del /f /q MRobot.spec - -REM 使用 PyInstaller 打包（onedir 模式） -echo. -echo 2. 使用 PyInstaller 打包... -pyinstaller MRobot.py --onedir --windowed --icon=assets\logo\M.ico --name=MRobot --clean - -if %errorlevel% neq 0 ( - echo. - echo ❌ PyInstaller 打包失败！ - pause - exit /b 1 -) - -echo. -echo 3. 检查打包结果... -if not exist "dist\MRobot" ( - echo ❌ 未找到 dist\MRobot 目录！ - pause - exit /b 1 -) - -if not exist "dist\MRobot\MRobot.exe" ( - echo ❌ 未找到 MRobot.exe！ - pause - exit /b 1 -) - -echo. -echo ✅ PyInstaller 打包完成！ -echo. -echo 4. 下一步： -echo - 如果要创建安装程序，请运行 Inno Setup 编译 MRobot.iss -echo - 或者直接使用 dist\MRobot 文件夹中的程序 -echo. -echo ========================================== -echo 打包完成 -echo ========================================== -echo. -pause diff --git a/build.sh b/build.sh deleted file mode 100755 index 3b59ed0..0000000 --- a/build.sh +++ /dev/null @@ -1,52 +0,0 @@ -#!/bin/bash - -# MRobot 打包脚本 -# 使用方法: chmod +x build.sh && ./build.sh - -echo "==========================================" -echo " MRobot 打包脚本" -echo "==========================================" -echo "" - -# 清理旧的构建文件 -echo "1. 清理旧的构建文件..." -rm -rf build dist *.spec - -# 使用 PyInstaller 打包（onedir 模式） -echo "" -echo "2. 使用 PyInstaller 打包..." -pyinstaller MRobot.py \ - --onedir \ - --windowed \ - --icon=assets/logo/M.ico \ - --name=MRobot \ - --clean - -if [ $? -ne 0 ]; then - echo "" - echo "❌ PyInstaller 打包失败！" - exit 1 -fi - -echo "" -echo "3. 检查打包结果..." -if [ ! -d "dist/MRobot" ]; then - echo "❌ 未找到 dist/MRobot 目录！" - exit 1 -fi - -if [ ! -f "dist/MRobot/MRobot.exe" ]; then - echo "❌ 未找到 MRobot.exe！" - exit 1 -fi - -echo "" -echo "✅ PyInstaller 打包完成！" -echo "" -echo "4. 下一步：" -echo " - 如果要创建安装程序，请运行 Inno Setup 编译 MRobot.iss" -echo " - 或者直接使用 dist/MRobot 文件夹中的程序" -echo "" -echo "==========================================" -echo " 打包完成" -echo "==========================================" diff --git a/手册.pages b/手册.pages new file mode 100644 index 0000000..48ec89a Binary files /dev/null and b/手册.pages differ