ArkUI是一套構建分布式應用界面的聲明式UI開發框架。它使用極簡的UI信息語法、豐富的UI組件、以及實時界面預覽工具，幫助您提升移動應用界面開發效率30%。您只需使用一套ArkTS API，就能在Android、iOS、鴻蒙多個平臺上提供生動而流暢的用戶界面體驗。

一、配套關系

表1 版本軟件和平臺配套關系

二、SDK獲取

表2 獲取SDK路徑列表

三、Samples

表3 Samples列表

四、開發工具

ACE Tools是一套為ArkUI-X應用開發者提供的命令行工具，支持在Windows/Ubuntu/macOS平臺運行，用于構建OpenHarmony、HarmonyOS、Android和iOS平臺的應用程序， 其功能包括開發環境檢查，新建項目，編譯打包，安裝調試等。

五、環境準備

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

配置Node.js環境

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

配置Java環境

Android和OpenHarmony/HarmonyOS應用打包需Java環境支持，建議下載JDK11.0.2以上版本，下載請點擊此處。推薦環境變量配置如下：

[macOS]

// 配置環境變量
export JAVA_HOME=/path-to-java-sdk
export PATH=$JAVA_HOME/bin:$PATH

[Windows]

// 配置環境變量  
set JAVA_HOME=/path-to-java-sdk  
set PATH=%PATH%;%JAVA_HOME%/bin

配置ohpm環境

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

配置ArkUI-X SDK環境

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

[macOS]

// 配置環境變量  
export ARKUIX_SDK_HOME=/path-to-arkui-x-sdk

[Windows]

// 配置環境變量  
set ARKUIX_SDK_HOME=/path-to-arkui-x-sdk

六、命令安裝

安裝ace命令

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

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

全局安裝ACE命令

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

七、開發環境檢查

ace check

執行 ace check 命令可以檢查ArkUI-X應用本地開發環境是否完備。

注：開發環境檢查主要針對Android/iOS/OpenHarmony/HarmonyOS IDE以及對應SDK的默認安裝和下載路徑進行檢查。如果提示結果與實際不符，請您通過ace config命令指定實際的IDE安裝和SDK下載路徑。

八、創建應用

以創建一個 Stage模型‘demo’項目為例：

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   //選擇創建Empty Ability或者Native C++項目

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

九、應用運行

安裝運行到Android設備

cd demo  
ace run apk

安裝運行到iOS設備

cd demo  
ace run app

安裝運行到OpenHarmony設備

cd demo  
ace run hap

上述命令會完成應用構建打包，并安裝到目標平臺設備運行。

審核編輯 黃宇