開發準備

本文檔適用于ArkUI跨平臺應用開發的初學者。通過開發環境搭建、應用工程創建、編譯和運行，熟悉ArkUI跨平臺應用開發基本流程。

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

基本概念

ArkUI

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

ArkUI-X

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

開發工具

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

IDE工具（DevEco Studio）

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

命令行工具（ACE Tools）

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

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

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

配置開發環境

使用DevEco Studio開發ArkUI-X約束說明

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

依賴環境準備

在開發應用前，請先完成依賴環境準備。

表1 Windows平臺環境要求

組件包名	說明
OpenHarmony SDK	OpenHarmony的SDK包。
ArkUI-X SDK	ArkUI-X的SDK包。
Android SDK	Android的SDK包。

表2 macOS平臺環境要求

組件包名	說明
OpenHarmony SDK	OpenHarmony的SDK包。
ArkUI-X SDK	ArkUI-X的SDK包。
Android SDK	Android的SDK包。
Xcode	iOS應用開發環境，請參考官方環境搭建指導。

OpenHarmony SDK

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

安裝ArkUI-X SDK

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

配置Android SDK安裝目錄環境變量

配置環境變量ANDROID_HOME，設置Android SDK安裝目錄。

Windows環境變量設置方法：在此電腦 > 屬性 > 高級系統設置 > 高級 > 環境變量中，新建系統變量。變量名為ANDROID_HOME，變量值為Android SDK安裝目錄。

環境變量配置完成后，關閉并重啟DevEco Studio。
macOS環境變量設置方法：
1. 打開終端工具，執行以下命令，打開.bash_profile文件。
```
vi ~/.bash_profile

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

搜狗高速瀏覽器截圖20240326151344.png

1.  單擊字母“i”，進入**Insert**模式。

1.  輸入以下內容，配置Android SDK安裝目錄。

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

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

1.  執行以下命令，使配置的環境變量生效。

    ```
    source ~/.bash_profile
    ```

1.  環境變量配置完成后，關閉并重啟DevEco Studio。