Skip to content

Commit

Permalink
update doc
Browse files Browse the repository at this point in the history
  • Loading branch information
JingYeoh committed Nov 25, 2019
1 parent 4525812 commit 3da48c4
Show file tree
Hide file tree
Showing 2 changed files with 18 additions and 18 deletions.
18 changes: 9 additions & 9 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -12,24 +12,24 @@

> Powered by bytedance douyin android team.
# Features
## Features
- **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](wiki/en/DATA.md)
## [Data of size savings](wiki/en/DATA.md)
**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, Musically, Vigo**, etc.
There is no feedback on related resource issues.
For more data details, please go to **[Data of size savings](wiki/en/DATA.md)**.

# Quick start
## Quick start
- **Command tool:** Support command line.
- **Gradle plugin:** Support for `gradle plugin`, using the original packaging command to execute obfuscation.

## #Gradle plugin
### #Gradle plugin
Configured in `build.gradle(root project)`
```gradle
buildscript {
Expand Down Expand Up @@ -78,22 +78,22 @@ def aabResGuardPlugin = project.tasks.getByName("aabresguard${VARIANT_NAME}")
Path bundlePath = aabResGuardPlugin.getObfuscatedBundlePath()
```

## [#Command line](wiki/en/COMMAND.md)
### [#Command line](wiki/en/COMMAND.md)
**AabResGuard** provides a `jar` file that can be executed directly from the command line. More details, please go to **[Command Line](wiki/en/COMMAND.md)**.

## [#Output](wiki/en/OUTPUT.md)
### [#Output](wiki/en/OUTPUT.md)
After the packaging is completed, the obfuscated file and the log files will be output. More details, please go to **[Output File](wiki/en/OUTPUT.md)**.
- **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](wiki/en/CHANGELOG.md)
## [Change log](wiki/en/CHANGELOG.md)
Version change log. More details, please go to **[Change Log](wiki/en/CHANGELOG.md)** .

# [Contribute](wiki/en/CONTRIBUTOR.md)
## [Contribute](wiki/en/CONTRIBUTOR.md)
Read the details to learn how to participate in the improvement **AabResGuard**.

## #Contributor
### #Contributor
* [JingYeoh](https://github.com/JingYeoh)
* [Jun Li]()
* [Zilai Jiang](https://github.com/Zzzia)
Expand Down
18 changes: 9 additions & 9 deletions wiki/zh-cn/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -12,23 +12,23 @@

> 本工具由字节跳动抖音 Android 团队提供。
# 特性
## 特性
- **资源去重:** 对重复资源文件进行合并,缩减包体积。
- **文件过滤:** 支持对 `bundle` 包中的文件进行过滤,目前只支持 `MATE-INFO/``lib/` 路径下的过滤。
- **白名单:** 白名单中的资源,名称不予混淆。
- **增量混淆:** 输入 `mapping` 文件,支持增量混淆。
- **文案删除:** 输入按行分割的字符串文件,移除文案及翻译。
- **???:** 展望未来,会有更多的特性支持,欢迎提交 PR & issue。

# [数据收益](DATA.md)
## [数据收益](DATA.md)
**AabResGuard** 是抖音Android团队完成的资源混淆工具,目前已经在 **Tiktok、Musically、Vigo** 等多个产品上线多月,目前无相关资源问题的反馈。
具体的数据详细信息请移步 **[数据收益](DATA.md)**

# 快速开始
## 快速开始
- **命令行工具:** 支持命令行一键输入输出。
- **Gradle plugin:** 支持 `gradle plugin`,使用原始打包命令执行混淆。

## #Gradle plugin
### #Gradle plugin
`build.gradle(root project)` 中进行配置
```gradle
buildscript {
Expand Down Expand Up @@ -76,22 +76,22 @@ def aabResGuardPlugin = project.tasks.getByName("aabresguard${VARIANT_NAME}")
Path bundlePath = aabResGuardPlugin.getObfuscatedBundlePath()
```

## [#命令行支持](COMMAND.md)
### [#命令行支持](COMMAND.md)
**AabResGuard** 提供了 `jar` 包,可以使用命令行直接执行,具体的使用请移步 **[命令行支持](COMMAND.md)**

## [#输出文件](OUTPUT.md)
### [#输出文件](OUTPUT.md)
在打包完成后会输出混淆后的文件和相应的日志文件,详细信息请移步 **[输出文件](OUTPUT.md)**
- **resources-mapping.txt:** 资源混淆 mapping,可作为下次混淆输入以达到增量混淆的目的。
- **aab:** 优化后的 aab 文件。
- **-duplicated.txt:** 被去重的文件日志记录。

# [版本日志](CHANGELOG.md)
## [版本日志](CHANGELOG.md)
版本变化日志记录,详细信息请移步 **[版本日志](CHANGELOG.md)**

# [代码贡献](CONTRIBUTOR.md)
## [代码贡献](CONTRIBUTOR.md)
阅读详细内容,了解如何参与改进 **AabResGuard**

## #贡献者
### #贡献者
* [JingYeoh](https://github.com/JingYeoh)
* [Jun Li]()
* [Zilai Jiang](https://github.com/Zzzia)
Expand Down

0 comments on commit 3da48c4

Please sign in to comment.