Appearance
基于 ArkTS 和 ArkUI 的 HarmonyOS 应用开发系统教程,从基础到进阶,涵盖 UI 组件、状态管理、性能优化等核心内容。
📚 教程目录
第一部分:UI 组件与样式
构建美观、高效的用户界面。
第二部分:布局与适配
(待补充)
第三部分:状态管理
(待补充)
第四部分:网络与数据
(待补充)
第五部分:性能优化
(待补充)
第六部分:系统能力
访问 HarmonyOS 系统底层能力和原生模块开发。
第七部分:测试与调试
(待补充)
第八部分:发布与运营
(待补充)
🎯 学习路线
初学者路线
text
1. UI 组件与样式
├─ 图标方案选型 ← 理论对比
├─ SVG 图标实战 ← 完整流程
└─ 快速获取图标 ← 即用方案
2. 布局与适配
└─ (待补充)
3. 状态管理
└─ (待补充)进阶开发者路线
text
1. 性能优化
2. 系统能力
├─ NAPI 原生模块接口 ← 高性能计算
3. 测试与调试💡 特色内容
⭐ 图标方案选型与实战
核心内容:
- SVG + Image 组件(推荐)
- IconFont 自定义字体
- Emoji 快速原型
- 模板渲染与主题化
- 完整实战示例
适合人群:
- 需要实现图标系统的开发者
- 需要主题切换功能的项目
- 希望统一 UI 风格的团队
学习收获:
- 掌握三种图标方案的优劣
- 学会 SVG 模板渲染与着色
- 实现主题化图标系统
- 了解性能优化技巧
⭐ SVG 图标获取与使用实战
核心内容:
- 图标资源获取(Iconify、Material Symbols、Remix Icon)
- SVG 优化处理(SVGOMG 工具)
- 资源目录结构与命名规范
- 完整代码改造示例
- 4 个可直接使用的 SVG 文件
适合人群:
- 想快速上手 SVG 图标的开发者
- 需要完整落地流程的初学者
- 正在从 Emoji 迁移到 SVG 的项目
学习收获:
- 从 0 到 1 实现 SVG 图标系统
- 掌握 SVG 优化与处理技巧
- 学会资源管理与命名规范
- 解决常见问题与陷阱
⭐ 快速获取常用功能图标
核心内容:
- 3 大图标源入口(Material Symbols、Remix Icon、Iconify)
- 4 个常用功能图标推荐名称对照表
- 快速下载步骤(聊天/录音/用户/设置)
- 完整迁移指南(Emoji → SVG)
- 主题色管理与夜间模式
适合人群:
- 需要快速找到特定图标的开发者
- 不知道图标英文名称的初学者
- 想批量下载常用图标的项目
学习收获:
- 快速查找和下载所需图标
- 掌握图标命名对照技巧
- 3 步完成 Emoji 到 SVG 迁移
- 实现主题化图标系统
⭐ NAPI 原生模块接口入门指南
核心内容:
- NAPI 基础概念与核心价值
- 开发环境搭建与项目结构
- 快速开始:创建第一个 NAPI 模块
- 常用 API:数据类型转换、对象操作、数组操作
- 实战案例:图像处理、AI 推理
- 注意事项:内存管理、异常处理、线程安全
- 进阶主题:异步操作、回调函数
适合人群:
- 需要高性能计算的开发者
- 需要访问系统底层能力的项目
- 想复用现有 C/C++ 库的团队
- 进行 AI 推理、图像处理等场景
学习收获:
- 掌握 NAPI 开发流程
- 学会 JavaScript 与 C/C++ 互操作
- 实现高性能原生模块
- 集成第三方 C/C++ 库
📖 使用指南
如何阅读本教程
- 按需学习:根据目录选择需要的章节
- 动手实践:每篇文章都有完整代码示例
- 循序渐进:建议按照学习路线顺序学习
- 查漏补缺:可作为速查手册使用
代码示例说明
typescript
// ⭐ 推荐做法
Image($r("app.media.icon_home"))
.renderMode(ImageRenderMode.Template)
.fillColor("#4A90E2");
// ⚠️ 注意事项
// 未设置 renderMode 时,fillColor 不生效
// ❌ 不推荐
Text("💬"); // Emoji 跨设备不一致🔧 开发环境
推荐配置
- IDE:DevEco Studio 4.0+
- SDK:HarmonyOS 4.0+
- 语言:ArkTS (TypeScript)
- UI 框架:ArkUI
快速搭建
- 下载 DevEco Studio
- 安装 HarmonyOS SDK
- 创建第一个 ArkTS 项目
- 运行示例代码
📝 更新日志
- 2025-01-27:创建教程目录结构
- 2025-01-27:添加图标方案选型与实战章节
- 2025-01-27:添加 SVG 图标获取与使用实战章节
- 2025-01-27:添加快速获取常用功能图标章节
- 2025-01-27:添加 NAPI 原生模块接口入门指南章节
🤝 贡献指南
欢迎贡献内容!
贡献方式
- 提交 Issue 反馈问题
- 提交 Pull Request 改进内容
- 分享学习心得
内容规范
- 代码示例完整可运行
- 配图清晰易懂
- 注释详细规范
- 排版美观统一
🔗 相关资源
官方文档
学习资源
工具推荐
📧 联系方式
- 技术分享:herong.info
- 问题反馈:通过 Issue 或评论区
让我们一起打造更好的 HarmonyOS 应用! 🚀