快速开始
环境准备
请确认Deft基础环境已经配置
然后需要安装DevEco Studio
,如果未安装,直接去官网下载安装即可。
另外,需要安装鸿蒙相关targets和deft-cli
工具包,执行以下代码可快速安装。
rustup target add aarch64-unknown-linux-ohosrustup target add x86_64-unknown-linux-ohoscargo install deft-cli
DevEcoStudio安装完成后,进入File
->Settings
->OpenHarmony SDK
,下载SDK,API版本选择14或者15,需要安装Native
和Toolchains
模块,其他模块可以不选。
SDK安装完成后,配置一下OHOS_SDK_HOME
和DEVECO_HOME
环境变量。
OHOS_SDK_HOME
为SDK安装路径(含版本号),DEVECO_HOME
为DevEcoStudio安装目录。
Windows参考示例:
set OHOS_SDK_HOME=C:\Users\dev\AppData\Local\OpenHarmony\Sdk\15set DEVECO_HOME=C:\Program Files\Huawei\DevEco Studio
MacOS参考示例:
export OHOS_SDK_HOME=/Users/dev/Library/OpenHarmony/Sdk/15export DEVECO_HOME=/Applications/DevEco-Studio.app/Contents
创建工程
执行下面命令,快速创建新工程,demo为新工程名称。
npm create deft@0.7 demo
根据自己的喜好选择语言和框架。
命令执行完后,会在当前目录下创建一个demo
项目,默认情况下,新建的工程是不包含鸿蒙工程文件的,执行下面命令,初始化鸿蒙工程。
cd demodeft init ohos
AppID随便填,格式正确即可,参考示例:com.example.myapp
。
然后执行以下代码启动项目:
npm installnpm run dev
启动成功后,会看到如下输出:
...webpack 5.91.0 compiled successfully in 1828 ms
----------------------------------------------------------Press r to run on this devicePress h to run on the connected HarmonyOS device(arm64)Press e to run on the connected HarmonyOS device(x86_64)Press q to quit----------------------------------------------------------
构建预览
预览前,确保鸿蒙设备已经连接到电脑并开启USB调试模式(如果是使用DevEcoStudio创建的模拟器,确保模拟器已经启动即可,不需要额外设置)
根据自己的鸿蒙设备架构(windows+模拟器一般是x86_64,真机或Mac+模拟器一般是arm64),按e
或h
即可开始构建预览应用。首次构建,需要下载依赖,所以耗时可能会比较长,可以配置cargo镜像提高下载速度。
构建成功后,会自动在已连接的鸿蒙设备内启动预览,可以直接修改ui目录下的JS/TS文件实时预览效果。
目录结构
├── ohos -- 鸿蒙工程相关文件├── build.rs -- Cargo构建脚本├── Cargo.toml -- Cargo项目配置文件├── package.json -- JS项目配置文件├── src -- Rust源代码│ └── main.rs├── tsconfig.json -- TypeScript配置文件├── ui -- JS/CSS源码│ ├── main.ts -- JS入口文件│ ├── App.vue│ └── deft-env.d.ts└── webpack.config.js -- Webpack配置文件
打包
执行下面命令构建release版so库
npm run build:ohos
构建完成后,使用DevEcoStudio
打开ohos
目录,和普通鸿蒙应用一样打包即可。