Cloud Storage for Firebase を使用すると、画像や動画などのユーザー生成コンテンツをアップロードして共有できるため、リッチ メディア コンテンツをアプリに組み込むことができます。データはGoogle Cloud Storageバケットに保存されます。これは、高可用性とグローバルな冗長性を備えたエクサバイト規模のオブジェクト ストレージ ソリューションです。 Cloud Storage for Firebase を使用すると、これらのファイルをモバイル デバイスやウェブブラウザから直接安全にアップロードでき、不安定なネットワークを簡単に処理できます。
前提条件
- Firebase SDK をインストールします。
- Firebase コンソールでアプリを Firebase プロジェクトに追加します。
デフォルトの Cloud Storage バケットを作成する
Firebase コンソールのナビゲーション ペインから [ Storage ] を選択し、[ Get started ] をクリックします。
セキュリティ ルールを使用した Cloud Storage データの保護に関するメッセージを確認します。開発中は、パブリック アクセスのルールを設定することを検討してください。
デフォルトの Cloud Storage バケットの場所を選択します。
この場所の設定は、プロジェクトのデフォルトの Google Cloud Platform (GCP) リソースの場所です。この場所は、場所の設定を必要とするプロジェクト内の GCP サービス、特にCloud FirestoreデータベースとApp Engineアプリ (Cloud Scheduler を使用する場合に必要) に使用されることに注意してください。
ロケーションを選択できない場合、プロジェクトにはデフォルトの GCP リソース ロケーションがすでに存在します。プロジェクトの作成時、または場所の設定が必要な別のサービスのセットアップ時に設定されました。
Blaze プランを使用している場合は、それぞれに独自の場所を持つ複数のバケットを作成できます。
[完了]をクリックします。
公開アクセスを設定する
Cloud Storage for Firebase は、データをどのように構造化するか、インデックスを作成する方法、いつデータを読み書きできるかを定義できる宣言型ルール言語を提供します。デフォルトでは、Cloud Storage への読み取りおよび書き込みアクセスは制限されているため、認証されたユーザーのみがデータの読み取りまたは書き込みを行うことができます。認証をセットアップせずに開始するには、パブリック アクセスのルールを構成できます。
これにより、アプリを使用していない人も含めて、誰でも Cloud Storage を使用できるようになるため、認証を設定するときに Cloud Storage を再度制限してください。
Cloud Storage をアプリに追加する
Swift Package Manager を使用して、Firebase の依存関係をインストールおよび管理します。
- Xcode で、アプリ プロジェクトを開いた状態で、 File > Add Packagesに移動します。
- プロンプトが表示されたら、Firebase Apple プラットフォーム SDK リポジトリを追加します。
- Cloud Storage ライブラリを選択します。
- 完了すると、Xcode はバックグラウンドで依存関係の解決とダウンロードを自動的に開始します。
https://github.com/firebase/firebase-ios-sdk
クラウド ストレージを設定する
Firebase 参照を作成または使用する前に、Firebase を初期化する必要があります。別の Firebase 機能で既にこれを行っている場合は、この手順を省略できます。
-
UIApplicationDelegate
にFirebaseCore
モジュールをインポートし、アプリ デリゲートが使用する他のすべてのFirebase モジュールをインポートします。たとえば、Cloud Firestore と認証を使用するには:SwiftUI
import SwiftUI import FirebaseCore import FirebaseFirestore import FirebaseAuth // ...
迅速
import FirebaseCore import FirebaseFirestore import FirebaseAuth // ...
Objective-C
@import FirebaseCore; @import FirebaseFirestore; @import FirebaseAuth; // ...
- アプリ デリゲートの
application(_:didFinishLaunchingWithOptions:)
メソッドでFirebaseApp
共有インスタンスを構成します。SwiftUI
// Use Firebase library to configure APIs FirebaseApp.configure()
迅速
// Use Firebase library to configure APIs FirebaseApp.configure()
Objective-C
// Use Firebase library to configure APIs [FIRApp configure];
- SwiftUI を使用している場合は、アプリケーション デリゲートを作成し、それを
UIApplicationDelegateAdaptor
またはNSApplicationDelegateAdaptor
を介してApp
構造体にアタッチする必要があります。アプリ デリゲート スウィズリングも無効にする必要があります。詳細については、 SwiftUI の説明を参照してください。SwiftUI
@main struct YourApp: App { // register app delegate for Firebase setup @UIApplicationDelegateAdaptor(AppDelegate.self) var delegate var body: some Scene { WindowGroup { NavigationView { ContentView() } } } }
- デフォルトの Firebase アプリを使用して、Cloud Storage サービスへの参照を取得します。
迅速
let storage = Storage.storage()
Objective-C
FIRStorage *storage = [FIRStorage storage];
Cloud Storage を使用する準備が整いました。
まず、 Cloud Storage 参照を作成する方法を学びましょう。
詳細設定
追加のセットアップが必要なユース ケースがいくつかあります。
- 複数の地域で Cloud Storage バケットを使用する
- 異なるストレージ クラスでの Cloud Storage バケットの使用
- 同じアプリ内の複数の認証済みユーザーで Cloud Storage バケットを使用する
最初のユース ケースは、世界中にユーザーがいて、ユーザーのデータを近くに保存したい場合に最適です。たとえば、米国、ヨーロッパ、アジアにバケットを作成して、これらの地域のユーザーのデータを保存し、レイテンシを短縮できます。
2 番目の使用例は、アクセス パターンが異なるデータがある場合に役立ちます。たとえば、写真やその他の頻繁にアクセスされるコンテンツを格納するマルチリージョンまたはリージョン バケットと、ユーザー バックアップまたはその他のアクセス頻度の低いコンテンツを格納するニアラインまたはコールドライン バケットをセットアップできます。
これらのいずれのユース ケースでも、複数の Cloud Storage バケットを使用する必要があります。
3 番目のユース ケースは、ユーザーが複数のログイン アカウント (個人アカウントと仕事用アカウントなど) を持つことができる Google ドライブなどのアプリを構築している場合に役立ちます。カスタム Firebase アプリ インスタンスを使用して、追加の各アカウントを認証できます。
複数の Cloud Storage バケットを使用する
上記のデフォルト以外の Cloud Storage バケットを使用する場合、または 1 つのアプリで複数の Cloud Storage バケットを使用する場合は、カスタム バケットを参照するFIRStorage
のインスタンスを作成できます。
迅速
// Get a non-default Cloud Storage bucket storage = Storage.storage(url:"gs://my-custom-bucket")
Objective-C
// Get a non-default Cloud Storage bucket FIRStorage storage = [FIRStorage storageWithURL:@"gs://my-custom-bucket"];
インポートされたバケットの操作
既存の Cloud Storage バケットを Firebase にインポートする場合、 Google Cloud SDKに含まれているgsutil
ツールを使用して、これらのファイルにアクセスする機能を Firebase に付与する必要があります。
gsutil -m acl ch -r -u service-<project number>@gcp-sa-firebasestorage.iam.gserviceaccount.com gs://<your-cloud-storage-bucket>
Firebase プロジェクトの概要で説明されているように、プロジェクト番号を見つけることができます。
新しく作成されたバケットには、デフォルトのアクセス制御が Firebase を許可するように設定されているため、これは影響しません。これは一時的な措置であり、将来的には自動的に実行されます。
カスタム Firebase アプリを使用する
カスタムFirebaseApp
を使用してより複雑なアプリを構築している場合は、そのアプリで初期化されたStorage
のインスタンスを作成できます。
迅速
// Get the default bucket from a custom FirebaseApp storage = Storage.storage(app:customApp) // Get a non-default bucket from a custom FirebaseApp storage = Storage.storage(app:customApp, url:"gs://my-custom-bucket")
Objective-C
// Get the default bucket from a custom FIRApp FIRStorage storage = [FIRStorage storageForApp:customApp]; // Get a non-default bucket from a custom FIRApp FIRStorage storage = [FIRStorage storageForApp:customApp withURL:@"gs://my-custom-bucket"];
次のステップ
アプリを起動する準備をします。
App Checkを有効にして、自分のアプリだけがストレージ バケットにアクセスできるようにします。
Google Cloud Console でプロジェクトの予算アラートを設定します。
Firebase コンソールで使用状況と請求のダッシュボードを監視して、複数の Firebase サービスにわたるプロジェクトの使用状況の全体像を把握します。より詳細な使用状況については、クラウド ストレージの使用状況ダッシュボードにアクセスすることもできます。
Firebase の起動チェックリストを確認します。