Menambahkan Firebase ke project Unity

Tingkatkan game Unity Anda dengan Firebase Unity SDK.

Untuk menunjukkan betapa mudah memasang Firebase ke dalam project Unity, kami membuat contoh game, MechaHamster, yang dapat didownload dari GitHub, App Store, dan Google Play Store.

MechaHamster (GitHub)

MechaHamster (App Store)

MechaHamster (Play Store)

Temukan informasi lebih lanjut tentang cara meningkatkan game Anda dengan Firebase di halaman game Firebase.

Sudah menambahkan Firebase ke project Unity Anda? Pastikan Anda menggunakan Firebase Unity SDK versi terbaru.

Prasyarat

Instal Unity 2017.4 atau yang lebih baru. Versi sebelumnya mungkin juga kompatibel, tetapi tidak akan didukung terus-menerus.
(khusus iOS) Instal aplikasi berikut:
- Xcode 9.4.1 atau versi yang lebih tinggi
- CocoaPods 1.10.0 atau versi yang lebih tinggi
Pastikan project Unity Anda memenuhi persyaratan berikut:
- Untuk iOS — menargetkan iOS 10 atau yang lebih tinggi
- Untuk Android — menargetkan API level 16 (Jelly Bean) atau yang lebih tinggi
  
  Catatan: Jika Anda mengalami error "Error saat dexing" saat melakukan build Android menggunakan Unity 2017 atau 2018, lihat FAQ untuk menemukan solusi yang memungkinkan.

Siapkan perangkat fisik atau gunakan emulator untuk menjalankan aplikasi Anda.
- Untuk iOS — Siapkan perangkat iOS fisik atau gunakan simulator iOS.
  Apakah Anda ingin menggunakan Cloud Messaging?
  Untuk Cloud Messaging di iOS, berikut prasyaratnya:
  - Siapkan perangkat iOS fisik.
  - Dapatkan Kunci Autentikasi Notifikasi Push Apple untuk akun Apple Developer.
  - Di XCode, aktifkan Notifikasi Push di App > Capabilities.
- Untuk Android — Emulator harus menggunakan image emulator dengan Google Play.

Jika Anda belum memiliki project Unity dan hanya ingin mencoba produk Firebase, download salah satu contoh panduan memulai.

Langkah 1: Buat project Firebase

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

Membuat project Firebase

Di Firebase console, klik Tambahkan project, lalu pilih atau masukkan Nama project.

Jika sudah memiliki project Google Cloud, Anda dapat memilihnya dari menu drop-down untuk menambahkan resource Firebase ke project tersebut.
(Opsional) Jika membuat project baru, Anda dapat mengedit Project ID.

Firebase otomatis menetapkan ID unik ke project Firebase Anda. Buka Memahami Project Firebase untuk mempelajari cara Firebase menggunakan project ID.

Setelah Firebase menyediakan resource untuk project Anda, project ID tidak dapat Anda ubah.
Jika ingin menggunakan ID khusus, Anda harus mengedit project ID selama langkah penyiapan ini.
Klik Lanjutkan.

(Opsional) Siapkan Google Analytics untuk project Anda untuk mengoptimalkan penggunaan produk-produk Firebase berikut:

Saat diminta, pilih untuk menggunakan akun Google Analytics yang ada atau membuat akun baru.
Jika Anda memilih untuk membuat akun baru, pilih lokasi pelaporan Analytics, lalu setujui setelan berbagi data dan persyaratan Google Analytics untuk project Anda.

Klik Buat project (atau Tambahkan Firebase, jika menggunakan project Google Cloud yang sudah ada).

Firebase otomatis menyediakan resource untuk project Firebase Anda. Setelah selesai, Anda akan dibawa ke halaman ringkasan untuk project Firebase Anda di Firebase console.

Langkah 2: Daftarkan aplikasi Anda ke Firebase

Anda dapat mendaftarkan satu atau beberapa aplikasi atau game untuk dihubungkan dengan project Firebase Anda.

Buka Firebase console.
Di bagian tengah halaman ringkasan project, klik ikon Unity () untuk meluncurkan alur kerja penyiapan.

Jika Anda sudah menambahkan aplikasi ke project Firebase, klik Tambahkan aplikasi untuk menampilkan opsi platform.
Pilih target build project Unity yang ingin Anda daftarkan, atau Anda bahkan dapat memilih untuk mendaftarkan kedua target sekaligus.

Catatan: Jika Anda hanya mendaftarkan satu target build project Unity Anda sekarang, Anda dapat kembali ke alur kerja penyiapan kapan saja untuk mendaftarkan target build lainnya.
Masukkan ID khusus platform project Unity Anda.
- Untuk iOS — Masukkan ID iOS project Unity Anda di kolom ID paket iOS.
- Untuk Android — Masukkan ID Android project Unity Anda di kolom nama paket Android.
  Istilah nama paket dan ID aplikasi sering kali digunakan secara bergantian.
