FlutterでIsarを使ったらAGP 8.x非互換で詰んだ話——pub-cacheパッチとriverpod_generator競合の解決記録

この記事は「詰まった → 原因 → 解決した」の記録です。同じエラーで検索してたどり着いた方の助けになれば幸いです。

→ 個人開発したアプリはこちら：RPG×HIITフィットネスアプリ「MUSCLE QUEST」をリリースしました

環境
問題① isar_flutter_libs で namespace エラーが出る
問題② riverpod_generator と isar_generator が analyzer のバージョンで競合する
問題③ AGP バージョンアップで発生した JDK エラー（おまけ）
問題④ package_info_plus・wakelock_plus が AGP 8.x で警告・エラーになる
問題⑤ Isar.getDir() が存在しないというコンパイルエラー
まとめ：詰まりポイントと解決策の一覧
おわりに

環境

項目	バージョン
Flutter	3.24.5
Dart	3.5.4
isar / isar_flutter_libs	3.1.0+1
isar_generator	3.1.0+1
flutter_riverpod	2.6.1
AGP（Android Gradle Plugin）	8.3.0
Gradle	8.4
Kotlin	1.9.22
compileSdk	35

問題① isar_flutter_libs で namespace エラーが出る

エラー内容

flutter build apk や flutter run を実行すると、以下のエラーが出てビルドが止まります。

Namespace not specified. Specify a namespace in the module's build file.
See https://d.android.com/r/tools/upgrade-assistant/set-namespace for information about setting the namespace.

FAILURE: Build failed with an exception.
* What went wrong:
A problem occurred configuring project ':isar_flutter_libs'.

原因：AGP 8.x から namespace が必須になった

Android Gradle Plugin（AGP）8.0 以降、すべての Android ライブラリモジュールで build.gradle に namespace の明示的な指定が必須になりました。

しかし isar_flutter_libs 3.1.0+1 は AGP 8.x が普及する前に公開されたバージョンのため、namespace の記述がありません。Isar自体の開発が2023年末に事実上停止しており、パッケージ側での修正は期待できない状況です。

解決策：pub-cache の build.gradle に直接 namespace を追記する

以下のファイルを直接編集します。

~/.pub-cache/hosted/pub.dev/isar_flutter_libs-3.1.0+1/android/build.gradle

android { ... } ブロックの中に namespace を追記します。

gradle

apply plugin: 'com.android.library'

android {
    namespace 'dev.isar.isar_flutter_libs'  // ← この行を追加
    compileSdkVersion 30

    defaultConfig {
        minSdkVersion 16
    }
}

追記後に flutter clean && flutter run を実行するとビルドが通ります。

⚠️ 重要な注意点：flutter pub get で消える

このパッチは pub-cache（パッケージのダウンロードキャッシュ）に直接手を入れています。flutter pub get を実行すると上書きされて消えます。

pubspec.yaml を変更してパッケージを更新するたびに再適用が必要です。CI/CD環境で使う場合はビルドスクリプトにパッチ適用コマンドを組み込む必要があります。

荒技ではありますが、現状これが最も手軽な解決策です。

問題② riverpod_generator と isar_generator が analyzer のバージョンで競合する

エラー内容

riverpod_generator と isar_generator を同時に dev_dependencies に追加して flutter pub get を実行すると、以下のエラーが出て依存関係の解決に失敗します。

Because riverpod_generator >=2.0.0 depends on analyzer ^6.7.0
  and isar_generator >=3.0.0 depends on analyzer <6.0.0,
  riverpod_generator >=2.0.0 is incompatible with isar_generator >=3.0.0.

So, because [your app] depends on both isar_generator ^3.1.0+1
  and riverpod_generator ^2.x.x, version solving failed.

原因：analyzer の要求バージョンが真っ向から衝突している

コード生成系パッケージはどちらも内部で Dart の静的解析エンジン analyzer を使います。

パッケージ	analyzer の要求バージョン
riverpod_generator 2.x	^6.7.0（6.7以上）
isar_generator 3.x	<6.0.0（6未満）

6.7以上かつ 6未満を同時に満たすバージョンは存在しません。dependency_overrides で無理やり固定してもどちらかのコード生成が壊れます。

解決策：riverpod_generator を捨てて手動プロバイダーに切り替える

今回は Isar を優先し、riverpod_generator と riverpod_annotation を削除して、flutter_riverpod だけを残す構成にしました。

