Flutter aspectd （二）源码解析

引导

在上一篇文章中，我们进行了apply patch文件，那么我们来看看apply的文件，具体做了哪些事情。可以看到是在common.dart文件做了更改，和新加了一个aspectd.dart文件

common.dart文件

该文件所在目录：

packages/flutter_tools/lib/build_system/targets/common.dart

可以看到在build方法新增了如下代码：

 @override
  Future<void> build(Environment environment) async {
    // 这是原来的代码
    await buildImpl(environment);
    // 这是新增代码
    if (await AspectdHook.isAspectdEnabled()) {
        await AspectdHook().runBuildDillCommand(environment);
    }
  }

AspectdHook.isAspectdEnabled()

上面代码调用了AspectdHook.isAspectdEnabled()，看看这里面做了什么

  static Future<bool> isAspectdEnabled() async {
    final Directory currentDirectory = globals.fs.currentDirectory;
    
    // 获取到aspectd_impl对应的目录，详情见下面
    final Directory aspectdDirectory = getAspectdImplDirectory(currentDirectory);
    // 如果该目录不存在，返回false，不走aspectd逻辑
    if (!aspectdDirectory.existsSync()) {
      return false;
    }
    
    // 拿到aspectd_imple项目下的.packages文件，因为要取该文件，所以我们需要先执行 pub get
    final String aspectdImplPackagesPath = globals.fs.path.join(aspectdDirectory.absolute.path, '.packages');
    // 通过.package文件中的数据，得到aspectd目录，从而得到frontend_server.dart.snapshot所在的目录，具体见下方
    final Directory flutterFrontendServerDirectory = await getFlutterFrontendServerDirectory(aspectdImplPackagesPath);
    
    // 判断如果aspectd_impl项目不存在或frontend_server.dart.snapshot对应目录不存在 及 对应的文件不存在的话返回false
    if (!(aspectdDirectory.existsSync() &&
        flutterFrontendServerDirectory.existsSync() &&
        currentDirectory.absolute.path != aspectdDirectory.absolute.path &&
        globals.fs
            .file(globals.fs.path.join(aspectdDirectory.path, 'pubspec.yaml'))
            .existsSync() &&
        globals.fs
            .file(
            globals.fs.path.join(aspectdDirectory.path, '.packages'))
            .existsSync() &&
        globals.fs
            .file(globals.fs.path.join(
            aspectdDirectory.path, 'lib', aspectdImplPackageName + '.dart'))
            .existsSync())) {
      return false;
    }
    // 生成frontend_server.dart.snapshot，具体见下方
    return await checkAspectdFlutterFrontendServerSnapshot(aspectdImplPackagesPath);
  }

下面就是获取到aspectd_impl目录的具体方法

const String aspectdImplPackageRelPath = '..';
const String aspectdImplPackageName = 'aspectd_impl';

.
.
.

  static Directory getAspectdImplDirectory(Directory rootProjectDir) {
    return globals.fs.directory(globals.fs.path.normalize(globals.fs.path.join(
        rootProjectDir.path,
        aspectdImplPackageRelPath,
        aspectdImplPackageName)));
  }

获取aspectd对应的项目，及该项目下的flutter_frontend_server目录

 static Future<Directory> getFlutterFrontendServerDirectory(
      String packagesPath) async {
      // 找到aspectd对应项目的路径后，添加具体flutter_frontend_server对应的路径
    return globals.fs.directory(globals.fs.path.join(
        (await getPackagePathFromConfig(packagesPath, 'aspectd')).absolute.path,
        'lib',
        'src',
        'flutter_frontend_server'));
  }

 static Future<Directory> getPackagePathFromConfig(String packageConfigPath, String packageName) async {
    // 取出.package中的信息
    final PackageConfig packageConfig = await loadPackageConfigWithLogging(globals.fs.file(packageConfigPath),logger: globals.logger,);
    if ((packageConfig?.packages?.length ?? 0) > 0) {
      final Package aspectdPackage = packageConfig.packages.toList().firstWhere(
                // 找到我们要找的信息
              (Package element) => element.name == packageName,
          orElse: () => null);
        // 返回找到的路径
      return globals.fs.directory(aspectdPackage.root.toFilePath());
    }
    return null;
  }

生成frontend_server.dart.snapshot

const String frontendServerDartSnapshot = 'frontend_server.dart.snapshot';