Di mana Anda menemukan ID project Unity?
Buka project Unity di Unity IDE Anda, lalu buka bagian setelan untuk setiap platform:
- Untuk iOS — Buka Build Settings > iOS.
- Untuk Android — Buka Android > Player Settings > Other Settings.
ID project Unity Anda adalah nilai Bundle Identifier (contoh ID: com.yourcompany.yourproject).
Pastikan untuk memasukkan ID yang benar-benar digunakan project Anda. Nilai ID peka huruf besar/kecil, dan tidak dapat diubah untuk aplikasi Firebase ini setelah didaftarkan ke project Firebase Anda.
(Opsional) Masukkan nama panggilan khusus platform project Unity Anda.
Nama panggilan ini adalah ID internal praktis yang hanya terlihat oleh Anda di Firebase console.
Klik Daftarkan aplikasi.

Langkah 3: Tambahkan file konfigurasi Firebase

Dapatkan file konfigurasi Firebase khusus platform Anda di alur kerja penyiapan Firebase console.

Jika Anda mendaftarkan target build iOS dan Android project Unity, Anda harus mendownload dan menambahkan file konfigurasi untuk kedua platform.
- Untuk iOS — Klik Download GoogleService-Info.plist.
- Untuk Android — Klik Download google-services.json.
Apa yang perlu Anda ketahui tentang file konfigurasi ini?
- File konfigurasi Firebase berisi ID unik, tetapi tidak bersifat rahasia, untuk project Anda. Untuk mempelajari file konfigurasi ini lebih lanjut, baca Memahami Project Firebase.
- Anda dapat mendownload lagi file konfigurasi Firebase kapan saja.
- Pastikan nama file konfigurasi tidak diberi karakter tambahan, seperti (2).
Buka jendela Project untuk project Unity Anda, lalu pindahkan file konfigurasi ke folder Assets.
Kembali ke Firebase console, di alur kerja penyiapan, klik Berikutnya.

Langkah 4: Tambahkan Firebase Unity SDK

Di Firebase console, klik Download Firebase Unity SDK, lalu ekstrak SDK di tempat yang mudah diakses.
- Anda dapat mendownload Firebase Unity SDK lagi kapan saja.
- Firebase Unity SDK tidak khusus untuk platform tertentu.
Di dalam project Unity, buka Assets > Import Package > Custom Package.
Dari SDK yang telah diekstrak, pilih produk Firebase yang didukung yang ingin digunakan dalam aplikasi Anda.
Analytics diaktifkan
- Tambahkan paket Firebase untuk Google Analytics: FirebaseAnalytics.unitypackage
- Tambahkan paket untuk produk Firebase lainnya yang ingin digunakan di aplikasi Anda. Misalnya, untuk menggunakan Firebase Authentication dan Firebase Realtime Database:
  FirebaseAuth.unitypackage dan FirebaseDatabase.unitypackage
Analytics tidak diaktifkan
Tambahkan paket untuk produk Firebase yang ingin digunakan di aplikasi Anda. Misalnya, untuk menggunakan Firebase Authentication dan Firebase Realtime Database:
FirebaseAuth.unitypackage dan FirebaseDatabase.unitypackage
Unity 5.x dan versi sebelumnya menggunakan framework .NET 3.x, jadi impor paket dotnet3/.

Unity 2017.x dan versi setelahnya mendukung penggunaan framework .NET 4.x. Jika project Unity Anda menggunakan .NET 4.x, impor paket dotnet4/.

Unity 2019 dan yang lebih baru tidak lagi mendukung framework .NET 3.x, jadi impor paket dotnet4/.
Di jendela Import Unity Package, klik Import.
Kembali ke Firebase console, di alur kerja penyiapan, klik Berikutnya.

Langkah 5: Konfirmasikan persyaratan versi layanan Google Play

Firebase Unity SDK untuk Android memerlukan layanan Google Play versi terbaru agar SDK dapat digunakan.

Tambahkan kode berikut di awal aplikasi Anda. Anda dapat memeriksa dan mengupdate layanan Google Play secara opsional ke versi yang diperlukan oleh Firebase Unity SDK sebelum memanggil metode lain di SDK.

Firebase.FirebaseApp.CheckAndFixDependenciesAsync().ContinueWith(task => {
  var dependencyStatus = task.Result;
  if (dependencyStatus == Firebase.DependencyStatus.Available) {
    // Create and hold a reference to your FirebaseApp,
    // where app is a Firebase.FirebaseApp property of your application class.
       app = Firebase.FirebaseApp.DefaultInstance;

    // Set a flag here to indicate whether Firebase is ready to use by your app.
  } else {
    UnityEngine.Debug.LogError(System.String.Format(
      "Could not resolve all Firebase dependencies: {0}", dependencyStatus));
    // Firebase Unity SDK is not safe to use here.
  }
});

