游戏引擎 / 系统课时
检查正式包中的路径问题
检查正式包中的路径问题
正式包常在写存档或读取配置时暴露开发目录依赖。本课把只读资源、用户数据和操作系统路径分开,通过完整写入读取例程建立正确用法,再在隔离目录和升级场景检查路径行为。
学习目标
- 能为资源与用户数据选择正确路径
- 能验证目录创建、读写失败和跨平台大小写
让路径表达数据所属位置
项目内的场景、纹理和配置通常通过 res:// 访问,发布包中的资源应按只读内容对待。存档、玩家设置和日志放到 user://;它由平台和项目设置映射到用户数据目录,不应自己拼接开发电脑的用户目录。
操作系统工具需要真实路径时,用 ProjectSettings.globalize_path 转换合适的虚拟路径。发布包中的资源可能在包内或被重映射,并不保证转换后就是可供外部程序直接打开的普通文件;需要外部工具的资源应采用明确的导出或复制流程。
使用正斜杠和精确大小写,不依赖当前工作目录。关卡名或玩家输入拼进路径时,还应限制允许值和目录范围,防止错误输入跳到其他数据位置。路径合法不等于文件已经存在,读取仍要检查失败。
创建目录并检查每次文件操作
以下独立例程保存一个最小 JSON,再读回验证并删除演示文件。保存为 paths.gd,运行 godot --headless --path . --script paths.gd;它只使用本测试项目的用户数据目录。
extends SceneTree
func _initialize() -> void:
var directory := ProjectSettings.globalize_path("user://saves")
var error := DirAccess.make_dir_recursive_absolute(directory)
if error != OK:
push_error("save directory failed: %s" % error)
quit(1)
return
var save_path := "user://saves/course-demo.json"
var file := FileAccess.open(save_path, FileAccess.WRITE)
if file == null:
push_error("save open failed")
quit(1)
return
file.store_string(JSON.stringify({"schema": 1, "coins": 42}))
file.close() # 完成写入后重新打开,检查实际读回内容。
file = FileAccess.open(save_path, FileAccess.READ)
if file == null:
quit(1)
return
var data: Variant = JSON.parse_string(file.get_as_text())
file.close()
assert(data is Dictionary and data.get("coins") == 42)
print("coins=", int(data["coins"]), " user_path=true")
# 仅删除本例刚写出的文件;不清理其他玩家数据。
DirAccess.remove_absolute(ProjectSettings.globalize_path(save_path))
quit()预期输出(省略启动横幅):
coins=42 user_path=true这不是生产级存档事务。实际存档需要按游戏要求做临时文件、校验、备份和迁移,避免写到一半中断破坏唯一有效文件。也要检查磁盘满、权限和 JSON 损坏,不能只依赖断言让正式游戏退出。
查找正式包里的隐含依赖
搜索代码里的绝对开发路径、相对文件名以及对 res:// 的写操作。复制正式包到带空格与非 ASCII 字符的新目录,并从不同工作目录启动。运行成功但存档跑到意外目录,也属于失败,应记录实际映射位置。
动态资源加载使用实际导出范围内的路径,原始数据文件还需相应包含规则。Linux 等目标环境核对大小写;Android 和其他沙箱平台核对存储限制。不要通过请求广泛外部存储权限来修复本该放在用户数据目录的存档。
保持升级后的数据可找到
项目名、自定义用户数据目录设置或应用身份改变,可能影响数据位置。更改前先写迁移规则,并用旧版创建的样本验证新版能读到。覆盖升级、首次安装和卸载重装是不同测试,结果要分别记录。
最后检查重启后设置与存档仍在,复制发布包不带开发目录也能加载资源,测试路径失败时能给出明确反馈。桌面 headless 读写通过只证明该平台测试目录的行为,手机正式包与系统升级仍需真机验收。
路径契约见 File paths,读写失败行为见 FileAccess。