GFExtensionSelectionDiscovery¶
API Reference / Kernel / 类索引
- 路径：
addons/gf/kernel/extension/gf_extension_selection_discovery.gd - 模块：
Kernel - 继承：
RefCounted - API：
public - 类别：运行时服务 (
runtime_service) - 首次版本：
8.0.0
GF 扩展启用选择与贡献路径快照缓存。 基于 manifest 集合、当前启用 ID 和扩展工具贡献文件，生成启用选择、依赖图、 enabled/disabled manifest 与各类贡献路径的稳定 snapshot。
成员概览¶
| 类型 | 名称 | 签名 |
|---|---|---|
| 方法 | get_snapshot |
static func get_snapshot( manifests: Array[GFExtensionManifest] = [], configured_ids: Array[String] = [], options: Dictionary = {} ) -> Dictionary: |
| 方法 | clear_cache |
static func clear_cache() -> void: |
方法¶
get_snapshot¶
- API：
public - 首次版本：
8.0.0
static func get_snapshot( manifests: Array[GFExtensionManifest] = [], configured_ids: Array[String] = [], options: Dictionary = {} ) -> Dictionary:
获取当前扩展启用选择快照。 默认会复用仍然有效的快照；当 manifest、启用 ID、manifest load errors 或扩展工具贡献文件变化时，自动重新派生并替换缓存。
参数：
| 名称 | 说明 |
|---|---|
manifests |
当前可发现的扩展 manifest 列表。 |
configured_ids |
项目配置中的启用扩展 ID。 |
options |
发现选项。 |
返回：扩展启用选择快照。
结构：
options: Dictionary，支持 force_refresh、builtin_extension_ids 和 manifest_load_errors。return: Dictionary，包含 ok、configured_ids、resolved_ids、unknown_enabled_ids、enabled_manifests、disabled_manifests、graph_report、manifest_paths、contribution_paths、paths、tool_contribution_errors、signature、signature_hash 和 revision。
clear_cache¶
- API：
public - 首次版本：
8.0.0
清空启用选择快照缓存。