はじめに

OpenHarmonyの大規模なFlutterプロジェクト開発において、`json_serializable`、`freezed`、または`moor`のようなライブラリを使って、手動での退屈な定型コードを書く代わりに自動化することが一般的になっています。これらの強力なツールを支える基盤フレームワークこそが**`build`**パッケージです。

`build`は単なるツールではありません。Dartのコード生成プロトコル全体を定義するフレームワークであり、開発者がコンパイルプロセスに「プラグイン方式」で介入し、ソースコードの分析、変換、新規ファイルの生成をコンパイラのソースコードを修正することなく実現できるようにします。

コア生成アーキテクチャの解析

`build`パッケージは`Builder`インターフェースを定義することで、複雑なインクリメンタルビルドのロジックを単純な「入力-出力」モデルに抽象化しています。

主要APIの実践

2.1 シンプルなビルダーの定義

import 'package:build/build.dart';

/// 💡 シンプルなビルダーの例：各.txtファイルに対応する.infoファイルを生成
class DocumentInfoBuilder implements Builder {
  @override
  final buildExtensions = const {
    '.txt': ['.info']
  };

  @override
  Future<void> build(BuildStep buildStep) async {
    // 1. 入力ファイルの内容を読み込む
    final inputAsset = buildStep.inputId;
    final fileContent = await buildStep.readAsString(inputAsset);

    // 2. 出力パスを準備
    final outputAsset = inputAsset.changeExtension('.info');

    // 3. 生成された内容を書き込む
    await buildStep.writeAsString(outputAsset, 'コンテンツ長: ${fileContent.length} バイト');
  }
}

2.2 Resolverを使用した型情報の取得

OpenHarmonyのアダプタープラグインでは、クラス構造の分析が必要になることがよくあります。

Future<void> analyzeClassStructure(BuildStep buildStep) async {
  // 💡 現在ライブラリの完全なセマンティック情報を取得
  final library = await buildStep.resolver.libraryFor(buildStep.inputId);
  
  // クラス、メソッド、プロパティを反復処理
  for (var element in library.topLevelElements) {
    print('トップレベル要素を発見: ${element.name}');
  }
}

一般的な使用シナリオ

3.1 OpenHarmonyカスタムプロトコルジェネレーター

OpenHarmonyのネイティブ分散プロトコルを開発している場合、`@OhosService`アノテーションを定義し、`build`を使用してDartからArkTSへのブリッジング定型コードを自動生成できます。これにより、MethodChannelを手動で維持する手間が完全になくなります。

3.2 自動リソースマニフェスト

OpenHarmonyアプリをパッケージ化する前に、`assets`ディレクトリを自動スキャンし、すべてのリソースパスを含む静的定数クラスを生成します。これにより、手動でのファイル名入力によるタイプミス（Typo）を防ぎます。

OpenHarmonyプラットフォームの適応

4.1 インクリメンタルビルドのパフォーマンス

ヒント：OpenHarmonyプロジェクトのコード量は通常急速に増加します。`build`フレームワークは極限まで効率的なインクリメンタルビルドをサポートしており、どのファイルが変更されたかを正確に検知できます。OpenHarmonyのDevEco Studio開発環境で`build_runner watch`と組み合わせることで、「保存即更新」を実現でき、頻繁にクロスプラットフォームインターフェースを調整するOpenHarmony開発者にとって大きな効率向上につながります。

4.2 絟一生成規範

OpenHarmonyプロジェクトのルートディレクトリにある`build.yaml`で`build`オプションを構成することで、チーム内のすべての生成コードのディレクトリ構造を統一できます（例えば、すべて`.dart_tool/build/generated`に出力）。これにより、OpenHarmonyプロジェクトのディレクトリが整理され、プロフェッショナルなレベルの品質要件を満たします。

完全な実践例：OpenHarmonyバージョン番号自動注入ツール

この例では、ビルダーを作成し、ビルド時に`pubspec.yaml`のバージョン情報をコードに自動的に注入する方法を示します。

import 'package:build/build.dart';

class VersionInjectorBuilder implements Builder {
  @override
  final buildExtensions = const {
    'pubspec.yaml': ['lib/version_constants.g.dart']
  };

  @override
  Future<void> build(BuildStep buildStep) async {
    // 1. pubspecファイルのテキストを読み込む
    final fileContent = await buildStep.readAsString(buildStep.inputId);
    
    // 💡 バージョン番号の簡単な正規表現マッチング（実際にはyamlライブラリの使用を推奨）
    final versionMatch = RegExp(r'version: ([\d\.\+]+)').firstMatch(fileContent);
    final appVersion = versionMatch?.group(1) ?? '1.0.0';

    // 2. Dartコードを生成
    final generatedCode = """
// 🛡️ OpenHarmonyビルドシステムによって自動生成、手動での変更は禁止
const String APP_VERSION = '$appVersion';
const String BUILD_TIMESTAMP = '${DateTime.now()}';
""";

    // 3. libディレクトリに書き込む
    await buildStep.writeAsString(
      AssetId(buildStep.inputId.package, 'lib/version_constants.g.dart'),
      generatedCode,
    );
    
    print('✅ OpenHarmonyプロジェクトのバージョン定数を更新: $appVersion');
  }
}

まとめ

`build`パッケージは、OpenHarmony開発者が「作業従事者」から「アーキテクト」へ進化するための階段です。具体的なビジネスロジックを提供するものではありませんが、すべての自動化、スマート化されたDartツールのための標準的な基盤プロトコルを提供します。OpenHarmonyのクロスプラットフォームエコシステムが日増しに複雑化する今日、このメタプログラミングの基盤を習得することは、独自の開発パラダイムを定義し、専用のOpenHarmony生産性ツールを構築するための核心的な能力となります。