diff --git a/iOS_macOS_Developer_Guide.md b/iOS_macOS_Developer_Guide.md index 19a88a3f..8d3bd7f1 100644 --- a/iOS_macOS_Developer_Guide.md +++ b/iOS_macOS_Developer_Guide.md @@ -54,7 +54,7 @@ flutter build ios --no-codesign # 5. macOS 编译验证 flutter build macos -# 6. 防止误提交 pubspec.yaml +# 5. 防止误提交 pubspec.yaml git stash push -m "macOS-local-pubspec" pubspec.yaml ``` @@ -126,7 +126,7 @@ Error: The getter 'ohos' isn't defined for the class 'TargetPlatform' | image_picker | ^1.2.2 | 相机/相册选图 | | share_plus | ^13.1.0 | 系统分享面板 | | gal | ^2.3.0 | 保存图片/视频到相册 | -| pro_image_editor | 本地包(含魔改) | 图片编辑器核心(⚠️ 需本地包,见§2.5) | +| pro_image_editor | ^12.4.4 | 图片编辑器核心(⚠️ 见§2.5) | | flutter_quill | ^11.5.0 | Quill富文本编辑器 | | flex_color_picker | ^3.8.0 | HSL颜色选择器 | | flutter_image_compress | ^2.4.0 | 图片压缩 | @@ -147,6 +147,11 @@ Error: The getter 'ohos' isn't defined for the class 'TargetPlatform' | nearby_service | ^0.2.1 | 近场设备发现+通信 | | sqflite | ^2.4.1 | SQLite轻量数据库 | | receive_sharing_intent | ^1.8.1 | 接收外部分享内容 | +| workmanager | ^0.9.0 | 后台任务调度 | +| flutter_tts | ^4.2.0 | TTS文本转语音朗读 | +| speech_to_text | ^7.0.0 | 语音转文字 | +| live_activities | ^2.0.0 | 灵动岛/实时活动 | +| flutter_vibrate | ^1.3.0 | 跨平台触觉反馈 | #### 2.2.2 dependency_overrides 区域 — 整体替换 @@ -157,6 +162,7 @@ MacBook Pro 端不需要 `dependency_overrides` 中的本地包覆盖,改为 dependency_overrides: meta: ^1.17.0 web: ^1.1.0 + timezone: ^0.11.0 win32: ^6.0.1 # 删除所有 path: packages/xxx 条目 ``` @@ -210,19 +216,13 @@ extended_image ^10.0.1 | photo_view ^0.15.0 git clone <仓库URL> xianyan cd xianyan -# 2. 解压 pro_image_editor 本地包到 packages/ 目录 -# (从共享位置获取 pro_image_editor.zip) -unzip pro_image_editor.zip -d packages/ -# 确保 packages/pro_image_editor/ 目录存在且包含 pubspec.yaml - -# 3. 修改 pubspec.yaml(替换本地包为远程版本) +# 2. 修改 pubspec.yaml(替换本地包为远程版本) # 参见 §2.2 的替换清单 -# 注意:pro_image_editor 保持本地包引用(path: packages/pro_image_editor) -# 4. 获取依赖 +# 3. 获取依赖 flutter pub get -# 5. 编译验证 +# 4. 编译验证 flutter build ios --no-codesign flutter build macos @@ -234,19 +234,18 @@ echo "pubspec.yaml" >> .git/info/exclude ### 2.5 特殊包说明 -#### 2.5.1 pro_image_editor(含魔改,需本地包) +#### 2.5.1 pro_image_editor(已迁移至远程版本) -`pro_image_editor` 包含项目自定义的 `CanvasStyleModel` 类,远程版本不包含此类型。 -MacBook Pro 端必须使用本地包版本: +`pro_image_editor` 已从本地包迁移为远程版本 `^12.4.4`,MacBook Pro 端直接使用远程版本即可: ```yaml -# pubspec.yaml 中保持本地包引用 - pro_image_editor: - path: packages/pro_image_editor +# MacBook Pro 端使用远程版本 + pro_image_editor: ^12.4.4 ``` -需要将 `pro_image_editor.zip` 解压到 `packages/pro_image_editor/` 目录。 -该本地包不包含 `TargetPlatform.ohos` 引用,官方 SDK 编译正常。 +> **注意**:如果项目代码中使用了自定义的 `CanvasStyleModel` 类, +> 远程版本可能不包含此类型,需要检查兼容性。 +> 如遇编译错误,可恢复使用本地包版本(`path: packages/pro_image_editor`)。 #### 2.5.2 file_picker(API 变更)