-
前言
该加固工具为jar包文件,适用于Windows、Linux以及Mac系统,需要安装java环境。
如在Mac或Linux系统下使用,则需把modules目录下的文件赋予可执行权限。
以下均以Windows环境下描述,其他系统环境使用方法类似。
-
游戏包加固
1. APK加固命令行参数
java -jar FairGuard.jar -autoconfig [options] -inputfile %inputapk%[-outputfile %outputapk%]
参数说明:
参数
说明
-autoconfig
必填项,自动配置加固参数
[options]
可选项,对加固后的apk文件进行签名或者对齐
-inputfile
必填项,参数后面跟待加固的apk绝对文件路径
-outputfile
可选项,输出文件路径名。如未设置此选项,则输出文件路径默认为%inputapk%同目录,以_fairguard_protected.apk为结尾的文件名
options说明如下:
参数
说明
-sign
对加固后的apk包签名,默认会进行对齐操作
APK加固并签名命令行示例:
java-jarFairGuardx.x.x.jar-autoconfig-sign-inputfilegame.apk
2. AAB加固命令行参数
java -jar FairGuard.jar -autoconfig [options] -inputfile %inputaab%[-outputfile %outputaab%]
参数说明:
参数
说明
-autoconfig
必填项,自动配置加固参数
[options]
可选项,对加固后的aab文件进行签名或者对齐
-inputfile
必填项,参数后面跟待加固的aab绝对文件路径
-outputfile
可选项,输出文件路径名。如未设置此选项,则输出文件路径默认为%inputaab%同目录,以_fairguard_protected.aab为结尾的文件名
options说明如下:
参数
说明
-sign
对加固后的aab包签名
AAB签名需要把Jarsigner所在目录添加到系统路径
AAB加固并签名命令行示例:
java-jarFairGuardx.x.x.jar-autoconfig-sign-inputfilegame.apk
3.config.ini配置
config.ini文件位于FairGuard.jar相同目录下,如下是它主要字段的设置:
■ gamekey设置
用户需要将gamekey填写在该配置文件中,格式如下所示。
[gamekey]
key=638f**************************d636d531
若无gamekey,可 联系客服 获取 (如只是做APK或AAB签名,key输入任意内容即可,不需要申请正式gamekey)
■ 加固目录设置
[packworkdir]
dir=d:\packworkdir
设置加固目录,用于存放加固过程中的临时文件,如未设置,则FairGuard.jar所在目录存放临时文件。
■ 配置签名相关信息
若需要进行自动签名操作,除了在命令行中加入”-sign”参数外,还需要在config.ini文件中设置签名相关信息,格式如下所示。
[signinfo]
keystore-path=c:\xxx\xxx\gamesign.jks
alias=xxxx
password=xxxxx
alias-pwd=xxxxx
keystore-path:签名文件路径,使用绝对路径表示(路径不可包含中文)
alias:签名别名
password:对应签名信息的密码
alias-pwd:对应签名别名的密码
以上4个信息,任意一项有误的话,签名均会失败。
■ 设置游戏引擎的so名称
除了默认支持的Unity、UE、Cocos以外的其它游戏引擎,可通过添加如下选项,实现对游戏引擎的保护。
[engineso]
name=game-engine. so
-
APK签名
命令行参数:
java -jar FairGuard.jar -optype_sign_apk-inputfile %inputfile.apk% [-outputfile %output.apk%]
参数说明:
参数
说明
-optype_sign_apk
必填项,表示进行APK签名操作
-inputfile
必填项,参数后面跟待签名的APK文件路径
-outputfile
可选项,输出文件路径名。如未设置此选项,则输出文件路径默认为% inputfile.apk %同目录,命名为以%inputfile_signed.apk %为结尾的文件名
签名信息在config.ini文件中配置,配置如下所示:
[signinfo]
keystore-path=c:\xxx\xxx\gamesign.jks
alias=xxxx
password=xxxxx
alias-pwd=xxxxx
keystore-path:签名文件路径,使用绝对路径表示(路径不可包含中文)
alias:签名别名
password:对应签名信息的密码
alias-pwd:对应签名别名的密码
以上4个信息,任意一项有误的话,签名均会失败。
如没有配置signver字段,则同时做v1、v2和v3签名;
如果只使用v1签名,则使用下方的配置:
[signinfo]
keystore-path=c:\xxx\xxx\gamesign.jks
alias=xxxx
password=xxxxx
alias-pwd=xxxxx
signver=v1
如果只是做签名操作,gamekey不会做验证,可随意设置。
APK签名命令行示例:
java-jarFairGuardx.x.x.jar-optype_sign_apk-inputfilegame.apk
-
AAB签名
命令行参数:
java -jar FairGuard.jar -optype_sign_jar-inputfile %inputfile.aab% [-outputfile %output.aab%]
参数说明:
参数
说明
-optype_sign_jar
必填项,表示进行AAB签名操作
-inputfile
必填项,参数后面跟待签名的AAB文件路径
-outputfile
可选项,输出文件路径名。如未设置此选项,则输出文件路径默认为% inputfile.aab %同目录,命名为以%inputfile_signed.aab %为结尾的文件名
签名信息在config.ini文件中配置,配置如下所示:
[signinfo]
keystore-path=c:\xxx\xxx\gamesign.jks
alias=xxxx
password=xxxxx
alias-pwd=xxxxx
keystore-path:签名文件路径,使用绝对路径表示(路径不可包含中文)
alias:签名别名
password:对应签名信息的密码
alias-pwd:对应签名别名的密码
以上4个信息,任意一项有误的话,签名均会失败。
如果只是做签名操作,gamekey不会做验证,可随意设置。
AAB签名命令行示例:
java -jar FairGuardx.x.x.jar -optype_sign_jar -inputfile game.aab
-
使用注意事项
■ 如果使用防重签名功能选项,需要加固前后的签名一致; 如果加入了google签名计划,需要把签名过的包给到客户对接人员。
■ Mac或Linux下使用,需要赋予modules目录下的文件可执行权限。
■ 有其它问题可点击联系QQ客服:2079128588
即刻体验FairGuard加固方案!
免费试用游戏游戏安全保护, 对接专业技术服务!