pubspec.yaml の差分はこうなります。

yaml

dependencies:
  flutter_riverpod: ^2.6.1   # これだけ残す
- riverpod_annotation: ^2.x.x # 削除

dev_dependencies:
  build_runner: ^2.4.13
  isar_generator: ^3.1.0+1
- riverpod_generator: ^2.x.x  # 削除

riverpod_generator を使うと @riverpod アノテーションだけでプロバイダーが自動生成できて便利ですが、手動でも数行追加するだけです。

たとえば @riverpod で書いていたプロバイダーは、手動では以下のように書きます。

dart

// riverpod_generator を使う場合（削除）
// @riverpod
// TimerNotifier timerNotifier(TimerNotifierRef ref) => TimerNotifier();

// 手動プロバイダー（こちらに統一）
final timerProvider =
    StateNotifierProvider.autoDispose<TimerNotifier, TimerState>((ref) {
  return TimerNotifier();
});

記述量は増えますが、動作は完全に同等です。中規模以下のアプリなら手動プロバイダーで十分です。

問題③ AGP バージョンアップで発生した JDK エラー（おまけ）

エラー内容

FAILURE: Build failed with an exception.
* What went wrong:
Execution failed for task ':app:mergeDebugJavaResource'.
> Error while transforming core-for-system-modules.jar ...
  jlink: No value present

原因と解決策

AGP 8.1.0 は JDK の image transform 処理に不具合があり、特定の環境で jlink エラーが発生します。AGP・Gradle・Kotlin のバージョンをセットでアップグレードすることで解消しました。

項目	変更前	変更後
AGP	8.1.0	8.3.0
Gradle	8.1.1	8.4
Kotlin	1.8.x	1.9.22

settings.gradle の AGP バージョンと gradle-wrapper.properties の Gradle バージョンは対応関係があります。AGP 8.3.x には Gradle 8.4 以上が必要です。

問題④ package_info_plus・wakelock_plus が AGP 8.x で警告・エラーになる

エラー内容

The option 'android.experimental.legacyTransform' is deprecated
...
PluginException: compileSdkVersion is not specified

解決策：dependency_overrides で古いバージョンに固定

最新バージョンの package_info_plus と wakelock_plus は AGP 8.12+ を前提とした書き方になっており、それ未満の AGP ではビルドエラーになります。dependency_overrides で動作確認済みのバージョンに固定することで回避できます。

yaml

# pubspec.yaml
dependency_overrides:
  package_info_plus: 8.0.2
  wakelock_plus: 1.2.8

dependency_overrides は直接依存していないパッケージのバージョンを強制的に上書きします。他のパッケージが内部でこれらに依存していても指定バージョンが使われます。

問題⑤ Isar.getDir() が存在しないというコンパイルエラー

エラー内容

The method 'getDir' isn't defined for the type 'Isar'.
Try correcting the name to the name of an existing method.

原因と解決策

ネット上の Isar のサンプルコードには Isar.getDir() を使う例が多く見られますが、isar 3.1.0+1 にはこのメソッドが存在しません。path_provider パッケージで取得したパスを渡す書き方が正しい実装です。

dart

// NG：ネット上によくある古い書き方
final dir = await Isar.getDir();

// OK：path_provider で取得する
import 'package:path_provider/path_provider.dart';

final dir = await getApplicationDocumentsDirectory();
final isar = await Isar.open(
  [UserProfileSchema, WorkoutSessionSchema, AchievementSchema],
  directory: dir.path,
  inspector: kDebugMode, // デバッグ時だけ Isar Inspector を有効化
);

まとめ：詰まりポイントと解決策の一覧

問題	原因	解決策
namespace not specified	AGP 8.x が namespace 必須に	pub-cache の build.gradle に手動追記
riverpod_generator と isar_generator の競合	analyzer の要求バージョンが両立不可	riverpod_generator を削除、手動プロバイダーに統一
jlink エラー	AGP 8.1.0 の不具合	AGP 8.3.0 + Gradle 8.4 + Kotlin 1.9.22 にアップグレード
package_info_plus / wakelock_plus のエラー	AGP 8.12+ を前提とした実装	dependency_overrides で旧バージョンに固定
Isar.getDir() が存在しない	3.1.0+1 にそのメソッドがない	path_provider の getApplicationDocumentsDirectory() を使う