Google berkomitmen untuk mendorong terwujudnya keadilan ras bagi komunitas Kulit Hitam. Lihat caranya.

Menambahkan Firebase ke aplikasi Flutter

Ikuti panduan ini untuk menambahkan produk Firebase ke aplikasi Flutter.

Prasyarat

  • Instal editor atau IDE pilihan Anda.

  • Pastikan aplikasi Flutter Anda menarget versi iOS 8 atau yang lebih baru.

  • Siapkan perangkat iOS fisik atau simulator iOS untuk menjalankan aplikasi Anda.

    • Untuk Cloud Messaging, selesaikan langkah-langkah berikut:

      • Siapkan perangkat iOS fisik.
      • Dapatkan Kunci Autentikasi Notifikasi Push Apple untuk akun Apple Developer.
      • Di XCode, aktifkan Notifikasi Push di bagian App > Capabilities.
    • Untuk semua produk Firebase lainnya, Anda dapat menggunakan perangkat iOS fisik atau simulator iOS.

  • Instal Flutter untuk sistem operasi spesifik Anda, termasuk hal-hal berikut:

    • Flutter SDK
    • Library pendukung
    • SDK dan software khusus platform terkait
  • Login ke Firebase menggunakan Akun Google Anda.

Jika belum memiliki aplikasi Flutter, Anda dapat menyelesaikan Memulai: Uji Coba untuk membuat aplikasi Flutter baru menggunakan editor atau IDE pilihan Anda.

Langkah 1: Buat project Firebase

Agar dapat menambahkan Firebase ke aplikasi Flutter, Anda perlu membuat project Firebase yang akan dihubungkan ke aplikasi Anda. Buka bagian Memahami Project Firebase untuk mempelajari project Firebase lebih lanjut.

Langkah 2: Daftarkan aplikasi Anda ke Firebase

  1. Di tengah halaman Project Overview di Firebase console, klik ikon iOS () untuk meluncurkan alur kerja penyiapan.

    Jika Anda sudah menambahkan aplikasi ke project Firebase, klik Add app untuk menampilkan opsi platform.

  2. Masukkan ID paket aplikasi di kolom iOS bundle ID.

    Temukan ID paket ini dari project terbuka Anda di XCode. Pilih aplikasi level paling atas pada navigator project, lalu akses tab General. Nilai Bundle Identifier adalah ID paket iOS (misalnya, com.yourcompany.ios-app-name).

  3. (Opsional) Masukkan informasi lain aplikasi seperti yang diminta oleh alur kerja penyiapan.

  4. Klik Register app.

Langkah 3: Tambahkan file konfigurasi Firebase

  1. Klik Download GoogleService-Info.plist untuk mendapatkan file konfigurasi iOS Firebase Anda (GoogleService-Info.plist).

  2. Dengan menggunakan Xcode, pindahkan file ke direktori Runner/Runner aplikasi Flutter Anda.

  3. Kembalilah ke alur kerja penyiapan Firebase console, klik Next untuk mengabaikan langkah-langkah yang belum dilakukan.

  4. Lanjutkan ke langkah Add FlutterFire plugins.

Langkah 4: Tambahkan plugin FlutterFire

Flutter menggunakan plugin untuk menyediakan akses ke berbagai layanan khusus platform, seperti Firebase API. Plugin menyertakan kode khusus platform untuk mengakses layanan dan API di setiap platform.

Firebase diakses melalui sejumlah library yang berbeda, satu untuk setiap produk Firebase (misalnya: Realtime Database, Authentication, Analytics, atau Cloud Storage). Flutter menyediakan serangkaian plugin Firebase, yang secara kolektif disebut FlutterFire.

Karena Flutter adalah SDK multi-platform, setiap plugin FlutterFire dapat diterapkan untuk iOS dan Android. Jadi, jika Anda menambahkan plugin FlutterFire ke aplikasi Flutter, plugin tersebut akan digunakan oleh versi iOS dan Android aplikasi Firebase Anda.

Pastikan untuk memeriksa dokumentasi FlutterFire guna melihat daftar terbaru plugin FlutterFire.

  1. Pastikan aplikasi saat ini tidak berjalan di emulator atau perangkat Anda.

  2. Dari direktori utama aplikasi Flutter, buka file pubspec.yaml.

  3. Tambahkan plugin FlutterFire untuk Firebase Core Flutter SDK.

    dependencies:
      flutter:
        sdk: flutter
      # Add the dependency for the Firebase Core Flutter SDK
      firebase_core: ^0.4.0+9
    
  4. Tambahkan plugin FlutterFire untuk produk Firebase yang ingin Anda gunakan di aplikasi Anda.

    Analytics diaktifkan

    dependencies:
      flutter:
        sdk: flutter
      # Check that you have this dependency (added in the previous step)
      firebase_core: ^0.4.0+9
    # Add the dependency for the FlutterFire plugin for Google Analytics firebase_analytics: ^5.0.2
    # Add the dependencies for any other Firebase products you want to use in your app # For example, to use Firebase Authentication and Cloud Firestore firebase_auth: ^0.14.0+5 cloud_firestore: ^0.12.9+5

    Analytics tidak diaktifkan

    dependencies:
      flutter:
        sdk: flutter
      # Check that you have this dependency (added in the previous step)
      firebase_core: ^0.4.0+9
    # Add the dependencies for the Firebase products you want to use in your app # For example, to use Firebase Authentication and Cloud Firestore firebase_auth: ^0.14.0+5 cloud_firestore: ^0.12.9+5
  5. Jalankan flutter packages get.
    Untuk mengetahui informasi lebih lanjut tentang cara mengelola paket dan plugin, baca Menggunakan Paket.

  6. Jika Anda menambahkan Analytics, jalankan aplikasi untuk mengirim verifikasi ke Firebase bahwa Anda telah berhasil mengintegrasikan Firebase. Jika tidak, Anda dapat melewatkan langkah verifikasi.

Anda sudah siap. Aplikasi Flutter Anda sudah terdaftar dan dikonfigurasi untuk menggunakan Firebase.

Mencoba aplikasi contoh dengan Analytics

Seperti semua paket lainnya, plugin firebase_analytics dilengkapi dengan program contoh.

  1. Buka aplikasi Flutter yang telah Anda konfigurasi untuk menggunakan Firebase (lihat petunjuk di halaman ini).

  2. Akses direktori lib aplikasi, lalu hapus file main.dart yang sudah ada.

  3. Dari repositori contoh program Google Analytics, salin dan tempel dua file berikut ke dalam direktori lib aplikasi Anda:

    • main.dart
    • tabs_page.dart
  4. Jalankan aplikasi Flutter Anda.

  5. Buka project Firebase aplikasi Anda di Firebase console, lalu klik Analytics di panel navigasi kiri.

    • Klik Dashboard. Jika Analytics berfungsi dengan baik, dasbor akan menampilkan satu pengguna aktif di panel "Users active in the last 30 minutes" (mungkin perlu waktu untuk melihatnya di panel ini).

    • Klik DebugView. Aktifkan fitur tersebut untuk melihat semua peristiwa yang dihasilkan oleh contoh program.

Untuk mengetahui informasi selengkapnya tentang cara menyiapkan Analytics, baca panduan memulai untuk iOS dan Android.

Langkah berikutnya