《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 | 项目名称，也是最终生成的应用名称。建议使用英文、数字和下划线组合，不要用中文。 | MyFirstApp |
| Project location | 项目存放的本地目录路径。选择一个你方便管理的位置。 | D:\Projects\ |
| Bundle name | 应用的包名 ，也叫 Bundle ID 或 Package Name。这是应用在系统层面的唯一标识符，一旦应用上架后就不能修改 。格式通常是反向域名：com.公司名.项目名。 | com.example.myfirstapp |
| Save location | 通常与 Project location 相同，是项目的完整保存路径。 | D:\Projects\MyFirstApp |

🛠️ ArkUI-X 特有配置项

当你选择 ArkUI-X 模板后，还会看到一些针对跨平台的特殊选项：

|-----------------------|-------------------------------------------------------|-------------------------|
| 选项 | 说明 | 常见选择 |
| Module name | 模块名称。一个项目可以包含多个模块，入口模块通常叫 entry。如果你不需要多模块结构，保持默认即可。 | entry |
| Device type | 选择应用支持的设备类型。ArkUI-X 支持跨平台，这里的选择会影响生成的各平台工程。 | Phone、Tablet、2in1 |
| 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平台适配目录 |
| 最终产物 | .hap 鸿蒙安装包 | .apk(Android) 、.app(iOS) 、.hap (鸿蒙) |

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 中。