Mit Cloud Storage for Firebase können Sie von Benutzern generierte Inhalte wie Bilder und Videos hochladen und freigeben, wodurch Sie Rich-Media-Inhalte in Ihre Apps integrieren können. Ihre Daten werden in einem Google Cloud Storage- Bucket gespeichert – einer Objektspeicherlösung im Exabyte-Bereich mit hoher Verfügbarkeit und globaler Redundanz. Mit Cloud Storage for Firebase können Sie diese Dateien sicher direkt von Mobilgeräten und Webbrowsern hochladen und problemlos mit unregelmäßigen Netzwerken umgehen.
Voraussetzungen
- Installieren Sie das Firebase-SDK .
- Fügen Sie Ihre App Ihrem Firebase-Projekt in der Firebase-Konsole hinzu .
Erstellen Sie einen standardmäßigen Cloud Storage-Bucket
Wählen Sie im Navigationsbereich der Firebase-Konsole Speicher aus und klicken Sie dann auf Erste Schritte .
Lesen Sie die Mitteilung zum Sichern Ihrer Cloud Storage-Daten mithilfe von Sicherheitsregeln. Erwägen Sie während der Entwicklung, Ihre Regeln für den öffentlichen Zugriff einzurichten .
Wählen Sie einen Speicherort für Ihren standardmäßigen Cloud Storage-Bucket aus.
Diese Standorteinstellung ist der standardmäßige Google Cloud Platform (GCP)-Ressourcenstandort Ihres Projekts . Beachten Sie, dass dieser Standort für GCP-Dienste in Ihrem Projekt verwendet wird, die eine Standorteinstellung erfordern, insbesondere Ihre Cloud Firestore- Datenbank und Ihre App Engine -App (was erforderlich ist, wenn Sie Cloud Scheduler verwenden).
Wenn Sie keinen Standort auswählen können, hat Ihr Projekt bereits einen standardmäßigen GCP-Ressourcenstandort. Es wurde entweder während der Projekterstellung oder beim Einrichten eines anderen Dienstes festgelegt, der eine Standorteinstellung erfordert.
Wenn Sie den Blaze-Plan haben, können Sie mehrere Buckets mit jeweils einem eigenen Standort erstellen.
Klicken Sie auf Fertig .
Öffentlichen Zugang einrichten
Cloud Storage for Firebase bietet eine deklarative Regelsprache, mit der Sie definieren können, wie Ihre Daten strukturiert und indiziert werden sollen und wann Ihre Daten gelesen und geschrieben werden können. Standardmäßig ist der Lese- und Schreibzugriff auf Cloud Storage eingeschränkt, sodass nur authentifizierte Benutzer Daten lesen oder schreiben können. Um zu beginnen, ohne die Authentifizierung einzurichten, können Sie Ihre Regeln für den öffentlichen Zugriff konfigurieren .
Dadurch wird Cloud Storage für jeden zugänglich, auch für Personen, die Ihre App nicht verwenden. Stellen Sie also sicher, dass Sie Ihren Cloud Storage erneut einschränken, wenn Sie die Authentifizierung einrichten.
Fügen Sie Cloud Storage zu Ihrer App hinzu
Verwenden Sie Swift Package Manager, um Firebase-Abhängigkeiten zu installieren und zu verwalten.
- Navigieren Sie in Xcode bei geöffnetem App-Projekt zu File > Add Packages .
- Wenn Sie dazu aufgefordert werden, fügen Sie das Firebase Apple-Plattform-SDK-Repository hinzu:
- Wählen Sie die Cloud Storage-Bibliothek aus.
- Wenn Sie fertig sind, beginnt Xcode automatisch mit dem Auflösen und Herunterladen Ihrer Abhängigkeiten im Hintergrund.
https://github.com/firebase/firebase-ios-sdk
Cloud-Speicher einrichten
Sie müssen Firebase initialisieren, bevor eine Firebase-Referenz erstellt oder verwendet wird. Wenn Sie dies bereits für eine andere Firebase-Funktion getan haben, können Sie diesen Schritt überspringen.
- Importieren Sie das
FirebaseCore
Modul in IhrUIApplicationDelegate
sowie alle anderen Firebase-Module, die Ihr App-Delegierter verwendet. So verwenden Sie beispielsweise Cloud Firestore und Authentifizierung:SwiftUI
import SwiftUI import FirebaseCore import FirebaseFirestore import FirebaseAuth // ...
Schnell
import FirebaseCore import FirebaseFirestore import FirebaseAuth // ...
Ziel c
@import FirebaseCore; @import FirebaseFirestore; @import FirebaseAuth; // ...
- Konfigurieren Sie eine freigegebene
FirebaseApp
Instanz in der Methodeapplication(_:didFinishLaunchingWithOptions:)
Ihres App-Delegaten:SwiftUI
// Use Firebase library to configure APIs FirebaseApp.configure()
Schnell
// Use Firebase library to configure APIs FirebaseApp.configure()
Ziel c
// Use Firebase library to configure APIs [FIRApp configure];
- Wenn Sie SwiftUI verwenden, müssen Sie einen Anwendungsdelegaten erstellen und ihn über
UIApplicationDelegateAdaptor
oderNSApplicationDelegateAdaptor
an IhreApp
Struktur anfügen. Sie müssen auch das Swizzling von App-Delegaten deaktivieren. Weitere Informationen finden Sie in den SwiftUI-Anweisungen .SwiftUI
@main struct YourApp: App { // register app delegate for Firebase setup @UIApplicationDelegateAdaptor(AppDelegate.self) var delegate var body: some Scene { WindowGroup { NavigationView { ContentView() } } } }
- Rufen Sie mithilfe der standardmäßigen Firebase-App einen Verweis auf den Cloud Storage-Dienst ab:
Schnell
let storage = Storage.storage()
Ziel c
FIRStorage *storage = [FIRStorage storage];
Sie sind bereit, Cloud Storage zu verwenden!
Lassen Sie uns zunächst lernen, wie Sie eine Cloud Storage-Referenz erstellen .
Erweiterte Einrichtung
Es gibt einige Anwendungsfälle, die eine zusätzliche Einrichtung erfordern:
- Verwenden von Cloud Storage-Buckets in mehreren geografischen Regionen
- Verwenden von Cloud Storage-Buckets in verschiedenen Speicherklassen
- Verwenden von Cloud Storage-Buckets mit mehreren authentifizierten Benutzern in derselben App
Der erste Anwendungsfall ist perfekt, wenn Sie Benutzer auf der ganzen Welt haben und ihre Daten in ihrer Nähe speichern möchten. Sie können beispielsweise Buckets in den USA, Europa und Asien erstellen, um Daten für Benutzer in diesen Regionen zu speichern, um die Latenz zu reduzieren.
Der zweite Anwendungsfall ist hilfreich, wenn Sie Daten mit unterschiedlichen Zugriffsmustern haben. Zum Beispiel: Sie können einen multiregionalen oder regionalen Bucket einrichten, der Bilder oder andere häufig aufgerufene Inhalte speichert, und einen Nearline- oder Coldline-Bucket, der Benutzer-Backups oder andere selten aufgerufene Inhalte speichert.
In jedem dieser Anwendungsfälle sollten Sie mehrere Cloud Storage-Buckets verwenden .
Der dritte Anwendungsfall ist nützlich, wenn Sie eine App wie Google Drive erstellen, mit der Benutzer mehrere angemeldete Konten haben können (z. B. ein privates Konto und ein Arbeitskonto). Sie können jedes zusätzliche Konto mit einer benutzerdefinierten Firebase-App- Instanz authentifizieren.
Verwenden Sie mehrere Cloud Storage-Buckets
Wenn Sie einen anderen Cloud Storage-Bucket als den oben angegebenen Standard oder mehrere Cloud Storage-Buckets in einer einzelnen App verwenden möchten, können Sie eine Instanz von FIRStorage
erstellen, die auf Ihren benutzerdefinierten Bucket verweist:
Schnell
// Get a non-default Cloud Storage bucket storage = Storage.storage(url:"gs://my-custom-bucket")
Ziel c
// Get a non-default Cloud Storage bucket FIRStorage storage = [FIRStorage storageWithURL:@"gs://my-custom-bucket"];
Arbeiten mit importierten Buckets
Wenn Sie einen vorhandenen Cloud Storage-Bucket in Firebase importieren, müssen Sie Firebase den Zugriff auf diese Dateien mit dem gsutil
Tool gewähren, das im Google Cloud SDK enthalten ist:
gsutil -m acl ch -r -u service-<project number>@gcp-sa-firebasestorage.iam.gserviceaccount.com gs://<your-cloud-storage-bucket>
Sie finden Ihre Projektnummer wie in der Einführung zu Firebase-Projekten beschrieben.
Dies wirkt sich nicht auf neu erstellte Buckets aus, da für diese die Standardzugriffssteuerung so eingestellt ist, dass sie Firebase zulässt. Dies ist eine vorübergehende Maßnahme und wird in Zukunft automatisch durchgeführt.
Verwenden Sie eine benutzerdefinierte Firebase-App
Wenn Sie eine kompliziertere App mit einer benutzerdefinierten FirebaseApp
erstellen, können Sie eine Instanz von Storage
erstellen, die mit dieser App initialisiert wird:
Schnell
// 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")
Ziel 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"];
Nächste Schritte
Bereiten Sie den Start Ihrer App vor:
Aktivieren Sie App Check, um sicherzustellen, dass nur Ihre Apps auf Ihre Speicher-Buckets zugreifen können.
Richten Sie Budgetbenachrichtigungen für Ihr Projekt in der Google Cloud Console ein.
Überwachen Sie das Nutzungs- und Abrechnungs- Dashboard in der Firebase-Konsole, um sich einen Überblick über die Nutzung Ihres Projekts über mehrere Firebase-Dienste hinweg zu verschaffen. Sie können auch das Cloud Storage Usage Dashboard besuchen, um detailliertere Nutzungsinformationen zu erhalten.
Überprüfen Sie die Firebase-Startcheckliste .