ArkUI-X之初體驗(yàn)

開發(fā)跨平臺(tái)應(yīng)用

創(chuàng)建工程

在DevEco Studio中導(dǎo)入ArkUI-X Sample，快速創(chuàng)建跨平臺(tái)工程。

1. 點(diǎn)擊File > New > Import > Import Sample。
2. 在左上方的下拉框中選擇OpenHarmony，選擇ArkUI-X/HelloWorld，點(diǎn)擊 Next 。
3. 在工程配置頁面，填寫Project name和Project location，點(diǎn)擊 Finish ，等待Sample工程導(dǎo)入完成。

編譯構(gòu)建生成跨平臺(tái)應(yīng)用

DevEco Studio可打包生成不同平臺(tái)的應(yīng)用包。

在主菜單欄，單擊Build > Build Hap(s)/APP(s) > Build APP(s) 。

編譯后的ArkTS代碼、資源和平臺(tái)膠水代碼已生成到Android和iOS應(yīng)用工程中，后續(xù)安裝、運(yùn)行和調(diào)試請(qǐng)使用Android Studio和Xcode，也可使用[ACE Tools]。

ACE Tools快速指南

開發(fā)前請(qǐng)熟悉鴻蒙開發(fā)指導(dǎo)文檔：[gitee.com/li-shizhen-skin/harmony-os/blob/master/README.md]

簡(jiǎn)介

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

使用說明

針對(duì)Windows和macOS的平臺(tái)環(huán)境，使用ACE Tools前，建議優(yōu)先下載DevEco Studio，完成DevEco Studio的下載和安裝。

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

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

1. 配置ohpm環(huán)境

OHPM CLI作為鴻蒙生態(tài)三方庫(kù)的包管理工具，支持OpenHarmony共享包的發(fā)布、安裝和依賴管理?？赏ㄟ^DevEco Studio > File > Settings > Build, Execution, Deployment > Ohpm 查看ohpm home的安裝路徑，并配置到環(huán)境變量中（macOS為DevEco Studio > Preferences > Build, Execution, Deployment > Ohpm）。

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

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

[macOS]

// 配置環(huán)境變量
export ARKUIX_SDK_HOME=/path-to-arkui-x-sdk
export PATH=${ARKUIX_SDK_HOME}/10/arkui-x/toolchains/bin:$PATH

[Windows]

可在桌面工具欄搜索框鍵入"環(huán)境變量"，然后選擇 編輯系統(tǒng)環(huán)境變量 ，進(jìn)行環(huán)境變量配置。另外，也可在控制臺(tái)通過如下命令進(jìn)行配置。

// 配置環(huán)境變量
set ARKUIX_SDK_HOME=/path-to-arkui-x-sdk
set PATH=%PATH%;%ARKUIX_SDK_HOME%/10/arkui-x/toolchains/bin

說明 ：配置環(huán)境變量時(shí)，由于ARKUIX_SDK_HOME是ACE Tools要求的固定變量名，不允許自定義。

開發(fā)環(huán)境檢查

ace check

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

說明 ：開發(fā)環(huán)境檢查只識(shí)別IDE和SDK默認(rèn)的安裝路徑，如果提示結(jié)果與實(shí)際不符，請(qǐng)您通過[ace config命令]指定實(shí)際的IDE安裝和SDK下載路徑。

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

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

ohos@user Desktop % ace create demo
? Enter the project name(demo): # 輸入工程名稱，不輸入默認(rèn)為文件夾名稱
? Enter the bundleName (com.example.demo):  # 輸入包名，不輸入默認(rèn)為com.example.工程名
? Enter the runtimeOS (1: OpenHarmony, 2: HarmonyOS): 1 # 輸入RuntimeOS系統(tǒng)

Project created. Target directory:  ${當(dāng)前目錄}/demo.

In order to run your app, type:

   $ cd demo
   $ ace run

Your app code is in demo/entry.

`HarmonyOS與OpenHarmony鴻蒙文檔籽料：mau123789是v直接拿`

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

• 安裝運(yùn)行到Android/iOS/OpenHarmony設(shè)備（注：iOS設(shè)備執(zhí)行ace run前請(qǐng)先打開Xcode完成應(yīng)用簽名）

cd demo
ace run

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

審核編輯 黃宇