Anda sudah siap! Project Unity Anda sudah terdaftar dan dikonfigurasi untuk menggunakan Firebase.

Jika Anda mengalami masalah dalam penyiapan, buka FAQ & pemecahan masalah Unity.

Menyiapkan alur kerja desktop (beta)

Saat Anda membuat game, pengujian game sering kali jauh lebih mudah dilakukan di editor Unity dan di platform desktop terlebih dahulu. Kemudian, Anda dapat men-deploy dan melakukan pengujian di perangkat seluler setelahnya. Untuk mendukung alur kerja ini, kami menyediakan beberapa fitur Firebase Unity SDK yang dapat dijalankan di Windows, macOS, Linux, dan dari dalam editor Unity:

Siapkan project Unity platform desktop dengan mengikuti petunjuk yang sama seperti untuk platform seluler (mulai dengan langkah Mendaftarkan aplikasi ke Firebase di atas).
Jalankan project Unity Anda di Unity IDE atau pilih untuk mem-build project Unity Anda untuk desktop.

Catatan: Firebase menemukan file konfigurasi Firebase seluler (GoogleService-Info.plist atau google-services.json) yang Anda tambahkan ke project Unity Anda. Kemudian, dari file konfigurasi seluler, Firebase otomatis akan membuat file konfigurasi Firebase desktop (google-services-desktop.json).
File konfigurasi desktop ini berisi project ID Unity yang Anda masukkan di alur kerja penyiapan Firebase console. File ini mengaitkan aplikasi Anda dengan project Firebase Anda.
(Opsional) Jalankan project Unity Anda dalam Mode Edit.

Firebase Unity SDK juga dapat dijalankan dalam mode edit Unity, yang memungkinkan penggunaannya dalam plugin editor.
1. Saat Anda membuat FirebaseApp yang digunakan oleh editor, jangan gunakan instance default.
2. Sebagai gantinya, berikan nama unik untuk panggilan FirebaseApp.Create().
  
  Hal ini penting untuk menghindari konflik dalam menentukan antara instance yang digunakan oleh Unity IDE dan instance yang digunakan oleh project Unity Anda.

Produk Firebase yang didukung

Pelajari lebih lanjut tentang library Firebase Unity di dokumentasi referensi.

Firebase Unity SDK mendukung produk Firebase berikut di iOS dan Android:

Produk Firebase	Paket Unity
AdMob	Didistribusikan secara terpisah dalam AdMob Unity Plugin
Analytics	`FirebaseAnalytics.unitypackage`
Authentication	`FirebaseAuth.unitypackage`
Cloud Firestore (beta)	`FirebaseFirestore.unitypackage`
Cloud Functions	`FirebaseFunctions.unitypackage`
Cloud Messaging	`FirebaseMessaging.unitypackage` (direkomendasikan) `FirebaseAnalytics.unitypackage`
Cloud Storage	`FirebaseStorage.unitypackage`
Crashlytics	`FirebaseCrashlytics.unitypackage` (direkomendasikan) `FirebaseAnalytics.unitypackage`
Dynamic Links	`FirebaseDynamicLinks.unitypackage` (direkomendasikan) `FirebaseAnalytics.unitypackage`
Realtime Database	`FirebaseDatabase.unitypackage`
Remote Config	`FirebaseRemoteConfig.unitypackage` (direkomendasikan) `FirebaseAnalytics.unitypackage`

Produk Firebase yang didukung (desktop)

Firebase Unity SDK memiliki dukungan alur kerja desktop untuk sekumpulan produk, sehingga bagian Firebase tertentu dapat digunakan dalam editor Unity dan dalam build desktop mandiri di Windows, macOS, serta Linux.

Produk Firebase (desktop)	Paket Unity
Authentication	`FirebaseAuth.unitypackage`
Cloud Functions	`FirebaseFunctions.unitypackage`
Cloud Firestore	`FirebaseFirestore.unitypackage`
Cloud Storage	`FirebaseStorage.unitypackage`
Realtime Database	`FirebaseDatabase.unitypackage`
Remote Config	`FirebaseRemoteConfig.unitypackage`

Firebase menyediakan library desktop lainnya sebagai implementasi stub (nonfungsional) demi kemudahan saat mem-build aplikasi untuk Windows, macOS, dan Linux. Oleh sebab itu, Anda tidak perlu mengompilasi kode secara kondisional untuk menarget desktop.

Langkah berikutnya

Pelajari contoh aplikasi Firebase.
Bersiap meluncurkan aplikasi Anda:
- Siapkan pemberitahuan anggaran untuk project Anda di Google Cloud Console.
- Pantau dasbor Penggunaan dan penagihan di Firebase console untuk mendapatkan gambaran keseluruhan penggunaan project Anda di berbagai layanan Firebase.
- Periksa checklist peluncuran Firebase.
Mengalami masalah dengan Firebase dan project Unity Anda? Buka FAQ & pemecahan masalah Unity.