修复“部分指令必须是部分中的唯一指令”是修复 Dart 宏错误的一种方法。

解决方案 1：调整零件文件的导入和模块结构

在 Flutter（测试版通道）中使用 Dart 宏来分离导入并解决增强文件中的指令冲突。

import 'dart:async';
import 'package:flutter/material.dart';
import 'package:macros/macros.dart';
// Define a macro class that implements ClassDeclarationsMacro and ClassDefinitionMacro
macro class ReviewableModule implements ClassDeclarationsMacro, ClassDefinitionMacro {
  const ReviewableModule();
  @override
  FutureOr<void> buildDeclarationsForClass(ClassDeclaration clazz, MemberDeclarationBuilder builder) async {
    builder.declareInType(DeclarationCode.fromParts(['external List<Bind> get binds;']));
  }
  @override
  FutureOr<void> buildDefinitionForClass(ClassDeclaration clazz, TypeDefinitionBuilder builder) async {
    var bindsGetter = (await builder.methodsOf(clazz)).firstWhere((method) => method.identifier.name == 'binds');
    var bindsMethod = await builder.buildMethod(bindsGetter.identifier);
    bindsMethod.augment(FunctionBodyCode.fromParts(['{\n', 'return [\n', '...augmented,\n', '];\n', '}']));
  }
}

解决方案 2：修改库以处理宏生成的零件中的导入

使用修改后的库结构和代码生成将部件导入限制到主库文件，以满足部件文件限制。

// Original library file
library macros_test;
// List all imports here instead of in part files
import 'dart:core';
import 'package:flutter_modular/src/presenter/models/bind.dart';
part 'home_module.g.dart';
// Macro code in home_module.dart
part of 'package:macros_test/home_module.dart';
augment class HomeModule {
  augment List<Bind> get binds => [...augmented];
}

解决方案 3：集成宏生成代码的单元测试

在 Dart 中创建一个单元测试文件来验证 HomeModule 类中的增强方法，以确保跨环境的预期功能。

// Unit test file: test/home_module_test.dart
import 'package:flutter_test/flutter_test.dart';
import 'package:macros_test/home_module.dart';
void main() {
  group('HomeModule Macro Tests', () {
    test('Check binds augmentation', () {
      final module = HomeModule();
      expect(module.binds, isNotNull);
      expect(module.binds, isA<List<Bind>>());
    });
  });
}

解决有关在 Flutter 中使用 Dart 宏的常见问题

1. 在 Flutter 中使用 Dart 宏的主要目的是什么？
2. 在 Dart 中使用宏的主要目标是在编译时自动执行重复任务并使用自定义功能增强类，从而使开发人员无需手动编写样板代码。
3. 宏如何与 part-of 指示？
4. Dart 中的宏生成的代码必须符合 part-of 指令的限制，这意味着增强文件不应包含额外的导入或指令，它们必须位于主库中。
5. 什么是 declareInType 用于 Dart 宏？
6. 这 declareInType 命令允许宏在类中动态声明新属性或方法，这对于根据某些条件或配置添加 getter 或方法很有用。
7. 为什么我会收到“指令的一部分必须是零件中的唯一指令”错误？
8. 如果增强文件除了以下内容之外还包含任何导入，则会出现此错误 part-of 指示。所有导入都应放置在主库文件中，而不是与主库文件链接的文件中 part-of 指示。
9. 宏可以帮助减少大型项目中的样板代码吗？
10. 是的，宏在大型项目中特别有用，它们可以帮助自动设置依赖项或重复方法，使代码更易于管理且不易出错。
11. 什么是 buildMethod 在宏中做什么？
12. 这 buildMethod 宏中的命令允许访问和修改现有方法，如果您想向类中已存在的方法添加自定义行为，这会很有用。
13. Dart 中是否有支持宏的 IDE？
14. 目前，使用 Flutter beta 通道时，主要在 VSCode 中支持宏，其中 IDE 可以有效地显示增强的类和方法。
15. 宏如何处理 Flutter 应用程序中的依赖关系？
16. 宏非常适合通过在编译时生成必要的绑定或服务来处理依赖关系，从而更轻松地动态管理复杂的依赖关系。
17. 为什么是 FunctionBodyCode.fromParts 在宏中使用？
18. FunctionBodyCode.fromParts 有助于从不同部分构建函数体，从而可以以模块化方式组装代码，而不是编写完整的方法。这非常适合在增强方法中添加特定逻辑。
19. 我可以使用 Dart 的测试框架测试宏生成的代码吗？
20. 是的，您可以使用 Dart 的测试框架通过编写确认增强类和方法的正确行为的单元测试来验证宏生成的代码的功能。

关于管理 Dart 宏错误的最终想法

在 Flutter 中使用 Dart 宏开辟了自动化代码和提高模块化的有效方法，但像“部分指令”约束这样的错误需要仔细构建导入和指令。将所有导入移至库文件有助于符合 Dart 规则，尤其是在处理复杂的宏生成的类时。

虽然由于严格的指令规则，使用宏可能会受到限制，但掌握这些技术可以简化您的 Flutter 项目。通过实施这些解决方案，开发人员可以利用宏而不会遇到零件文件错误，从而创建高效且合规的代码。 🚀