一、工具介绍
为方便用户快速集成到自动化任务中，乐固加固推出命令行工具。该工具是一个jar包（支持基础版、专业版、企业版），提供上传apk、下载加固包功能。下载的加固包需要用户重新签名才能正常运行。
该工具需要java环境，java环境安装教程可以参考Java sdk安装及配置
另外，如果需要jar包和jenkins配合使用请参考这篇文章：jenkins android使用加固打包说明
二、参数介绍
参考命令：
java -Dfile.encoding=utf-8 -jar ms-shield.jar -sid SecretId -skey SecretKey -uploadPath c:/apk/sample.apk -downloadPath c:/apk/result/
参数介绍：
| 参数 | 说明 |
|---|---|
| -downloadPath |
加固后apk的路径，必选参数。请务必保证路径可写权限 |
| -downloadType |
下载类型，可选参数。默认是file，将自动下载文件，url打印加固后的url |
| -proxy |
代理地址，可选参数。设置形如https://dev.proxy.oa.com:8080 |
| -sid |
SecretId，必选参数。 |
| -skey |
SecretKey，必选参数。 |
| -uploadMd5 |
待加固文件的md5，可选参数。如果uploadType为url，该参数必须 |
| -uploadPath |
待加固apk文件的路径，必选参数。-uploadType为file时候制定本地待加固apk文件的路径；-uploadType为url时候指定远程apk文件url |
| -uploadType |
待加固文件类型，可选参数。默认是file，其他可选url |
注意
如果上传apk的文件名是sample.apk，下载加固后的apk为sample_legu.apk；
如果上传apk的类型地址url，下载加固后apk为my_legu.apk；
如果downloadType为url，会打印出加固包下载链接；
sid和skey来自腾讯云账号，注册腾讯云账号后需要单独申请。
申请地址：https://console.cloud.tencent.com/cam/capi
白名单的应用需要走-uploadType file;
三、错误码
jar包的错误码：
| 错误码 | 说明 | 解决办法 |
|---|---|---|
| 40301 | 上传类型应该为file或url | uploadType只能是file或者url |
| 40302 | apk大小超过1G | 确认大小是否超过限制 |
| 40303 | 上传apk不存在或不是apk | 确认是否是有效apk |
| 40304 | 上传url不正确 | 确认是否是有效url |
| 40305 | 下载类型应该为file或url | downloadType只能是file或者url |
| 40306 | 下载路径异常或无读写权限 | 确认下载输出目录正常，且可访问 |
| 40307 | 检查id和key是否正确 | 在腾讯云官网确认账号信息 |
| 40308 | 网络超时,检查网络,代理或其他 | 确认网络是否正常 |
| 40309 | 加固处理出错 | 服务端返回数据，请尝试重新加固 |
| 40310 | 加固处理超时 | 服务端返回数据，请尝试重新加固 |
| 40311 | 未知错误 | 无 |
| 40312 | 网络异常,检查代理或其他 | 访问网络中途中断或其他，请检查网络 |
| 40313 | 如果uploadType为url,该参数必须 | 如果是url，必须跟上uploadMd5参数 |
| 40314 | 上传apk失败 | 请重试或反馈 |
| 40315 | 工具内部异常 | 请重试或反馈 |
| 40316 | 代理设置异常 | 确认代理设置格式正常 |
| 40317 | 服务端异常 | 请重试或反馈 |
| 40318 | 客户端异常 | 请重试或反馈 |
| 40319 | 签名校验错误 | 请重试或反馈 |
四、更新jar包相关
4.1自动更新
查看jar包版本
java –jar ms-shield.jar –v
升级到最新版本
java –jar ms-shield.jar –update
注意，window下自动更新可能会失败，覆盖失败时，ms-shield.jar和ms-shield-x.x.x.jar同时存在，只能是右键重命名为ms-shield.jar
4.2手动更新
查看jar包更新历史：
https://leguimg.qcloud.com/ms-client/java-tool/version.json
可以根据最近日期获取到最新版本号
4.3下载文件
将上面获取到的版本号替换下面的版本号进行下载：
如下下载最新版本1.0.3版本
https://leguimg.qcloud.com/ms-client/java-tool/1.0.3/ms-shield.jar
五、获取帮助
需要获取帮助和交流欢迎加入qq群：565306474