static Future<bool> checkAspectdFlutterFrontendServerSnapshot(
      String packagesPath) async {
      // 获取到frontend_server.dart.snapshot对应上级目录，及文件对应路径
    final Directory flutterFrontendServerDirectory = await getFlutterFrontendServerDirectory(packagesPath);
    final String aspectdFlutterFrontendServerSnapshot = globals.fs.path.join(flutterFrontendServerDirectory.absolute.path,frontendServerDartSnapshot);
    
    // 获取到系统的frontend_server.dart.snapshot对应的路径
    final String defaultFlutterFrontendServerSnapshot = globals.artifacts.getArtifactPath(Artifact.frontendServerSnapshotForEngineDartSdk);
    
    // 如果frontend_server.dart.snapshot不存在，那么进行创建
    if (!globals.fs.file(aspectdFlutterFrontendServerSnapshot).existsSync()) {
    
        // 在getDartSdkDependency中执行pub get以便获取到aspectd对应项目中的.package,从而能得到dartSdkDir，详情见下方
      final String dartSdkDir = await getDartSdkDependency((await getPackagePathFromConfig(packagesPath, 'aspectd')).absolute.path);

        // 获取到flutter_frontend_server文件夹下的package_config.json
      final String frontendServerPackageConfigJsonFile = '${flutterFrontendServerDirectory.absolute.path}/package_config.json';
        // 获取到flutter_frontend_server文件夹下的rebased_package_config.json,一开始是不存在的，下面会往里面放东西
      final String rebasedFrontendServerPackageConfigJsonFile = '${flutterFrontendServerDirectory.absolute.path}/rebased_package_config.json';
      // 读取package_config.json中数据
      String frontendServerPackageConfigJson = globals.fs.file(frontendServerPackageConfigJsonFile).readAsStringSync();
      // 把上面读取到的数据中的../../../third_party/dart/替换为真是的dartSdkDir目录，即上面得到的kernel目录
      frontendServerPackageConfigJson = frontendServerPackageConfigJson.replaceAll('../../../third_party/dart/', dartSdkDir);
      // 将上面替换后的数据写到rebased_package_config.json文件中
      globals.fs.file(rebasedFrontendServerPackageConfigJsonFile).writeAsStringSync(frontendServerPackageConfigJson);

        // 准备生成frontend_server.dart.sanpshot文件对应的命令
      final List<String> commands = <String>[
        globals.artifacts.getArtifactPath(Artifact.engineDartBinary),
        '--deterministic',
        '--packages=$rebasedFrontendServerPackageConfigJsonFile',
        '--snapshot=$aspectdFlutterFrontendServerSnapshot',
        '--snapshot-kind=kernel',
        '${flutterFrontendServerDirectory.absolute.path}/starter.dart'
      ];
      // 执行命令生成frontend_server.dart.snapshot
      final ProcessResult processResult =await globals.processManager.run(commands);
      // 删除上面拷贝的那一份rebased_package_config.json文件（已经生成frontend_server.dart.server，所以不需要了）
      globals.fs.file(rebasedFrontendServerPackageConfigJsonFile).deleteSync();
      
      //异常判断
      if (processResult.exitCode != 0 || globals.fs.file(aspectdFlutterFrontendServerSnapshot).existsSync() ==false) {
        throwToolExit('Aspectd unexpected error: ${processResult.stderr.toString()}');
      }
    }
    
    // 查看系统中的frontend_server.dart.snapshot是否存在，存在的话删除掉
    if (globals.fs.file(defaultFlutterFrontendServerSnapshot).existsSync()) {
      globals.fs.file(defaultFlutterFrontendServerSnapshot).deleteSync();
    }
    // 把刚才生成的文件拷贝到系统
    globals.fs.file(aspectdFlutterFrontendServerSnapshot).copySync(defaultFlutterFrontendServerSnapshot);
    return true;
  }

  static Future<String> getDartSdkDependency(String aspectdDir) async {
    // 在aspectdDir下（即aspectd所在项目）执行pub get从而生成.package文件
    final ProcessResult processResult = await globals.processManager.run(
        <String>[
          globals.fs.path.join(
              globals.artifacts.getArtifactPath(Artifact.engineDartSdkPath),
              'bin',
              'pub'),
          'get',
          '--verbosity=warning'
        ],
        workingDirectory: aspectdDir,
        environment: <String, String>{'FLUTTER_ROOT': Cache.flutterRoot});
        
    // 异常卡控
    if (processResult.exitCode != 0) {
      throwToolExit(
          'Aspectd unexpected error: ${processResult.stderr.toString()}');
    }
    
    // 根据.package文件找到kernel对应的具体目录，也就是dart sdk的目录
    final Directory kernelDir = await getPackagePathFromConfig(
        globals.fs.path.join(aspectdDir, '.packages'), 'kernel');
    return kernelDir.parent.parent.uri.toString();
  }

