Attention: Here be dragons

This is the latest (unstable) version of this documentation, which may document features not available in or compatible with released stable versions of Godot.

Checking the stable version of the documentation...

PCKPacker

继承： RefCounted < Object

创建可以加载到正在运行的项目中的包。

描述

PCKPacker 可以创建打包文件，项目运行时可以使用 ProjectSettings.load_resource_pack() 来加载打包文件。

var packer = PCKPacker.new()
packer.pck_start("test.pck")
packer.add_file("res://text.txt", "text.txt")
packer.flush()

上面的例子中，PCKPacker 创建了打包文件 test.pck，但后将名为 text.txt 的文件添加到了包的根目录。

注意：PCK 是 Godot 自有的打包文件格式。要创建任何程序都能够读取的 ZIP 压缩包，请改用 ZIPPacker。

方法

Error

add_file(target_path: String, source_path: String, encrypt: bool = false)

Error

add_file_removal(target_path: String)

Error

flush(verbose: bool = false)

Error

pck_start(pck_path: String, alignment: int = 32, key: String = "0000000000000000000000000000000000000000000000000000000000000000", encrypt_directory: bool = false)

方法说明

Error add_file(target_path: String, source_path: String, encrypt: bool = false) 🔗

将 source_path 文件添加到当前 PCK 包的内部路径 target_path 处。target_path 不必写 res:// 前缀，内部会将其去除。

Error add_file_removal(target_path: String) 🔗

注册移除 PCK 内部路径 target_path 处的文件。主要用于补丁。如果位于该路径的文件已从之前的 PCK 加载，则会被移除。target_path 不必写 res:// 前缀，内部会将其去除。

Error flush(verbose: bool = false) 🔗

自上次刷新以来，使用所有 add_file() 调用写入指定的文件。如果 verbose 为 true，被添加的文件的列表将被打印到控制台，以便于调试。

Error pck_start(pck_path: String, alignment: int = 32, key: String = "0000000000000000000000000000000000000000000000000000000000000000", encrypt_directory: bool = false) 🔗

在文件路径 pck_path 处新建 PCK 文件。不会自动添加 .pck 文件扩展名，因此 pck_path 中应包含该扩展名（即使扩展名不是必需的）。