【仓颉三方库】数据解析——【protobuf-cj】

最新推荐文章于 2024-08-14 23:11:00 发布

小奶狗-旺旺

最新推荐文章于 2024-08-14 23:11:00 发布

阅读量680

点赞数 15

分类专栏：移动开发 HarmonyOS 鸿蒙文章标签：数据库鸿蒙架构

本文链接：https://blog.csdn.net/xiaonagou/article/details/141168021

版权

移动开发同时被 3 个专栏收录

39 篇文章 0 订阅

订阅专栏

HarmonyOS

39 篇文章 0 订阅

订阅专栏

鸿蒙

39 篇文章 0 订阅

订阅专栏

介绍

当前基于cangjie v0.53.4

特性

🚀 支持 Google Protocol Buffers

软件架构

架构

软件目前主要分为 protobuf, protoc 两个部分

protobuf 提供 libprotobuf-cj.a, 在仓颉中使用 Google Protocol Buffers 需要链接该静态库
protoc 提供 protoc-gen-cj, 一个 google protoc 的 plugin, 用于将.proto 文件编译为仓颉代码

 protobuf:
 - abstract class MessageLite <: ToString: 定义了messages的通用操作, proto中定义的message均继承MessageLite.
 - interface Enum<E>: 定义了仓颉 enum 和 C 风格 enum 之间"映射"关系的接口, protobuf enum 实现这些接口, 从而在语言之交换 enum 信息

 protoc(protoc-gen-cj):
 - 从 stdin 读取二进制数据解析为 CodeGeneratorRequest, 根据该请求组织生成仓颉代码, 写入CodeGeneratorResponse, 打包并输出到 stdout

源码目录

.
├── README.md
├── doc
│   ├── assets
│   ├── design.md
│   ├── feature_api.md
├── ci_test
├── src
│   ├── google
│   ├── protobuf
│   ├── protoc
└── test
    ├── HLT
    ├── LLT
    └── UT

doc 存放库的设计文档、提案、库的使用文档、LLT 用例覆盖报告(此项目不支持 cpm build 编译，而覆盖率需要 cpm build --coverage,所以未能输出覆盖报告)
ci_test 是python源码目录
src 是库源码目录
test 存放测试用例，包括 HLT 用例、LLT 用例和 UT 用例

接口说明

主要是核心类和成员函数说明见 API

编译执行

示例

example.proto 文件内容

syntax = "proto3";
package foo;

message Person {
    string name = 1;
    int32 id = 2;
    string email = 3;
}

示例

import collection.*
import io.*
import foo.* // The foo package is generated by the protobuf-gen-cj plugin.

main() {
    var p = Person()
    // parameter assignment
    p.name = "test"
    p.id = 1
    p.email = "test@huawei.com"
    // print
    println("Serialize to string: ${p}")
    // encode
    var b = p.pack()
    println("Serialize result: ${b}")
    // decode
    var p1 = Person.fromBytes(b)
    println("Deserialization result: ${p1}")
    return
}

安装教程

安装对应版本cangjie
设置CANGJIE_PATH为合法目录，作为.cjo文件的安装目录
安装google protobuf compiler
编译&安装protobuf-cj库、protoc-gen-cj插件(见使用说明1-4)

使用说明

cd protobuf-cj
git submodule update --init --recursive 拉取依赖库
make 编译*.a、*.cjo、protoc-gen-cj
make install 安装*.a、*.cjo、protoc-gen-cj
protoc --cj_out=src/ -Isrc/ $(proto_files) 编译proto_files生成*.pb.cj文件
在项目中使用protobuf messages, 使用时导入*.pb.cj所在包, 编译时添加-lprotobuf-cj选项

若依赖库拉取失败，需要将依赖库手动拷贝到对应目录下，git submodule可以查看所有依赖库

约束与限制

1.支持的标量数值类型double、float、int32、int64、uint32、uint64、sint32、sint64、fixed32、fixed64、sfixed32、sfixed64、bool、string、bytes。

2.当前版本基于 Google Protocol Buffers V21.5 版本开发，需要符合对应版本协议的proto书写规范

开源协议

总是有很多小伙伴反馈说：鸿蒙开发不知道学习哪些技术？不知道需要重点掌握哪些鸿蒙应用开发知识点？ 为了解决大家这些学习烦恼。在这准备了一份很实用的鸿蒙（HarmonyOS NEXT）学习路线与学习文档给大家用来跟着学习。

针对一些列因素，整理了一套纯血版鸿蒙（HarmonyOS Next）全栈开发技术的学习路线，包含了鸿蒙开发必掌握的核心知识要点，内容有（ArkTS、ArkUI开发组件、Stage模型、多端部署、分布式应用开发、WebGL、元服务、OpenHarmony多媒体技术、Napi组件、OpenHarmony内核、OpenHarmony驱动开发、系统定制移植等等）鸿蒙（HarmonyOS NEXT）技术知识点。

本路线共分为四个阶段：

第一阶段：鸿蒙初中级开发必备技能

请添加图片描述

第二阶段：鸿蒙南北双向高工技能基础：`gitee.com/MNxiaona/733GH`

请添加图片描述

第三阶段：应用开发中高级就业技术

在这里插入图片描述

第四阶段：全网首发-工业级南向设备开发就业技术：`gitee.com/MNxiaona/733GH`

《鸿蒙 (Harmony OS)开发学习手册》（共计892页）

如何快速入门？

1.基本概念
2.构建第一个ArkTS应用
3.……

在这里插入图片描述

开发基础知识:`gitee.com/MNxiaona/733GH`

1.应用基础知识
2.配置文件
3.应用数据管理
4.应用安全管理
5.应用隐私保护
6.三方应用调用管控机制
7.资源分类与访问
8.学习ArkTS语言
9.……

在这里插入图片描述

基于ArkTS 开发

1.Ability开发
2.UI开发
3.公共事件与通知
4.窗口管理
5.媒体
6.安全
7.网络与链接
8.电话服务
9.数据管理
10.后台任务(Background Task)管理
11.设备管理
12.设备使用信息统计
13.DFX
14.国际化开发
15.折叠屏系列
16.……

鸿蒙开发面试真题（含参考答案）:`gitee.com/MNxiaona/733GH`

在这里插入图片描述

OpenHarmony 开发环境搭建

《OpenHarmony源码解析》:gitee.com/MNxiaona/733GH

搭建开发环境
系统架构分析

构建子系统
启动流程
子系统
分布式任务调度子系统
分布式通信子系统
驱动子系统
……

OpenHarmony 设备开发学习手册

项目实战开发教学：`gitee.com/MNxiaona/733GH`

在这里插入图片描述

写在最后

如果你觉得这篇内容对你还蛮有帮助，我想邀请你帮我三个小忙：
点赞，转发，有你们的『点赞和评论』，才是我创造的动力。
关注小编，同时可以期待后续文章ing🚀，不定期分享原创知识。
想要获取更多完整鸿蒙最新学习资源，请移步前往小编：gitee.com/MNxiaona/733GH

小奶狗-旺旺

关注

15
点赞
踩
21

收藏

觉得还不错? 一键收藏
0
评论
【仓颉三方库】数据解析——【protobuf-cj】

doc 存放库的设计文档、提案、库的使用文档、LLT 用例覆盖报告(此项目不支持 cpm build 编译，而覆盖率需要 cpm build --coverage,所以未能输出覆盖报告)
复制链接

扫一扫