《2026鸿蒙NEXT纯血开发与AI辅助》第二章：DevEco Studio 的基本使用以及arkui的详细介绍-卓伊凡
首先我们说了我们开发是鸿蒙纯血应用，所以我们要用arkui和arkts进行开发，那么面对首页创建有4个模板，我们应该怎么选择呢？
这四个模板的核心区别在于：你开发的应用，最终想在哪些设备上运行。
简单来说，ArkUI-X 前缀的模板是为了帮你实现“一次开发，多端部署”，让鸿蒙应用也能跑在安卓和iOS上；而普通的 Native C++ 模板，则专注于调用系统底层的C/C++能力，但仅限鸿蒙设备。
模板名称 |
核心目标 |
运行平台 |
主要语言 |
适用场景 |
ArkUI-X |
跨平台应用 |
HarmonyOS + Android + iOS |
ArkTS (主) + C++ (可选) |
需要一次开发，同时发布到鸿蒙、安卓、iOS三个市场的应用。 |
ArkUI-X Library |
跨平台依赖库 |
HarmonyOS + Android + iOS |
ArkTS (主) + C++ (可选) |
开发可被多个跨平台应用复用的公共组件或基础库。 |
ArkUI-X Native C++ |
跨平台应用 + 高性能 |
HarmonyOS + Android + iOS |
ArkTS + C/C++ |
需要跨平台，且涉及音视频编解码、游戏引擎、图形处理等高性能计算场景。 |
Native C++ |
鸿蒙原生应用 |
仅 HarmonyOS |
ArkTS + C/C++ |
应用仅针对鸿蒙设备，但需要使用C/C++能力提升性能或复用已有的C/C++代码库。 |
关键区别详解
1. 带 ArkUI-X 前缀的模板：跨平台开发
这是华为推出的跨平台开发框架，目的是解决多平台适配的痛点。核心价值在于：
- 一套代码，多平台运行：你可以使用主流的ArkTS语言编写UI和业务逻辑，然后通过这个框架，可以将其编译成在安卓和iOS上也能运行的应用。这对于有出海需求或需要覆盖更多用户的开发者来说，能显著节省开发成本。
- 区分应用、库和高性能场景：
ArkUI-X(应用)：用来创建最核心的、独立运行的App工程。ArkUI-XLibrary (库)：如果你的项目需要拆分成多个模块，或者你想做一个公共组件给别人用，就用这个模板来创建依赖库。ArkUI-XNative C++ (高性能)：这个模板在跨平台的基础上，集成了C/C++的支持。比如，你想在App里实现一个非常复杂的动画引擎或图像处理算法，为了性能，这部分逻辑就可以用C++来写，然后通过这个模板与ArkTS的UI层交互。
2. 普通的 Native C++ 模板：鸿蒙原生高性能开发
这个模板是传统的鸿蒙原生应用开发方式。它的特点是：
- 平台专一：它创建的应用只能运行在HarmonyOS设备上。
- 性能优化与复用：它最大的优势是可以让你方便地集成C/C++代码。这通常有两个目的：一是利用C++的高性能处理复杂计算（如图形渲染、游戏开发）；二是复用团队现有的C/C++代码库，不必用ArkTS重写一遍。
详细解释一下创建 ArkUI-X 项目时，界面上的各个选项都代表什么。
当你选择 ArkUI-X 模板后，会看到一个配置表单，通常包含以下几个关键选项：
📁 基础配置项
选项 |
说明 |
示例 |
Project name |
项目名称，也是最终生成的应用名称。建议使用英文、数字和下划线组合，不要用中文。 |
|
Project location |
项目存放的本地目录路径。选择一个你方便管理的位置。 |
|
Bundle name |
应用的包名，也叫 Bundle ID 或 Package Name。这是应用在系统层面的唯一标识符，一旦应用上架后就不能修改。格式通常是反向域名： |
|
Save location |
通常与 Project location 相同，是项目的完整保存路径。 |
|
🛠️ ArkUI-X 特有配置项
当你选择 ArkUI-X 模板后，还会看到一些针对跨平台的特殊选项：
选项 |
说明 |
常见选择 |
Module name |
模块名称。一个项目可以包含多个模块，入口模块通常叫 |
|
Device type |
选择应用支持的设备类型。ArkUI-X 支持跨平台，这里的选择会影响生成的各平台工程。 |
|
Enable ArkUI-X |
是否启用跨平台能力。既然你选了这个模板，这个选项会自动勾选。 |
✅ 已勾选 |
Enable Native C++ |
是否需要支持 C/C++ 代码。如果勾选，项目会包含 C++ 模块，适合音视频处理、游戏引擎等高性能场景。 |
按需勾选 |
📦 关于 Bundle Name 的深入说明
Bundle name 这个选项非常重要，值得单独展开：
格式建议：com.公司名.项目名 例如：com.example.myfirstapp
它的作用：
- 系统唯一标识：Android 和 iOS 都用它来区分不同的应用。
- 上架后不可改：一旦应用发布到应用商店，这个包名就永久绑定了。
- 多平台统一：ArkUI-X 会自动将这个包名同步到：
- Android 的
package name（在AndroidManifest.xml中） - iOS 的
Bundle Identifier（在 Xcode 工程中） - 鸿蒙的
bundleName（在AppScope/app.json5中）
建议：在创建项目前就确定好包名，避免后期修改带来麻烦。
如何选择？
你可以根据以下场景来决定：
- 我的应用只需要上架鸿蒙应用市场，但要用到C++做高性能计算。
👉 选Native C++。这是最直接、最轻量的方式。 - 我的应用需要同时上架鸿蒙、安卓和iOS三个应用市场。
👉 选ArkUI-X。如果业务逻辑不复杂，对性能没有极致要求，用这个基础版就够了。 - 我的应用需要跨平台，并且包含了复杂的音视频处理、游戏逻辑等。
👉 选ArkUI-X Native C++。这样可以保证跨平台的同时，核心的高性能模块能用C++高效实现。 - 我正在开发一个公共组件（比如一个特殊的登录按钮、一个图表库），希望它能在所有平台复用。
👉 选ArkUI-X Library。这是专门为此设计的。
选择哪个模板，本质上就是选择“应用的分发范围”和“是否引入C++”。想清楚这两点，就能做出最合适的选择。你遇到的这个提示，其实是开启 ArkUI-X 跨平台开发的关键一步。它不是在询问一个可有可无的插件，而是在邀请你下载整个 ArkUI-X 跨平台开发的核心引擎。
简单来说，ArkUI-X SDK 是一套 “跨平台编译工具链 + 运行时库”的集合。它的核心作用，是让你用 ArkTS 语言编写的代码，最终也能在 Android 和 iOS 上顺畅地运行起来。
为了帮你更好地理解，可以把它和鸿蒙原生开发的 SDK 做个对比：
特性 |
鸿蒙原生 SDK (你之前熟悉的) |
ArkUI-X SDK (现在要配置的) |
核心目标 |
构建仅运行于鸿蒙的应用 |
构建能跨平台运行（鸿蒙/Android/iOS）的应用 |
关键组件 |
鸿蒙设备模拟器、ArkTS 编译器、API 库 |
跨平台编译器、平台桥接库（连接 Android/iOS 系统） |
工程结构 |
标准鸿蒙工程 |
标准鸿蒙工程 + |
最终产物 |
|
|
ArkUI-X SDK 的核心组成
这个 SDK 之所以重要，是因为它包含了几个关键部分，共同完成了“一次开发，多端部署”的魔法：
- 跨平台编译器：它的核心工作是将你写的 ArkTS 代码（UI和业务逻辑）进行转换。对于 Android 平台，它会将 ArkTS 编译成 Dex 字节码；对于 iOS 平台，则会编译成可执行的机器码。这个过程保证了核心代码在不同平台上的通用性。
- 平台桥接库 (Bridge)：这是实现跨平台的关键。它就像一位“翻译官”，负责处理 ArkTS 代码与各平台（Android 的 Java/Kotlin、iOS 的 Objective-C/Swift）底层 API 之间的通信和适配。比如，当你的 ArkTS 代码需要调用相机时，这个桥接层就会负责去调用 Android 或 iOS 的原生相机 API。
- ACE Tools 命令行工具：这是一套强大的自动化脚本工具。它让你可以通过命令行快速完成环境检查 (
ace check)、创建项目 (ace create) 和一键编译运行 (ace run) 等操作，极大提升了开发效率。 - 模板和示例代码：SDK 中包含了像 "Empty Ability" 这样的项目模板，也就是你正在创建的项目原型。它预先配置好了跨平台工程的基础结构，让你可以开箱即用。
💻 如何配置 ArkUI-X SDK？
当 DevEco Studio 弹出提示时，你只需要：
- 点击确认：在
File > Settings > ArkUI-X(macOS 是DevEco Studio > Preferences > ArkUI-X) 中。 - 选择路径：为 SDK 选择一个存放路径（建议空间充足）。
- 开始下载：IDE 会自动开始下载这套核心工具链。根据网络情况，可能需要几分钟。
- 配置环境变量（可选但推荐）：SDK 安装后，为了能在命令行使用
ace命令，最好将路径添加到系统环境变量ARKUIX_SDK_HOME中。
