docs: 更新iOS/macOS开发者指南 - 新增workmanager/flutter_tts/speech_to_text/live_activities/flutter_vibrate替换说明, pro_image_editor迁移至远程版本, dependency_overrides添加timezone覆盖
This commit is contained in:
@@ -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 变更)
|
||||
|
||||
|
||||
Reference in New Issue
Block a user