OpenHarmony网络协议通信—nanopb

简介

nanopb是一种小代码量的协议缓冲区实现，适用于任何内存受限的系统。

下载安装

直接在OpenHarmony-SIG仓中搜索nanopb并下载。

使用说明

以OpenHarmony 3.1 Beta的rk3568版本为例

1. 将下载的Nanopb库代码存在以下路径：./third_party/nanopb

2. 修改添加依赖的编译脚本，路径：/developtools/bytrace_standard/ohos.build

{
  "subsystem": "developtools",
  "parts": {
    "bytrace_standard": {
      "module_list": [
        "//developtools/bytrace_standard/interfaces/innerkits/native:bytrace_core",
        "//developtools/bytrace_standard/bin:bytrace_target",
        "//developtools/bytrace_standard/bin:bytrace.cfg",
        "//developtools/bytrace_standard/interfaces/kits/js/napi:bytrace",
        "//third_party/nanopb:protobuf-nanopb",
        "//third_party/nanopb:hiperf_nanopb_test"
      ],
      "inner_kits": [
        {
          "type": "so",
          "name": "//developtools/bytrace_standard/interfaces/innerkits/native:bytrace_core",
          "header": {
            "header_files": [
              "bytrace.h"
            ],
            "header_base": "//developtools/bytrace_standard/interfaces/innerkits/native/include"
          }
        }
      ],
      "test_list": [
        "//developtools/bytrace_standard/bin/test:unittest"
      ]
    }
  }
}

3. 编译：./build.sh --product-name rk3568 --ccache

4. 生成库文件和一些可执行测试文件，路径：out/rk3568/developtools/profiler

接口说明

1. 从流中获取当前错误消息，如果没有错误消息，则获取占位符字符串：
   PB_GET_ERROR()
2. 设置错误消息并返回false：
   PB_RETURN_ERROR()
3. 构造输出流以写入内存缓冲区：
   pb_ostream_from_buffer()
4. 将数据写入输出流：
   pb_write()
5. 将结构的内容编码为协议缓冲区消息，并将其写入输出流：
   pb_encode()
6. 使用标志设置的扩展行为对消息进行编码：
   pb_encode_ex()
7. 计算编码消息的长度：
   pb_get_encoded_size()
8. 以varint格式对有符号或无符号整数进行编码。适用于类型为bool、enum、int32、int64、uint32和uint64的字段：
   pb_encode_varint()
9. 将字符串的长度写入变量，然后写入字符串的内容。适用于字节和字符串类型的字段：
   pb_encode_string()
10. 将4个字节写入流，并在big-endian体系结构上交换字节。适用于fixed32、sfixed32和float类型的字段：
    pb_encode_fixed32()
11. 将8个字节写入流，并在big-endian体系结构上交换字节。适用于fixed64、sfixed64和double类型的字段：
    pb_encode_fixed64()
12. 对32位浮点值进行编码，使其在编码消息中显示为64位双精度：
    pb_encode_float_as_double()
13. 对子消息字段进行编码，包括其大小标头：
    pb_encode_submessage()
14. 创建从内存缓冲区读取数据的输入流helper函数：
    pb_istream_from_buffer()
15. 从输入流读取数据：
    pb_read()
16. 读取和解码结构的所有字段：
    pb_decode()
17. 与pb_decode相同，但允许扩展选项：
    pb_decode_ex()
18. 释放任何动态分配的字段：
    pb_release()
19. 从流中删除字段的数据，而不进行实际解码：
    pb_skip_field()
20. 读取并解码可变编码整数：
    pb_decode_varint()
21. 与pb_decode_varint相同，但将值限制为32位：
    pb_decode_varint32()
22. 解码fixed32、sfixed32或浮点值：
    pb_decode_fixed32()
23. 解码fixed64、sfixed64或double值：
    pb_decode_fixed64()
24. 将64位双精度值解码为32位浮点变量：
    pb_decode_double_as_float()
25. 使用导线类型PB\U WT\U字符串解码字段的长度，并创建用于读取数据的子流：
    pb_make_string_substream()
26. 关闭使用pb_make_string_substream创建的子流：
    pb_close_string_substream()
27. 开始迭代消息类型中的字段：
    pb_field_iter_begin()
28. 前进到消息中的下一个字段：
    pb_field_iter_find()
29. 验证UTF8编码的字符串：
    pb_validate_utf8()

兼容性

支持OpenHarmony API version 8 及以上版本。

目录结构

|---- nanopb
|     |---- docs                          #数据文件
|     |---- examples
|           |---- cmake_relpath           #使用CMake的Nanopb示例
|           |---- cmake_simple            #使用CMake的Nanopb示例
|           |---- network_server          #使用nanopb通过网络进行通信连接示例
|           |---- simple                  #Nanopb简单示例
|           |---- using_double_on_avr     #在avr编译器上使用双精度数据类型的Nanopb示例
|           |---- using_union_messages    #使用union消息的Nanopb示例
|     |---- tests                         #测试文件
|     |---- tools                         #不同系统打包工具
|     |---- pb.h                          #nanopb库的常见部分
|     |---- pb_common.c                   #pb_encode.c和pb_decode.c的通用支持功能
|     |---- pb_common.h                   #pb_encode.c和pb_decode.c的通用支持功能
|     |---- pb_decode.c                   #使用最少的资源解码protobuf
|     |---- pb_decode.h                   #用于解码协议缓冲区的函数
|     |---- pb_encode.c                   #使用最少的资源对protobuf进行编码
|     |---- pb_encode.h                   #对协议缓冲区进行编码的函数
|     |---- README.md                     #安装使用方法

为了能让大家更好的学习鸿蒙（HarmonyOS NEXT）开发技术，这边特意整理了《鸿蒙开发学习手册》（共计890页），希望对大家有所帮助：https://qr21.cn/FV7h05

《鸿蒙开发学习手册》：

如何快速入门：https://qr21.cn/FV7h05

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

开发基础知识：https://qr21.cn/FV7h05

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

基于ArkTS 开发：https://qr21.cn/FV7h05

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

鸿蒙开发面试真题（含参考答案）：https://qr18.cn/F781PH

鸿蒙开发面试大盘集篇（共计319页）：https://qr18.cn/F781PH

1.项目开发必备面试题
2.性能优化方向
3.架构方向
4.鸿蒙开发系统底层方向
5.鸿蒙音视频开发方向
6.鸿蒙车载开发方向
7.鸿蒙南向开发方向