Android - 混淆 java-library 工程

1,402 阅读2分钟

欢迎关注微信公众号:FSA全栈行动 👋

一、工程配置

AndroidStudio 可以创建好几种 Module 工程,如果 Module 使用的是 android 插件(com.android.applicationcom.android.library),那么通过在 buildTypes 中将 minifyEnabled 设为 true 即可开启混淆,但如果 Module 使用的是 java 插件(java-library),那就需要借助额外的工具了,因为 java-library 默认没有提供混淆配置域。

1、依赖混淆库

想要混淆 java-library 工程,需要在 build.gradle 文件中手动依赖一个第三方库 proguard-gradle

import proguard.gradle.ProGuardTask

buildscript {
    repositories {
        mavenCentral()
    }
    dependencies {
        classpath "com.guardsquare:proguard-gradle:7.1.0"
    }
}

2、自定义混淆 Task

依赖混淆库之后,还要自定义混淆任务,配置一些混淆选项,这里说明几个重点配置项:

  • injars:要混淆的 jar 包(可以是文件或目录)
  • outjars:混淆后的 jar 包输出位置(可以是文件或目录)
  • printmapping:混淆后的代码与源码之间的映射关系日志
  • configuration:混淆规则文件(一般就是 proguard-rules.pro
  • dontshrink:不要开启压缩(默认混淆时会压缩代码,将没被引用到的代码抹去,这会导致某些类文件丢失字段,比如 java bean)
task("proguardTask", type: ProGuardTask, dependsOn: jar) {
    description = "Obfuscates source files"

    def artifactName = "[you library name].jar" // 根据实际情况修改!!!
    def inputFolder = "$buildDir/libs"
    def obfuscatedFolder = "$buildDir/obfuscated"
    def inputJar = "$inputFolder/$artifactName"
    def outputJar = "$obfuscatedFolder/$artifactName"

    injars inputJar
    outjars outputJar

    // For de-obfuscating stack traces later on
    printseeds "$obfuscatedFolder/seeds.txt"
    printmapping "$obfuscatedFolder/mapping.txt"

    // dependencies
    libraryjars "${System.getProperty('java.home')}/lib/rt.jar" //works for java 8
    libraryjars configurations.runtime
    libraryjars sourceSets.main.compileClasspath

    configuration files("proguard-rules.pro")
    // 不要压缩(压缩会把暂时没用到的代码抹去)
    dontshrink

    // 配置阶段触发:将之前生成的混淆jar包删除
    delete obfuscatedFolder

    // 执行阶段触发:当混淆jar包生成出来时,自动替换掉 build/libs 目录下的原始jar包
    doLast {
        delete "$inputJar"
        copy {
            from outputJar
            into inputFolder
        }
    }
}

proguard-gradle 这个库还有很多配置项,需要你感兴趣,可以到官网查阅手册了解:

3、关联混淆 Task

注意了,上面在声明混淆任务 proguardTask 时指定了一个依赖任务 dependsOn: jar,意思是当执行 proguardTask 任务时,需要先执行 jar 任务而已。反过来就不一定了,执行 jar 任务并不会执行 proguardTask 任务(此时 jar 任务不对 proguardTask 负责)。但是一般情况下,我们希望 jar 任务执行之后,顺便把 proguardTask 任务一并执行,这时就可以使用 finalizedBy() 方法对其进行关联:

jar.finalizedBy(proguardTask)

至此,只要 java-library 工程一触发 jar 任务(Mark 或 Build),proguardTask 任务也会一并执行了。

二、完整代码

以下是 java-library 工程 build.gradle 文件中的全部代码:

apply plugin: 'java-library'
dependencies {
    ...
}

import proguard.gradle.ProGuardTask

buildscript {
    repositories {
        mavenCentral()
    }
    dependencies {
        classpath "com.guardsquare:proguard-gradle:7.1.0"
    }
}

task("proguardTask", type: ProGuardTask, dependsOn: jar) {
    description = "Obfuscates source files"

    def artifactName = "[you library name].jar" // 根据实际情况修改!!!
    def inputFolder = "$buildDir/libs"
    def obfuscatedFolder = "$buildDir/obfuscated"
    def inputJar = "$inputFolder/$artifactName"
    def outputJar = "$obfuscatedFolder/$artifactName"

    injars inputJar
    outjars outputJar

    // For de-obfuscating stack traces later on
    printseeds "$obfuscatedFolder/seeds.txt"
    printmapping "$obfuscatedFolder/mapping.txt"

    // dependencies
    libraryjars "${System.getProperty('java.home')}/lib/rt.jar" //works for java 8
    libraryjars configurations.runtime
    libraryjars sourceSets.main.compileClasspath

    configuration files("proguard-rules.pro")
    // 不要压缩(压缩会把暂时没用到的代码抹去)
    dontshrink

    // 配置阶段触发:将之前生成的混淆jar包删除
    delete obfuscatedFolder

    // 执行阶段触发:当混淆jar包生成出来时,自动替换掉 build/libs 目录下的原始jar包
    doLast {
        delete "$inputJar"
        copy {
            from outputJar
            into inputFolder
        }
    }
}

jar.finalizedBy(proguardTask)

如果文章对您有所帮助, 请不吝点击关注一下我的微信公众号:FSA全栈行动, 这将是对我最大的激励. 公众号不仅有Android技术, 还有iOS, Python等文章, 可能有你想要了解的技能知识点哦~