OpenHarmony 仓颉文档：全场景应用开发指南发布

OpenHarmony 仓颉文档：全场景应用开发指南

一、仓颉语言与文档简介

OpenHarmony 自 API Version 22 起正式提供仓颉编程语言API 支持（仅适配 Stage 应用模型），为全场景智能设备应用开发提供全新技术选择。

仓颉语言是 OpenHarmony 生态原生打造的通用编程语言，核心优势在于兼顾开发效率与运行性能——采用静态类型检查机制保障代码可靠性，支持内存安全设计减少运行时错误，同时通过编译优化实现高效执行，适配手机、平板、穿戴设备、智能汽车等多终端场景。此外，其语法设计简洁直观，降低跨平台开发门槛，为开发者提供流畅的编码体验。

本仓库存放仓颉语言开发 OpenHarmony 应用的全套官方资源，涵盖开发指南、语法教程、API 参考、实战示例等内容，是开发者从入门到进阶的一站式学习平台。我们欢迎所有开发者参与文档共建，通过提交 Issue、PR 等方式共同完善 OpenHarmony 仓颉生态。

二、文档架构总览

以下文档架构图清晰呈现了各模块的层级关系与核心内容，帮助开发者快速定位所需资源：

图 1 OpenHarmony 仓颉文档架构图

文档架构图

文档整体分为 5 大核心模块，各模块功能与资源链接如下：

1. 应用开发导读

• 链接：应用开发导读[1]
• 核心价值：全景式介绍文档体系结构、学习路径规划、核心能力分布，帮助开发者快速建立认知框架，明确学习优先级。

2. 入门必备（零基础友好）

聚焦"从 0 到 1"的基础能力搭建，包含 4 个核心子模块：

• 快速入门：快速入门[2] 涵盖开发环境搭建、核心概念科普、工具准备指南，通过"Hello World"级实战案例，帮助开发者 10 分钟上手仓颉语言开发 OpenHarmony 应用。
• 开发基础知识：开发基础知识[3] 详解应用程序包（APP Package）结构、配置文件（config.json5）语法、权限申请规则等开发必备基础，解决入门阶段常见困惑。
• 资源分类与访问：资源分类与访问[4] 系统介绍字符串、颜色、字体、间距、图标等应用资源的分类标准、存放规范与调用方式，助力开发者实现资源高效管理。
• 学习仓颉语言：学习仓颉语言[5] 从语法特性、数据类型、函数定义到面向对象编程，全面讲解仓颉语言核心知识，搭配代码示例帮助开发者夯实语言基础。

3. 核心开发指南

• 链接：开发[6]
• 内容定位：深入解析各功能模块的实现原理、开发流程与最佳实践，覆盖应用开发全场景需求，包含 5 大方向：
  • 应用框架：支撑应用核心能力构建，包括 Ability Kit（组件生命周期管理）、ArkData（数据存储与管理）、ArkUI（跨终端 UI 渲染）、窗口管理、屏幕管理、ArkWeb（Web 页面集成）、文件基础服务、进程间通信（IPC）等。
  • 系统能力：提供底层系统支撑，涵盖安全（访问控制、加解密、密钥管理）、网络（短距通信、网络连接、蜂窝通信）、基础功能（进程线程、上传下载）、硬件交互（传感器调用）、调测调优（性能分析、调试工具）。
  • 媒体能力：实现音视频/图像相关功能，包括相机服务（拍照/录像）、图片处理（裁剪/滤镜）、媒体文件管理（音视频解析）等。
  • 图形能力：提供方舟 2D 图形绘制服务，支持自定义图形、动画效果开发。
  • 应用服务：补充场景化能力，核心包含位置服务（定位、地理信息查询）。

4. API 参考手册

• 链接：API 参考[7]
• 核心价值：提供仓颉语言版 OpenHarmony API 全集，每个接口均包含功能描述、参数说明、返回值定义、权限要求、错误码解释及实战示例代码，是开发过程中不可或缺的查询工具，帮助开发者精准调用系统能力。

5. 实战示例仓库

• 链接：仓颉鸿蒙示例仓库[8]
• 仓库亮点：包含丰富的可直接运行的实战项目，覆盖基础语法验证、核心功能实现、跨终端适配等场景。近期新增"仓颉调用 C 语言"专项示例，支持开发者复用 C 语言存量代码，降低跨语言开发成本。仓库持续更新，欢迎开发者参考示例快速落地项目，或提交自研示例丰富生态。

三、参与共建

OpenHarmony 仓颉文档是开源协作项目，当前已收获 18 星、51 次 Fork，累计处理 4 次 Pull Requests 与 13 个 Issue。如果您在使用过程中发现文档漏洞、有优化建议，或希望补充实战案例，可通过 AtomGit 仓库提交贡献，与全球开发者共同完善这份全场景开发指南。

我的联系方式，一起交个朋友！未来也会推出更多新技术的分享

参考资料

[2]

快速入门: https://atomgit.com/openharmony-sig/docs_cangjie/blob/master/zh-cn/application-dev/cj-start/start/quick-start/README_zh.md

[3]

开发基础知识: https://atomgit.com/openharmony-sig/docs_cangjie/blob/master/zh-cn/application-dev/cj-start/basic-knowledge/README_zh.md

[4]

资源分类与访问: https://atomgit.com/openharmony-sig/docs_cangjie/blob/master/zh-cn/application-dev/cj-start/start/ide-resource-categories-and-access.md

[5]

学习仓颉语言: https://atomgit.com/openharmony-sig/docs_cangjie/blob/master/zh-cn/application-dev/learn-cj/README_zh.md

[6]

开发: https://atomgit.com/openharmony-sig/docs_cangjie/blob/master/zh-cn/application-dev/README_zh.md

[7]

API参考: https://atomgit.com/openharmony-sig/docs_cangjie/blob/master/zh-cn/application-dev/reference/README_zh.md

[8]

仓颉鸿蒙示例仓库: https://atomgit.com/openharmony-sig/applications_app_samples_cangjie