開發(fā)準備

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

在開始之前，您需要了解有關跨平臺應用的一些基本概念：ArkUI框架的簡單說明、ArkUI-X的基本概念。

基本概念

ArkUI

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

ArkUI-X

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

開發(fā)工具

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

IDE工具（DevEco Studio）

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

命令行工具（ACE Tools）

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

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

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

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

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

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

依賴環(huán)境準備

在開發(fā)應用前，請先完成依賴環(huán)境準備。

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

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

OpenHarmony SDK

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

安裝ArkUI-X SDK

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

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

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

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

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

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

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

1.  單擊字母“i”，進入**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)境變量配置完成后，關閉并重啟DevEco Studio。