• 前言

        该加固工具为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加固方案!

即刻体验FairGuard加固方案!

免费试用游戏游戏安全保护, 对接专业技术服务!

免费体验
首 页
产 品
方 案
客 服
帮 助