OpenHarmony 环境搭建
OpenHarmony 端依赖支持 OHOS 的 Flutter 发行版、DevEco Studio / hvigor 和 OpenHarmony SDK。fplayer 的 OHOS 原生库由 ijkplayer 的 fplayercore HAR 提供。
当前推荐流程以 fplayer 仓库中的 OHOS 说明 为准;本页只保留环境搭建和构建入口。
1. 准备 Flutter OHOS
安装一个支持 OHOS 的 Flutter 发行版,并确认 flutter 能识别 ohos 平台:
flutter doctor
flutter devices
flutter doctor 中应出现 OpenHarmony toolchain 相关检查项。需要多版本隔离时可以使用 fvm,但不要混用普通 Flutter 与 OHOS Flutter 的缓存。
2. 准备 DevEco / hvigor
安装 DevEco Studio,并确保以下命令可用:
hvigorw --version
ohpm --version
设置 DevEco SDK 和工具链环境变量(路径按本机安装位置调整):
export DEVECO_SDK_HOME=/Applications/DevEco-Studio.app/Contents/sdk
export OHOS_BASE_SDK_HOME="$DEVECO_SDK_HOME/default"
export OHOS_SDK="$OHOS_BASE_SDK_HOME/<api-version>/native"
export PATH="/Applications/DevEco-Studio.app/Contents/tools/hvigor/bin:$PATH"
export PATH="/Applications/DevEco-Studio.app/Contents/tools/ohpm/bin:$PATH"
<api-version> 使用本机 DevEco SDK 的实际版本目录(当前为 26.0.0)。如果 native 位于 default/openharmony/native,请以 DevEco 的实际 SDK 目录为准,不要硬编码旧版本。
SDK 版本需与项目的 build-profile.json5 和 oh-package.json5 保持一致;不要继续使用旧版 custom_3.7.12_ohos 目录。
3. 放置 HAR
在 fplayer 插件的 ohos/har/ 中需要两个文件:
flutter.har:来自 Flutter OHOS SDK 的 engine artifactfplayercore-ohos.har:来自 ijkplayer 的官方 Release,或由tool/fetch_ijkplayer_packages.sh下载
ohos/oh-package.json5 通过本地 file: 路径引用它们:
{
"dependencies": {
"@ohos/flutter_ohos": "file:./har/flutter.har",
"@fplayer/fplayercore": "file:./har/fplayercore-ohos.har"
}
}
4. 构建
在应用工程的 OHOS 目录中执行 Flutter OHOS 构建:
flutter build hap
首次构建前确认:
flutter pub get已完成ohos/har/flutter.har和ohos/har/fplayercore-ohos.har均存在- DevEco SDK 版本与 hvigor 配置一致
- 真机安装需要配置签名
已知限制
- 系统音量写入在 OHOS 上不可用,相关接口会返回成功但不改变系统音量。
takeSnapShot()在 OHOS 上未实现。- OHOS 的完整能力矩阵和最新构建说明见 fplayer 仓库的
docs/ohos.md。
