UE4 Pak 文件格式

https://wangjie.rocks/2019/01/10/ue4-pak/

UE4 Pak 文件格式

jashwang 收录于 Unreal engine4

2019-01-10 约 1735 字预计阅读 4 分钟

UE4 打包过程中，会调用 UnrealPak 将 Cook 后的文件资源打包成一整个 Pak 文件，这个 Pak 中的内容可以分为三大块，按写入顺序分别为：文件内容区 + 文件索引信息区 + Pak文件信息区

文件内容区: 依次存储每个文件的 FPakEntry + 文件内容
文件索引信息区: 依次存储每个文件的文件名 + FPakEntry
Pak文件信息区: 存储整个 Pak 文件的信息

注意: 文件内容区 和 文件索引信息区 FPakEntry 部分除了 Offset 外是冗余存储的，文件内容区域的 FPakEntry 序列化时 Offset 的8字节内容全为 0，如图

Pak文件信息区: FPakInfo

这个结构体序列化后，写到pak文件的最后的地方，固定 45 字节，格式如下，代码见 FPakFile::Initialize

bEncryptedIndex: 1 字节，表示pak的索引部分是否被加密

Pak 文件加密的基本过程：编译时，TargetRules.cs 文件中会添加一个宏定义 IMPLEMENT_ENCRYPTION_KEY_REGISTRATION()，这个宏展开成 UE_REGISTER_ENCRYPTION_KEY(YourAESKeyCode)，这个宏里会声明一个全局结构体实例 GEncryptionKeyRegistration，在构造函数里调用 RegisterEncryptionKeyCallback 注册一个回调，这个回调就是返回 YourAESKeyCode，RegisterEncryptionKeyCallback 这个函数里其实就是向FCoreDelegates::GetPakEncryptionKeyDelegate 里绑定了一个 lambda，lambda里调用回调函数获取密钥。完整的宏展开流程 IMPLEMENT_APPLICATION -> IMPLEMENT_ENCRYPTION_KEY_REGISTRATION -> UE_REGISTER_ENCRYPTION_KEY。也就是说，默认 Pak 加密的 AES 密钥是硬编码在代码里的
Magic: 4 字节，值必须为 0x5A6F12E1，否则是非法pak
Version: 4 字节，pak文件格式的版本号

每个版本的区别如下：
- 1：初始版本号
- 2: 移除了 FPakEntry 中的时间戳
- 3：增加文件加密功能和分块压缩功能，FPakEntry 中多了分块信息数据和是否加密的标志位
- 4：增加索引加密功能，FPakInfo 中多了索引是否加密的标志位
- 5：压缩分块信息中的起始和结束位置是相对于 FPakEntry.Offset 的偏移，之前的版本是相对于 Pak 文件起始位置(即0)的偏移
IndexOffset: 8 字节，Pak 文件索引信息区的起始位置
IndexSize: 8 字节，Pak 文件索引信息区的大小
IndexHash: 20 字节，文件索引信息的SHA1值

文件索引信息区

从上面的结构体中根据索引的起始偏移和大小定位索引内容，并且根据 bEncryptedIndex 来判断是否要对索引内容进行解密，格式如下，代码见 FPakFile::LoadIndex

MountPoint: 默认挂载点，类型是字符串，长度不定。字符串序列化格式为：4字节(内容为字符串长度) + 字符串内容(字符串以0结尾)
NumEntries: 4 字节，序列化的文件数量
接下来就是依次存储每个文件的 Filename(文件路径) 和对应的 FPakEntry，有 NumEntries 个

Filename

FPakEntry

FPakEntry 记录的是每一个文件序列化到 Pak 中的文件头信息，序列化格式如下

Offset: 8 字节，文件实际内容区域起始位置在 Pak 文件中的偏移，第一个文件就是 0
Size：8 字节，文件压缩后的大小
UncompressedSize：8 字节，文件原始大小
CompressionMethod: 4 字节，文件压缩方式，见 ECompressionFlags
Timestamp: 8 字节，时间戳，这个数据只在老版本的pak(Version <= 1) 中才有，Version >= 2 中的 pak 已经废弃不序列化了
Hash: 20 字节，文件的SHA1哈希值
CompressionBlocks: 分块信息列表，每一个分块信息为 16 字节(两个 uint64，分别是块内容起始位置偏移和结束位置偏移)。分块信息数据只有在 Version >= 3，并且开启了压缩的情况下才会序列化。TArray 的序列化格式为: 4 字节(内容为Array长度) + 每一个 Array项的序列化。所以这部分数据大小为: 4 + 16 * 分块数量，下面的图中只有一个分块
bEncrypted: 1 字节，文件块内容是否加密，这部分数据只有在 Version >= 3 才有
CompressionBlockSize: 4 字节，每一个压缩分块的大小，这部分数据只有在 Version >= 3 才有。序列化时，每个文件会按这个值进行分块，然后每个分块再进行压缩加密，默认值是 64K，如果文件大小小于这个值，则CompressionBlockSize 就是文件实际大小。反序列化时，读取每个分块，进行解密，然后再分配CompressionBlockSize 大小的内存进行解压，所有的内存块合起来就是真正的文件内容，下图的分块大小是 1055

文件内容区

这个区域位于 Pak 文件的起始位置，依次存储每一个文件的 FPakEntry 和实际文件内容，如果开启了压缩，则文件内容需要进行分块压缩，如果开启了加密，则压缩过的文件内容还要进行加密

本文于 2019-01-10 更新

UE4

返回 | 主页

Bluelua 新特性: 在 lua 中重载蓝图函数 UE4基础：搭建开发环境

0 条