华为云码道(CodeArts)鸿蒙应用开发实战 — 旅游推荐应用开发实战

举报
Lincoln_HWC 发表于 2026/10/08 17:48:37 2026/10/08
【摘要】 华为云码道(CodeArts)鸿蒙应用开发实战 — 旅游推荐应用开发实战📖 实验手册来源:华为云学堂 KooLabs 云实验📅 手册最后更新:2026年8月16日 | 实验最后测试:2026年6月16日🏢 华为技术有限公司📌 码道安装版本:26.5.2(版本不一致可能导致实验部分截图和实际体验不一致) 📑 目录一、实验概述二、实验特别提醒三、实验环境要求四、任务 1:环境准备(C...

华为云码道(CodeArts)鸿蒙应用开发实战 — 旅游推荐应用开发实战

📖 实验手册来源:华为云学堂 KooLabs 云实验
📅 手册最后更新:2026年8月16日 | 实验最后测试:2026年6月16日
🏢 华为技术有限公司
📌 码道安装版本:26.5.2(版本不一致可能导致实验部分截图和实际体验不一致)


📑 目录


一、实验概述

1.1 实验简介

项目 内容
实验名称 华为云码道(CodeArts)鸿蒙应用开发实战-旅游推荐应用开发实战
实验目标 学习华为云码道 CodeArts 代码智能体的鸿蒙实战开发能力,学会快速搭建"鸿蒙+码道"开发环境,了解码道的鸿蒙应用开发全流程,最终完成一个旅游推荐应用的全流程开发
技术栈 CodeArts + HarmonyOS 核心技术 + ArkTS 开发规范
核心能力 代码托管、编译构建、调试部署
教学方式 项目驱动教学
最终目标 助力高效搭建全场景原生应用,接轨鸿蒙生态开发需求

1.2 实验任务总览

任务 1  环境准备(CodeArts + DevEco Studio)
  ├── 1.1 下载 DevEco Studio
  ├── 1.2 华为云码道(CodeArts)准备
  └── 1.3 DevEco Studio 集成 CodeArts(插件 + 登录)

任务 2  项目准备
  ├── 2.1 项目背景
  ├── 2.2 项目开发流程
  ├── 2.3 五层架构设计说明
  └── 2.4 实验目录设计说明

任务 3  项目开发——文档设计
  ├── 3.1 架构设计文档
  ├── 3.2 需求功能文档
  └── 3.3 课程参考文档下载

任务 4  代码开发与错误修复
  ├── 4.1 项目创建
  ├── 4.2 CodeArts 选择
  ├── 4.3 代码开发
  ├── 4.4 错误修复
  ├── 4.5(可选)手动编程
  ├── 4.6(可选)UI 代码开发
  └── 4.7 项目图片

任务 5  运行调试与新功能增加
  ├── 5.1 运行调试
  ├── 5.2 新功能添加
  ├── 5.3 登录功能设计
  └── 5.4 登录功能添加

任务 6  验收测试与上线准备
  ├── 6.1 功能测试
  ├── 6.2 上线准备
  └── 6.3 项目源码

二、实验特别提醒

2.1 费用与账号要求

⚠️ 重要提醒

  • 本实验仅提供云服务实验操作的指导性参考建议,手册中的所有陈述、信息和建议不构成任何明示或暗示的担保
  • 若有华为云资源操作,您将使用自身华为云账号完成实验操作,需要您自行承担本次实操的云资源费用

进入实操前,请确保华为云账号满足以下条件:

序号 要求
1 已通过实名认证并且账户余额充足
2 云资源产生的费用需您自行承担,KooLabs 云实验平台不会向您征收额外费用
3 所有实验操作将保留至您的账号,请谨慎操作
4 实操结束后,您可以选择继续付费保留资源,或参考手册手动释放资源

2.2 Token 消耗预估

🔴 重要:本实验使用码道云服务,实验总消耗预计 300w Token。如果您调整了资源规格、使用时长,或执行了本方案以外的操作,可能导致费用发生变化,请以控制台显示的实际价格和最终账单为准。

2.3 免费开通

💡 华为云码道体验版免费一键开通(一键开通链接见实验页面)


三、实验环境要求

⚠️ 注意:本实验不提供实验环境,需在本地完成操作。

项目 要求
操作系统 Windows 10/11 或 macOS 10.14+ 或 Linux
网络环境 能够访问华为云服务
账号要求 华为云账号(已实名认证)
码道版本 26.5.2

📌 官网支持:Windows版下载(x64) | Mac版下载(Apple Silicon) | Linux版下载(ARM64)
本手册以 Windows版 为例进行操作。
因软件不断演进,示例图仅供参考,具体页面请以最新软件为准。


四、任务 1:环境准备(CodeArts + DevEco Studio)

任务 1.1 下载 DevEco Studio

项目 内容
操作目的 下载安装鸿蒙官方 IDE
版本要求 6.0 以上版本
下载地址 见实验手册链接
安装参考 见实验手册安装教程链接

操作步骤:

  1. 访问 DevEco Studio 下载页面
  2. 选择 6.0 以上版本 下载
  3. 按照安装教程完成安装

任务 1.2 华为云码道(CodeArts)准备

项目 内容
操作目的 下载 CodeArts 离线安装包
下载内容 CodeArts 离线安装包文件(.zip)
官网地址 见实验手册链接

操作步骤:

  1. 访问 CodeArts 官网
  2. 下载 CodeArts 离线安装包文件

任务 1.3 DevEco Studio 集成 CodeArts(插件 + 登录)

项目 内容
操作目的 在 DevEco Studio 中安装 CodeArts 插件并登录

操作步骤:

  1. 打开 DevEco Studio
  2. 进入设置:File → Settings → Plugins
  3. 点击右上角 ⚙️ → Install Plugin from Disk
  4. 选择下载的 CodeArts .zip 插件包
  5. 完成安装后登录华为云账号
操作路径:
File → Settings → Plugins → ⚙️ → Install Plugin from Disk → 选择 .zip 插件包

✅ 环境准备完成检查清单:

  • [ ] DevEco Studio 已安装(6.0+)
  • [ ] CodeArts 离线包已下载
  • [ ] CodeArts 插件已导入 DevEco Studio
  • [ ] 已登录华为云账号

五、任务 2:项目准备

任务 2.1 项目背景

项目背景:一款基于 HarmonyOS 开发的旅游应用,旨在为用户提供景点浏览、搜索、详情查看等核心功能,帮助用户便捷地获取旅游信息。

任务 2.2 项目开发流程

了解应用开发的全流程。流程图中的蓝色部分,可以通过华为云码道 CodeArts 代码智能体进行流程优化和辅助。

完整开发流程(8 阶段):

阶段 名称 码道可优化
01 开发环境准备
02 架构设计 ✅
03 功能需求分析 ✅
04 项目创建
05 代码开发 ✅
06 错误修复 ✅
07 运行调试 ✅
08 打包上线

任务 2.3 五层架构设计说明

项目采用 五层架构 设计:

层级 目录 核心内容 职责说明
页面层 pages/ 首页、列表、详情、搜索、我的(5 大核心业务页面) 应用交互入口,直接面向用户,呈现所有可视化内容与操作场景
组件层 components/ 轮播、卡片、列表项 封装可复用 UI 元素,统一页面样式,减少重复开发,提升页面一致性
服务层 service/ ApiService.ets 核心业务支撑,统一封装网络请求与 API 调用,解耦页面与数据请求,负责数据的获取与异常处理
数据层 model/ 景点、用户、城市(三大核心数据实体) 规范数据结构,统一数据格式,适配前端展示与接口交互
工具层 common/ 网络工具、通用工具类、全局常量 全局基础支撑,为整个应用提供通用能力,保障应用稳定运行

任务 2.4 实验目录设计说明

标准工程目录,分为五层架构:

travel_app/
├── pages/              # 页面层:业务页面,承载首页、列表等交互入口
│   ├── Index.ets       # 首页
│   ├── List.ets        # 列表页
│   ├── Detail.ets      # 详情页
│   ├── Search.ets      # 搜索页
│   └── Mine.ets        # 我的页
├── components/         # 组件层:封装可复用 UI 组件
│   ├── Banner.ets      # 轮播组件
│   ├── Card.ets        # 卡片组件
│   └── ListItem.ets    # 列表项组件
├── service/            # 服务层:统一管理网络请求
│   └── ApiService.ets  # 网络请求与 API 封装
├── model/              # 数据层:定义数据模型
│   ├── Attraction.ets  # 景点
│   ├── User.ets        # 用户
│   └── City.ets        # 城市
└── common/             # 工具层:公共能力
    ├── Network.ets     # 网络工具
    ├── Utils.ets       # 通用工具类
    └── Constants.ets   # 全局常量

各层职责:

层级 职责
页面层(pages) 为业务页面层,承载首页、列表等交互入口
组件层(components) 封装可复用 UI 组件
服务层(service) 统一管理网络请求
数据层(model) 定义景点、用户等数据模型
工具层(common) 提供网络、工具、常量等公共能力,实现职责解耦与高效开发

六、任务 3:项目开发——文档设计

任务 3.1 项目开发步骤:架构设计文档

项目 内容
操作目的 导入项目背景信息至华为云码道(CodeArts)代码智能体,让码道分析生成架构设计文档

步骤说明:

  1. 打开 DevEco Studio,启动华为云码道(CodeArts)代码智能体插件
  2. 提交项目背景,生成架构设计文档
  3. 架构文档审核确认

向码道输入的提示词:

本项目是一款基于HarmonyOS开发的旅游推荐应用,旨在为用户提供景点浏览、搜索、详情查看等核心功能,帮助用户便捷地获取旅游信息。
我需要一个项目架构文档,请参考项目背景进行设计,生成一个architecture.md文档。

📌 产出文件:architecture.md

任务 3.2 项目开发步骤:需求功能文档

项目 内容
操作目的 提示码道通过上一步生成的架构设计文档生成功能需求分析文档

步骤说明:

  1. 打开 DevEco Studio,启动华为云码道(CodeArts)代码智能体插件
  2. 在对话框里提醒码道读取上一步生成的架构设计文档,然后基于架构设计文档进行功能细化,生成需求功能文档
  3. 需求功能文档审核确认

向码道输入的提示词:

请读取项目目录中的architecture.md架构设计文档,帮我进行功能需求细化,生成功能需求文档requirements.md。

📌 产出文件:requirements.md

任务 3.3 课程参考文档下载

以下链接为课程案例的参考文档下载地址:

文档 说明
architecture.md 架构设计参考文档(见实验手册下载链接)
requirements.md 功能需求参考文档(见实验手册下载链接)

💡 如果自行生成的文档不够完善,可以直接下载参考文档使用。


七、任务 4:代码开发与错误修复

任务 4.1 项目创建

项目 内容
操作目的 通过 DevEco Studio 创建鸿蒙项目

步骤说明:

  1. 打开 DevEco Studio,选择新建项目
  2. New Project → 选择 Empty Ability → 下一步 → 项目名称:travel_app
操作路径:
DevEco Studio → New Project → Empty Ability → 下一步 → 项目名称:travel_app

创建完成后可得到标准鸿蒙工程目录结构。

✅ 检查点:项目 travel_app 创建成功,工程目录结构正确

任务 4.2 CodeArts 选择

项目 内容
操作目的 选择 CodeArts 智能体

步骤说明:

  1. 选择智能体
  2. 版本选择:GLM-5.1
选项 说明
智能体 自主规划与执行,完成复杂开发任务
智能问答 精通代码,即问即答
推荐模型 GLM-5.1

任务 4.3 代码开发

项目 内容
操作目的 使用 CodeArts 基于 3.1 和 3.2 生成的架构文档和需求功能文档,快捷开发项目代码

步骤说明:

  1. 将 3.1 和 3.2 中的案例文档 architecture.md 和 requirements.md,下载复制到项目目录下
  2. 在 CodeArts 对话框中输入提示词
  3. 等待一段时间后,码道会根据架构文档和功能需求文档进行文件和代码生成

向码道输入的提示词:

我需要根据architecture.md架构文档和requirements.md需求文档完成一个鸿蒙旅游推荐应用。

⏳ 等待说明:根据架构设计和需求文档的复杂度,需要等待一定时间,让码道自动完成代码生成。

✅ 检查点:码道完成代码生成后,检查项目目录中是否生成了完整的五层架构代码文件

任务 4.4 错误修复

项目 内容
操作目的 通过 CodeArts 快速修复项目 Bug

步骤说明:

  1. 检查编译器是否有爆红错误提示
  2. 将鼠标放入错误提示的代码上,复制错误提示
  3. 将复制的错误提示输入码道对话框中,提示码道进行错误 Bug 修复

错误修复流程:

编译器爆红 → 复制错误提示 → 粘贴到 CodeArts 对话框 → 码道分析修复 → 确认修复

📌 补充:编译过程中遇到的 Bug 提示,也可以复制提示,导入 CodeArts 对话框,使用 CodeArts 进行快速定位修改。

任务 4.5(可选)手动编程

项目 内容
操作目的 通过 CodeArts 快速手动编写代码

步骤说明:

  1. 编程过程中可以通过 CodeArts 代码提示和自动续写完成

💡 适用场景:需要手动编写工具类(如日期格式化工具类)时,CodeArts 的代码提示和自动续写可以大幅加速编写过程。

任务 4.6(可选)UI 代码开发

项目 内容
操作目的 UI 界面开发,可以通过预览器观看 UI 效果,提示 CodeArts 进行 UI 开发

步骤说明:

  1. 通过预览器预览开发的界面 UI 代码
  2. 提示码道进行 UI 界面修改

💡 适用场景:需要调整页面布局、修改 UI 样式时,先通过预览器查看效果,再通过对话让 CodeArts 调整。

任务 4.7 项目图片

项目 内容
操作目的 项目图片导入,为本案例的项目添加图片资源

步骤说明:

  1. 通过提示码道寻找图片资源并下载到项目资源目录

向码道输入的提示词:

帮我寻找对应景点的图片资源下载到项目的资源文件目录下src/main/resources/base/media,并且修改项目中的图片引用。

图片资源存放路径:

travel_app/src/main/resources/base/media/

✅ 检查点:图片资源已下载到 src/main/resources/base/media 目录,项目中的图片引用已更新


八、任务 5:运行调试与新功能增加

任务 5.1 运行调试

项目 内容
操作目的 开发完成项目代码后,通过用户角度进行应用测试

步骤说明:

步骤 1:创建模拟器

  1. 通过 No Devices 中的设备管理器进行运行调试
  2. 在设备管理器里面创建一个手机模拟器
  3. 选择默认下一步直到创建完成
操作路径:
No Devices → 设备管理器 → 创建手机模拟器 → 默认下一步 → 创建完成

步骤 2:启动模拟器

  1. 点击启动模拟器
  2. 编译运行应用

步骤 3:运行应用

  1. 模拟器启动后,编译器检测到对应设备
  2. 点击手机模拟器解锁桌面
  3. 运行编译器代码
  4. 编译成功即可在模拟器中打开应用

⚠️ 编译错误处理:如果出现编译错误,请复制错误提示到码道中提醒码道修改。

步骤 4:用户视角测试

从普通游客用户视角,全程模拟真实使用场景,对应用进行:

测试维度 说明
操作体验 模拟真实用户操作流程
功能试用 验证各功能是否正常工作
交互感受 体验交互流畅度和用户友好性
异常场景实测 测试异常场景的处理能力

📌 功能补全:如果有功能未完成,请提示码道 CodeArts 完成未完成的功能。

任务 5.2 新功能添加

流程说明:设计一个登录功能,通过码道完成登录功能及其页面 UI 的一键开发。

功能需求设计 → 功能代码开发 → 功能调试 → 错误修复
    ↓                ↓              ↓           ↓
通过码道进行    导入需求文档    运行项目    描述需要修改
需求设计        给码道进行      调试功能    的功能细节
                代码开发

任务 5.3 登录功能设计

项目 内容
操作目的 提示码道完成登录功能的功能设计

步骤说明:

  1. 提示 CodeArts 生成登录功能需求文档

向码道输入的提示词:

登录页面,我需要在我的页面增加一个退出登录按钮,并新开发一个登录注册页面,请帮我设计出需求文档。

📌 产出文件:Login-Register.md
📌 也可参考案例需求文档 Login-Register.md(见实验手册下载链接)

任务 5.4 登录功能添加

项目 内容
操作目的 提示码道基于设计的登录功能文档,生成对应的功能模块代码

步骤说明:

  1. 提示码道读取需求文档并开发

向码道输入的提示词:

请读取Login-Register.md需求文档,完成项目登录注册功能的开发。

✅ 检查点:登录注册页面已生成,退出登录按钮已添加,功能模块代码完整


九、任务 6:验收测试与上线准备

任务 6.1 功能测试

项目 内容
操作目的 通过验收文档提示华为云码道 CodeArts 进行功能测试

验收范围:本应用验收覆盖五大核心模块

模块名称 验收内容
首页轮播 轮播图正常展示和自动播放、热门景点列表正确加载、搜索入口可正常跳转、下拉刷新功能正常
列表加载 景点列表正确展示、筛选功能正常工作、分页加载正常、列表项点击跳转正常
详情展示 景点信息完整展示、图片浏览功能正常、收藏功能正常、分享功能正常
搜索查询 搜索结果准确、历史记录正常保存、清空历史功能正常
个人中心管理 用户信息正确展示、收藏列表正常展示、删除收藏功能正常

⚠️ 重要:需要手动人为通过模拟器测试相关功能是否实现。码道可以辅助测试,但不能完全替代人工验证。

任务 6.2 上线准备

上线发布流程(7 步):

账号认证 → 合规准备 → 签名打包 → AGC 信息填报 → 上传包 → 提交审核 → 通过上架
步骤 操作 说明
1 账号认证 完成开发者账号认证
2 合规准备 确保应用符合华为应用市场合规要求
3 签名打包 对应用进行签名并打包
4 AGC 信息填报 在 AGC 后台填报应用信息(见实验手册链接)
5 上传包 上传签名后的应用包
6 提交审核 提交至华为应用市场审核
7 通过上架 审核通过后应用上架

相关资源链接:

资源 说明
AGC 后台信息填报地址 见实验手册链接
发布 HarmonyOS 应用指导文档地址 见实验手册链接

任务 6.3 项目源码

案例项目源码下载地址:见实验手册链接

✅ 实验完成!


十、全流程总结与速查表

10.1 全流程步骤速查

步骤 任务 关键操作 提示词/命令
1 1.1 下载 DevEco Studio (6.0+) —
2 1.2 下载 CodeArts 离线包 —
3 1.3 集成 CodeArts 插件 File → Settings → Plugins → ⚙️ → Install Plugin from Disk
4 3.1 生成架构设计文档 我需要一个项目架构文档,请参考项目背景进行设计,生成一个architecture.md文档。
5 3.2 生成需求功能文档 请读取项目目录中的architecture.md架构设计文档,帮我进行功能需求细化,生成功能需求文档requirements.md。
6 4.1 创建项目 New Project → Empty Ability → travel_app
7 4.2 选择 CodeArts 智能体 模型:GLM-5.1
8 4.3 代码开发 我需要根据architecture.md架构文档和requirements.md需求文档完成一个鸿蒙旅游推荐应用。
9 4.4 错误修复 复制错误提示 → 粘贴到 CodeArts 对话框
10 4.7 项目图片 帮我寻找对应景点的图片资源下载到项目的资源文件目录下src/main/resources/base/media,并且修改项目中的图片引用。
11 5.1 运行调试 No Devices → 设备管理器 → 创建模拟器 → 运行
12 5.3 登录功能设计 登录页面,我需要在我的页面增加一个退出登录按钮,并新开发一个登录注册页面,请帮我设计出需求文档。
13 5.4 登录功能添加 请读取Login-Register.md需求文档,完成项目登录注册功能的开发。
14 6.1 功能测试 五大模块逐一验收
15 6.2 上线发布 账号认证→合规→签名→AGC→上传→审核→上架

10.2 核心提示词汇总

用途 提示词
生成架构文档 本项目是一款基于HarmonyOS开发的旅游推荐应用,旨在为用户提供景点浏览、搜索、详情查看等核心功能,帮助用户便捷地获取旅游信息。我需要一个项目架构文档,请参考项目背景进行设计,生成一个architecture.md文档。
生成需求文档 请读取项目目录中的architecture.md架构设计文档,帮我进行功能需求细化,生成功能需求文档requirements.md。
代码开发 我需要根据architecture.md架构文档和requirements.md需求文档完成一个鸿蒙旅游推荐应用。
项目图片 帮我寻找对应景点的图片资源下载到项目的资源文件目录下src/main/resources/base/media,并且修改项目中的图片引用。
登录功能设计 登录页面,我需要在我的页面增加一个退出登录按钮,并新开发一个登录注册页面,请帮我设计出需求文档。
登录功能开发 请读取Login-Register.md需求文档,完成项目登录注册功能的开发。

10.3 产出文件清单

文件名 产出阶段 说明
architecture.md 任务 3.1 架构设计文档
requirements.md 任务 3.2 功能需求文档
Login-Register.md 任务 5.3 登录功能需求文档
travel_app/ 任务 4.1 鸿蒙项目工程目录
src/main/resources/base/media/ 任务 4.7 项目图片资源目录

10.4 五层架构速查

travel_app/
├── pages/          # 页面层 - 5大核心页面
│   ├── Index.ets     # 首页
│   ├── List.ets      # 列表页
│   ├── Detail.ets    # 详情页
│   ├── Search.ets    # 搜索页
│   └── Mine.ets      # 我的页
├── components/     # 组件层 - 可复用UI
│   ├── Banner.ets    # 轮播
│   ├── Card.ets      # 卡片
│   └── ListItem.ets  # 列表项
├── service/        # 服务层 - 网络请求
│   └── ApiService.ets
├── model/          # 数据层 - 数据模型
│   ├── Attraction.ets
│   ├── User.ets
│   └── City.ets
└── common/         # 工具层 - 公共能力
    ├── Network.ets
    ├── Utils.ets
    └── Constants.ets

10.5 五大验收模块速查

模块 关键验收点
🏠 首页轮播 轮播展示+自动播放、热门列表加载、搜索入口跳转、下拉刷新
📋 列表加载 列表展示、筛选功能、分页加载、点击跳转
📄 详情展示 信息展示、图片浏览、收藏功能、分享功能
🔍 搜索查询 搜索结果、历史记录、清空历史
👤 个人中心 用户信息、收藏列表、删除收藏

10.6 关键配置参数

参数 值
DevEco Studio 版本 6.0+
CodeArts 版本 26.5.2
推荐模型 GLM-5.1
预计 Token 消耗 300w
操作系统 Windows 10/11 / macOS 10.14+ / Linux

10.7 后续拓展建议

💡 实验结束后,还可以:

  • 体验让智能体生成更多项目功能,比如生成推荐排行榜等功能
  • 下载华为云码道(CodeArts)代码智能体进一步深入使用更多功能
  • 探索 CodeArts 在其他类型鸿蒙应用中的开发能力

📝 版权声明:版权所有 © 2026,华为技术有限公司,保留所有权利。
本资料是华为的保密信息,所有内容仅供华为授权的培训客户内部使用。

【声明】本内容来自华为云开发者社区博主,不代表华为云及华为云开发者社区的观点和立场。转载时必须标注文章的来源(华为云社区)、文章链接、文章作者等基本信息,否则作者和本社区有权追究责任。如果您发现本社区中有涉嫌抄袭的内容,欢迎发送邮件进行举报,并提供相关证据,一经查实,本社区将立刻删除涉嫌侵权内容,举报邮箱: cloudbbs@huaweicloud.com
  • 点赞
  • 收藏
  • 关注作者

评论(0)

0/1000
抱歉,系统识别当前为高风险访问,暂不支持该操作

全部回复

上滑加载中

设置昵称

在此一键设置昵称,即可参与社区互动!

*长度不超过10个汉字或20个英文字符,设置后3个月内不可修改。

*长度不超过10个汉字或20个英文字符,设置后3个月内不可修改。