---
title: "Flutterのビルドフック（Native Assets）とは？hook/build.dartの書き方とFFI連携【Dart 3.13】"
url: "https://www.issoh.co.jp/tech/details/10305/"
published: 2025-12-17
updated: 2026-11-10
categories: ["Flutter"]
publisher: "株式会社一創"
---

# Flutterのビルドフック（Native Assets）とは？hook/build.dartの書き方とFFI連携【Dart 3.13】

Flutterのビルドフック（build hooks）は、パッケージの `hook/build.dart` に書いたDartスクリプトでC・C++・Rustなどのネイティブコードをビルドし、アプリに同梱する仕組みです。旧称はNative Assetsで、2025年11月12日公開のDart 3.10で安定版になり、Flutter 3.38から実験フラグなしで使えます。呼び出し側は `dart:ffi` の `@Native` を付けた関数を書くだけで、Platform Channelsのようなホスト言語側のコードは要りません。

基準は2026年11月10日時点の安定版（Flutter 3.47.9／Dart 3.13.7）です。コードと出力はmacOS x64で実行したもので、iOS・Androidのビルドは行っていないため、配布の節は公式ドキュメントを根拠にしています。検索語の「flutter hooks」はflutter\_hooksパッケージを指す場合もありますが別物で、違いはよくある質問で触れます。

## まとめ：Flutterのビルドフック（Native Assets）の要点

- **正体**：`hook/build.dart` がビルド中に自動実行され、生成した動的ライブラリを「コードアセット」としてアプリに同梱する。Dart 3.10（2025-11-12）で安定化、旧称はNative Assets。
- **必要なパッケージ**：`hooks`（2.2.0）と `code_assets`（2.2.0）。Cをソースからビルドするなら `native_toolchain_c`（0.19.6）を足す。
- **呼び出し方**：`@Native` と `external` で宣言した関数が、アセットID `package:<パッケージ名>/<assetName>` のライブラリへ自動で結び付く。
- **実行**：`dart run`・`dart test`・`dart build cli`・`flutter run` で自動実行される。`dart compile exe` はフック付きパッケージを拒否する。
- **Dart 3.13の追加**：`hook/link.dart` で使うC関数だけを残せる。SQLiteでは1,351,680バイトが51,472バイトになった。ただし関数に `@RecordUse()` が無いと、エラーなしでライブラリごと消える。
- **使い分け**：同期で速く呼びたいC/C++/Rustの処理はビルドフック＋FFI。OS機能や画面連携、Flutterのプラグイン APIが必要なものは従来のプラグイン。

## ビルドフック（hooks）の仕組みとNative Assetsからの経緯

フックは、Dartパッケージの `hook/` に置くDartスクリプトです。Dart SDKが見つけて実行し、決まった形式の出力を受け取ります。現在使えるのはビルドフックとリンクフックの2種類です。

### hook/build.dartとhook/link.dartの役割

