OpenHarmony仓颉文档:全场景应用开发指南
一、仓颉语言与文档简介
OpenHarmony 自 API Version 22 起正式提供仓颉编程语言API支持(仅适配Stage应用模型),为全场景智能设备应用开发提供全新技术选择。
仓颉语言是 OpenHarmony 生态原生打造的通用编程语言,核心优势在于兼顾开发效率与运行性能------采用静态类型检查机制保障代码可靠性,支持内存安全设计减少运行时错误,同时通过编译优化实现高效执行,适配手机、平板、穿戴设备、智能汽车等多终端场景。此外,其语法设计简洁直观,降低跨平台开发门槛,为开发者提供流畅的编码体验。
本仓库存放仓颉语言开发 OpenHarmony 应用的全套官方资源,涵盖开发指南、语法教程、API 参考、实战示例等内容,是开发者从入门到进阶的一站式学习平台。我们欢迎所有开发者参与文档共建,通过提交 Issue、PR 等方式共同完善 OpenHarmony 仓颉生态。
二、文档架构总览
以下文档架构图清晰呈现了各模块的层级关系与核心内容,帮助开发者快速定位所需资源:
图1 OpenHarmony仓颉文档架构图

文档整体分为5大核心模块,各模块功能与资源链接如下:
1. 应用开发导读
- 链接:应用开发导读
- 核心价值:全景式介绍文档体系结构、学习路径规划、核心能力分布,帮助开发者快速建立认知框架,明确学习优先级。
2. 入门必备(零基础友好)
聚焦"从0到1"的基础能力搭建,包含4个核心子模块:
- 快速入门 :快速入门
涵盖开发环境搭建、核心概念科普、工具准备指南,通过"Hello World"级实战案例,帮助开发者10分钟上手仓颉语言开发OpenHarmony应用。 - 开发基础知识 :开发基础知识
详解应用程序包(APP Package)结构、配置文件(config.json5)语法、权限申请规则等开发必备基础,解决入门阶段常见困惑。 - 资源分类与访问 :资源分类与访问
系统介绍字符串、颜色、字体、间距、图标等应用资源的分类标准、存放规范与调用方式,助力开发者实现资源高效管理。 - 学习仓颉语言 :学习仓颉语言
从语法特性、数据类型、函数定义到面向对象编程,全面讲解仓颉语言核心知识,搭配代码示例帮助开发者夯实语言基础。
3. 核心开发指南
- 链接:开发
- 内容定位:深入解析各功能模块的实现原理、开发流程与最佳实践,覆盖应用开发全场景需求,包含5大方向:
- 应用框架:支撑应用核心能力构建,包括 Ability Kit(组件生命周期管理)、ArkData(数据存储与管理)、ArkUI(跨终端UI渲染)、窗口管理、屏幕管理、ArkWeb(Web页面集成)、文件基础服务、进程间通信(IPC)等。
- 系统能力:提供底层系统支撑,涵盖安全(访问控制、加解密、密钥管理)、网络(短距通信、网络连接、蜂窝通信)、基础功能(进程线程、上传下载)、硬件交互(传感器调用)、调测调优(性能分析、调试工具)。
- 媒体能力:实现音视频/图像相关功能,包括相机服务(拍照/录像)、图片处理(裁剪/滤镜)、媒体文件管理(音视频解析)等。
- 图形能力:提供方舟2D图形绘制服务,支持自定义图形、动画效果开发。
- 应用服务:补充场景化能力,核心包含位置服务(定位、地理信息查询)。
4. API参考手册
- 链接:API参考
- 核心价值:提供仓颉语言版 OpenHarmony API 全集,每个接口均包含功能描述、参数说明、返回值定义、权限要求、错误码解释及实战示例代码,是开发过程中不可或缺的查询工具,帮助开发者精准调用系统能力。
5. 实战示例仓库
- 链接:仓颉鸿蒙示例仓库
- 仓库亮点:包含丰富的可直接运行的实战项目,覆盖基础语法验证、核心功能实现、跨终端适配等场景。近期新增"仓颉调用C语言"专项示例,支持开发者复用C语言存量代码,降低跨语言开发成本。仓库持续更新,欢迎开发者参考示例快速落地项目,或提交自研示例丰富生态。
三、参与共建
OpenHarmony 仓颉文档是开源协作项目,当前已收获18星、51次 Fork,累计处理4次 Pull Requests 与13个 Issue。如果您在使用过程中发现文档漏洞、有优化建议,或希望补充实战案例,可通过 AtomGit 仓库提交贡献,与全球开发者共同完善这份全场景开发指南。
欢迎大家加入开源鸿蒙跨平台开发者专区:https://openharmonycrossplatform.csdn.net/