Memulai Cloud Storage di platform Apple

Dengan Cloud Storage for Firebase, Anda dapat mengupload dan membagikan konten buatan pengguna, seperti gambar dan video, sehingga Anda dapat memperkaya aplikasi dengan konten multimedia. Data Anda disimpan dalam bucket Google Cloud Storage, yakni solusi penyimpanan objek berskala exabyte dengan ketersediaan tinggi dan redundansi global. Cloud Storage for Firebase dapat digunakan untuk mengupload file tersebut secara langsung dan aman dari perangkat seluler dan browser web, sehingga jaringan yang tidak stabil dapat ditangani dengan mudah.

Prasyarat

Instal Firebase SDK.
Tambahkan aplikasi Anda ke project Firebase di Firebase console.

Membuat bucket Cloud Storage default

Dari panel navigasi Firebase console, pilih Storage, lalu klik Get started.
Tinjau pesan tentang cara mengamankan data Cloud Storage menggunakan aturan keamanan. Selama pengembangan, sebaiknya siapkan aturan Anda untuk akses publik.
Pilih lokasi untuk bucket Cloud Storage default.
- Setelan lokasi ini adalah lokasi resource Google Cloud Platform (GCP) default project Anda. Perlu diperhatikan bahwa lokasi ini akan digunakan untuk layanan GCP di project Anda yang memerlukan setelan lokasi, khususnya, database Cloud Firestore dan aplikasi App Engine (yang diperlukan jika Anda menggunakan Cloud Scheduler).
- Jika lokasi tidak dapat dipilih, berarti project Anda sudah memiliki lokasi resource GCP default. Lokasi ditetapkan baik selama pembuatan project maupun saat penyiapan layanan lain yang memerlukan setelan lokasi.
Jika menggunakan paket Blaze, Anda dapat membuat beberapa bucket, masing-masing dengan lokasinya sendiri.

Peringatan: Setelah lokasi resource GCP default project ditetapkan, Anda tidak dapat mengubahnya.
Klik Done.

Menyiapkan akses publik

Cloud Storage for Firebase menyediakan bahasa aturan deklaratif, sehingga Anda dapat menentukan cara data disusun dan diindeks, serta kapan data tersebut dapat dibaca dan dituliskan. Secara default, akses baca dan tulis pada Cloud Storage dibatasi, sehingga hanya pengguna terautentikasi yang dapat membaca atau menulis data. Untuk memulai tanpa menyiapkan Authentication, Anda dapat mengonfigurasi aturan untuk akses publik.

Tindakan ini membuat Cloud Storage terbuka untuk siapa saja, bahkan orang yang tidak menggunakan aplikasi Anda. Oleh karena itu, pastikan untuk membatasi Cloud Storage kembali saat Anda menyiapkan autentikasi.

Menambahkan Cloud Storage ke aplikasi

Gunakan Swift Package Manager untuk menginstal dan mengelola dependensi Firebase.

Di Xcode, dengan project aplikasi Anda dalam keadaan terbuka, buka File > Add Packages.
Saat diminta, tambahkan repositori SDK platform Apple Firebase:

  https://github.com/firebase/firebase-ios-sdk

Pilih library Cloud Storage.
Setelah selesai, Xcode akan otomatis mulai me-resolve dan mendownload dependensi Anda di latar belakang.

Menyiapkan Cloud Storage

Anda harus menginisialisasi Firebase sebelum membuat atau menggunakan referensi Firebase. Jika hal ini telah dilakukan pada fitur Firebase lainnya, Anda dapat melewati langkah ini.

Impor modul FirebaseCore dalam UIApplicationDelegate Anda, serta semua modul Firebase lainnya yang digunakan oleh delegasi aplikasi Anda. Misalnya, untuk menggunakan Cloud Firestore dan Authentication:
Swift
```
import FirebaseCore
import FirebaseFirestore
import FirebaseAuth
// ...
      
```
Objective-C
```
@import FirebaseCore;
@import FirebaseFirestore;
@import FirebaseAuth;
// ...
      
```
Konfigurasikan instance bersama FirebaseApp, yang biasanya ada dalam penginisialisasi App atau metode application(_:didFinishLaunchingWithOptions:) delegasi aplikasi:
Swift
```
// Use Firebase library to configure APIs
FirebaseApp.configure()
```
Objective-C
```
// Use Firebase library to configure APIs
[FIRApp configure];
```
Dapatkan referensi ke layanan Cloud Storage, menggunakan Aplikasi Firebase default:
Swift
```
let storage = Storage.storage()
```
Objective-C
```
FIRStorage *storage = [FIRStorage storage];
```

