开源项目Aspect Injector指南及常见问题解答

项目基础介绍

Aspect Injector是一个基于.NET平台（包括C#、VB等）的面向切面编程（AOP）框架。它通过编译时注入的方式工作，支持Blazor和AOT编译场景。该框架允许开发者通过属性（Attributes）来创建并注入切面（Aspects），实现方法、构造器、属性和事件的环绕、前置和后置处理。它兼容任何引用netstandard2.0库的.NET项目，并提供Roslyn分析器以辅助C#开发。项目采用Apache-2.0许可证。

主要编程语言

• 主要: C#
• 支持: VB.NET以及其他.NET兼容语言

新手使用须知：三大注意事项与解决步骤

注意事项1：环境配置

问题描述：确保你的开发环境已具备运行Aspect Injector所需的最低条件。

• 解决步骤
  1. 更新NuGet包管理器：至少版本5.0+，以支持瞬态构建特性。现代的Visual Studio和.NET SDK通常已经满足此要求。
  2. 正确添加到所有项目：如果你的解决方案使用旧的project.json格式，需将AspectInjector添加到解决方案中的每个项目里。

注意事项2：使用 Analyzers 在 VSCode 中

问题描述：若希望VSCode中的OmniSharp支持Roslyn分析器，需手动启用设置。

• 解决步骤
  1. 打开VSCode的settings.json文件。
  2. 添加 "omnisharp.enableRoslynAnalyzers": true 到JSON配置中，保存设置。

注意事项3：理解切面定义与应用

问题描述：新手可能会混淆如何定义切面以及在哪里应用它们。

• 解决步骤
  1. 定义切面：创建一个继承自Attribute的类，并标记为[Aspect]。例如，创建日志记录切面。

     [Aspect(Scope.Global)]
     [Injection(typeof(LogCall))]
     public class LogCall : Attribute
     {
         [Advice(Kind.Before)]
         public void LogEnter([Argument(Source.Name)] string name)
         {
             Console.WriteLine($"Calling '{name}' method");
         }
     }
     

  2. 应用切面：在目标方法、属性上使用定义好的切面。

     [LogCall]
     public void Calculate()
     {
         Console.WriteLine("Calculated");
     }
     

以上步骤帮助新手快速入门Aspect Injector，避免常见陷阱，确保高效利用此强大工具进行面向切面编程。