Skip to content

Home

Jump to bottom
lhx077 edited this page May 1, 2025 · 1 revision

ABProcessor - Unity AssetBundle外部处理库

项目概述

ABProcessor是一个用C#编写的库，用于在Unity外部处理AssetBundle(.ab)文件。该库提供了创建、压缩、加密和管理AssetBundle的功能，可以轻松集成到现有项目中。对于性能要求高的场景，ABProcessor还提供了C++原生方法支持，通过P/Invoke与C#交互。

该库完全符合Unity AssetBundle格式规范，生成的文件可以直接在Unity中加载使用。无论是游戏开发、资源管理还是自动化工具开发，ABProcessor都能提供高效可靠的AssetBundle处理能力。

功能特性

  • AssetBundle创建：将多个文件打包成AssetBundle格式
  • 压缩支持：支持None、LZMA、LZ4和LZ4HC多种压缩方式
  • 加密功能：支持对AssetBundle内容进行AES加密保护
  • 高性能处理：可选的C++原生方法提高处理性能
  • 跨平台支持：基于.NET Standard 2.0，可在多种平台使用
  • 简洁API：提供简单易用的API接口

项目结构

ABProcessor/
├── src/                    # 源代码目录
│   ├── ABProcessor.cs      # 核心处理类
│   ├── ABProcessorNative.cs # C#与C++交互的包装类
│   └── Native/             # C++原生代码
│       └── ABProcessorNative.cpp # 高性能处理的C++实现
├── samples/                # 示例代码
│   ├── ABProcessorSample.cs # 示例程序
│   └── ABProcessorSample.csproj # 示例项目文件
└── ABProcessor.csproj      # 主项目文件

快速开始

安装

  1. 克隆仓库到本地：

    git clone https://github.com/lhx077/ABProcessor.git

  2. 使用Visual Studio或其他IDE打开解决方案文件 ABProcessor.sln

  3. 编译项目：

    dotnet build

基本用法

创建AssetBundle

// 初始化处理器
AssetBundleProcessor processor = new AssetBundleProcessor(
    outputPath: "D:/Output",
    compressionLevel: System.IO.Compression.CompressionLevel.Optimal,
    useEncryption: false,
    unityCompressionType: UnityCompressionType.LZ4,
    unityVersion: "2019.4.0f1"
);

// 准备文件列表
List<string> files = new List<string>
{
    "D:/Assets/Texture1.png",
    "D:/Assets/Model1.fbx",
    "D:/Assets/Config.json"
};

// 创建AssetBundle
string bundlePath = processor.CreateAssetBundle("my_bundle", files);
Console.WriteLine($"AssetBundle已创建: {bundlePath}");

解包AssetBundle

// 初始化处理器
AssetBundleProcessor processor = new AssetBundleProcessor("D:/Extract");

// 解包AssetBundle
List<string> extractedFiles = processor.ExtractAssetBundle(
    "D:/Bundles/my_bundle", 
    "D:/Extract"
);

Console.WriteLine($"已解包 {extractedFiles.Count} 个文件");

使用加密

// 初始化处理器（启用加密）
AssetBundleProcessor processor = new AssetBundleProcessor(
    outputPath: "D:/Output",
    useEncryption: true,
    encryptionKey: "your_secret_key_here"
);

// 创建加密的AssetBundle
string bundlePath = processor.CreateAssetBundle("encrypted_bundle", files);

// 解包加密的AssetBundle（需要提供相同的密钥）
List<string> extractedFiles = processor.ExtractAssetBundle(
    bundlePath, 
    "D:/Extract"
);

高级用法

使用不同的压缩类型

// 使用LZMA压缩（更高压缩率，但解压较慢）
AssetBundleProcessor lzmaProcessor = new AssetBundleProcessor(
    outputPath: "D:/Output",
    unityCompressionType: UnityCompressionType.LZMA
);

// 使用LZ4HC压缩（高压缩率的LZ4变种）
AssetBundleProcessor lz4hcProcessor = new AssetBundleProcessor(
    outputPath: "D:/Output",
    unityCompressionType: UnityCompressionType.LZ4HC
);

// 不使用压缩（更快的加载速度，但文件更大）
AssetBundleProcessor noCompressionProcessor = new AssetBundleProcessor(
    outputPath: "D:/Output",
    unityCompressionType: UnityCompressionType.None
);

使用C++高性能版本

// 创建C++版本的处理器
using (ABProcessorNative processor = new ABProcessorNative(
    outputPath: "D:/Output",
    compressionLevel: System.IO.Compression.CompressionLevel.Optimal,
    useEncryption: false,
    encryptionKey: null,
    compressionType: UnityCompressionType.LZ4,
    unityVersion: "2019.4.0f1"))
{
    // 创建AssetBundle
    List<string> files = new List<string>
    {
        "D:/Assets/Texture1.png",
        "D:/Assets/Model1.fbx",
        "D:/Assets/Config.json"
    };
    
    string bundlePath = processor.CreateAssetBundle("my_bundle", files);
    Console.WriteLine($"AssetBundle已创建: {bundlePath}");
    
    // 解包AssetBundle
    List<string> extractedFiles = processor.ExtractAssetBundle(
        bundlePath, 
        "D:/Extract"
    );
    
    Console.WriteLine($"已解包 {extractedFiles.Count} 个文件");
}

编译C++原生库

Windows

  1. 使用Visual Studio打开解决方案
  2. 右键点击Native项目，选择"生成"
  3. 编译后的DLL将位于 bin/Debug/netstandard2.0/ 目录下

Linux/macOS

# 安装必要的工具
sudo apt-get install build-essential cmake

# 编译原生库
cd ABProcessor/src/Native
cmake .
make

# 复制库文件到输出目录
cp libABProcessorNative.so ../../bin/Debug/netstandard2.0/

注意事项

  • 该库不依赖Unity，可以在任何支持.NET Standard 2.0的环境中使用
  • 使用C++原生方法需要编译对应平台的原生库
  • 加密功能使用AES算法，请妥善保管密钥
  • 生成的AssetBundle文件与Unity完全兼容，可以直接在Unity中加载

许可证

本项目采用Apache 2.0许可证。详情请参阅LICENSE文件。

贡献

欢迎提交问题和拉取请求。对于重大更改，请先开issue讨论您想要更改的内容。

Clone this wiki locally