综合，在调用isAspectdEnabled方法的时候，做了2件事情：1.判断是否存在aspectd_impl和aspectd项目，不存在就不走aspectd这一套，防止其他项目有问题，2.生成frontend_server.dart.snapshot文件，并替换掉系统中的该文件。

frontend_server.dart.snapshot的作用：把我们的dart代码编译成app.dill

AspectdHook().runBuildDillCommand(environment)

上面只是做了一些准备工作，之后就是真正的将dart代码编译成dill

Future<void> runBuildDillCommand(Environment environment) async {

    // 把系统的当前指向目录切换到aspectd_impl目录下方
    final Directory aspectdDir = getAspectdImplDirectory(globals.fs.currentDirectory);
    final Directory previousDirectory = globals.fs.currentDirectory;
    globals.fs.currentDirectory = aspectdDir;

    // 指定产物所在的目录，及编译工作所在的目录
    String relativeDir = environment.outputDir.absolute.path.substring(environment.projectDir.absolute.path.length +  1);
    final String outputDir = globals.fs.path.join(aspectdDir.path, relativeDir);
    final String buildDir =globals.fs.path.join(aspectdDir.path, '.dart_tool', 'flutter_build');

    // 指定要编译的dart文件，这里是aspectd_impl.dart,改文件起到了承上启下的作用，能把要插入的代码和我们写的代码串到一起，见下方
    final Map<String, String> defines = environment.defines;
    defines[kTargetFile] = globals.fs.path.join(aspectdDir.path, 'lib', aspectdImplPackageName + '.dart');

    // 准备编译环境
    final Environment auxEnvironment = Environment(
        projectDir: aspectdDir,
        outputDir: globals.fs.directory(outputDir),
        cacheDir: environment.cacheDir,
        flutterRootDir: environment.flutterRootDir,
        fileSystem: environment.fileSystem,
        logger: environment.logger,
        artifacts: environment.artifacts,
        processManager: environment.processManager,
        engineVersion: environment.engineVersion,
        buildDir: globals.fs.directory(buildDir),
        defines: defines,
        inputs: environment.inputs);
    const KernelSnapshot auxKernelSnapshot = KernelSnapshot();
    
    // 进行编译，获得产物
    final CompilerOutput compilerOutput = await auxKernelSnapshot.buildImpl(auxEnvironment);

    // 把生成的产物拷贝到我们写的项目的.dart_tool/flutter_build/对应目录下（因为上方生成的app.dill产物是在aspectd_impl项目中）
    final String aspectdDill = compilerOutput.outputFilename;
    final File originalDillFile = globals.fs.file(globals.fs.path.join(environment.buildDir.absolute.path, 'app.dill'));
    // 这里是把我们写的项目中存在的app.dill进行了备份
    if (originalDillFile.existsSync()) {
      originalDillFile.renameSync(originalDillFile.absolute.path + '.bak');
    }
    // 具体的拷贝app.dill方法
    globals.fs.file(aspectdDill).copySync(originalDillFile.absolute.path);
    globals.fs.currentDirectory = previousDirectory;
  }

import 'package:sensors_demo/main.dart' as app;

// 下面就是导入的要插入的代码，它里面的注解能够使它虽没被引用，依然能参与编译
import 'sensorsdata_aop_impl.dart';
import 'sa_autotrack.dart';

// 这里调用的是我们写的代码中的main方法，所以生成的app.dill中包含aspect_impl及我们写的代码
void main()=> app.main();

总结

aspectd中都做了哪些事情：

判断当前执行项目的上一级中是否有aspect_impl项目，有的话就走aspectd逻辑。
生成frontend_server.dart.snapshot文件，并替换flutter sdk中对应的该文件。aspectd源码中的flutter_frontend_server文件下的就是对应做这个事情的。（frontend_server.dart.snapshot是用来把dart代码编译成dill）
把我们写的代码及要插入的代码一起编译成app.dill。我们写的代码是通过aspect_impl项目中的main方法调用了我们项目中的main方法。而插入的代码是通过注解实现的，在frontend_server.dart.snapshot将dart编译成app.dill过程中，会把注解转换为具体代码插入到抽象语法树（AST）中。涉及到的就是aspectd源码中的transformer中的文件。这也是为什么要用自己生成的frontend_server.dart.snapshot文件替换系统的该文件，因为aspectd生成的frontend_server.dart.snapshot中能够把注解转换为具体代码插入到AST中，从而最后生成的app.dill中是包含所有的代码。

