智能客服
你问我答，随时在线为你解决问题
- 探索了解鸿蒙应用和多设备开发，学习如何构建应用/元服务应用形态HarmonyOS 应用One as All，All as One
元服务秒开直达 服务随行 无处不在
游戏为游戏创意玩法带来无限可能
多设备应用开发穿戴
折叠屏手机鸿蒙电脑开发者学堂视频课程Codelabs - 设计了解鸿蒙应用和多设备开发，学习如何构建应用/元服务
- 开发获取官方开发工具和文档等资源，将创意转化为鸿蒙应用开发工具DevEco Studio应用开发 IDE, AI Agent 和 CLI
小艺开放平台Skill 和智能体开发平台
ArkTS
ArKUI
AppGallery ConnectDevEco Testing开发资源工具下载示例代码开发文档最佳实践 - 分发通过华为应用市场发布你的应用，多渠道触达用户应用分发应用市场纯净安全的全场景应用分发平台
游戏中心
应用审核政策服务分发小艺HarmonyOS 的超级 AI 入口
智慧助手·今天
服务分发文档内容分发主题服务
内容分发文档 - 推广与变现一站式流量增长与营销变现平台推广应用推广引擎全链路应用推广与增长服务平台
鲸鸿动能广告为企业广告主提供广告营销服务
联运服务推广文档变现鲸鸿动能流量变现使能应用展示广告，实现流量变现应用内支付变现文档 - 生态合作携手伙伴共建共享鸿蒙智能终端生态伙伴 SDK一站式获取安全可靠的鸿蒙伙伴 SDK
生态服务鸿蒙应用开发、培训和人力服务
服务商伙伴中心华为终端云服务商伙伴的统一门户
伙伴入驻指南生态市场介绍，卖家和买家服务指引
廉洁政策合作伙伴诚信廉洁政策
- 支持获取客服帮助、技术支持、活动资讯等信息智能客服24小时 AI 在线自助服务，即问即答
社区问答在官方论坛提问，与开发者互动交流
在线提单提交工单，获得技术支持
开发者活动HDD 等线下活动速览及报名入口
资讯帮助指南
全部文档
指南
API
开放能力API
应用框架
系统
媒体
图形
应用服务
AI
NDK开发
本文导读
Binary Sign Tool（二进制签名工具），用于对二进制文件进行代码签名，支持通过命令行的方式对标准ELF文件进行代码签名或打印已签名ELF的权限、证书信息。
命令行工具获取
支持运行在Linux平台的工具：下载最新的Command Line Tools，可以在SDK库openHarmony/toolchains/lib中找到，文件名为binary-sign-tool。
支持运行在HarmonyOS PC/2in1平台的工具：从应用商店下载安装DevBox软件，无需额外配置，即可在终端窗口中执行binary-sign-tool命令。
支持运行在Java平台的工具：下载API 24及以上版本的Command Line Tools，可以在SDK库openHarmony/toolchains/lib中找到，文件名为binary-sign-tool.jar。此工具运行要求JDK 8及以上版本。
二进制签名工具命令列表
展开
| 命令 | 描述 |
|---|---|
| help | 帮助命令，用于查询工具支持的命令信息。 |
| sign | 二进制文件签名。 |
| display-sign | 打印文件签名证书信息。 |
帮助命令（help）
# Java版本命令样例： java -jar binary-sign-tool.jar -help # C++版本命令样例： binary-sign-tool -help
签名命令（sign）
使用证书签名或自签名方式对二进制文件进行签名，有关如何申请二进制证书可参考：申请二进制证书。
命令参数列表
展开
| 参数 | 参数说明 |
|---|---|
| -keyAlias | 密钥别名，证书签名时为必填项，不区分大小写。 |
| -keyPwd | 密钥口令，可选项。 |
| -appCertFile | 签名证书文件（证书链，顺序为实体证书-中间CA证书-根证书），证书签名时为必填项。 |
| -signAlg | 签名算法，必填项，包括SHA256withECDSA或SHA384withECDSA。 |
| -keystoreFile | 密钥库文件，证书签名时为必填项。 |
| -keystorePwd | 密钥库口令，可选项。 |
| -inFile | 输入的原始elf文件，必填项。 |
| -outFile | 输出签名后文件，必填项。 |
| -moduleFile | 权限module.json文件，可选项。 |
| -selfSign | 是否自签名模式，1表示自签名，0表示证书签名，默认为0，可选项。 |
示例：
# 1. 使用证书对二进制文件签名 # 注意：keyAlias,appCertFile,keystoreFile,keyPwd,keystorePwd替换为自己的证书和密钥 # Java版本命令样例： java -jar binary-sign-tool.jar sign -keyAlias "test" -signAlg "SHA256withECDSA" -appCertFile "test.cer" -inFile "unsigned-elf" -keystoreFile "test.p12" -outFile "signed-elf" -keyPwd "123456" -keystorePwd "123456" -moduleFile "module.json" # C++版本命令样例： binary-sign-tool sign -keyAlias "test" -signAlg "SHA256withECDSA" -appCertFile "test.cer" -inFile "unsigned-elf" -keystoreFile "test.p12" -outFile "signed-elf" -keyPwd "123456" -keystorePwd "123456" -moduleFile "module.json" # 2. 自签名模式对二进制文件签名 # Java版本命令样例： java -jar binary-sign-tool.jar sign -inFile "unsigned-elf" -outFile "signed-elf" -selfSign "1" # C++版本命令样例： binary-sign-tool sign -inFile "unsigned-elf" -outFile "signed-elf" -selfSign "1" # 执行结果 write code sign data success.
打印签名证书信息命令（display-sign）
命令参数列表
展开
| 参数 | 参数说明 |
|---|---|
| -inFile | 输入的elf文件，必填项。 |
示例：
# Java版本命令样例： java -jar binary-sign-tool.jar display-sign -inFile "signed-elf" # C++版本命令样例： binary-sign-tool display-sign -inFile "signed-elf" # 执行结果 # 权限信息输出 # 1. 无权限信息 permission is not found # 2. 输出权限信息 # 签名信息输出 # 1. 无代码签名 code signature is not found # 2. 自签名模式 code signature is self-sign # 3. 输出签名证书
错误信息
FILE_NOT_FOUND
错误描述
执行命令，报错提示：ERROR - FILE_NOT_FOUND, code: -102. Details: The 'test.p12' file does not exist or the path is invalid, parameter name '-keystoreFile'
可能原因
输入文件不存在或路径不正确。
处理步骤
检查输入文件路径或文件名是否正确。
COMMAND_PARAM_ERROR
错误描述
执行命令，报错提示：ERROR - COMMAND_PARAM_ERROR, code: -107. Details: 'generate-cert' Parameters error, Param key - value must in pairs
可能原因
- 粘贴命令时，多粘贴了一段内容，导致出现COMMAND_PARAM_ERROR错误。
- 填写命令时，如果最后一个参数的value值未填写，将导致COMMAND_PARAM_ERROR错误。
处理步骤
检查并修正命令中的多余或错误部分。
KEY_PASSWORD_ERROR
错误描述
执行命令，报错提示：ERROR - KEY_PASSWORD_ERROR, code: -114. Details: 'test' keypair password error
可能原因
当密钥对密码错误时，会导致KEY_PASSWORD_ERROR错误。
处理步骤
检查命令中的密码参数是否正确。确保访问不同密钥库时，填写各自的密钥对密码。
NOT_SUPPORT_ERROR
错误描述
执行命令，报错提示：ERROR - NOT_SUPPORT_ERROR, code: -104. Details: Not support file: ./test.p12
可能原因
填写错误的密钥库文件类型会导致NOT_SUPPORT_ERROR错误。
处理步骤
确保密钥库文件的后缀为 .p12。
KEY_ALIAS_ERROR
错误描述
执行命令，报错提示：ERROR - KEY_ALIAS_ERROR, code: -109. Details: 'XXX' key alias already exists and cannot be generated repeatedly
可能原因
密钥库中已存在该别名的密钥对，将导致KEY_ALIAS_ERROR错误。
处理步骤
替换需要生成密钥对的别名为其他名称。
SIGN_ERROR
错误描述
执行命令后，报错提示：ERROR - SIGN_ERROR, code: -105. Details: No certificates configured for sign
可能原因
签名密钥与实体证书不匹配。
处理步骤
- 检查keyAlias密钥是否使用正确。
- 检查appCertFile是否使用正确，确保密钥与证书匹配。
华为开发者联盟 版权所有 ©2026
在 开发与测试 开放能力API 中进行搜索
请输入您想要搜索的关键词