mirror of
https://github.com/GeWuYou/GFramework.git
synced 2026-03-23 03:04:29 +08:00
fb14d7122c
- 将所有小写的命名空间导入更正为首字母大写格式 - 统一 GFramework 框架的命名空间引用规范 - 修复 core、ecs、godot 等模块的命名空间导入错误 - 标准化文档示例代码中的 using 语句格式 - 确保所有文档中的命名空间引用保持一致性 - 更新 global using 语句以匹配正确的命名空间格式
89 lines
3.6 KiB
C#
89 lines
3.6 KiB
C#
using Microsoft.CodeAnalysis;
|
|
|
|
namespace GFramework.SourceGenerators.Diagnostics;
|
|
|
|
/// <summary>
|
|
/// Priority 特性相关的诊断信息
|
|
/// </summary>
|
|
internal static class PriorityDiagnostic
|
|
{
|
|
private const string Category = "GFramework.Priority";
|
|
|
|
/// <summary>
|
|
/// GF_Priority_001: Priority 特性只能应用于类
|
|
/// </summary>
|
|
public static readonly DiagnosticDescriptor OnlyApplyToClass = new(
|
|
id: "GF_Priority_001",
|
|
title: "Priority 特性只能应用于类",
|
|
messageFormat: "Priority 特性只能应用于类，不能应用于 '{0}'",
|
|
category: Category,
|
|
defaultSeverity: DiagnosticSeverity.Error,
|
|
isEnabledByDefault: true,
|
|
description: "Priority 特性设计用于类级别的优先级标记，不支持其他类型。"
|
|
);
|
|
|
|
/// <summary>
|
|
/// GF_Priority_002: 类已手动实现 IPrioritized 接口
|
|
/// </summary>
|
|
public static readonly DiagnosticDescriptor AlreadyImplemented = new(
|
|
id: "GF_Priority_002",
|
|
title: "类已实现 IPrioritized 接口",
|
|
messageFormat: "类 '{0}' 已手动实现 IPrioritized 接口，将跳过自动生成",
|
|
category: Category,
|
|
defaultSeverity: DiagnosticSeverity.Warning,
|
|
isEnabledByDefault: true,
|
|
description: "当类已经手动实现 IPrioritized 接口时，源生成器将跳过代码生成以避免冲突。"
|
|
);
|
|
|
|
/// <summary>
|
|
/// GF_Priority_003: 类必须声明为 partial
|
|
/// </summary>
|
|
public static readonly DiagnosticDescriptor MustBePartial = new(
|
|
id: "GF_Priority_003",
|
|
title: "类必须声明为 partial",
|
|
messageFormat: "类 '{0}' 使用了 Priority 特性，必须声明为 partial",
|
|
category: Category,
|
|
defaultSeverity: DiagnosticSeverity.Error,
|
|
isEnabledByDefault: true,
|
|
description: "源生成器需要在 partial 类中生成 IPrioritized 接口实现。"
|
|
);
|
|
|
|
/// <summary>
|
|
/// GF_Priority_004: Priority 值缺失或无效
|
|
/// </summary>
|
|
public static readonly DiagnosticDescriptor InvalidValue = new(
|
|
id: "GF_Priority_004",
|
|
title: "Priority 值无效",
|
|
messageFormat: "Priority 特性的值无效或缺失",
|
|
category: Category,
|
|
defaultSeverity: DiagnosticSeverity.Error,
|
|
isEnabledByDefault: true,
|
|
description: "Priority 特性必须提供一个有效的整数值。"
|
|
);
|
|
|
|
/// <summary>
|
|
/// GF_Priority_005: Priority 不支持嵌套类
|
|
/// </summary>
|
|
public static readonly DiagnosticDescriptor NestedClassNotSupported = new(
|
|
id: "GF_Priority_005",
|
|
title: "Priority 不支持嵌套类",
|
|
messageFormat: "Priority 特性不支持嵌套类 '{0}'，请将类移至顶层",
|
|
category: Category,
|
|
defaultSeverity: DiagnosticSeverity.Error,
|
|
isEnabledByDefault: true,
|
|
description: "Priority 特性仅支持顶层类，不支持嵌套类。请将嵌套类移至命名空间级别。"
|
|
);
|
|
|
|
/// <summary>
|
|
/// GF_Priority_Usage_001: 建议使用 GetAllByPriority
|
|
/// </summary>
|
|
public static readonly DiagnosticDescriptor SuggestGetAllByPriority = new(
|
|
id: "GF_Priority_Usage_001",
|
|
title: "建议使用 GetAllByPriority",
|
|
messageFormat: "类型 '{0}' 实现了 IPrioritized 接口，建议使用 GetAllByPriority<{0}>() 而非 GetAll<{0}>()",
|
|
category: "GFramework.Usage",
|
|
defaultSeverity: DiagnosticSeverity.Info,
|
|
isEnabledByDefault: true,
|
|
description: "当获取实现了 IPrioritized 接口的服务时，应使用 GetAllByPriority 方法以确保按优先级排序。"
|
|
);
|
|
} |