为了好理解，写的有些啰嗦，悟性好的直接看阿里提供的图：

image

人面猴
序言：七十年代末，一起剥皮案震惊了整个滨河市，随后出现的几起案子，更是在滨河造成了极大的恐慌，老刑警刘岩，带你破解...
沈念sama阅读 203,324评论 5赞 476
死咒
序言：滨河连续发生了三起死亡事件，死亡现场离奇诡异，居然都是意外死亡，警方通过查阅死者的电脑和手机，发现死者居然都...
沈念sama阅读 85,303评论 2赞 381
救了他两次的神仙让他今天三更去死
文/潘晓璐我一进店门，熙熙楼的掌柜王于贵愁眉苦脸地迎上来，“玉大人，你说我怎么就摊上这事。” “怎么了？”我有些...
开封第一讲书人阅读 150,192评论 0赞 337
道士缉凶录：失踪的卖姜人
文/不坏的土叔我叫张陵，是天一观的道长。经常有香客问我，道长，这世上最难降的妖魔是什么？我笑而不...
开封第一讲书人阅读 54,555评论 1赞 273
港岛之恋（遗憾婚礼）
正文为了忘掉前任，我火速办了婚礼，结果婚礼上，老公的妹妹穿的比我还像新娘。我一直安慰自己，他们只是感情好，可当我...
茶点故事阅读 63,569评论 5赞 365
恶毒庶女顶嫁案：这布局不是一般人想出来的
文/花漫我一把揭开白布。她就那样静静地躺着，像睡着了一般。火红的嫁衣衬着肌肤如雪。梳的纹丝不乱的头发上，一...
开封第一讲书人阅读 48,566评论 1赞 281
城市分裂传说
那天，我揣着相机与录音，去河边找鬼。笑死，一个胖子当着我的面吹牛，可吹牛的内容都是我干的。我是一名探鬼主播，决...
沈念sama阅读 37,927评论 3赞 395
双鸳鸯连环套：你想象不到人心有多黑
文/苍兰香墨我猛地睁开眼，长吁一口气：“原来是场噩梦啊……” “哼！你这毒妇竟也来了？” 一声冷哼从身侧响起，我...
开封第一讲书人阅读 36,583评论 0赞 257
万荣杀人案实录
序言：老挝万荣一对情侣失踪，失踪者是张志新（化名）和其女友刘颖，没想到半个月后，有当地人在树林里发现了一具尸体，经...
沈念sama阅读 40,827评论 1赞 297
护林员之死
正文独居荒郊野岭守林人离奇死亡，尸身上长有42处带血的脓包…… 初始之章·张勋以下内容为张勋视角年9月15日...
茶点故事阅读 35,590评论 2赞 320
白月光启示录
正文我和宋清朗相恋三年，在试婚纱的时候发现自己被绿了。大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
茶点故事阅读 37,669评论 1赞 329
活死人
序言：一个原本活蹦乱跳的男人离奇死亡，死状恐怖，灵堂内的尸体忽然破棺而出，到底是诈尸还是另有隐情，我是刑警宁泽，带...
沈念sama阅读 33,365评论 4赞 318
日本核电站爆炸内幕
正文年R本政府宣布，位于F岛的核电站，受9级特大地震影响，放射性物质发生泄漏。R本人自食恶果不足惜，却给世界环境...
茶点故事阅读 38,941评论 3赞 307
男人毒药：我在死后第九天来索命
文/蒙蒙一、第九天我趴在偏房一处隐蔽的房顶上张望。院中可真热闹，春花似锦、人声如沸。这庄子的主人今日做“春日...
开封第一讲书人阅读 29,928评论 0赞 19
一桩弑父案，背后竟有这般阴谋
文/苍兰香墨我抬头看了看天上的太阳。三九已至，却和暖如春，着一层夹袄步出监牢的瞬间，已是汗流浃背。一阵脚步声响...
开封第一讲书人阅读 31,159评论 1赞 259
情欲美人皮
我被黑心中介骗来泰国打工，没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留，地道东北人。一个月前我还...
沈念sama阅读 42,880评论 2赞 349
代替公主和亲
正文我出身青楼，却偏偏与公主长得像，于是被迫代替她去往敌国和亲。传闻我的和亲对象是个残疾皇子，可洞房花烛夜当晚...
茶点故事阅读 42,399评论 2赞 342