Anda siap untuk mulai menggunakan Cloud Storage.

Pertama, mari pelajari cara membuat referensi Cloud Storage.

Penyiapan lanjutan

Ada beberapa kasus penggunaan yang memerlukan penyiapan tambahan:

Menggunakan bucket Cloud Storage di beberapa region geografis
Menggunakan bucket Cloud Storage di berbagai kelas penyimpanan
Menggunakan bucket Cloud Storage dengan beberapa pengguna terautentikasi dalam aplikasi yang sama

Kasus penggunaan pertama sangat cocok jika Anda memiliki pengguna di berbagai tempat di dunia dan ingin menyimpan data mereka di dekat mereka. Misalnya, Anda dapat membuat bucket di Amerika Serikat, Eropa, dan Asia untuk menyimpan data bagi pengguna di region-region tersebut guna mengurangi latensi.

Kasus penggunaan kedua sangat membantu jika Anda memiliki data dengan berbagai pola akses. Misalnya: Anda dapat menyiapkan bucket multiregional atau regional yang menyimpan gambar atau konten lain yang sering diakses, dan bucket nearline atau coldline yang menyimpan cadangan pengguna atau konten lainnya yang jarang diakses.

Dalam kedua kasus penggunaan tersebut, sebaiknya gunakan beberapa bucket Cloud Storage.

Kasus penggunaan ketiga berguna jika Anda membuat aplikasi yang memungkinkan pengguna untuk memiliki beberapa akun login (misalnya, akun pribadi dan akun kerja), seperti Google Drive. Anda dapat menggunakan instance Aplikasi Firebase kustom untuk mengautentikasi setiap akun tambahan.

Menggunakan beberapa bucket Cloud Storage

Jika Anda ingin menggunakan bucket Cloud Storage selain bucket default yang disediakan di atas, atau ingin menggunakan beberapa bucket Cloud Storage di satu aplikasi, Anda dapat membuat instance FIRStorage yang mereferensikan bucket khusus Anda:

Swift

// 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"];

Menangani bucket hasil impor

Saat mengimpor bucket Cloud Storage yang sudah ada ke Firebase, Anda harus mengizinkan Firebase untuk mengakses file ini menggunakan alat gsutil, yang disertakan dalam Google Cloud SDK:

gsutil -m acl ch -r -u service-<project number>@gcp-sa-firebasestorage.iam.gserviceaccount.com gs://<your-cloud-storage-bucket>

Anda dapat menemukan nomor project seperti yang dijelaskan dalam pengantar project Firebase.

Hal ini tidak akan memengaruhi bucket yang baru dibuat karena bucket ini memiliki kontrol akses default yang ditetapkan untuk mengizinkan Firebase. Ini adalah tindakan sementara dan akan dilakukan secara otomatis di masa mendatang.

Menggunakan Aplikasi Firebase kustom

Jika Anda membuat aplikasi yang lebih rumit menggunakan FirebaseApp kustom, Anda dapat membuat instance Storage yang diinisialisasi dengan aplikasi tersebut:

Swift

// 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"];

Langkah berikutnya

Bersiap meluncurkan aplikasi Anda:
- Aktifkan App Check untuk membantu memastikan bahwa hanya aplikasi Anda yang dapat mengakses bucket penyimpanan.
- Siapkan pemberitahuan anggaran untuk project Anda di Google Cloud Console.
- Pantau dasbor Usage and billing di Firebase console untuk mendapatkan gambaran keseluruhan penggunaan project Anda di berbagai layanan Firebase. Anda juga dapat membuka dasbor Usage Cloud Storage untuk mengetahui informasi penggunaan yang lebih mendetail.
- Periksa checklist peluncuran Firebase.