[dart.devのHooksガイド](https://dart.dev/tools/hooks)によれば、ビルドフックはパッケージごとに実行され、ネイティブコンパイラの呼び出しや事前ビルド済みバイナリのダウンロードを担います。依存先のフックが作ったアセットを使えるよう、実行順はpubspecの依存関係の順です。そのため、フックを使うパッケージ同士の循環依存は扱えません。

リンクフックはバンドル段階でアプリ全体の情報を受け取り、使わないネイティブコードを削ります。

### Native Assetsからビルドフックへの改称と安定化の時期

Dart 3.10.0のCHANGELOGは「Support for hooks — formerly know as native assets — are now stable.」と記しています。Flutter側では、[公式ガイド](https://docs.flutter.dev/interop/bind-native-code)が3.38以降のネイティブ連携に `flutter create --template=package_ffi` を勧めています。OS別のビルドファイル（`CMakeLists.txt`・`.podspec`・`build.gradle`）を書かなくて済むのが、従来のFFIプラグインとの最大の違いです。

3.38から3.47までの各版の変更点は、[Flutter 3.47とは？material\_ui移行・iOS 15と3.47.7までの修正【2026年10月時点】](/tech/details/16894/)や[Flutter 3.44の変更点｜SPM既定化・HCPP・AGP 9と3.44.9までの修正履歴](/tech/details/15767/)で扱っています。

### 関連パッケージと2026年11月時点の版

| パッケージ                | 最新版    | 公開日（UTC）   | 役割                     |
| -------------------- | ------ | ---------- | ---------------------- |
| `hooks`              | 2.2.0  | 2026-08-18 | build()／link()とフック入出力  |
| `code_assets`        | 2.2.0  | 2026-11-06 | CodeAssetと対象OS・CPU     |
| `native_toolchain_c` | 0.19.6 | 2026-11-06 | C/C++/Objective-Cのビルド  |
| `record_use`         | 1.1.1  | 2026-08-18 | リンクフックへ渡す使用記録          |
| `data_assets`        | 0.20.0 | 2026-05-18 | データアセット（実験段階）          |
| `ffigen`             | 23.0.0 | 2026-10-06 | Cヘッダからのバインディング生成       |
| `jnigen`             | 1.0.1  | 2026-10-01 | Java/Kotlin向けバインディング生成 |

[code\_assetsの2.0.0](https://pub.dev/packages/code%5Fassets/changelog)では、`OS`・`Architecture`・`Sanitizer` を `const` のMapやSetのキーに使えなくなりました。1.x系から上げるときの確認点はここです。一方、`native_toolchain_c` と `data_assets` はREADMEに「Status: Experimental」とあるlabs.dart.dev公開の0.x系です。`native_toolchain_c` は更新のたびにCHANGELOGと対象OSのビルド結果を確かめ、`data_assets` の本番採用は待ちましょう。

## 最小構成の実装手順：Dartから呼ぶC関数の例

Cの加算関数を1つビルドしてDartから呼びます。パッケージ側の書き方はFlutterアプリでも同じです。

### pubspec.yamlとネイティブソース

`dart pub add hooks code_assets native_toolchain_c` で依存を足します。書く場所は `dev_dependencies` ではなく `dependencies` です。フックは依存元のアプリから実行されるため、フックのコードも依存解決に含める必要があります。

```
name: hookdemo
environment:
  sdk: ^3.10.0

dependencies:
  code_assets: ^2.2.0
  hooks: ^2.2.0
  native_toolchain_c: ^0.19.6

dev_dependencies:
  test: ^1.25.6
```

```
// src/add.h
#include <stdint.h>
#define OFFSET 0
```

```
// src/add.c
#include "add.h"
#if defined(_WIN32)
__declspec(dllexport)
#endif
int32_t add(int32_t a, int32_t b) { return a + b + OFFSET; }
```

### hook/build.dartでのCのビルド設定とCBuilder・CLibraryの選択

```
// hook/build.dart
import 'package:code_assets/code_assets.dart';
import 'package:hooks/hooks.dart';
import 'package:native_toolchain_c/native_toolchain_c.dart';

void main(List<String> args) async {
  await build(args, (input, output) async {
    if (!input.config.buildCodeAssets) return;
    await CBuilder.library(
      name: 'add',
      assetName: 'src/add_bindings.dart',
      sources: ['src/add.c', 'src/add.h'],
    ).run(input: input, output: output);
  });
}
```

`assetName` には、ネイティブ関数を宣言するDartファイルの `lib/` からの相対パスを書きます。生成されるアセットIDは `package:hookdemo/src/add_bindings.dart` です。`sources` に `add.h` を入れている理由は後述します。

dart.devの例は `CLibrary` を使い、Flutterの `package_ffi` テンプレートは `CBuilder.library` を使っています。選び方は単純で、リンクフックを置かないなら `CBuilder` です。`CLibrary.build` は、リンクが有効なビルドでは成果物をリンクフックへ回します。そのため `hook/link.dart` を置かずに `CLibrary.build` を使うと、`dart build cli` の `bundle/lib` にライブラリが出力されませんでした。

### @Nativeでのバインディングとテスト

```
// lib/src/add_bindings.dart
import 'dart:ffi';

@Native<Int32 Function(Int32, Int32)>()
external int add(int a, int b);
```

`@Native` の `assetId` と、ライブラリに付ける `@DefaultAsset` の両方を省くと、宣言したファイル自身のライブラリURIがアセットIDになります。`assetName` とファイルパスを一致させれば、それだけで解決します。

```
// lib/hookdemo.dart
export 'src/add_bindings.dart' show add;
```

```
// bin/main.dart
import 'package:hookdemo/hookdemo.dart';

void main() => print('2 + 3 = ${add(2, 3)}');
```

```
// test/add_test.dart
import 'package:hookdemo/hookdemo.dart';
import 'package:test/test.dart';

void main() {
  test('add via build hook', () => expect(add(2, 3), 5));
}
```

### 実行結果とdart build cliの出力

Dart 3.13.7（macOS x64）での実行結果の抜粋です（出力先のパスは短くしています）。`dart build cli` は実行ファイルの隣の `bundle/lib/` へ動的ライブラリを置きます。

```
$ dart run bin/main.dart
Running build hooks...2 + 3 = 5

$ dart test
00:00 +1: All tests passed!

$ dart build cli
Running build hooks...Running link hooks...Running link hooks...Copying 1 build assets:
package:hookdemo/src/add_bindings.dart
Generated: build/cli/macos_x64/bundle/bin/main

$ dart compile exe bin/main.dart
'dart compile' does not support build hooks, use 'dart build' instead.
Packages with build hooks: hookdemo.
```

CLIツールを配るなら `dart build cli` が前提です。Xcodeを入れずCommand Line Toolsだけの環境では、ビルド中に `xcrun: error: SDK "iphoneos" cannot be located` がいくつも表示されましたが、macOS向けのビルドは完走しました。

### Flutterのpackage\_ffiテンプレートの生成物

`flutter create --template=package_ffi native_add` は、`hook/build.dart`・`src/native_add.c` と `.h`・`ffigen.yaml`・生成済みバインディング・テスト・`example/` アプリを作ります。OS別のビルドファイルはパッケージ本体に無く、`android/` や `ios/` があるのは `example/` の中だけです。Flutter 3.47.9で生成した直後に `flutter test` を実行すると、2件のテスト（`sum` の同期呼び出しと、別isolateで動かす長時間処理の非同期呼び出し）が通りました。

注意したいのは生成された `pubspec.yaml` です。`code_assets: ^1.1.0` と `hooks: ^2.0.0` のままなので、下で扱う `.h` の列挙を使う場合は、`native_toolchain_c: ^0.19.6` に更新し、その依存に合わせて `code_assets: ^2.2.0` と `hooks: ^2.2.0` に揃えてください。

## アセットIDの解決とつまずきやすいエラー

### assetNameとファイルパスの不一致によるNo asset with id

`assetName` を `src/wrong.dart` に変えると、次の例外で止まります。メッセージに「見つからなかったID」と「実際にあるID」が並ぶので、見比べれば原因がわかります。バインディングのファイルを移動やリネームしたら、フックの `assetName` も同時に直します。

```
Invalid argument(s): Couldn't resolve native function 'add' in
'package:hookdemo/src/add_bindings.dart' : No asset with id
'package:hookdemo/src/add_bindings.dart' found. Available native assets:
package:hookdemo/src/wrong.dart. Attempted to fallback to process lookup.
dlsym(RTLD_DEFAULT, add): symbol not found.
```

### 環境変数が届かない半密閉環境とuser\_definesの書き方

フックは半密閉（semi-hermetic）の環境で動きます。`Platform.environment` に届くのは、`PATH`・`HOME`・一時ディレクトリ・`HTTP_PROXY` 系・`LIBCLANG_PATH`・`ANDROID_HOME` と `ANDROID_NDK` 系・`NIX_` で始まる変数などに限られ、これらが変わるとキャッシュは無効になります。`MY_FLAG=hello dart run` で起動しても、フックの中では `MY_FLAG` は `null` でした。独自の環境変数でビルドは切り替えられません。

設定を渡すには、pubspec.yamlの `hooks.user_defines` を使い、フック側で `input.userDefines` から読みます。pub workspaceではルートのpubspec.yamlに書く必要があり、依存パッケージが既定値を持つこともできません。パッケージ作者の視点では、設定できるのはアプリを作る人だけと考えておくのが安全です。

```
# pubspec.yaml（workspace の場合はルートの pubspec.yaml）
hooks:
  user_defines:
    hookdemo:
      enable_debug_logging: true
```

### ヘッダの変更が再ビルドされない問題と入力ファイルの宣言

Cのヘッダを書き換えたのに結果が変わらない場合は、ヘッダが依存に登録されていないのが原因です。`sources: ['src/add.c']` のまま `add.h` の `OFFSET` を100にしても、`dart run` の結果は5のままでした。`src/add.h` を `sources` に足すと再ビルドされ、105になります。[native\_toolchain\_c 0.19.6](https://pub.dev/packages/native%5Ftoolchain%5Fc/changelog)で、`.h` をコンパイラに渡さず依存としてだけ登録できるようになりました。

`CBuilder` を使わず自前でファイルを読むフックは、`output.dependencies.add(file.uri)` で宣言します。宣言漏れは、そのまま「古いライブラリが残る」不具合になります。

## iOS・Androidへ配布するときの条件

[Flutterの公式ガイド](https://docs.flutter.dev/interop/bind-native-code)（Flutter 3.47基準）は、フックの出力に次の一貫性を求めています。ファイル名の接尾辞で分けるのをやめ、アーキテクチャやSDKごとに分かれている `input.outputDirectory` へ書き出すのが対応策です。

| 条件                    | 違反したときに起きること        |
| --------------------- | ------------------- |
| CPUアーキテクチャ間でファイル名を揃える | lipoでの結合時に片方が選ばれ警告  |
| iOSの実機とシミュレータで名前を揃える  | XCFrameworkを作れず失敗   |
| 全SDKで同じアセットIDの集合を出す   | ビルド失敗やApp Storeでの却下 |

`libsqlite3_arm64.dylib` や `_sim` のような命名が典型的な違反です。iOS側で作られるXCFrameworkの構造は[XCFrameworkとは？作成手順とSwiftPM配布・署名の要点【Xcode 27対応】](/tech/details/9262/)が詳しいです。

ソースからビルドするなら、ストア対応の多くは `native_toolchain_c` が肩代わりします。[CHANGELOG](https://pub.dev/packages/native%5Ftoolchain%5Fc/changelog)によると、0.7.0からAndroid向けの動的ライブラリは既定で16KBページサイズ、0.17.5からApple向けに `-encryptable` リンカーフラグを付けています。事前ビルド済みのバイナリを自分で配る場合は、これらを自分で満たす必要があります。AndroidでC++標準ライブラリを共有リンクする場合は、`libc++_shared.so` の同梱も要ります。静的リンクの場合、この共有ライブラリの同梱は不要です。公式ガイドは `android_libcpp_shared`（0.3.1）のフックで入れる方法を案内しています。

### ユニバーサルMach-O出力の検証とFlutterの版による差

フックは対象アーキテクチャごとに1回ずつ呼ばれるので、複数アーキテクチャをまとめたMach-Oを1回で返すのは誤りです。`code_assets` 2.0.0は、この出力を検証で拒否すると定めています。ただし検証を実行するのは、フックを起動する側に組み込まれた版です。Flutter 3.47.9の `flutter_tools` とDart 3.13.7の組み込みはどちらも `code_assets` 1.2.1で、x86\_64＋arm64のdylibを返すフックを書いても拒否されず、そのまま動きました。Flutter 3.50.0-0.4.preの `flutter_tools` は2.1.0を固定しているので、今は動いている構成が次の安定版で失敗する可能性があります。事前ビルド品を配っているパッケージは、先にアーキテクチャ別へ分けておきましょう。

### システムライブラリと事前ビルド済みバイナリの登録

OSに最初からあるライブラリは、ソースからビルドせずリンク方法だけを宣言します。公式ガイドの例にある `input.target.os` は手元の `code_assets` 2.2.0ではコンパイルできなかったため、次のコードは `input.config.code.targetOS` で書いています。次のコードは `build()` のコールバック内部の抜粋です。先のフックのコールバック本体を置き換え、`hooks` と `code_assets` のimportは残してください。この形でmacOSでの実行を確認しています。

```
// hook/build.dart（システムライブラリを使う場合）
switch (input.config.code.targetOS) {
  case OS.android || OS.iOS || OS.linux || OS.macOS:
    output.assets.code.add(CodeAsset(
      package: input.packageName,
      name: 'src/third_party/unix.dart',
      linkMode: LookupInProcess(),
    ));
  case OS.windows:
    output.assets.code.add(CodeAsset(
      package: input.packageName,
      name: 'src/third_party/windows.dart',
      linkMode: DynamicLoadingSystem(Uri.file('ws2_32.dll')),
    ));
  default:
    throw UnsupportedError('unsupported OS');
}
```

ソースを公開していないライブラリは、ビルド時にダウンロードしてハッシュを照合し、`DynamicLoadingBundled()` の `CodeAsset` として登録するのが公式の推奨手順です。ダウンロードはビルド時に限ります。アプリの起動後に機能を変えるコードを取得して実行する設計は、[App Store Review Guidelines](https://developer.apple.com/app-store/review/guidelines/)の2.5.2が原則として認めていません。

## link hookによるネイティブコードのツリーシェイキング（Dart 3.13）

Dart 3.13で、使用記録（recorded uses）によるツリーシェイキングが入りました。`recordedUses` は `hooks` 2.1.0で実験段階を外れています。ビルド定義をビルドフックとリンクフックで共有するのが基本形です。以下は先のhookdemoとは別の、パッケージ名を `shake` にした例です。先の依存に `record_use` と `meta` を加え、SQLite 3.54.1のアマルガメーションの `sqlite3.c` と `sqlite3.h` を `src/` に配置します。実行用のDartコードから掲載した関数を呼び、`dart build cli` でビルドします。

```
// lib/src/c_library.dart
import 'package:native_toolchain_c/native_toolchain_c.dart';

final cLibrary = CLibrary(
  name: 'sqlite3',
  assetName: 'src/bindings.dart',
  sources: ['src/sqlite3.c'],
  defines: {'SQLITE_API': '__attribute__((visibility("default")))'},
);
```

```
// hook/build.dart
import 'package:hooks/hooks.dart';
import 'package:shake/src/c_library.dart';

void main(List<String> args) async {
  await build(args, (input, output) async {
    await cLibrary.build(input: input, output: output);
  });
}
```

```
// hook/link.dart
import 'package:hooks/hooks.dart';
import 'package:native_toolchain_c/native_toolchain_c.dart';
import 'package:record_use/record_use.dart';
import 'package:shake/src/c_library.dart';

void main(List<String> args) async {
  await link(args, (input, output) async {
    final used = input.recordedUses?.calls.keys
        .cast<Method>()
        .map((e) => e.name);
    await cLibrary.link(
      input: input,
      output: output,
      linkerOptions: LinkerOptions.treeshake(symbolsToKeep: used),
    );
  });
}
```

```
// lib/src/bindings.dart
import 'dart:ffi';
import 'package:meta/meta.dart' show RecordUse;

@RecordUse()
@Native<Int Function()>()
external int sqlite3_libversion_number();

@RecordUse()
@Native<Int Function()>()
external int sqlite3_threadsafe();

@RecordUse()
@Native<Int Function(Pointer<Void>)>()
external int sqlite3_close(Pointer<Void> db);
```

手書きの `@Native` はDart名とCのシンボル名が同じなので `e.name` をそのまま渡せます。ffigenで生成する場合は名前が一致しないことがあるので、公式の [sqlite例](https://github.com/dart-lang/native/tree/main/pkgs/code%5Fassets/example/sqlite)のように `recordUse` を有効にして生成される対応表 `recordUseMapping` を通します。

### @RecordUseを付け忘れるとライブラリごと消える失敗

一番の落とし穴はここです。dart.devの解説は「コンパイラが `@Native` の参照を記録する」と読めますが、手書きの `@Native` だけでは `recordedUses.calls` は空でした。`recordedUses` 自体は `null` ではないので、`symbolsToKeep` は空リストになり、ライブラリのリンクと同梱が丸ごと省かれます。ビルドはエラーなく成功します。

手元ではさらに悪い結果になりました。`bundle/lib` が無いまま実行ファイルは動き、`sqlite3_libversion_number()` は、ビルドしたSQLite 3.54.1の3054001ではなく、3051000を返したのです。プロセス内シンボルへのフォールバックで、macOSに入っている別のSQLiteへつながっていました。OSや他のライブラリと名前が重なるシンボルでは、失敗に気づけないまま別の実装が動きます。リンクフックを入れたら、CIで `bundle/lib` の `.dylib` や `.so` の有無に加え、必要な公開シンボルとライブラリ固有の戻り値も検査してください。このSQLiteの例なら、バージョン番号が3054001であることの確認です。

### SQLite 3.54.1の実測サイズと関数の到達範囲による削減差

SQLite 3.54.1のアマルガメーションを `dart build cli`（macOS x64・Dart 3.13.7）で出力したサイズです。

| 構成                          | dylibサイズ      | 公開シンボル数 |
| --------------------------- | ------------- | ------- |
| ビルドフックのみ（CBuilder）          | 1,351,680 バイト | 279     |
| リンクフック＋libversion\_numberのみ | 51,472 バイト    | 1       |
| リンクフック＋close含む3関数           | 1,346,560 バイト | 3       |

1関数だけなら96%減りますが、`sqlite3_close` を足した瞬間にほぼ元の大きさへ戻ります。`sqlite3_close` から到達できるコードがエンジンの大半に及ぶためです。リンカーが削れるのは到達できないコードだけで、公開関数の数を減らしても中核を呼ぶ関数が残れば効きません。SQLiteのように1つの入口から全体へつながるライブラリより、独立した機能が並ぶ画像処理やコーデック系のほうが削減を期待できます。

確認の際は、ビルドの種類にも注意が必要です。Flutter 3.47.9の `flutter_tools` はdebugビルドでリンクを無効にしていて、リンクフックが動くのはprofileとreleaseだけです。`dart run` でもビルドフックしか走りません。サイズの比較や動作確認は、release相当のビルドで行ってください。

## 既存のFFIプラグインをビルドフックへ移す手順

Flutter 3.47.9の `flutter create --template=plugin_ffi` は「The “plugin\_ffi” template is deprecated and will be removed in a future version of Flutter.」と警告します。新規は `package_ffi` で作り、既存は次の順で移します。

1. Cのソースを `src/` へ集め、`android/`・`ios/`・`macos/`・`linux/`・`windows/` のビルド定義を消す。
2. `pubspec.yaml` の `flutter.plugin.platforms`（`ffiPlugin: true`）を消し、`hooks`・`code_assets`・`native_toolchain_c` を足す。
3. `hook/build.dart` を置く。
4. ffigenの設定に `ffi-native:` を足して `@Native` 形式で生成し直し、`DynamicLibrary.open` の分岐を消す。
5. SDK制約をDart 3.10以上へ上げ、対象の各OSでビルドする。

[sqlite3の3.0.0](https://pub.dev/packages/sqlite3/changelog)はこの移行を破壊的変更として出し、利用者に `sqlite3_flutter_libs` の依存を外すよう案内しました。独立していた同梱用パッケージが不要になるのが、移行の一番の利点です。

急いで移すべきなのは、Flutter以外（`dart run` やサーバー）でも同じパッケージを使いたい場合と、リンクフックでサイズを削りたい場合です。Dart 3.10未満のアプリを抱えている社内プラグインは、SDKを上げるまで移さないでください。SDK制約を上げると、そのアプリは新しい版へ更新できず、古い版に留まります。アプリのネイティブ連携を設計から見直すなら、[Flutter / React Native開発](/service/apps/cross%5Fplatform/)の支援も用意しています。

## FFI（ビルドフック）とPlatform Channels・Pigeon・JNIの使い分け

ビルドフックはFFIでネイティブコードを呼ぶための配布手段で、Platform Channelsの置き換えではありません。

| 方式                | 呼び出し      | ネイティブ側の言語     | 向く処理               |
| ----------------- | --------- | ------------- | ------------------ |
| ビルドフック＋dart:ffi   | 同期・直接     | C／C++／Rust等   | 計算・既存Cライブラリ        |
| Platform Channels | 非同期メッセージ  | Kotlin／Swift等 | OS機能・既存コードの保守      |
| Pigeon（29.1.1）    | 型付きチャネル   | Kotlin／Swift等 | 新規のOS連携            |
| jnigen（1.0.1）     | FFI経由でJNI | Java／Kotlin   | Android APIの直接呼び出し |

画像処理・暗号・圧縮・数値計算のように画面に触れない処理で、C/C++/Rustの資産があるならビルドフック＋FFIを選びます。C++のクラスやRust固有の型はそのまま渡せないので、C互換の関数を公開する境界を用意します。OS機能を新しく呼ぶなら、手書きのチャネルより [Flutter公式も推すPigeon](https://docs.flutter.dev/platform-integration/platform-channels)が先です。PigeonのFFI/JNI直接呼び出しはREADMEで「Preview」扱いです。

ビルドフックを採るべきでない場面もあります。C/Rustのビルドを保守できる人がいないまま、Kotlin/Swiftで書ける小さなOS機能呼び出しのためにFFIへ寄せるのは避けてください。クロスコンパイルの失敗はフックの中で起き、調査の負担がPlatform Channelsより重くなります。FFI呼び出しは呼び出し元のスレッドで同期実行されるため、重い関数は別isolateから呼びます（テンプレートの `native_add.h` にも同じ注記があります）。

### Rust・CMake資産の組み込み用パッケージと選定条件

Rustは、サードパーティ製の `native_toolchain_rust`（1.0.7）がビルドフックからcargoを呼びます。旧名の `native_toolchain_rs` はdiscontinuedなので、古い記事のコードは名前から直します。CMakeで組まれた資産には、サードパーティ製の `native_toolchain_cmake`（0.3.2）があります。どちらもDartチームの公式パッケージではないため、採用前に更新頻度とissueを確かめましょう。既存のSwiftパッケージを持ち込むなら、[Swift Package Manager入門｜使い方とPackage.swift、CocoaPods移行をSwift 6世代で解説](/tech/details/12700/)で扱う従来のプラグインも選択肢に残ります。

## よくある質問

### flutter\_hooksパッケージとビルドフックは同じものですか？

別物です。flutter\_hooks（0.21.4）は、`useState` や `useEffect` などReactのHooksに似たAPIでウィジェットの状態を扱うサードパーティ製パッケージです。ビルドフックはDart SDKがビルド時にネイティブコードを用意する仕組みで、ウィジェットの状態管理とは関係がありません。

### Native Assetsとbuild hooksは同じ機能ですか？

同じ機能です。実験段階ではNative Assetsと呼ばれ、Dart 3.10の安定化に合わせてhooks（ビルドフック）へ改称されました。実験期のAPIパッケージ `native_assets_cli` はpub.devでdiscontinued扱いになり、後継に `hooks` が指定されています。古い記事のコードは、import先から書き直す必要があります。

### 実験フラグの有効化は今も必要ですか？

不要です。Dart 3.10以降・Flutter 3.38以降の安定版では、`hook/build.dart` を置けば `dart run` や `flutter run` が自動で実行します。Flutter 3.47.9では、ネイティブアセットと使用記録のどちらも既定で有効です。`native_toolchain_c` が実験段階であることと、SDKの実験フラグが要ることは別の話です。

### FlutterでJavaやKotlinのAPIを直接呼べますか？

`jnigen` でJava/Kotlinのクラスからバインディングを生成すれば、FFI経由でJNIを通して呼べます。Apple側ではObjective-Cを `ffigen`、Swiftを実験段階の `swiftgen` が担います。Swiftを別の方向からAndroidで動かす取り組みは、[Swift SDK for Androidとは？Swift 6.4.2での導入手順とswift-java・Skipの選び方【2026年11月】](/tech/details/9563/)で扱っています。

### Flutter Webでもビルドフックのネイティブコードは使えますか？

使えません。コードアセットは `dart:ffi` から呼び出す前提で、`dart:ffi` はWebのコンパイル対象にありません。Webにも対応するパッケージでは、条件付きimportでWeb向けの実装（WasmやJS連携）を別に用意します。

## 関連記事

- [Flutter 3.47とは？material\_ui移行・iOS 15と3.47.7までの修正【2026年10月時点】](/tech/details/16894/)
- [Flutter 3.44の変更点｜SPM既定化・HCPP・AGP 9と3.44.9までの修正履歴](/tech/details/15767/)
- [XCFrameworkとは？作成手順とSwiftPM配布・署名の要点【Xcode 27対応】](/tech/details/9262/)
- [Swift Package Manager入門｜使い方とPackage.swift、CocoaPods移行をSwift 6世代で解説](/tech/details/12700/)
- [FVMとは？Flutter SDKをプロジェクト単位で固定する運用とCI設定【2026年8月時点】](/tech/details/16731/)

---

出典: [Flutterのビルドフック（Native Assets）とは？hook/build.dartの書き方とFFI連携【Dart 3.13】](<https://www.issoh.co.jp/tech/details/10305/>)（株式会社一創）
