# FakerAndroid

**Repository Path**: mirrors/FakerAndroid

## Basic Information

- **Project Name**: FakerAndroid
- **Description**: 简介 直接将 Apk 文件转换为可以进行二次开发的 Android 项目的工具,支持 so hook,对于 il2cpp 的游戏 apk 直接生成 il2cpp c++脚手架 将痛
- **Primary Language**: Java
- **License**: MIT
- **Default Branch**: main
- **Homepage**: https://www.oschina.net/p/FakerAndroid
- **GVP Project**: No

## Statistics

- **Stars**: 23
- **Forks**: 24
- **Created**: 2020-10-30
- **Last Updated**: 2024-10-26

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# FakerAndroid ([FakerAndroid.jar or FakerAndroid-AS](https://github.com/Efaker/FakerAndroid/releases))

A tool translate a apk file to stantard android project include so hook api and il2cpp c++ scaffolding when apk is a unity il2cpp game.
## Summary
- Write code on a apk file elegantly.
- The Apk file can be directly converted into Android project for secondary development, supporting so hook. For the game of il2cpp, APK directly generates il2cpp C++ scaffolding
- What's more to say about transforming the painful reverse environment into a comfortable development environment, saying goodbye to assembly and binary~ 
## Feature
- Stantard AndroidStudio android project generated
- Original java class usage or cover it by compileable java code
- Hook Api offered for hooking .so method 
- When apk is a il2cpp game il2cpp c++ scaffoding generated
- Back compilation voluntary when there is a modification of smali files(AndroidStudio project file tree model)
- Unlimited possibilities and expansibility. You has the final say
### Environment
- Java(18)
- For Il2cpp Game Apk to generate il2cpp C++ scaffolding .Net environment needed ([Mac&Linux users handle it by yourself](https://dotnet.microsoft.com/download/dotnet/5.0)) 
### Usage 
- Download [FakerAndroid.jar](https://github.com/Efaker/FakerAndroid/releases)(2022/03/30/23:48:00)
- cmd ```cd <FakerAndroid.jar base dir>``` 
- cmd ```java -jar FakerAndroid.jar fk <apkpath>``` (project will be generated in the same dir of the orininal apk) or ```java -jar FakerAndroid.jar fk <apkpath> -o <outdir>```
- Demo```java -jar FakerAndroid.jar fk D:\apk\test.apk``` or ```java -jar FakerAndroid.jar fk D:\apk\test.apk -o D:\test```
### Or Usage 
- Download [FakerAndroid-AS.zip](https://github.com/Efaker/FakerAndroid/releases)(2022/03/30/23:48:00)
- AS->File-Settings->Plugin->SettingIcon->InstallPlugin Plugin From Disk->Restart As
- AS->File->FakerAndroid->Choose your apk file

### Secondary development course
##### 1、Open the project
- By Android studio File->open->```<generated project root>```
- Keep the root dir build.gradle file depends com.android.tools.build:gradle:3.4.0,don't upgrate or modify it
- Set project ndk base version 21 best
- A little modification will be needed by yourself when the res or AndroidManifest.xml can't pass the compiler 
##### 2、Debug or run the project
- With a testing machine conected
- Run 
##### 3、Advanced
- Original java class call  
  With the help of javaScaffoding write your java code to call original class in app moudle(app/src/main/java) 
- Original java class replacement      
  Write java code in moudle app（app/src/main/java）,keep the class name and package name corresponding same as the original class
- Smali increament building  
  When there is a smali files mod,there is a least files builing 
- So Hook  
  With the help of fakeCpp api use jni hook the so method
- Il2cpp unity script development  
  With the help of il2cpp Scaffolding and fakeCpp api,use jni have a modification of il2cpp game script

##### 4、Issues
- [Issues](https://github.com/Efaker/FakerAndroid/issues)

##### 5、Demo
- [DEMO](https://github.com/Efaker/FakerAndroid-Demos/releases/tag/1031)