仓颉编程语言技术文档

1. 安装指南

1.1 通用版本安装

仓颉通用版本工具链支持三大系统平台（arm64与x86-64架构），推荐使用VSCode及仓颉包管理工具(cjpm)进行开发。

安装步骤：

1. 访问仓颉官网下载页面
2. 根据系统架构选择对应版本：
   • 长期稳定版本(LTS)：适合生产环境使用
   • 稳定版本(STS)：每半年更新的较稳定版本
3. 下载完成后运行安装程序
4. 配置环境变量
5. 验证安装：终端执行cj --version查看版本信息

1.2 鸿蒙版本安装

鸿蒙版本目前处于内测阶段，需申请内测权限后方可使用。

安装步骤：

1. 申请内测权限
2. 下载DevEco仓颉插件
3. 在DevEco Studio中安装插件
4. 重启IDE完成配置

2. 项目使用说明

2.1 开发环境配置

通用版本：

• 推荐使用VSCode作为代码编辑器
• 安装仓颉语言扩展插件
• 配置cjpm包管理工具

鸿蒙版本：

• 使用DevEco Studio作为开发环境
• 确保已安装鸿蒙SDK
• 配置鸿蒙设备模拟器或真机调试环境

2.2 项目创建

通用版本项目：

cjpm init <项目名称>
cd <项目名称>
cjpm build

鸿蒙应用项目：

1. 在DevEco Studio中选择"新建鸿蒙项目"
2. 选择仓颉语言模板
3. 配置项目基本信息
4. 完成创建

3. API使用文档

3.1 核心API

基础数据类型：

• Int：整型数据
• Float：浮点型数据
• String：字符串类型
• Bool：布尔类型

集合类型：

• Array：动态数组
• Map：键值对集合
• Set：无序不重复集合

3.2 并发编程API

轻量级线程：

thread := Thread.new {
    // 线程执行体
}
thread.start()

协程支持：

async func demo() {
    // 异步操作
}

3.3 UI组件API（鸿蒙版本）

基础组件：

• Text：文本显示组件
• Button：按钮组件
• Image：图片显示组件

布局组件：

• Column：纵向布局
• Row：横向布局
• Stack：层叠布局

4. 项目安装方式

4.1 通用版本安装方式

Windows系统：

1. 下载.exe安装包
2. 双击运行安装向导
3. 勾选"添加环境变量"选项
4. 完成安装

macOS系统：

brew tap cangjie-lang/cangjie
brew install cangjie

Linux系统：

curl -fsSL https://cangjie-lang.cn/install.sh | bash

4.2 鸿蒙版本安装方式

1. 确保已安装DevEco Studio 3.1及以上版本
2. 通过IDE插件市场搜索"仓颉"插件
3. 点击安装并重启IDE
4. 在新建项目时选择仓颉语言模板

4.3 验证安装

通用版本：

cj --version
cjpm --help

鸿蒙版本：

1. 创建测试项目
2. 构建并运行示例程序
3. 检查设备或模拟器上的运行效果