cloud_firestore以外の選択肢

FlutterからFirestoreを利用する場合、cloud_firestoreというパッケージを使えばいい。ただ、Flutter以外のDartのコードでFirestoreにアクセスする場合、googleapisというパッケージを使うことになる。このパッケージはおそらくgRPCのサービス定義から自動生成されたクライアントを含んでいるのだと思うけど、ドキュメントにはgRPCかどうかは明記されていないようだ。また、認証にはgoogleapis_authという別のパッケージも必要になる。

dependencies:
  googleapis: ^9.2.0
  googleapis_auth: ^1.3.1

認証

Firestoreにアクセスする際の認証については、いくつか方法がある。公式ドキュメントによると、アプリケーションのデフォルト認証情報（以下、ADC）を利用する方式が今回のケースに適しているようだ。

ADCを利用する場合、クライアントライブラリはいくつかの方法でADCを探索することになる。今回は以下のコマンドでADCを生成することで、クライアントライブラリがそれを利用できるようにした。

% gcloud auth application-default login

Dart側はgoogleapis_authパッケージを使い、以下のように実装することでADCを利用して認証できるようになる。

final authClient = await clientViaApplicationDefaultCredentials(
  scopes: [FirestoreApi.datastoreScope],
);

Firestoreへのアクセス

googleapisパッケージのコードを使うと、直感的なコードでFirestoreにアクセスできるようになる。以下の例では、ドキュメントのリストを取得している。

final api = FirestoreApi(authClient);
final response = await api.projects.databases.documents.list(
  'projects/$project_id/databases/(default)/documents',
  '$collection_id',
);