Android游戏加固工具使用说明

该加固工具为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说明如下:

参数说明
-signapk对加固后的apk包签名,默认会进行对齐操作

APK加固并签名命令行示例

java  -jar  FairGuardx.x.x.jar  -autoconfig  -signapk  -inputfile  game.apk


2.AAB加固命令行参数

java -jar FairGuard.jar -autoconfig -sign -inputfile %inputaab% [-outputfile %outputaab%]

参数说明:

参数说明
-autoconfig必填项,自动配置加固参数
[options]可选项,对加固后的aab文件进行签名
-inputfile必填项,参数后面跟待加固的aab绝对文件路径
-outputfile可选项,输出文件路径名。如未设置此选项,则输出文件默认为%inputaab%同目录且文件名以    _fairguard_protected.aab结尾的文件

options说明如下:

参数说明
-sign对加固后的aab包签名

AAB加固并签名命令行示例

java  -jar  FairGuardx.x.x.jar  -autoconfig  -sign  -inputfile  game.aab  


3.config.ini配置

config.ini文件位于FairGuard.jar相同目录下,如下是它主要字段的设置:

1) gamekey设置

用户需要将gamekey填写在该配置文件中,格式如图1所示。若无gamekey,可 联系客服 获取(如只是做APK或AAB签名,key输入任意内容即可,不需要申请正式gamekey)

图1 gamekey配置

2) 加固目录设置

图2 packworkdir配置

设置加固目录,用于存放加固过程中的临时文件,如未设置,则FairGuard.jar所在目录存放临时文件。

3) 配置签名相关信息

若需要进行自动签名操作,除了在命令行中加入”-signapk”参数外,还需要在config.ini文件中设置签名相关信息,格式如图2所示。

图3 签名信息配置

keystore-path:签名文件路径,使用绝对路径表示

alias:签名别名

password:对应签名信息的密码

alias-pwd:对应签名别名的密码

以上4个信息,任意一项有误的话,签名均会失败。


4) 设置游戏引擎的so名称

除了默认支持的Unity,UE,Cocos以外的其它游戏引擎,可通过添加如下选项,实现对游戏引擎的保护

图4 游戏引擎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文件中配置,配置如下图所示

图5 签名信息配置

keystore-path:签名文件路径,使用绝对路径表示

alias:签名别名

password:对应签名信息的密码

alias-pwd:对应签名别名的密码

以上4个信息,任意一项有误的话,签名均会失败。

APK签名命令行示例

java  -jar  FairGuardx.x.x.jar  -optype_sign_apk  -inputfile  game.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文件中配置,配置如下图所示

图6 签名信息配置

keystore-path:签名文件路径,使用绝对路径表示

alias:签名别名

password:对应签名信息的密码

alias-pwd:对应签名别名的密码

以上4个信息,任意一项有误的话,签名均会失败。

AAB签名命令行示例

java  -jar  FairGuardx.x.x.jar  -optype_sign_jar  -inputfile  game.apk


四、使用注意事项

1.如果使用防重签名功能选项,需要加固前后的签名一致; 如果加入了google签名计划,需要把签名过的包给到客户对接人员

2.Mac或Linux下使用,需要赋予modules目录下的文件可执行权限

3.Unity 2019以后版本,每个新打的游戏包需要更新版本号,不然在覆盖安装的情况下,会运行出错

4.有其它问题可点击联系QQ客服:2079128588