配置环境变量
- 配置HarmonyOS SDK和环境变量
- API12, deveco-studio-5.0 或 command-line-tools-5.0
- 配置 Java17
- 配置环境变量 (SDK, node, ohpm, hvigor)
export TOOL_HOME=/Applications/DevEco-Studio.app/Contents # mac环境
export DEVECO_SDK_HOME=$TOOL_HOME/sdk # command-line-tools/sdk
export PATH=$TOOL_HOME/tools/ohpm/bin:$PATH # command-line-tools/ohpm/bin
export PATH=$TOOL_HOME/tools/hvigor/bin:$PATH # command-line-tools/hvigor/bin
export PATH=$TOOL_HOME/tools/node/bin:$PATH # command-line-tools/tool/node/bin
- 通过代码工具下载Flutter仓库代码
git clone https://gitee.com/harmonycommando_flutter/flutter.git
,指定dev或master分支,并配置环境
# 依赖缓存
export PUB_CACHE=D:/PUB
# 拉取下来的flutter_flutter/bin目录
export PATH=<flutter_flutter path>/bin:$PATH
# 国内镜像
export PUB_HOSTED_URL=https://pub.flutter-io.cn
export FLUTTER_STORAGE_BASE_URL=https://storage.flutter-io.cn
# HamonyOS SDK
export TOOL_HOME=/Applications/DevEco-Studio.app/Contents # mac环境
export DEVECO_SDK_HOME=$TOOL_HOME/sdk # command-line-tools/sdk
export PATH=$TOOL_HOME/tools/ohpm/bin:$PATH # command-line-tools/ohpm/bin
export PATH=$TOOL_HOME/tools/hvigor/bin:$PATH # command-line-tools/hvigor/bin
export PATH=$TOOL_HOME/tools/node/bin:$PATH # command-line-tools/tool/node/bin
构建步骤
- 运行 flutter doctor -v 检查环境变量配置是否正确,Futter与OpenHarmony应都为ok标识,若两处提示缺少环境,按提示补上相应环境即可。
创建工程与编译命令,编译产物在
<projectName>/ohos/entry/build/default/outputs/default/entry-default-signed.hap
下。# 创建工程 flutter create --platforms ohos <projectName> # 进入工程根目录编译 # 示例:flutter build hap --release flutter build hap --release
- 通过flutter devices指令发现ohos设备之后,使用 hdc -t <deviceId> install <hap file path>进行安装。
也可直接使用下列指令运行:
# 示例:flutter run -d <device-id> flutter run --debug -d <device-id>
构建app包命令:
# 示例:flutter build app --release flutter build app --release
## 已兼容OpenHarmony开发的指令列表
|指令名称| 指令描述| 使用说明|
|:--|:--|:--|
|doctor|环境检测|flutter doctor|
|config|环境配置|flutter config --"key" "value"|
|create|创建新项目|flutter create --platforms ohos,android,ios --org "org" "appName"|
|create|创建module模板|flutter create -t module "moduleName"|
|create|创建plugin模板|flutter create -t plugin --platforms ohos,android,ios "pluginName"|
|create|创建plugin_ffi模板|flutter create -t plugin_ffi --platforms ohos,android,ios "pluginName"|
|devices|已连接设备查找|flutter devices|
|install|应用安装|flutter install -t "deviceId" "hap文件路径"|
|assemble|资源打包|flutter assemble|
|build|测试应用构建|flutter build hap --debug|
|build|正式应用构建|flutter build hap --release|
|run|应用运行|flutter run|
|attach|调试模式|flutter attach|
|screenshot|截屏|flutter screenshot|
运行到手机上
在项目根目录下执行flutter run
就可以运行到手机上了,若连接的是Android手机,则可以直接运行并在手机上查看效果。若连接的是鸿蒙NEXT手机,则需先配置证书,配置证书的地方在ohos/build-profile.json5
文件中,证书配置完成后,就直接直接运行并在鸿蒙NEXT手机上查看效果了。
鸿蒙平台ohos下的flutter.har包可以拷贝到其它项目中直接使用。
**粗体** _斜体_ [链接](http://example.com) `代码` - 列表 > 引用
。你还可以使用@
来通知其他用户。