1# 系统能力编解码工具 2 3系统能力(SystemCapability, 本文中使用SysCap缩写)编解码工具应用场景如下： 4 5应用开发时，IDE会根据应用配置的SysCap和API版本生成描述RPCID(Required Product Compatibility ID)的json文件，并调用编解码工具syscap_tool将该json文件编码成RPCID。另一方面，IDE拿到开发者导入PCID(Product Compatibility ID)，使用该工具解码出设备的SysCap集合。该工具仅供IDE使用，对用户不可见。 6 7提供的主要功能： 8 91. PCID编码：对描述SysCap集合的文件编码生成PCID。 10 112. PCID解码：对编码后的PCID文件解码获取SysCap集合。 12 133. RPCID编码：对描述应用所需的SysCap集合的文件编码生成RPCID。 14 154. RPCID解码：对编码后的RPCID文件解码获取应用所需的SysCap集合。 16 17## 目录 18 19``` 20/developtools 21├── syscap_codec # syscap codec代码目录 22│ ├── include 23│ │ └── syscap_tool.h # syscap_tool_shared对外接口定义 24│ ├── src 25│ │ ├── endian_internel.h # 内部实现的大小端转换接口定义(便于win、mac、linux平台通用) 26│ │ ├── endian_internel.c # 大小端转换实现 27│ │ ├── main.c # syscap_tool命令行工具代码实现 28│ │ └── syscap_tool.c # syscap_tool编解码接口的实现 29│ └── test 30│ └── syscap_tool_test.c # syscap_tool功能测试代码实现 31``` 32 33### API 34 35PC端工具，不对外提供API。 36 37### PC端编译说明 38 39syscap_tool PC端可执行文件编译步骤： 40 411. 编译命令：参考https://gitee.com/openharmony/build/blob/master/README_zh.md ，执行其指定的sdk编译命令来编译整个sdk， syscap_tool会被编译打包到里面。 42 432. 编译：在目标开发机上运行上面调整好的sdk编译命令， 正常编译syscap_tool会输出到sdk平台相关目录下。 44 45注意： ubuntu环境下只能编译windows/linux版本工具，mac版需要在macos开发机上编译。 46 47### PC端获取说明 48 491. 下载sdk获取(建议) 50 51通过访问本社区网站http://ci.openharmony.cn/dailybuilds ，下载sdk压缩包，从中根据自己平台到相应的目录toolchain下解压提取。 52 532. 支持运行环境 54 55Windows x86_64/Linux x86_64/Darwin x86_64 56 57### 命令帮助 58 59本工具一般被IDE、应用市场和包管理器集成，手工调试时可参考以下说明。 60 61使用./syscap_tool -h或者./syscap_tool --help查看： 62``` 63./syscap_tool --help 64 65./syscap_tool -R/P -e/d -i filepath [-o outpath] 66 67-h, --help : how to use 68 69-R, --RPCID : encode or decode RPCID 70 71-P, --PCID : encode or decode PCID 72 73-e, --encode : to encode 74 75-d, --encode : to decode 76 77-i filepath, --input filepath : input file 78 79-o outpath, --input outpath : output path 80``` 81 82### Release Note 83 84v1.0.0 2022-3-8 首版本，提供Windows/Linux/Mac平台的系统能力编解码。