开发准备

本文档适用于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）

1. DevEco Studio为ArkUI-X应用构建提供了简单的集成开发环境，版本要求：V4.0 Release。请参考[社区版本软件和工具配套关系]完成DevEco Studio下载和安装。
2. 请参考DevEco Studio[跨平台开发环境配置说明]，完成基于DevEco Studio的ArkUI-X开发环境配置。

命令行工具（ACE Tools）

1. ACE Tools默认随ArkUI-X SDK发布，。推荐使用DevEco Studio进行ArkUI-X SDK下载。
2. 请参考命令行[跨平台开发环境配置说明]完成基于命令行的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平台环境要求

表2 macOS平台环境要求

OpenHarmony SDK

1. 在 File > Settings > SDK （macOS为 DevEco Studio > Preferences > SDK ）下，点击Location右侧的 Edit ，为SDK选择存储路径。
2. 在弹出的SDK Setup页面选择存储路径，一直点击 Next ，直到完成SDK的安装后，点击 Finish 。

安装ArkUI-X SDK

1. 在 File > Settings > ArkUI-X （macOS为 DevEco Studio > Preferences > ArkUI-X ）下，点击Location右侧的 Edit ，为SDK选择存储路径。
2. 在弹出的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直接拿`
     

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。