【ITニュース解説】Why I Built a Simple App to Understand Isar in Flutter (And the Challenges I Faced)

新しいIT技術を学ぶ際、大規模なプロジェクトに挑戦しがちだが、焦点を絞ったシンプルなアプリ開発が効果的な学習法となることがある。これは、Flutterで利用できる新しいローカルデータベース「Isar」を深く理解するために、基本的な「習慣トラッカーアプリ」を開発した経験から得られた教訓である。複雑なユーザーインターフェースや外部API連携に煩わされることなく、データベース操作とアプリケーションの状態管理という核となる技術習得に集中することが目的だった。

Flutter開発でローカルストレージといえば、SQLite、Shared Preferences、Hiveが一般的だ。Isarは、定評あるHiveの作者が開発した次世代の高速なNoSQLデータベースである。その特徴はいくつかある。第一に「驚異的な速さ」。内部にC言語ベースのエンジンを持つため、データ読み書きが非常に高速だ。第二に「完全な型安全」。クエリ（データベースへの問い合わせ）時に文字列ベースのエラーを防ぎ、自動補完機能を活用しながら安全にコードを書ける。第三に「高度なクエリ機能」。全文検索、データのフィルタリング、複数の条件に基づくインデックス作成といった機能が標準で利用できる。最後に「Visual Inspector」。これは、アプリ実行中にデータベースの内部構造をブラウザでリアルタイムに確認できる機能で、まるでExcelのシートを見るようにデータの状態を把握できるため、デバッグ作業を効率化する。

アプリのコードが複雑になるのを防ぐため、「分割統治」というアプローチを採用した。これは問題を小さな部分に分け、それぞれを独立して開発する考え方だ。具体的には、以下の四つの層で構成した。まず「Models」は、Isarのデータベーススキーマ（データ構造）を定義する。今回の習慣トラッカーでは「Habit」クラスがこれにあたる。次に「Services」は、データベースに対するデータの作成・読み込み・更新・削除（CRUD操作）や、日付更新処理を独立して行う層である。これによりデータベースアクセスロジックが一元化され、保守性が向上する。「Providers」は、ユーザーインターフェース（UI）とServices層の橋渡し役を担う。UIからの操作要求をServicesに伝え、結果をUIに反映させる役割だ。最後に「Screens」は、ユーザーが直接操作する、クリーンでシンプルなUI部分である。

開発過程で複数の課題に直面した。一つ目は、AndroidのビルドツールであるGradleと「namespace（名前空間）」に関する問題だ。Isarパッケージを導入し、初めてプロジェクトをビルドしようとした際、AndroidのGradleエンジンがエラーを出した。これは、Isarの本体ライブラリである「isar_flutter_libs」パッケージが、現代のAndroidプロジェクトが要求する「namespace」ルールと最小SDKバージョン34の要件に準拠していなかったためだ。解決策として、パッケージのキャッシュディレクトリ内にある「android/build.gradle」ファイルを直接編集し、namespace 'dev.isar.isar_flutter_libs'という行とcompileSdkVersion 34を追加した。これにより、根本的な原因を修正し、ビルドエラーを解消した。

二つ目の課題は、Providerという状態管理ツールでの型指定に関するものだった。新しい習慣をUIから保存しようとした際、Provider.ofエラーでアプリが突然クラッシュした。原因は、どのProviderに操作を行うかを明示的に指定していなかった、単純な型指定の漏れだった。Dart言語は厳密な型付けを特徴とするが、context.read().addNewHabit()のように、どのProviderに対して操作を行っているのかを明示的に指定していなかったため、システムが混乱していたのだ。context.read<HabitProvider>().addNewHabit()のように、HabitProviderという具体的な型を明示することで問題は解決した。この経験から、Dart言語における厳密な型指定の重要性を改めて認識した。

三つ目の課題は、GitHubのバージョン管理システムでの言語認識に関するものだった。完成したプロジェクトをGitHubにプッシュした後、リポジトリの言語統計を確認すると、Dartがわずか7%で、HTMLが90%を占めているという奇妙な表示になっていた。これは、Flutterがウェブ向けにビルドする際に生成するHTMLファイルやその他の自動生成ファイルが、GitHubの言語解析器に誤って主要な言語として認識されたためだ。この問題を解決するため、プロジェクトのルートディレクトリに.gitattributesという設定ファイルを作成した。このファイルに、*.html linguist-generated=true、web/** linguist-generated=true、build/** linguist-generated=trueというコードを追加し、GitHubの言語解析器にこれらの自動生成ファイルやディレクトリを無視するよう指示した。これにより、リポジトリの言語統計は正しくDartが100%と表示されるようになった。

これらの小さなプロジェクトを通じて得られた最も重要な教訓は、Isarのような新しい技術を学ぶ最善の方法は、それを複雑なアプリケーション構造から切り離し、最も基本的な形で使ってみることだという点である。具体的な課題に直面し、それを自力で解決する過程こそが、技術を深く理解し、真の知識として定着させる鍵となる。