/BlackObfuscator

Black Obfuscator is an obfuscator for Android APK DexFile, it can help developer to protect source code by control flow flattening, and make it difficult to analyze the actual program control flow.

Primary LanguageJavaApache License 2.0Apache-2.0

DEX控制流混淆 · BlackObfuscator

English Version

本项目针对Android APK DEX控制流混淆,在不会改变应用原有逻辑的前提下,会将原始代码进行控制流混淆,使得代码难以阅读,增加反编译阅读的难度以达到保护应用。

项目声明

  • 本项目基于 dex2jar 进行修改
  • 目前是基础最简单的混淆版本(仅打散if),测试稳定性为主,后续将持续更新升级。
  • Black系列交流群:390562046(QQ)

注意事项

  • 本项目基于dex2jar,为了出现转换过程中避免不必要的问题,请尽量混淆自己业务的代码,避免其余三方库一起混淆,在混淆规则内提供自己的业务代码路径。

Android Studio插件支持

目前本项目已集成Android Studio插件,支持打包自动化混淆。详情请移至:BlackObfuscator-ASPlugin

如何使用

Main#main

参数 解释
-d 混淆深度,越高混淆越深
-i 输入dex
-o 输出dex
-a 规则文件,见下一步骤
-p 需要进行混淆的包名
    BlackObfuscatorCmd.main("d2j-black-obfuscator",
            "-d", "2",
            "-i", "/Users/milk/Documents/classes.dex",
            "-o", "/Users/milk/Documents/classes_out.dex",
            "-a", "filter.txt");

混淆规则

提供需要混淆的类

#it is annotation
#cn.kaicity

#class
cn.kaicity.gk.cdk.BuildConfig

#package
cn.kaicity

后续计划

  • 更高强度的混淆
  • 开发GUI

效果展示

混淆前

xx

混淆后

xx xx

感谢

License

Copyright 2021 Milk

Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

   http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.