《2026鸿蒙NEXT纯血开发与AI辅助》第二章：DevEco Studio 的基本使用以及arku

《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-X Library (库) ：如果你的项目需要拆分成多个模块，或者你想做一个公共组件给别人用，就用这个模板来创建依赖库。
- ArkUI-X Native 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 中。