AspectD 项目教程

AspectD 项目教程

aspectd AOP for Flutter(Dart) 项目地址: https://gitcode.com/gh_mirrors/as/aspectd

1、项目介绍

AspectD 是一个面向 Flutter（Dart）的 AOP（面向切面编程）框架。它借鉴了 AspectJ 的设计理念，提供了 call 和 execute 语法，允许开发者对 Dart 代码进行切面编程。由于 Flutter 中无法使用 dart:mirrors，AspectD 还提供了一种名为 inject 的方式来增强 Dart 代码的操控能力。此外，AspectD 提供了一个 dill 转换器容器，开发者可以在其基础上实现自定义的转换器，如钩子、JSON、镜像等。

2、项目快速启动

安装步骤

1. 创建 Dart 包： 在项目目录下创建一个名为 aspectd_impl 的 Dart 包。

   flutter create --template=package aspectd_impl
   

2. 添加依赖： 在 aspectd_impl 包的 pubspec.yaml 文件中添加 aspectd 和 example 依赖。

   dependencies:
     flutter:
       sdk: flutter
     aspectd:
       git:
         url: git@github.com:XianyuTech/aspectd.git
         ref: stable/v2.2.3
     example:
       path: ../example
   

3. 修改 aspectd_impl 包： 修改 aspectd_impl 包的入口文件 aspectd_impl.dart，并添加 AOP 实现。

   import 'package:example/main.dart' as app;
   import 'aop_impl.dart';
   
   void main() => app.main();
   

   在 aop_impl.dart 中添加 AOP 实现：

   import 'package:aspectd/aspectd.dart';
   
   @Aspect()
   @pragma("vm:entry-point")
   class ExecuteDemo {
     @pragma("vm:entry-point")
     ExecuteDemo();
   
     @Execute("package:example/main.dart", "_MyHomePageState", "-_incrementCounter")
     @pragma("vm:entry-point")
     void _incrementCounter(PointCut pointcut) {
       pointcut.proceed();
       print('KWLM called');
     }
   }
   

4. 应用 AspectD 补丁： 修改 Flutter 工具以应用 AspectD 的 Dart 快照。

   cd path-for-flutter-git-repo
   git apply --3way path-for-aspectd-package/0001-aspectd.patch
   rm bin/cache/flutter_tools.stamp
   

3、应用案例和最佳实践

案例一：日志记录

假设我们有一个 Calculator 类，我们希望在每次调用 getCurTime 方法时记录日志。

import 'package:aspectd/aspectd.dart';

@Aspect()
@pragma("vm:entry-point")
class CallDemo {
  @Call("package:app/calculator.dart", "Calculator", "-getCurTime")
  @pragma("vm:entry-point")
  Future<String> getCurTime(PointCut pointcut) async {
    print('Aspectd:KWLM02');
    print('${pointcut.sourceInfos.toString()}');
    Future<String> result = pointcut.proceed();
    String test = await result;
    print('Aspectd:KWLM03');
    print('${test}');
    return result;
  }
}

案例二：性能监控

假设我们希望在 GestureDetector 的 build 方法中插入性能监控代码。

import 'package:aspectd/aspectd.dart';

@Aspect()
@pragma("vm:entry-point")
class InjectDemo {
  @Inject("package:flutter/src/widgets/gesture_detector.dart", "GestureDetector", "-build", lineNum: 452)
  @pragma("vm:entry-point")
  static void onTapBuild() {
    // 性能监控代码
  }
}

4、典型生态项目

Flutter 插件开发

AspectD 可以用于 Flutter 插件的开发，特别是在需要对 Flutter 核心代码进行 AOP 编程时。例如，开发者可以使用 AspectD 对 Flutter 的 runApp 方法进行切面编程，以实现自定义的启动逻辑。

性能优化

在性能优化方面，AspectD 可以帮助开发者在不修改源代码的情况下，对关键代码路径进行性能监控和优化。例如，通过 inject 方式在关键代码路径中插入性能监控代码，从而实现对应用性能的实时监控。

安全增强

AspectD 还可以用于增强应用的安全性。例如，开发者可以使用 execute 方式对敏感操作进行切面编程，以实现权限检查和日志记录，从而提高应用的安全性。

aspectd AOP for Flutter(Dart) 项目地址: https://gitcode.com/gh_mirrors/as/aspectd