「part-of ディレクティブはパート内の唯一のディレクティブでなければなりません」を修正することは、Dart マクロ エラーを修正する 1 つの方法です。

解決策 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 コマンドを使用すると、マクロでクラス内の新しいプロパティまたはメソッドを動的に宣言できるため、特定の条件または構成に基づいてゲッターまたはメソッドを追加する場合に便利です。
7. 「パーツのディレクティブはパーツ内の唯一のディレクティブである必要があります」というエラーが表示されるのはなぜですか?
8. このエラーは、拡張ファイルに追加のインポートが含まれている場合に発生します。 part-of 指令。すべてのインポートは、 part-of 指令。
9. マクロは大規模プロジェクトの定型コードを減らすのに役立ちますか?
10. はい、マクロは大規模なプロジェクトで特に有益であり、依存関係や反復的なメソッドのセットアップを自動化し、コードの管理が容易になり、エラーが発生しにくくなります。
11. どういうことですか buildMethod マクロでやる？
12. の buildMethod マクロ内のコマンドを使用すると、既存のメソッドにアクセスして変更できるため、クラスにすでに存在するメソッドにカスタム動作を追加する場合に便利です。
13. Dart のマクロに対する IDE サポートはありますか?
14. 現在、マクロは主に Flutter ベータ チャネルを使用する場合に VSCode でサポートされており、IDE は拡張されたクラスとメソッドを効果的に表示できます。
15. マクロは Flutter アプリケーションの依存関係をどのように処理しますか?
16. マクロは、コンパイル時に必要なバインディングまたはサービスを生成することで依存関係を処理するのに最適で、複雑な依存関係を動的に管理しやすくなります。
17. なぜですか FunctionBodyCode.fromParts マクロで使われますか？
18. FunctionBodyCode.fromParts さまざまな部分から関数本体を構築するのに役立ち、完全なメソッドを記述するのではなく、モジュール形式でコードをアセンブルできるようになります。これは、拡張メソッドに特定のロジックを追加するのに最適です。
19. Dart のテスト フレームワークを使用してマクロで生成されたコードをテストできますか?
20. はい、Dart のテスト フレームワークを使用して、拡張されたクラスとメソッドの正しい動作を確認する単体テストを作成することで、マクロで生成されたコードの機能を検証できます。

Dart マクロ エラーの管理に関する最終的な考え

Flutter で Dart マクロを使用すると、コードを自動化し、モジュール性を向上させる効率的な方法が開かれますが、「ディレクティブの一部」制約などのエラーには、インポートとディレクティブを慎重に構造化する必要があります。すべてのインポートをライブラリ ファイルに移動すると、特に複雑なマクロ生成クラスを扱う場合に、Dart のルールに合わせるのに役立ちます。

マクロの操作は、厳格なディレクティブ ルールにより制限があると感じるかもしれませんが、これらのテクニックをマスターすると、Flutter プロジェクトを効率化できます。これらのソリューションを実装することで、開発者はパーツ ファイル エラーに遭遇することなくマクロを活用し、効率的かつ準拠性の高いコードを作成できます。 🚀