第一个鸿蒙仓颉应用

第一个鸿蒙仓颉应用

本文档适用于仓颉应用开发的初学者。通过创建和运行初始化的项目，快速了解工程目录的主要文件，熟悉仓颉应用开发流程。

开发环境准备

IDE下载与安装

在开始开发之前，需要先准备开发环境：

1. 下载DevEco Studio IDE
   • 访问华为开发者官网下载最新版本的DevEco Studio
   • 如果没有开发者账号，需要先申请注册

IDE下载页面

IDE下载页面

1. 安装仓颉插件
   • 下载完成后，从本地安装IDE插件
   • 确保插件版本与IDE版本兼容

插件安装界面

插件安装界面

1. 重启IDE
   • 安装成功后需要重启IDE以确保插件生效
   • 重启后可以在新建项目时看到仓颉相关模板

创建仓颉项目

步骤一：新建项目

1. 启动DevEco Studio
   • 若首次打开DevEco Studio，请单击Create Project创建工程
   • 如果已经打开了一个工程，请在菜单栏选择File > New > Create Project来创建一个新工程
2. 选择项目模板
   • 选择Application应用开发
   • 选择模板**[Cangjie] Empty Ability**
   • 单击Next进行下一步配置

项目模板选择

项目模板选择

步骤二：配置项目信息

1. 配置工程参数
   • 进入配置工程界面，可以修改工程名称和存储路径等工程的基本信息
   • 也可以保持默认设置
   • 确保项目名称符合命名规范
2. 完成项目创建
   • 单击Finish，工具会自动生成示例代码和相关资源
   • 等待工程创建完成

项目签名配置

签名问题解决

创建项目后，如果直接运行会遇到签名错误：

08:19:50.929: Launching com.nutpi.cangjiedemp
08:19:50.930: $ hdc shell aa force-stop com.nutpi.cangjiedemp
08:19:51.207: $ hdc shell mkdir data/local/tmp/e4f5714c783d4fb99b4ab804bca7d8a3
08:19:51.551: $ hdc file send /Users/jianguo/Desktop/cangjie/demo/cangjiedemo/entry/build/default/outputs/default/entry-default-unsigned.hap "data/local/tmp/e4f5714c783d4fb99b4ab804bca7d8a3" in 344 ms
08:19:51.705: $ hdc shell bm install -p data/local/tmp/e4f5714c783d4fb99b4ab804bca7d8a3 in 153 ms
Install Failed: error: failed to install bundle.
code:9568320
error: no signature file.
Open signing configs
08:19:51.752: $ hdc shell rm -rf data/local/tmp/e4f5714c783d4fb99b4ab804bca7d8a3
08:19:51.752: Launch com.nutpi.cangjiedemp failed, starting handle failure progress
Error while Deploy Hap

错误原因：鸿蒙应用需要签名才能安装到设备上。

配置签名

1. 打开签名配置
   • 在项目根目录的build-profile.json5文件中配置签名信息
   • 或者通过IDE的签名配置界面进行设置

签名配置界面

签名配置界面

1. 设置签名参数
   • 配置签名证书路径
   • 设置签名密码
   • 选择签名算法

签名参数设置

签名参数设置

1. 验证签名配置
   • 配置完成后，重新运行项目
   • 项目应该能够成功安装到设备上

项目运行成功

项目运行成功

仓颉工程目录结构

项目结构概览

仓颉工程目录结构如下所示：

cangjiedemo
├── 📁 AppScope
│   ├── 📁 resources
│   │   └── 📁 base
│   └── 📄 app.json5
├── 📁 entry
│   ├── 📁 src
│   │   └── 📁 main
│   ├── 📄 .gitignore
│   ├── 📄 build-profile.json5
│   ├── 📄 hvigorfile.ts
│   └── 📄 oh-package.json5
├── 📁 hvigor
│   ├── 📄 cangjie-build-support-3.1.132.tgz
│   └── 📄 hvigor-config.json5
├── 📄 .gitignore
├── 📄 build-profile.json5
├── 📄 code-linter.json5
├── 📄 hvigorfile.ts
├── 📄 oh-package-lock.json5
└── 📄 oh-package.json5

关键文件说明

应用级配置文件

• AppScope > app.json5：应用的全局配置信息，包括应用名称、版本号、权限等
• build-profile.json5：应用级配置信息，包括签名、产品配置等
• hvigorfile.ts：应用级编译构建任务脚本
• oh-package.json5：主要用来描述全局配置，如依赖覆盖、依赖关系重写和参数化配置等

模块级配置文件

• entry：仓颉工程模块，编译构建生成一个HAP包
  • src > main > cangjie：用于存放仓颉源码
  • src > main > cangjie > cjpm.toml：仓颉的包管理配置文件
  • src > main > resources：用于存放应用/服务所用到的资源文件，如图形、多媒体、字符串、布局文件等
  • src > main > module.json5：stage模块配置文件，主要包含HAP的配置信息、应用在具体设备上的配置信息以及应用的全局配置信息
  • build-profile.json5：当前的模块信息、编译信息配置项，包括buildOption、targets配置等
  • hvigorfile.ts：模块级编译构建任务脚本
  • oh-package.json5：用来描述包名、版本、入口文件（类型声明文件）和依赖项等信息

构建工具配置

• hvigor：用于存放当前工程使用的hvigor
  • cangjie-build-support-x.y.z-cj.x.tgz：仓颉指定的hvigor任务包
  • hvigor-config.json5：指定工程全局使用的hvigor以及hvigor参数配置
• oh_modules：用于存放三方库依赖信息，包含应用/服务所依赖的第三方库文件

开发注意事项

1. 签名管理

• 开发阶段可以使用调试签名
• 发布前必须使用正式签名证书
• 定期更新签名证书

2. 资源管理

• 资源文件应放在对应的资源目录下
• 遵循鸿蒙资源命名规范
• 注意不同设备的资源适配

3. 依赖管理

• 使用cjpm.toml管理仓颉包依赖
• 使用oh-package.json5管理鸿蒙模块依赖
• 定期更新依赖版本

4. 构建配置

• 根据目标设备配置不同的构建选项
• 优化构建脚本提高编译效率
• 配置代码检查规则

总结

通过以上步骤，您已经成功创建了第一个鸿蒙仓颉应用项目。现在您应该对以下内容有了基本了解：

1. 开发环境搭建：IDE下载、插件安装、环境配置
2. 项目创建流程：模板选择、参数配置、项目生成
3. 签名配置：解决运行时的签名问题
4. 项目结构：理解各个目录和文件的作用
5. 开发规范：掌握基本的开发注意事项

接下来您可以开始编写仓颉代码，开发您的第一个鸿蒙应用功能。