# APK-Tools

**Repository Path**: sun-huilin/APK-Tools

## Basic Information

- **Project Name**: APK-Tools
- **Description**: Unity APK 反编译与资源提取工具集合
- **Primary Language**: Unknown
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-01-10
- **Last Updated**: 2026-01-16

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# APK-Tools

Unity APK 反编译与资源提取工具集合

## 项目简介

本工具集用于从 Android APK 文件中提取和分析 Unity 游戏资源，特别是 Unity AssetBundle 格式的资源文件。

## 工具说明

### apktool
- **版本**: 2.12.1
- **用途**: 反编译 APK 文件，提取资源和 Smali 代码
- **文件**: `apktool_2.12.1.jar`

### AssetRipper
- **类型**: Git 子模块
- **用途**: 提取 Unity AssetBundle 资源并转换为标准格式
- **支持**: Unity 3.5.0 - 6000.5.X
- **可执行文件**: `AssetRipper/Source/0Bins/AssetRipper.GUI.Free/Release/AssetRipper.GUI.Free.exe`

## 快速开始

### 1. 反编译 APK

```batch
decompile_apk.bat
```

或手动执行：
```bash
java -jar apktool_2.12.1.jar -d your_game.apk -o output_decompiled
```

### 2. 提取 Unity 资源

运行 AssetRipper GUI：
```bash
AssetRipper\Source\0Bins\AssetRipper.GUI.Free\Release\AssetRipper.GUI.Free.exe
```

**操作步骤：**
1. 点击 `File` → `Load Folder`
2. 选择 `output_decompiled/assets/AssetBundles` 目录
3. 点击 `File` → `Export All` 导出资源

### 3. 查看提取结果

导出的资源位于：
```
extracted_assets/
├── Ripped/
│   ├── Texture2D/    # PNG 纹理
│   ├── Sprite/       # 精灵图
│   ├── AudioClip/    # 音频
│   └── ...
```

## 目录结构

```
APK-Tools/
├── apktool_2.12.1.jar          # APK 反编译工具
├── AssetRipper/                # Unity 资源提取工具（子模块）
├── decompile_apk.bat           # 反编译脚本
├── output_decompiled/          # 反编译输出（.gitignore）
├── extracted_assets/           # 资源提取输出（.gitignore）
└── source-apk/                 # 源 APK 文件（.gitignore）
```

## 子模块初始化

如果克隆此仓库后 AssetRipper 目录为空，请运行：

```bash
git submodule update --init --recursive
```

## 常见问题

### Q: 为什么 AssetBundles 不是 PNG/JPEG 格式？
A: AssetBundle 是 Unity 的专有二进制格式，需要使用 AssetRipper 等工具转换为标准格式。

### Q: 支持哪些 Unity 版本？
A: AssetRipper 支持 Unity 3.5.0 到 6000.5.X（包括 Unity 6）。

### Q: 如何处理加密的 AssetBundle？
A: 需要先解密，具体取决于游戏使用的加密方式。

## 相关资源

- [AssetRipper 官方文档](https://assetripper.github.io/AssetRipper/)
- [apktool 官方网站](https://ibotpeaches.github.io/Apktool/)
- [Unity AssetBundle 介绍](https://docs.unity3d.com/Manual/AssetBundlesIntro.html)

## 许可证

本项目使用的工具遵循其各自的许可证：
- AssetRipper: [GPL-3.0](https://github.com/AssetRipper/AssetRipper/blob/master/LICENSE.md)
- apktool: [Apache-2.0](https://github.com/iBotPeaches/Apktool/blob/master/LICENSE)

## 免责声明

本工具仅供学习和研究使用。请确保您有权提取和修改目标 APK 文件的资源，遵守相关版权法律法规。