1. 概要
目標
この Codelab では、Firestore を基盤とするレストランのおすすめアプリを Swift で iOS に作成します。ここでは以下について学びます。
- iOS アプリから Firestore のデータの読み取りと書き込みを行う
- Firestore データの変更をリアルタイムでリッスンする
- Firebase Authentication とセキュリティ ルールを使用して Firestore データを保護する
- 複雑な Firestore クエリを作成する
前提条件
この Codelab を開始する前に、以下がインストールされていることを確認してください。
- Xcode バージョン 14.0 以降
- CocoaPods 1.12.0 以降
2. Firebase コンソール プロジェクトを作成する
Firebase をプロジェクトに追加する
- Firebase コンソールに移動します。
- [新しいプロジェクトを作成] を選択し、プロジェクトに「Firestore iOS Codelab」という名前を付けます。
3. サンプル プロジェクトを取得する
コードのダウンロード
まず、サンプル プロジェクトのクローンを作成し、プロジェクト ディレクトリで pod update を実行します。
git clone https://github.com/firebase/friendlyeats-ios cd friendlyeats-ios pod update
Xcode で FriendlyEats.xcworkspace を開き、実行します（Cmd+R）。GoogleService-Info.plist ファイルがないため、アプリは正しくコンパイルされ、起動時にすぐにクラッシュします。これを次のステップで修正します。
Firebase を設定する
こちらのドキュメントの手順に沿って、新しい Firestore プロジェクトを作成します。プロジェクトを取得したら、Firebase コンソールからプロジェクトの GoogleService-Info.plist ファイルをダウンロードして、Xcode プロジェクトのルートにドラッグします。プロジェクトを再度実行して、アプリが正しく設定され、起動時にクラッシュしなくなったことを確認します。ログインすると、以下の例のような空白の画面が表示されます。ログインできない場合は、Firebase コンソールの [Authentication] でメール/パスワードによるログイン方法が有効になっていることを確認してください。
4. Firestore にデータを書き込む
このセクションでは、アプリの UI にデータを入力できるように、Firestore にデータを書き込みます。これは Firebase コンソールから手動で行うことができますが、基本的な Firestore の書き込みのデモを行うために、アプリ自体で行います。
このアプリの主なモデル オブジェクトはレストランです。Firestore のデータは、ドキュメント、コレクション、サブコレクションに分割されます。各レストランを、restaurants という最上位のコレクションにドキュメントとして保存します。Firestore データモデルの詳細については、こちらのドキュメントでドキュメントとコレクションをご覧ください。
Firestore にデータを追加する前に、レストラン コレクションへの参照を取得する必要があります。RestaurantsTableViewController.didTapPopulateButton(_:) メソッドの内部 for ループに以下を追加します。
let collection = Firestore.firestore().collection("restaurants")
コレクション参照が作成できたので、データを書き込めます。追加したコードの最後の行の直後に、次のコードを追加します。
let collection = Firestore.firestore().collection("restaurants")
// ====== ADD THIS ======
let restaurant = Restaurant(
name: name,
category: category,
city: city,
price: price,
ratingCount: 0,
averageRating: 0
)
collection.addDocument(data: restaurant.dictionary)
上記のコードは、新しいドキュメントをレストラン コレクションに追加します。ドキュメント データは辞書から取得され、これは Restaurant 構造体から取得されます。
あと少しで、Firestore にドキュメントを書き込む前に、Firestore のセキュリティ ルールを開き、データベースのどの部分をどのユーザーが書き込み可能にするかを記述する必要があります。現時点では、認証されたユーザーのみがデータベース全体の読み取りと書き込みを許可します。本番環境のアプリではやや制限が緩やかすぎますが、テスト中に認証の問題に頻繁に遭遇しないように、アプリの構築プロセスでは十分な余裕を持たせたいと考えています。この Codelab の最後では、セキュリティ ルールを強化し、意図しない読み取りと書き込みの可能性を制限する方法について説明します。
Firebase コンソールの [ルール] タブで次のルールを追加し、[公開] をクリックします。
rules_version = '2';
service cloud.firestore {
match /databases/{database}/documents {
match /{document=**} {
//
// WARNING: These rules are insecure! We will replace them with
// more secure rules later in the codelab
//
allow read, write: if request.auth != null;
}
}
}
セキュリティ ルールの詳細については後ほど説明しますが、お急ぎの場合はセキュリティ ルールのドキュメントをご覧ください。
アプリを実行してログインします。[入力] をタップします。ボタンをクリックすると、レストランのドキュメントが作成されますが、このボタンはアプリではまだ表示されません。
次に、Firebase コンソールで Firestore の [データ] タブに移動します。これで、レストラン コレクションに新しいエントリが表示されます。
これで、iOS アプリから Firestore にデータを書き込めました。次のセクションでは、Firestore からデータを取得してアプリで表示する方法について説明します。
5. Firestore のデータを表示する
このセクションでは、Firestore からデータを取得してアプリに表示する方法について説明します。主なステップは、クエリの作成とスナップショット リスナーの追加の 2 つです。このリスナーには、クエリに一致するすべての既存データが通知され、リアルタイムで更新を受信します。
まず、フィルタされていないデフォルトのレストランリストを返すクエリを作成します。RestaurantsTableViewController.baseQuery() の実装を見てみましょう。
return Firestore.firestore().collection("restaurants").limit(to: 50)
このクエリは、「restaurants」という名前の最上位のコレクションから、最大 50 件のレストランを取得します。クエリを作成したら、スナップショット リスナーをアタッチして Firestore からアプリにデータを読み込む必要があります。stopObserving() 呼び出しの直後の RestaurantsTableViewController.observeQuery() メソッドに、次のコードを追加します。
listener = query.addSnapshotListener { [unowned self] (snapshot, error) in
guard let snapshot = snapshot else {
print("Error fetching snapshot results: \(error!)")
return
}
let models = snapshot.documents.map { (document) -> Restaurant in
if let model = Restaurant(dictionary: document.data()) {
return model
} else {
// Don't use fatalError here in a real app.
fatalError("Unable to initialize type \(Restaurant.self) with dictionary \(document.data())")
}
}
self.restaurants = models
self.documents = snapshot.documents
if self.documents.count > 0 {
self.tableView.backgroundView = nil
} else {
self.tableView.backgroundView = self.backgroundView
}
self.tableView.reloadData()
}
上記のコードは、Firestore からコレクションをダウンロードし、配列としてローカルに保存します。addSnapshotListener(_:) 呼び出しは、サーバー上のデータが変更されるたびにビュー コントローラを更新するスナップショット リスナーをクエリに追加します。更新は自動的に行われるため、手動で変更を push する必要はありません。このスナップショット リスナーは、サーバーサイドの変更の結果としていつでも呼び出される可能性があるため、アプリが変更を処理できることが重要です。
辞書を構造体にマッピング（Restaurant.swift を参照）した後は、いくつかのビュー プロパティを割り当てるだけでデータを表示できます。RestaurantsTableViewController.swift の RestaurantTableViewCell.populate(restaurant:) に次の行を追加します。
nameLabel.text = restaurant.name
cityLabel.text = restaurant.city
categoryLabel.text = restaurant.category
starsView.rating = Int(restaurant.averageRating.rounded())
priceLabel.text = priceString(from: restaurant.price)
この入力メソッドは、テーブルビュー データソースの tableView(_:cellForRowAtIndexPath:) メソッドから呼び出されます。このメソッドは、以前の値の型のコレクションを個々のテーブルビューのセルにマッピングします。
アプリを再度実行し、先ほどコンソールで確認したレストランがシミュレータまたはデバイスに表示されるようになったことを確認します。このセクションが正常に完了すると、アプリは Cloud Firestore を使用してデータの読み取りと書き込みを行えるようになりました。
6. データの並べ替えとフィルタリング
現在、このアプリにはレストランの一覧が表示されますが、ユーザーがニーズに基づいてフィルタする方法はありません。このセクションでは、Firestore の高度なクエリを使用してフィルタリングを有効にします。
以下は、すべての飲茶レストランをフェッチするシンプルなクエリの例です。
let filteredQuery = query.whereField("category", isEqualTo: "Dim Sum")
名前が示すように、whereField(_:isEqualTo:) メソッドは、設定した制限を満たすフィールドを持つコレクションのメンバーのみをクエリでダウンロードします。この例では、category が "Dim Sum" のレストランのみがダウンロードされます。
このアプリでは、ユーザーが複数のフィルタを連結して特定のクエリ（「サンフランシスコのピザ」など）を作成できます。または「ロサンゼルスのシーフード 人気度順」など
RestaurantsTableViewController.swift を開き、query(withCategory:city:price:sortBy:) の中央に次のコードブロックを追加します。
if let category = category, !category.isEmpty {
filtered = filtered.whereField("category", isEqualTo: category)
}
if let city = city, !city.isEmpty {
filtered = filtered.whereField("city", isEqualTo: city)
}
if let price = price {
filtered = filtered.whereField("price", isEqualTo: price)
}
if let sortBy = sortBy, !sortBy.isEmpty {
filtered = filtered.order(by: sortBy)
}
上記のスニペットでは、複数の whereField 句と order 句を追加して、ユーザー入力に基づいて単一の複合クエリを作成しています。これで、このクエリはユーザーの要件を満たすレストランのみを返すようになります。
プロジェクトを実行し、料金、都市、カテゴリでフィルタできることを確認します（カテゴリと都市名は正確に入力してください）。テスト中に、ログに次のようなエラーが表示されることがあります。
Error fetching snapshot results: Error Domain=io.grpc Code=9
"The query requires an index. You can create it here: https://console.firebase.google.com/project/project-id/database/firestore/indexes?create_composite=..."
UserInfo={NSLocalizedDescription=The query requires an index. You can create it here: https://console.firebase.google.com/project/project-id/database/firestore/indexes?create_composite=...}
これは、Firestore ではほとんどの複合クエリにインデックスが必要になるためです。クエリでインデックスを必須にすることで、Firestore を高速かつ大規模に処理できます。エラー メッセージのリンクを開くと、Firebase コンソールのインデックス作成 UI が自動的に開き、正しいパラメータが入力されます。Firestore のインデックスについて詳しくは、こちらのドキュメントをご覧ください。
7. トランザクションでのデータの書き込み
このセクションでは、ユーザーがレストランにレビューを送信できる機能を追加します。これまでのところ、すべての書き込みはアトミックで、比較的単純でした。いずれかでエラーが発生した場合は、再試行するか自動的に再試行するようユーザーに促します。
レストランに評価を追加するには、複数の読み取りと書き込みを調整する必要があります。まずレビュー自体を送信し、次にレストランの評価数と平均評価を更新する必要があります。いずれか 1 つが失敗し、もう 1 つでは失敗すると、データベースのある部分のデータが別の部分のデータと一致しないという不整合な状態になります。
幸いなことに、Firestore のトランザクション機能を使用すると、1 回のアトミック オペレーションで複数の読み取りと書き込みを実行できるため、データの整合性が維持されます。
RestaurantDetailViewController.reviewController(_:didSubmitFormWithReview:) のすべての let 宣言の下に次のコードを追加します。
let firestore = Firestore.firestore()
firestore.runTransaction({ (transaction, errorPointer) -> Any? in
// Read data from Firestore inside the transaction, so we don't accidentally
// update using stale client data. Error if we're unable to read here.
let restaurantSnapshot: DocumentSnapshot
do {
try restaurantSnapshot = transaction.getDocument(reference)
} catch let error as NSError {
errorPointer?.pointee = error
return nil
}
// Error if the restaurant data in Firestore has somehow changed or is malformed.
guard let data = restaurantSnapshot.data(),
let restaurant = Restaurant(dictionary: data) else {
let error = NSError(domain: "FireEatsErrorDomain", code: 0, userInfo: [
NSLocalizedDescriptionKey: "Unable to write to restaurant at Firestore path: \(reference.path)"
])
errorPointer?.pointee = error
return nil
}
// Update the restaurant's rating and rating count and post the new review at the
// same time.
let newAverage = (Float(restaurant.ratingCount) * restaurant.averageRating + Float(review.rating))
/ Float(restaurant.ratingCount + 1)
transaction.setData(review.dictionary, forDocument: newReviewReference)
transaction.updateData([
"numRatings": restaurant.ratingCount + 1,
"avgRating": newAverage
], forDocument: reference)
return nil
}) { (object, error) in
if let error = error {
print(error)
} else {
// Pop the review controller on success
if self.navigationController?.topViewController?.isKind(of: NewReviewViewController.self) ?? false {
self.navigationController?.popViewController(animated: true)
}
}
}
更新ブロック内では、トランザクション オブジェクトを使用して実行するすべてのオペレーションが、Firestore による単一のアトミック更新として扱われます。サーバーで更新が失敗した場合、Firestore は自動的に更新を数回再試行します。つまり、1 つのエラーが繰り返し発生している可能性が高いことを意味します。たとえば、デバイスが完全にオフラインになっている場合や、ユーザーに書き込み先のパスに書き込む権限がない場合などです。
8. セキュリティ ルール
アプリのユーザーが、データベースのすべてのデータの読み取りと書き込みを行える状態でなければなりません。たとえば、レストランの評価は誰でも閲覧できるようにし、評価の投稿は認証されたユーザーのみに許可する必要があります。クライアントで適切なコードを記述するだけでは不十分です。データ セキュリティ モデルをバックエンドで指定して、完全に保護する必要があります。このセクションでは、Firebase セキュリティ ルールを使用してデータを保護する方法を学びます。
まず、Codelab の冒頭で記述したセキュリティ ルールを詳しく見てみましょう。Firebase コンソールを開き、[Database] >[Firestore] タブのルールをご覧ください。
rules_version = '2';
service cloud.firestore {
match /databases/{database}/documents {
match /{document=**} {
// Only authenticated users can read or write data
allow read, write: if request.auth != null;
}
}
}
上記のルールの request 変数は、すべてのルールで使用できるグローバル変数です。追加した条件により、ユーザーに何も許可する前にリクエストが認証されます。これにより、認証されていないユーザーが Firestore API を使用してデータに不正な変更を加えるのを防ぐことができます。これは良いスタートですが、Firestore ルールを使用すると、より強力なことができます。
レビューのユーザー ID が認証済みユーザーの ID と一致するように、レビューの書き込みを制限します。これにより、ユーザーが互いになりすましたり、不正なレビューを残したりすることを防止できます。セキュリティ ルールを次のように置き換えます。
rules_version = '2';
service cloud.firestore {
match /databases/{database}/documents {
match /restaurants/{any}/ratings/{rating} {
// Users can only write ratings with their user ID
allow read;
allow write: if request.auth != null
&& request.auth.uid == request.resource.data.userId;
}
match /restaurants/{any} {
// Only authenticated users can read or write data
allow read, write: if request.auth != null;
}
}
}
最初の match ステートメントは、restaurants コレクションに属する任意のドキュメントの ratings という名前のサブコレクションと一致します。allow write 条件を指定すると、レビューのユーザー ID がユーザーの ID と一致しない場合、レビューが送信されなくなります。2 番目の match ステートメントでは、認証されたすべてのユーザーがデータベースに対してレストランの読み取りと書き込みを行うことができます。
これは、レビューでは非常にうまくいきます。セキュリティ ルールを使用して、先にアプリに書き込んだ「ユーザーは自分のレビューしか書けない」という暗黙の保証を明示的に宣言しているからです。レビューの編集または削除の機能を追加した場合も、これとまったく同じルールセットにより、ユーザーが他のユーザーのレビューを編集または削除することもできなくなります。評価しています。しかし、Firestore ルールをより詳細に使用して、ドキュメント全体ではなく、ドキュメント内の個々のフィールドへの書き込みを制限することもできます。これを使用して、ユーザーがレストランの評価、平均評価、評価数のみを更新できるようにすることで、悪意のあるユーザーがレストランの名前や場所を変更する可能性を排除できます。
rules_version = '2';
service cloud.firestore {
match /databases/{database}/documents {
match /restaurants/{restaurant} {
match /ratings/{rating} {
allow read: if request.auth != null;
allow write: if request.auth != null
&& request.auth.uid == request.resource.data.userId;
}
allow read: if request.auth != null;
allow create: if request.auth != null;
allow update: if request.auth != null
&& request.resource.data.name == resource.data.name
&& request.resource.data.city == resource.data.city
&& request.resource.data.price == resource.data.price
&& request.resource.data.category == resource.data.category;
}
}
}
ここでは、許可するオペレーションを具体的に指定できるように、書き込み権限を create と update に分割しています。この Codelab の開始時に作成した [入力] ボタンの機能は保持したまま、すべてのユーザーがデータベースにレストランを書き込むことができますが、一度レストランを書き込んだ後は、名前、場所、価格、カテゴリを変更できません。具体的には、最後のルールでは、データベースにすでに存在するフィールドと同じ名前、市区町村、価格、カテゴリを維持するレストラン更新オペレーションが必要です。
セキュリティ ルールでできることについて詳しくは、こちらのドキュメントをご覧ください。
9. まとめ
この Codelab では、Firestore の基本的な読み取りと書き込みを行う方法と、セキュリティ ルールを使用してデータアクセスを保護する方法を学びました。解答の全文は、codelab-complete ブランチで確認できます。
Firestore の詳細については、次のリソースをご覧ください。