{"id":13482438,"url":"https://github.com/CodingGay/BlackObfuscator","last_synced_at":"2025-03-27T13:31:48.129Z","repository":{"id":37744171,"uuid":"437895718","full_name":"CodingGay/BlackObfuscator","owner":"CodingGay","description":"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.","archived":false,"fork":false,"pushed_at":"2023-10-15T10:19:03.000Z","size":7831,"stargazers_count":981,"open_issues_count":9,"forks_count":216,"subscribers_count":15,"default_branch":"jar2dex-2.2","last_synced_at":"2025-03-26T06:02:46.010Z","etag":null,"topics":["android","control-flow","dex","dex2jar","java","obfuscation","obfuscator"],"latest_commit_sha":null,"homepage":"","language":"Java","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/CodingGay.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null}},"created_at":"2021-12-13T14:02:29.000Z","updated_at":"2025-03-25T16:00:37.000Z","dependencies_parsed_at":"2024-06-10T16:02:39.775Z","dependency_job_id":null,"html_url":"https://github.com/CodingGay/BlackObfuscator","commit_stats":null,"previous_names":[],"tags_count":12,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/CodingGay%2FBlackObfuscator","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/CodingGay%2FBlackObfuscator/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/CodingGay%2FBlackObfuscator/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/CodingGay%2FBlackObfuscator/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/CodingGay","download_url":"https://codeload.github.com/CodingGay/BlackObfuscator/tar.gz/refs/heads/jar2dex-2.2","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":245854403,"owners_count":20683347,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["android","control-flow","dex","dex2jar","java","obfuscation","obfuscator"],"created_at":"2024-07-31T17:01:02.009Z","updated_at":"2025-03-27T13:31:48.095Z","avatar_url":"https://github.com/CodingGay.png","language":"Java","readme":"# DEX控制流混淆 · BlackObfuscator\n\n**[English Version](README_EN.md)**\n\n![](https://img.shields.io/badge/language-java-brightgreen.svg)\n\n本项目针对Android APK  DEX控制流混淆，在不会改变应用原有逻辑的前提下，会将原始代码进行控制流混淆，使得代码难以阅读，增加反编译阅读的难度以达到保护应用。\n\n## 项目声明\n- 本项目基于 [dex2jar](https://github.com/pxb1988/dex2jar) 进行修改\n- Black系列交流群：390562046（QQ）\n\n## 注意事项\n- 本项目基于dex2jar，为了出现转换过程中避免不必要的问题，请尽量混淆自己业务的代码，避免其余三方库一起混淆，在混淆规则内提供自己的业务代码路径。\n\n## Android Studio插件支持\n目前本项目已集成Android Studio插件，支持打包自动化混淆。详情请移至：[BlackObfuscator-ASPlugin](https://github.com/CodingGay/BlackObfuscator-ASPlugin)\n\n## GUI支持\nGUI工具已开发完成，详情请移至：[BlackObfuscator-GUI](https://github.com/CodingGay/BlackObfuscator-GUI)\n\n## 如何使用\n### Main#main\n\n参数 | 解释\n---|---\n-d | 混淆深度，越高混淆越深\n-i | 输入dex的路径 \n-o | 输出dex的路径 \n-a | 规则文件，见下一步骤\n-p | 需要进行混淆的包名\n\n```java\n    BlackObfuscatorCmd.main(\"d2j-black-obfuscator\",\n            \"-d\", \"2\",\n            \"-i\", \"/Users/milk/Documents/classes.dex\",\n            \"-o\", \"/Users/milk/Documents/classes_out.dex\",\n            \"-a\", \"filter.txt\");\n```\n### 混淆规则\n#### 提供需要混淆的类\n```x\n#it is annotation\n#cn.kaicity\n\n#class\ncn.kaicity.gk.cdk.BuildConfig\n\n#package\ncn.kaicity\n\n#blackList\n!cn.kaicity.gk.cdk\n\n#blackList中的包或者类不会进行混淆\n```\n\n## 后续计划\n- 更高强度的混淆\n\n## 效果展示\n### 混淆前\n![xx](image/orig.png)\n### 混淆后\n![xx](image/obf1.png)\n![xx](image/obf2.png)\n\n## 感谢\n- [dex2jar](https://github.com/pxb1988/dex2jar)\n\n## 请作者儿子喝奶粉\n![xx](image/wechat.png)\n![xx](image/aliplay.jpg)\n\n### License\n\n\u003e ```\n\u003e Copyright 2021 Milk\n\u003e\n\u003e Licensed under the Apache License, Version 2.0 (the \"License\");\n\u003e you may not use this file except in compliance with the License.\n\u003e You may obtain a copy of the License at\n\u003e\n\u003e    http://www.apache.org/licenses/LICENSE-2.0\n\u003e\n\u003e Unless required by applicable law or agreed to in writing, software\n\u003e distributed under the License is distributed on an \"AS IS\" BASIS,\n\u003e WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n\u003e See the License for the specific language governing permissions and\n\u003e limitations under the License.\n\u003e ```\n","funding_links":[],"categories":["Java"],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FCodingGay%2FBlackObfuscator","html_url":"https://awesome.ecosyste.ms/projects/github.com%2FCodingGay%2FBlackObfuscator","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FCodingGay%2FBlackObfuscator/lists"}