ArkUI是一套構(gòu)建分布式應(yīng)用界面的聲明式UI開(kāi)發(fā)框架。它使用極簡(jiǎn)的UI信息語(yǔ)法、豐富的UI組件、以及實(shí)時(shí)界面預(yù)覽工具，幫助您提升移動(dòng)應(yīng)用界面開(kāi)發(fā)效率30%。您只需使用一套ArkTS API，就能在Android、iOS、鴻蒙多個(gè)平臺(tái)上提供生動(dòng)而流暢的用戶界面體驗(yàn)。

一、配套關(guān)系

表1 版本軟件和平臺(tái)配套關(guān)系

二、SDK獲取

表2 獲取SDK路徑列表

三、Samples

表3 Samples列表

四、開(kāi)發(fā)工具

ACE Tools是一套為ArkUI-X應(yīng)用開(kāi)發(fā)者提供的命令行工具，支持在Windows/Ubuntu/macOS平臺(tái)運(yùn)行，用于構(gòu)建OpenHarmony、HarmonyOS、Android和iOS平臺(tái)的應(yīng)用程序， 其功能包括開(kāi)發(fā)環(huán)境檢查，新建項(xiàng)目，編譯打包，安裝調(diào)試等。

五、環(huán)境準(zhǔn)備

前置條件： Ubuntu需要18.04以上版本，macOS需要11.6.2及以上版本，Windows需要Windows 10版本。

配置Node.js環(huán)境

運(yùn)行ACE Tools和OpenHarmony SDK需Node.js環(huán)境支持，建議下載14.19.1 - 16.19.1版本。可命令行運(yùn)行 node -v 查看本地Node.js版本，如不存在或版本不符合要求，請(qǐng)自行下載安裝穩(wěn)定版本：Node.js下載地址，并配置到環(huán)境變量。

配置Java環(huán)境

Android和OpenHarmony/HarmonyOS應(yīng)用打包需Java環(huán)境支持，建議下載JDK11.0.2以上版本，下載請(qǐng)點(diǎn)擊此處。推薦環(huán)境變量配置如下：

[macOS]

// 配置環(huán)境變量
export JAVA_HOME=/path-to-java-sdk
export PATH=$JAVA_HOME/bin:$PATH

[Windows]

// 配置環(huán)境變量  
set JAVA_HOME=/path-to-java-sdk  
set PATH=%PATH%;%JAVA_HOME%/bin

配置ohpm環(huán)境

OHPM CLI（OpenHarmony Package Manager Command-line Interface）是OpenHarmony應(yīng)用工程的三方庫(kù)的包管理工具，可通過(guò)DevEco Studio > File > Settings > Build, Execution, Deployment > Ohpm 查看ohpm home的安裝路徑，并配置到環(huán)境變量中。

配置ArkUI-X SDK環(huán)境

ArkUI-X SDK下載路徑，可通過(guò)DevEco Studio > File > Settings > ArkUI-X（macOS為DevEco Studio > Preferences > ArkUI-X）查看ArkUI-X的下載路徑，并配置到環(huán)境變量中。推薦環(huán)境變量配置如下：

[macOS]

// 配置環(huán)境變量  
export ARKUIX_SDK_HOME=/path-to-arkui-x-sdk

[Windows]

// 配置環(huán)境變量  
set ARKUIX_SDK_HOME=/path-to-arkui-x-sdk

六、命令安裝

安裝ace命令

修改npm源，前往用戶目錄，在.npmrc文件中添加如下內(nèi)容：

@ohos:registry=https://repo.harmonyos.com/npm/  
registry=https://repo.huaweicloud.com/repository/npm/

全局安裝ACE命令

cd arkui-x/toolchains/ace_tools    // 根據(jù)ArkUI-X SDK下載路徑，進(jìn)入ACE Tools實(shí)際所在目錄。  
npm install  
npm install . -g

七、開(kāi)發(fā)環(huán)境檢查

ace check

執(zhí)行 ace check 命令可以檢查ArkUI-X應(yīng)用本地開(kāi)發(fā)環(huán)境是否完備。

注：開(kāi)發(fā)環(huán)境檢查主要針對(duì)Android/iOS/OpenHarmony/HarmonyOS IDE以及對(duì)應(yīng)SDK的默認(rèn)安裝和下載路徑進(jìn)行檢查。如果提示結(jié)果與實(shí)際不符，請(qǐng)您通過(guò)ace config命令指定實(shí)際的IDE安裝和SDK下載路徑。

八、創(chuàng)建應(yīng)用

以創(chuàng)建一個(gè) Stage模型‘demo’項(xiàng)目為例：

ace create project  
? Please enter the project name: demo  
? Please enter the bundle name (com.example.demo):com.example.demo  
? Please enter the system (1: OpenHarmony, 2: HarmonyOS): 1  
? Please enter the project type (1: Application, 2: Library): 1  
? Please enter the template (1: Empty Ability, 2: Native C++): 1   //選擇創(chuàng)建Empty Ability或者Native C++項(xiàng)目

執(zhí)行 `ace create project` 命令，接著輸入工程名 demo。

九、應(yīng)用運(yùn)行

安裝運(yùn)行到Android設(shè)備

cd demo  
ace run apk

安裝運(yùn)行到iOS設(shè)備

cd demo  
ace run app

安裝運(yùn)行到OpenHarmony設(shè)備

cd demo  
ace run hap

上述命令會(huì)完成應(yīng)用構(gòu)建打包，并安裝到目標(biāo)平臺(tái)設(shè)備運(yùn)行。

審核編輯 黃宇