mirror of
https://github.com/GeWuYou/GFramework.git
synced 2026-05-07 08:44:29 +08:00
833a295b84
- 新增 AdditionalTextGeneratorTestDriver 用于源生成器测试 - 添加 AutoLoadAttribute 特性支持 AutoLoad 类型映射 - 扩展项目构建目标，支持自定义 project.godot 路径验证 - 创建完整 Godot 集成教程文档，涵盖节点生命周期、信号系统等功能 - 添加源代码生成器测试项目配置和相关依赖包引用
44 lines
1.5 KiB
C#
44 lines
1.5 KiB
C#
#nullable enable
|
|
namespace GFramework.Godot.SourceGenerators.Abstractions;
|
|
|
|
/// <summary>
|
|
/// 显式声明某个 Godot 节点类型与 <c>project.godot</c> 中 AutoLoad 名称之间的映射关系。
|
|
/// </summary>
|
|
/// <remarks>
|
|
/// 当 AutoLoad 条目无法仅靠类型名唯一推断到 C# 节点类型时，
|
|
/// 可以通过该特性为生成器提供稳定的强类型映射入口。
|
|
/// </remarks>
|
|
[AttributeUsage(AttributeTargets.Class, Inherited = false, AllowMultiple = false)]
|
|
public sealed class AutoLoadAttribute : Attribute
|
|
{
|
|
/// <summary>
|
|
/// 初始化 <see cref="AutoLoadAttribute" /> 的新实例。
|
|
/// </summary>
|
|
/// <param name="name">在 <c>project.godot</c> 中声明的 AutoLoad 名称。</param>
|
|
/// <exception cref="ArgumentNullException">
|
|
/// <paramref name="name" /> 为 <see langword="null" />。
|
|
/// </exception>
|
|
/// <exception cref="ArgumentException">
|
|
/// <paramref name="name" /> 为空字符串或仅包含空白字符。
|
|
/// </exception>
|
|
public AutoLoadAttribute(string name)
|
|
{
|
|
if (name is null)
|
|
{
|
|
throw new ArgumentNullException(nameof(name));
|
|
}
|
|
|
|
if (string.IsNullOrWhiteSpace(name))
|
|
{
|
|
throw new ArgumentException("AutoLoad name cannot be empty or whitespace.", nameof(name));
|
|
}
|
|
|
|
Name = name;
|
|
}
|
|
|
|
/// <summary>
|
|
/// 获取在 <c>project.godot</c> 中声明的 AutoLoad 名称。
|
|
/// </summary>
|
|
public string Name { get; }
|
|
}
|