開(kāi)發(fā)準(zhǔn)備

本文檔適用于ArkUI跨平臺(tái)應(yīng)用開(kāi)發(fā)的初學(xué)者。通過(guò)開(kāi)發(fā)環(huán)境搭建、應(yīng)用工程創(chuàng)建、編譯和運(yùn)行，熟悉ArkUI跨平臺(tái)應(yīng)用開(kāi)發(fā)基本流程。

在開(kāi)始之前，您需要了解有關(guān)跨平臺(tái)應(yīng)用的一些基本概念：ArkUI框架的簡(jiǎn)單說(shuō)明、ArkUI-X的基本概念。

基本概念

ArkUI

ArkUI是一套構(gòu)建分布式應(yīng)用的聲明式UI開(kāi)發(fā)框架。它具備簡(jiǎn)潔自然的UI信息語(yǔ)法、豐富的UI組件、多維的狀態(tài)管理，以及實(shí)時(shí)界面預(yù)覽工具，幫助您提升應(yīng)用開(kāi)發(fā)效率，并能在多種設(shè)備上實(shí)現(xiàn)生動(dòng)而流暢的用戶體驗(yàn)。

ArkUI-X

ArkUI跨平臺(tái)框架(ArkUI-X)進(jìn)一步將ArkUI開(kāi)發(fā)框架擴(kuò)展到了多個(gè)OS平臺(tái)：目前支持OpenHarmony、Android、 iOS，后續(xù)會(huì)逐步增加更多平臺(tái)支持。開(kāi)發(fā)者基于一套主代碼，就可以構(gòu)建支持多平臺(tái)的精美、高性能應(yīng)用。

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

您可以通過(guò)自己偏好的文本編輯器和ACE Tools命令行工具進(jìn)行ArkUI-X應(yīng)用開(kāi)發(fā)，我們推薦您結(jié)合DevEco Studio進(jìn)行應(yīng)用開(kāi)發(fā)以獲取更好的開(kāi)發(fā)體驗(yàn)，除提供代碼智能編輯和雙向預(yù)覽功能外，還會(huì)對(duì)ArkTS接口進(jìn)行跨平臺(tái)過(guò)濾和編譯提示。

IDE工具（DevEco Studio）

1. DevEco Studio為ArkUI-X應(yīng)用構(gòu)建提供了簡(jiǎn)單的集成開(kāi)發(fā)環(huán)境，版本要求：V4.0 Release。請(qǐng)參考[社區(qū)版本軟件和工具配套關(guān)系]完成DevEco Studio下載和安裝。
2. 請(qǐng)參考DevEco Studio[跨平臺(tái)開(kāi)發(fā)環(huán)境配置說(shuō)明]，完成基于DevEco Studio的ArkUI-X開(kāi)發(fā)環(huán)境配置。

命令行工具（ACE Tools）

1. ACE Tools默認(rèn)隨ArkUI-X SDK發(fā)布，。推薦使用DevEco Studio進(jìn)行ArkUI-X SDK下載。
2. 請(qǐng)參考命令行[跨平臺(tái)開(kāi)發(fā)環(huán)境配置說(shuō)明]完成基于命令行的ArkUI-X開(kāi)發(fā)環(huán)境配置。

完成上述操作和基本概念的理解后，即可參照[DevEco Studio使用說(shuō)明]或[ACE Tools使用說(shuō)明]，以及[使用ArkTS語(yǔ)言開(kāi)發(fā)]中的章節(jié)進(jìn)行下一步ArkUI-X應(yīng)用開(kāi)發(fā)體驗(yàn)和學(xué)習(xí)。

開(kāi)發(fā)前請(qǐng)熟悉鴻蒙開(kāi)發(fā)指導(dǎo)文檔 ：gitee.com/li-shizhen-skin/harmony-os/blob/master/README.md點(diǎn)擊或者復(fù)制轉(zhuǎn)到。

配置開(kāi)發(fā)環(huán)境

使用DevEco Studio開(kāi)發(fā)ArkUI-X約束說(shuō)明

• DevEco Studio僅支持ArkUI-X源碼開(kāi)發(fā)和調(diào)試，各平臺(tái)Native代碼請(qǐng)使用對(duì)應(yīng)平臺(tái)的IDE編輯器進(jìn)行開(kāi)發(fā)和調(diào)試；
• ArkUI-X支持在Android/iOS平臺(tái)真機(jī)和模擬器上運(yùn)行調(diào)試；
• 平臺(tái)版本及構(gòu)建工具要求：
  • OpenHarmony平臺(tái)：支持API 10+；
  • Android平臺(tái)：Android 8+，Level-26，version code: O，Codename: Oreo；
  • iOS平臺(tái)：iOS 10+

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

在開(kāi)發(fā)應(yīng)用前，請(qǐng)先完成依賴環(huán)境準(zhǔn)備。

表1 Windows平臺(tái)環(huán)境要求

表2 macOS平臺(tái)環(huán)境要求

OpenHarmony SDK

1. 在 File > Settings > SDK （macOS為 DevEco Studio > Preferences > SDK ）下，點(diǎn)擊Location右側(cè)的 Edit ，為SDK選擇存儲(chǔ)路徑。
2. 在彈出的SDK Setup頁(yè)面選擇存儲(chǔ)路徑，一直點(diǎn)擊 Next ，直到完成SDK的安裝后，點(diǎn)擊 Finish 。

安裝ArkUI-X SDK

1. 在 File > Settings > ArkUI-X （macOS為 DevEco Studio > Preferences > ArkUI-X ）下，點(diǎn)擊Location右側(cè)的 Edit ，為SDK選擇存儲(chǔ)路徑。
2. 在彈出的SDK Setup頁(yè)面選擇存儲(chǔ)路徑，一直點(diǎn)擊 Next ，直到完成SDK的安裝后，點(diǎn)擊 Finish 。

配置Android SDK安裝目錄環(huán)境變量

配置環(huán)境變量ANDROID_HOME，設(shè)置Android SDK安裝目錄。

• Windows環(huán)境變量設(shè)置方法： 在此電腦 > 屬性 > 高級(jí)系統(tǒng)設(shè)置 > 高級(jí) > 環(huán)境變量中，新建系統(tǒng)變量。變量名為ANDROID_HOME，變量值為Android SDK安裝目錄。
  
  環(huán)境變量配置完成后，關(guān)閉并重啟DevEco Studio。

• macOS環(huán)境變量設(shè)置方法：

  1. 打開(kāi)終端工具，執(zhí)行以下命令，打開(kāi).bash_profile文件。

     vi ~/.bash_profile
     
     `HarmonyOS與OpenHarmony鴻蒙文檔籽料：mau123789是v直接拿`
     

1.  單擊字母“i”，進(jìn)入**Insert**模式。

1.  輸入以下內(nèi)容，配置Android SDK安裝目錄。

    ```
    export ANDROID_HOME=/Users/xxx/Library/Android/sdk
    ```

1.  編輯完成后，單擊**Esc**鍵，退出編輯模式，然后輸入“:wq”，單擊**Enter**鍵保存。

1.  執(zhí)行以下命令，使配置的環(huán)境變量生效。

    ```
    source ~/.bash_profile
    ```

1.  環(huán)境變量配置完成后，關(guān)閉并重啟DevEco Studio。