GFSettingsRecoveryPolicy¶
API Reference / Standard / 类索引
- 路径：
addons/gf/standard/utilities/settings/gf_settings_recovery_policy.gd - 模块：
Standard - 继承：
Resource - API：
public - 类别：资源定义 (
resource_definition) - 首次版本：
unreleased
设置加载的显式恢复策略。 缺失与损坏设置默认严格失败。项目可以显式选择保留当前内存状态， 或把有效设置重置为已注册默认值；恢复不会创建或覆盖持久化文件。
成员概览¶
| 类型 | 名称 | 签名 |
|---|---|---|
| 常量 | ACTION_FAIL |
const ACTION_FAIL: StringName = &"fail" |
| 常量 | ACTION_USE_CURRENT_STATE |
const ACTION_USE_CURRENT_STATE: StringName = &"use_current_state" |
| 常量 | ACTION_RESET_TO_DEFAULTS |
const ACTION_RESET_TO_DEFAULTS: StringName = &"reset_to_defaults" |
| 属性 | missing_file_action |
var missing_file_action: StringName = ACTION_FAIL |
| 属性 | corrupt_file_action |
var corrupt_file_action: StringName = ACTION_FAIL |
| 方法 | validate_policy |
func validate_policy() -> Dictionary: |
常量¶
ACTION_FAIL¶
- API：
public - 首次版本：
unreleased
不执行自动恢复。
ACTION_USE_CURRENT_STATE¶
- API：
public - 首次版本：
unreleased
保留当前有效值和暂存值。
ACTION_RESET_TO_DEFAULTS¶
- API：
public - 首次版本：
unreleased
使用空 replace 语义恢复已注册默认值。
属性¶
missing_file_action¶
- API：
public - 首次版本：
unreleased
文件缺失时的恢复动作。
corrupt_file_action¶
- API：
public - 首次版本：
unreleased
文件损坏或完整性校验失败时的恢复动作。
方法¶
validate_policy¶
- API：
public - 首次版本：
unreleased
检查策略自身是否合法。
返回：结构化校验报告。
结构：
return: GFValidationReportDictionary-compatible report with issues, counts, summary, and next_actions.