docs: 更新iOS/macOS开发者指南 - 新增workmanager/flutter_tts/speech_to_text/live_activities/flutter_vibrate替换说明, pro_image_editor迁移至远程版本, dependency_overrides添加timezone覆盖

This commit is contained in:
Developer
2026-06-01 08:33:27 +08:00
parent 287190a012
commit d39792d5cb

View File

@@ -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_pickerAPI 变更)