Memulai Cloud Storage untuk C++

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

Sebelum memulai

Android

  1. Jika Anda belum menghubungkan aplikasi dengan project Firebase, lakukanlah dari Firebase console.
  2. Tambahkan Firebase ke project Android Anda.
  3. Tambahkan dependensi untuk Cloud Storage ke file build.gradle level aplikasi:
    dependencies {
     implementation 'com.google.firebase:firebase-storage:16.1.0'
    }
  4. Tautkan library statis libapp.a dan libstorage.a dari C++ SDK.

iOS

  1. Jika Anda belum menghubungkan aplikasi dengan project Firebase, lakukanlah dari Firebase console.
  2. Tambahkan Firebase ke project iOS Anda.
  3. Sertakan Pod berikut dalam Podfile:
    pod 'Firebase/Storage'
  4. Jalankan pod install
  5. Tambahkan firebase.framework dan firebase_storage.framework dari C++ SDK ke project Xcode Anda.

Menyiapkan akses publik

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

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

Membuat dan menginisialisasi firebase::App

Agar dapat mengakses Storage, Anda harus membuat dan menginisialisasi firebase::App terlebih dahulu.

Sertakan file header untuk firebase::App:

#include "firebase/app.h"

Android

Buat firebase::App dengan meneruskan lingkungan JNI dan referensi jobject ke Java Activity sebagai argumen:

app = App::Create(AppOptions(), jni_env, activity);

iOS

Buat firebase::App:

app = App::Create(AppOptions());

Mengakses kelas firebase::storage::Storage

Class firebase::storage::Storage adalah titik masuk untuk Cloud Storage C++ SDK.

Storage* storage = Storage::GetInstance(app);

Anda kini siap untuk mulai menggunakan Cloud Storage.

Pertama, mari pelajari cara membuat referensi Cloud Storage.

Penyiapan lanjutan

Ada beberapa kasus penggunaan yang memerlukan penyiapan tambahan:

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

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

Dalam salah satu kasus penggunaan ini, sebaiknya gunakan beberapa bucket penyimpanan.

Kasus penggunaan ketiga berguna jika Anda sedang 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 penyimpanan

Jika Anda ingin menggunakan bucket penyimpanan selain bucket default yang disediakan di atas, atau menggunakan beberapa bucket penyimpanan di satu aplikasi, Anda dapat membuat instance firebase::storage::Storage yang mereferensikan bucket kustom Anda:

// Get a non-default Storage bucket
Storage* storage = Storage::GetInstance("gs://my-custom-bucket");

Bekerja dengan bucket hasil impor

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

gsutil -m acl ch -r -u firebase-storage@system.gserviceaccount.com:O gs://<your-cloud-storage-bucket>

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 firebase::App kustom, Anda dapat membuat instance firebase::storage::Storage yang diinisialisasi dengan aplikasi tersebut:

// Get the default bucket from a custom firebase::App
Storage* storage = Storage::GetInstance(customApp);

// Get a non-default bucket from a custom firebase::App
Storage* storage = Storage::GetInstance(customApp, "gs://my-custom-bucket");

Kirim masukan tentang...

Butuh bantuan? Kunjungi halaman dukungan kami.