ArkUI-X跨平台框架接入指南

ArkUI跨平台框架(ArkUI-X)进一步将ArkUI开发框架扩展到了多个OS平台:目前支持OpenHarmony、Android、 iOS,后续会逐步增加更多平台支持。开发者基于一套主代码,就可以构建支持多平台的精美、高性能应用。

使用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+

安装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文件。
    shell 复制代码
    vi ~/.bash_profile
    1. 单击字母"i",进入Insert模式。
    2. 输入以下内容,配置Android SDK安装目录。
    shell 复制代码
    export ANDROID_HOME=/Users/xxx/Library/Android/sdk
    1. 编辑完成后,单击Esc键,退出编辑模式,然后输入":wq",单击Enter键保存。
    2. 执行以下命令,使配置的环境变量生效。
    shell 复制代码
    source ~/.bash_profile
    1. 环境变量配置完成后,关闭并重启DevEco Studio。

创建工程

在DevEco Studio中创建跨平台模版工程。

  1. 点击File > New > Create Project。
  2. 在打开的模板市场中,选择[ArkUI-X]Empty Ability,点击Next。
  3. 在工程配置页面,填写Project name和Save location,点击Finish,等待模版工程创建完成。

编译构建生成跨平台应用

DevEco Studio可打包生成不同平台的应用包。

在主菜单栏,单击Build > Build Hap(s)/APP(s) > Build APP(s)。

编译后的ArkTS代码、资源和平台胶水代码已生成到Android和iOS应用工程中,后续安装、运行和调试请使用Android Studio和Xcode。

多端运行效果

我们分别在Harmony、Android和iOS平台运行生成的跨平台应用,查看运行效果。