【仓颉】创建静态库及使用

作者：乔汝嘉 团队：坚果派

前言

“仓颉编程语言是一款面向全场景智能的新一代编程语言，主打原生智能化、天生全场景、高性能、强安全。融入鸿蒙生态，为开发者提供良好的编程体验。” ——摘自仓颉首页[1] 本文将逐步实现仓颉静态库的创建和使用，使用的当前版本为0.51.4。

前置条件

关于Win11 + VSCode的开发环境，请参考这篇文章[2]

创建静态库项目

1. 在VSCode中使用快捷键ctrl + shift + p
2. 在上方的输入框中搜索Create Cangjie Project并选择
3. 选择Create CJNative Cangjie Project
4. 选择Create Static Output Cangjie Project
5. 在弹出的文件夹选择窗里选择工程存放的目录
6. 回到之前界面，在上方输入框中输入工程的名称statictest，并回车
7. 在左侧目录结构中找到src -> demo.cj，文件中只有一行默认的注释// You can write Cangjie code here.
8. 如图声明包名package statictestpack并在下方简单的创建一个方法cjadd()，用于做加法

1. 点击代码右上方三角按钮运行项目
2. 可以看到左侧目录中多了taget -> release -> statictest目录。里面有打包好的.a文件等。
3. 库的名称statictest是创建工程的时候设定的。另外可以看到项目根目录中的cjpm.toml中name字段。这个字段的值设置了三方库的名称。

在另一个工程中引用

1. 打开需要引入这个statictest库的项目。这里取[上一篇]((https://ost.51cto.com/posts/29298 "上一篇"))的helloworld项目
2. 在文件目录下方找到另一个工具栏CANGJIE LIBRARY，在这里可以方便的设置三方库的引用

1. CANGJIE LIBRARY中的dependencies右侧有个加号，点击它
2. 找到我们之前创建的statictest项目的目录，并选择

1. 插件会提示cjpm.toml文件已更改，是否重启LSPServer，选Yes来同步一下工程。由此我们可知，这一部分的界面操作，实质是在对cjpm.toml配置文件的更改。如果你很熟悉这个文件，也可以手动修改cjpm.toml配置文件
2. 可以看到添加完成之后dependencies多了一个依赖库的记录。

1. 在helloworld项目的代码中引用库里的方法。main.cj的第一行写from statictest import statictestpack.*。这里为了区分名称，我在之前写库的时候，包名和库名特地写成了不一样的。还记得吗？statictest是库工程中cjpm.toml的name字段。statictestpack是库项目中，demo.cj开头声明的package。
2. 这样引入刚才的静态库之后，就可以在下方的代码中调用cjadd()方法了。
3. 点击helloworld工程的运行按钮，看到代码下方TERMINAL中的运行结果：1加2等于3。

参考资料

[1]

仓颉首页: https://developer.huawei.com/consumer/cn/cangjie

[2]

这篇文章: https://ost.51cto.com/posts/29298