Proses debug Build, Penginstalan, dan Proses Menjalankan Game

Pengantar

Berikut ini adalah panduan untuk memproses debug kompilasi dan proses build untuk game Unity menggunakan Firebase SDK untuk Unity. Panduan ini menjelaskan cara menyelidiki dan menyelesaikan berbagai masalah umum yang dapat Anda temui saat mengonfigurasi dan membangun game untuk platform baru atau setelah update. Panduan ini disusun sesuai dengan urutan waktu masing-masing error ini terjadi dalam proses. Baca panduan secara berurutan dan lanjutkan setelah satu masalah teratasi.

Selain dokumen ini, baca FAQ Firebase untuk Unity untuk mengetahui informasi selengkapnya.

Masalah kompilasi Mode Play

Masalah build yang pertama dapat terjadi saat melakukan pengujian di editor sebelum Anda mencoba memulai build seluler. Bagian ini membahas semua error Firebase yang terjadi sebelum dan selama Mode Play.

Saat Unity memulai atau mendeteksi perubahan pada dependensi, kode, atau aset lainnya, Unity akan mencoba membangun ulang project. Jika project tidak dapat dikompilasi pada saat itu, editor akan mencatat error kompilasi ke dalam konsol. Jika Anda mencoba memasuki Mode Play, Anda akan menerima pop-up error di tab Scene Unity yang bertuliskan All compiler errors have to be fixed before you can enter playmode!.

Jenis, class, metode, dan anggota tidak ada

Banyak masalah Firebase terjadi karena ketidakmampuan editor dan compiler untuk menemukan jenis, class, metode, dan anggota yang diperlukan. Gejala umumnya adalah varian berikut:

The type or namespace name ‘<CLASS OR NAMESPACE NAME>' could not be found. Are you missing a using directive or an assembly reference?

The type or namespace name <TYPE OR NAMESPACE NAME> does not exist in the namespace ‘Firebase<.OPTIONAL NESTED NAMESPACE NAME PATH>' (are you missing an assembly reference?)

‘<CLASS NAME>' does not contain a definition for ‘<MEMBER VARIABLE OR METHOD NAME>'

Langkah penyelesaian:

  1. Jika Anda menggunakan class atau metode Firebase dalam kode, pastikan Anda menyediakannya dengan menyertakan perintah using yang tepat untuk produk Firebase yang bersangkutan yang diperlukan.

    1. Contoh dari MechaHamster: Tingkatkan Kemampuan dengan Edisi Firebase:
      1. using Firebase.RemoteConfig;
      2. using Firebase.Crashlytics;

  2. Pastikan Anda telah mengimpor paket Firebase yang sesuai:

    1. Cara mengimpor paket yang sesuai:
      1. Tambahkan Firebase Unity SDK sebagai .unitypackage atau
      2. Pelajari dan lakukan salah satu cara alternatif dalam Opsi penginstalan Unity tambahan.
    2. Pastikan setiap produk Firebase dalam project Anda dan EDM4U:
      • Menggunakan versi yang sama
      • Diinstal sebagai .unitypackage secara eksklusif ATAU secara eksklusif melalui Pengelola Paket Unity.

  3. Jika Anda telah mengimpor Firebase Unity SDK sebelum versi "10.0.0" sebagai .unitypackage, file zip Firebase Unity SDK akan berisi paket untuk dukungan .NET 3.x dan .NET 4.x. Pastikan Anda hanya menyertakan level .NET Framework yang kompatibel dalam project:

    1. Kompatibilitas antara versi Unity Editor dan Level .NET Framework dibahas dalam Menambahkan Firebase ke project Unity.
    2. Jika Anda tidak sengaja mengimpor paket Firebase di Level .NET Framework yang salah atau perlu beralih dari menggunakan .unitypackage ke salah satu Opsi penginstalan Unity tambahan, cara terbaiknya adalah dengan menghapus setiap paket Firebase melalui metode yang disebutkan di bagian migrasi ini, lalu impor ulang semua paket Firebase lagi.

  4. Pastikan bahwa editor Anda membangun ulang project dan percobaan untuk bermain mencerminkan status terbaru project Anda:

    1. Secara default, editor Unity disetel untuk membangun ulang setiap kali perubahan aset atau konfigurasi terdeteksi.
    2. Mungkin saja fungsi ini telah dinonaktifkan dan Unity Editor disetel ke refresh/kompilasi manual. Selidiki hal ini dan coba refresh secara manual jika hal ini yang terjadi.

Error runtime Mode Play

Jika game Anda dimulai, tetapi mengalami masalah dengan Firebase saat berjalan, coba langkah berikut:

Pastikan Anda menyetujui paket Firebase di "Security & Privacy" di Mac OS

Jika Anda melihat dialog yang bertuliskan, "FirebaseCppApp-<version>.bundle Cannot be opened because the developer cannot be verified." saat memulai game di editor di Mac OS, Anda harus menyetujui file paket tersebut di menu Security & Privacy Mac.

Untuk melakukannya, klik ikon Apple > System Preference > Security & Privacy

Di menu keamanan, kira-kira di bagian tengah halaman, ada bagian yang bertuliskan ""FirebaseCppApp-<version>.bundle" was blocked from use because it is not from an identified developer."

Klik tombol berlabel Allow Anyway.