UnrealPak功能介绍

unityloverz · 发表于 2022-8-1 19:36

[EngineDIR]\Engine\Source\Programs\UnrealPak\Private\UnrealPak.cpp有UnrealPak的入口函数，详细逻辑查看UnrealPak.cpp文件源码。
无参数时提示
(&#34;No pak file name specified. Usage:&#34;);
(&#34;  UnrealPak <PakFilename> -Test&#34;);
(&#34;  UnrealPak <PakFilename> -List&#34;);
(&#34;  UnrealPak <PakFilename> <GameUProjectName> <GameFolderName> -ExportDependencies=<OutputFileBase> -NoAssetRegistryCache -ForceDependsGathering&#34;);
(&#34;  UnrealPak <PakFilename> -Extract <ExtractDir>&#34;);
(&#34;  UnrealPak <PakFilename> -Create=<ResponseFile> [Options]&#34;);
(&#34;  UnrealPak <PakFilename> -Dest=<MountPoint>&#34;);
(&#34;  UnrealPak GenerateKeys=<KeyFilename>&#34;);
(&#34;  UnrealPak GeneratePrimeTable=<KeyFilename> [-TableMax=<N>]&#34;);
(&#34;  UnrealPak <PakFilename1> <PakFilename2> -diff&#34;);
(&#34;  UnrealPak -TestEncryption&#34;);
(&#34;  Options:&#34;);
(&#34; -blocksize=<BlockSize>&#34;);
(&#34; -bitwindow=<BitWindow>&#34;);
(&#34; -compress&#34;);
(&#34; -encrypt&#34;);
(&#34; -order=<OrderingFile>&#34;);
(&#34; -diff (requires 2 filenames first)&#34;);
(&#34; -enginedir (specify engine dir for when using ini encryption configs)&#34;);
(&#34; -projectdir (specify project dir for when using ini encryption configs)&#34;);
(&#34; -encryptionini (specify ini base name to gather encryption settings from)&#34;);
(&#34; -encryptindex (encrypt the pak file index, making it unusable in unrealpak without supplying the key)&#34;);普通打包
示例：（由Project Launcher打包日志中复制而来）

CommandUtils.Run: Run: <引擎路径>\Engine\Binaries\Win64\UnrealPak.exe
<项目路径>\Saved\StagedBuilds\WindowsNoEditor\<项目名>\Content\Paks\<Pak文件名>
-create=<引擎路径>\Engine\Programs\AutomationTool\Saved\Logs\<PakList_<Pak文件名>.txt>
-enginedir=&#34;<引擎路径>&#34;
-projectdir=&#34;<项目路径>&#34;
-platform=Windows
-abslog=&#34;<引擎路径>\Engine\Programs\AutomationTool\Saved\Logs\<PakLog_<Pak文件名>.log>&#34;
-order=<项目路径>\Build\WindowsNoEditor\FileOpenOrder\CookerOpenOrder.log
-UTF8Output
-tempfiles=<引擎路径>\TempFiles
-multiprocess
-patchpaddingalign=2048说明：
1.<PakFilename> -Create=<ResponseFile>
该选项代表生成Pak文件，后面指明PakList文件，包含了要打包的资源文件列表，由Cook，Chunk生成，内容示例如下：

2.-enginedir=&#34;<引擎路径>&#34; -projectdir=&#34;<项目路径>&#34; -platform=Windows
与查找密钥有关
3.-abslog=
指定打包日志文件路径
4.-order=
Cooker烘焙时的顺序文件
5.-UTF8Output
UTF8输出
6.-tempfiles=
烘焙文件临时存储
7.-multiprocess
多线程
8.-patchpaddingalign=
数据块对齐

其他功能
1.-generatepatch=
打Patch包时会添加的参数，后面指定要比较的Release文件
2.-compress
压缩资源文件，勾选compress content会添加
3.<PakFilename> -Test
测试Pak文件能否打开（测试了是否加密）
4.-TestEncryption
测试签名效率

Pak包签名和加密
无论是生成或者解压Pak包，都可以有以下中指定密钥的选项，代码在最一开始就通过以下命令行解析密钥
签名：（最终会生成Pak文件同名的.sig签名文件，如果的缺失.sig文件，程序无法运行，签名不影响Pak包解压）
1.GeneratePrimeTable=<KeyFilename> [-TableMax=<N>]
生成素数表到指定文件中，[-TableMax=<N>]用于指定最大数，默认为10000。
生成的素数后续用到。
2.GenerateKeys=<KeyFilename> P=0x<素数1> Q=0x<素数2> [-NoVerifyPrimes]
指定两个素数生成公私密钥，-NoVerifyPrimes可有可无，如果有将检查PQ是否为素数，可能花费时间。
如果不加-NoVerifyPrimes且PQ有一个不是素数，则会随机选择两个素数再生成公私密钥，花费时间比较长。
生成的公私密钥后续用到。
3.-encryptionini -enginedir=&#34;<引擎路径>&#34; -projectdir=&#34;<项目路径>&#34; -platform=Windows
配合使用，为Pak包RSA签名，在<项目路径>\Config\DefaultEncryption.ini文件中查找RSA签名的密钥，如果没有找到签名的公私密钥，那么生成PAK包时不会被签名。
4.-sign=0x<私钥指数>+0x<私钥底数>+0x<公钥指数>
直接在命令行指定公私密钥进行签名。
5.-sign=<KeyFileName>
从KeyFileName中读取公私密钥。

加密：（不会生成Pak文件同名的.sig签名文件，Pak包需要提供AES密钥才能解压）
1.-encryptindex -encryptionini -enginedir=&#34;<引擎路径>&#34; -projectdir=&#34;<项目路径>&#34; -platform=Windows
配合使用，AES加密文件索引，在<项目路径>\Config\DefaultEncryption.ini文件中查找AES的密钥，如果没有找到则不会加密，AES密钥长度至少32个字符（256位），否则报错。
2.-encryptindex
该选项可以在Project Setting -> Packaging - > Encrypt the pak index....配置
3.-encryptionini
该选项可以在Project Setting -> Packaging - > Encrypt ini files inside pak files配置，添加该选项将会单独加密ini文件，如果没有加密使用-encryptindex选项，但使用了该选项，则提供AES密钥解压时，Pak包其他文件可以被解压，但ini文件无法解压。
4.-encrypt
该选项应该需要手动指定（未在界面设置中找到），使用该选项将加密Pak包指定文件。
5.-aes=<密钥>
直接在命令行指定密钥进行加密。

DefaultEncryption.ini文件示例

Pak包解压
没有加密Pak包解压
<Pak文件路径> -Extract <解压路径>
加密过的Pak包解压（和签名无关，不需要公私密钥和.sig文件）
在<PakFileName> -Extract <ExtractDir>后面添加指定密钥的命令如：
1. -encryptindex -encryptionini -enginedir=&#34;<引擎路径>&#34; -projectdir=&#34;<项目路径>&#34; -platform=Windows
2. -aes=<密钥>
也可选择在encryptionini文件填好。

对于上述命令一些单独的功能建议可以写成批处理文件。

生成公私密钥

<hr/>4.19更新

集成到了项目设置中，功能和之前的没有太大变化，上面描述的基本囊括了这里能设置的。
第一部分为256位AES加密设置，点击按钮即可自动生成一个256位的密钥。
后面的选项依次是：

加密Pak中的ini文件
加密Pak中的文件序列
加密Pak中的UAsset文件
加密Pak中所有文件

第二部分是RSA签名，点击按钮即可生成公钥私钥的底数和指数，选项为是否开启打包签名。
进行操作后Config目录下生成DefaultCrypto.ini文件

转载请注明出处：https://zhuanlan.zhihu.com/p/34617967

点赞是我最大的动力~

		自动登录	找回密码
密码			立即注册

UnrealPak功能介绍

本帖子中包含更多资源