ArkUI-X环境搭建

前置条件: Ubuntu需要18.04以上版本,macOS需要11.6.2及以上版本,Windows需要Windows 10版本。

使用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. 配置ohpm环境

OHPM CLI作为鸿蒙生态三方库的包管理工具,支持OpenHarmony共享包的发布、安装和依赖管理。可通过DevEco Studio > File > Settings > Build, Execution, Deployment > Ohpm 查看ohpm home的安装路径,并配置到环境变量中(macOS为DevEco Studio > Preferences > Build, Execution, Deployment > Ohpm)。

image-20241022165807889

2. 配置ArkUI-X SDK环境

安装ArkUI-X SDK

File > Settings > ArkUI-X(macOS为DevEco Studio > Preferences > ArkUI-X)下,点击Location右侧的Edit,为SDK选择存储路径。

image-20241022165838838

在弹出的SDK Setup页面选择存储路径,一直点击Next,直到完成SDK的安装后,点击Finish

ArkUI-X SDK下载路径,可通过DevEco Studio > File > Settings > ArkUI-X查看ArkUI-X的安装路径,并配置到环境变量中(macOS为DevEco Studio > Preferences > ArkUI-X)。推荐如下配置方法:

[Windows]

可在桌面工具栏搜索框键入"环境变量",然后选择编辑系统环境变量,进行环境变量配置。另外,也可在控制台通过如下命令进行配置。

image-20241022142521429

// 配置环境变量
set ARKUIX_SDK_HOME=/Users/jianguo/Library/ArkUI-X/Sdk
set PATH=%PATH%;%ARKUIX_SDK_HOME%\12\arkui-x\toolchains\bin

说明:配置环境变量时,由于ARKUIX_SDK_HOME是ACE Tools要求的固定变量名,不允许自定义。

3.OpenHarmony SDK

  1. File > Settings > SDK(macOS为DevEco Studio > Preferences > SDK)下,点击Location右侧的Edit,为SDK选择存储路径。

  2. 在弹出的SDK Setup页面选择存储路径,一直点击Next,直到完成SDK的安装后,点击Finish

image-20241022170041440

4.配置Android SDK安装目录环境变量

配置环境变量ANDROID_HOME,设置Android SDK安装目录。

Windows环境变量设置方法: 在此电脑 > 属性 > 高级系统设置 > 高级 > 环境变量中,新建系统变量。变量名为ANDROID_HOME,变量值为Android SDK安装目录。

zh-cn_image_0000001578322442

环境变量配置完成后,关闭并重启DevEco Studio。

没有的话,需要自己下载。下载地址:https://developer.android.com/?hl=zh

开发环境检查

ace check 

创建应用

以创建一个 Stage模型‘nutpi’项目为例:

image-20241022171855827

ohos@user Desktop % ace create nutpi
? Enter the project name(demo): # 输入工程名称,不输入默认为文件夹名称
? Enter the bundleName (com.example.demo):  # 输入包名,不输入默认为com.nutpi.工程名
? Enter the runtimeOS (1: OpenHarmony, 2: HarmonyOS): 1 # 输入RuntimeOS系统

Project created. Target directory:  ${当前目录}/demo.

In order to run your app, type:

   $ cd demo
   $ ace run

Your app code is in demo/entry.

应用运行

  • 安装运行到Android/iOS/OpenHarmony设备(注:iOS设备执行ace run前请先打开Xcode完成应用签名)
cd demo
ace run

上述命令会完成应用构建打包,并安装到目标平台设备运行。

最后给大家给几个ace相关的命令

参考

ACE命令

编写第一个ArkUI-X应用

应用目录结构介绍

ArkUI-X初体验

ace config

设置ACE工具链相关配置,包括OpenHarmony SDK路径,HarmonyOS SDK路径、ArkUI-X SDK路径、Android SDK路径、Node.js路径、编译输出路径等。

语法:

ace config [arguments]
  • arguments
参数 说明
–android-sdk Android SDK路径。
–android-studio-path Android Studio安装路径(可选参数)。
–arkui-x-sdk ArkUI-X SDK路径。
–build-dir 编译输出的路径。
–deveco-studio-path DevEco Studio安装路径(可选参数)。
–harmonyos-sdk HarmonyOS SDK路径。
–java-sdk JDK路径。
–nodejs-dir Node.js 路径。
–ohpm-dir Ohpm路径。
–openharmony-sdk OpenHarmony SDK路径。
–source-dir ArkUI-X源码路径。
Logo

讨论HarmonyOS开发技术,专注于API与组件、DevEco Studio、测试、元服务和应用上架分发等。

更多推荐