Skip to content
A tool used to obfuscate aab resources.(Android app bundle资源混淆工具)
Java Kotlin Groovy
Branch: develop
Clone or download
JingYeoh Merge pull request #7 from TxShon/develop
complete string filter command type
Latest commit 5aa9504 Dec 1, 2019
Type Name Latest commit message Commit time
Failed to load latest commit information.
core string filter command type Dec 1, 2019
wiki Merge pull request #6 from bytedance/release/0.1.0 Nov 26, 2019
.gitignore bugfix, 修复增量 mapping 导致混淆失败的问题. Nov 1, 2019
.travis.yml 1. update junit test. Oct 16, 2019
build.gradle add bintray script. Nov 25, 2019
gradlew init repo. Oct 15, 2019
gradlew.bat init repo. Oct 15, 2019
settings.gradle 1. add samples Oct 16, 2019


A tool used to obfuscate aab resources

Download License Bundletool

English | 简体中文

Powered by bytedance douyin android team.


A tool used to obfuscate aab resources.

  • Merge duplicated resources: Consolidate duplicate resource files to reduce package size.
  • Filter bundle files: Support for filtering files in the bundle package. Currently only supports filtering in the MATE-INFO/ and lib/ paths.
  • White list: The resources in the whitelist are not to be obfuscated.
  • Incremental obfuscation: Input the mapping file to support incremental obfuscation.
  • Remove string: Input the unused file splits by lines to support remove strings.
  • ???: Looking ahead, there will be more feature support, welcome to submit PR & issue.

Data of size savings

AabResGuard is a resource obfuscation tool powered by the douyin Android team. It has been launched at the end of July 2018 in several overseas products, such as Tiktok, Vigo, etc. There is no feedback on related resource issues. For more data details, please go to Data of size savings.

Quick start

  • Command tool: Support command line.
  • Gradle plugin: Support for gradle plugin, using the original packaging command to execute obfuscation.

Gradle plugin

Configured in build.gradle(root project)

buildscript {
  repositories {
  dependencies {
    classpath ""

Configured in build.gradle(application)

apply plugin: ""
aabResGuard {
    mappingFile = file("mapping.txt").toPath() // Mapping file used for incremental obfuscation
    whiteList = [ // White list rules
    obfuscatedBundleFileName = "duplicated-app.aab" // Obfuscated file name, must end with '.aab'
    mergeDuplicatedRes = true // Whether to allow the merge of duplicate resources
    enableFilterFiles = true // Whether to allow filter files
    filterList = [ // file filter rules
    enableFilterStrings = false // switch of filter strings
    unusedStringPath = file("unused.txt").toPath() // strings will be filtered in this file
    languageWhiteList = ["en", "zh"] // keep en,en-xx,zh,zh-xx etc. remove others.

The aabResGuard plugin intrudes the bundle packaging process and can be obfuscated by executing the original packaging commands.

./gradlew clean :app:bundleDebug --stacktrace

Get the obfuscated bundle file path by gradle .

def aabResGuardPlugin = project.tasks.getByName("aabresguard${VARIANT_NAME}")
Path bundlePath = aabResGuardPlugin.getObfuscatedBundlePath()

Command line

AabResGuard provides a jar file that can be executed directly from the command line. More details, please go to Command Line.


After the packaging is completed, the obfuscated file and the log files will be output. More details, please go to Output File.

  • resources-mapping.txt: Resource obfuscation mapping, which can be used as the next obfuscation input to achieve incremental obfuscate.
  • aab: Optimized aab file.
  • -duplicated.txt: duplicated file logging.

Change log

Version change log. More details, please go to Change Log .


Read the details to learn how to participate in the improvement AabResGuard.



You can’t perform that action at this time.