Menginstal paket Google untuk Unity

Paket Google untuk Unity didistribusikan dalam dua format yang berbeda:

  • Paket aset:
    • Memiliki ekstensi .unitypackage.
    • Instal ke direktori Assets project Anda.
    • Dapat diimpor di Unity 5 dan yang lebih baru.
    • Umumnya menyertakan paket dependen.
  • Paket Unity Package Manager (UPM):
    • Memiliki ekstensi .tgz.
    • Instal ke direktori Packages project Anda.
    • Dapat diimpor di Unity 2018.4 dan yang lebih baru.
    • Merujuk ke paket dependensi yang perlu diinstal secara terpisah.

Halaman Paket berisi file .unitypackage terbaru untuk semua paket yang tersedia.

Halaman Arsip berisi file .unitypackage dan .tgz untuk semua versi paket.

Di bawah ini Anda dapat menemukan petunjuk cara menginstal kedua jenis paket, serta petunjuk migrasi untuk beralih dari satu jenis ke jenis lainnya.

Setelah memahami opsi penginstalan ini, pastikan Anda melihat petunjuk khusus produk tambahan untuk Firebase.

Mengimpor paket Asset dengan file .unitypackage

Impor file .unitypackage dengan memilih opsi menu Unity Assets > Import package > Custom Package dan mengimpor semua item. Tindakan ini akan menambahkan konten paket ke project Anda di bagian direktori Aset.

Mengimpor paket UPM dengan file .tgz (2018.4+)

Impor file .tgz ke project Anda menggunakan salah satu metode berikut:

manifes.json

  1. Buat folder baru di samping folder Packages project Anda dan beri nama GooglePackages.
  2. Letakkan file .tgz ke folder tersebut.
  3. Gunakan editor teks untuk membuka Packages/manifest.json pada folder project Unity Anda.
  4. Tambahkan entri untuk setiap paket yang ingin Anda instal, dengan memetakan nama paket ke lokasi pada disk, yang terkait dengan file Packages/manifest.json. Pastikan untuk menambahkan file: ke jalur file .tgz. Misalnya, jika Anda menginstal com.google.firebase.storage dan dependensinya, manifest.json akan terlihat seperti ini:

    {
      "dependencies": {
        "com.google.external-dependency-manager": "file:../GooglePackages/com.google.external-dependency-manager-1.2.164.tgz",
        "com.google.firebase.app": "file:../GooglePackages/com.google.firebase.app-7.1.0.tgz",
        "com.google.firebase.auth": "file:../GooglePackages/com.google.firebase.auth-7.1.0.tgz",
        "com.google.firebase.storage": "file:../GooglePackages/com.google.firebase.storage-7.1.0.tgz",
        // com.unity package entries...
      }
    }
    
  5. Simpan file manifest.json.

  6. Saat kembali fokus, Unity akan memuat ulang manifest.json dan mengimpor paket yang baru ditambahkan.

Beberapa versi Unity yang lebih lama tidak mendukung file .tgz di manifest.json. Dalam hal ini, Anda harus:

  1. Buka kompresi file .tgz.
  2. Tempatkan folder yang diekstrak di folder GooglePackages.
  3. Edit manifest.json untuk menggunakan jalur ke folder yang diekstrak, bukan file .tgz, seperti:

    {
      "dependencies": {
        "com.google.external-dependency-manager": "file:../GooglePackages/com.google.external-dependency-manager-1.2.164",
        "com.google.firebase.app": "file:../GooglePackages/com.google.firebase.app-7.1.0",
        "com.google.firebase.auth": "file:../GooglePackages/com.google.firebase.auth-7.1.0",
        "com.google.firebase.storage": "file:../GooglePackages/com.google.firebase.storage-7.1.0",
        // com.unity package entries...
      }
    }
    

UI Package Manager

  1. Buka jendela Unity Package Manager.
  2. Klik ikon + di pojok kiri atas jendela Package Manager dan pilih Add package from tarball untuk membuka file browser.

    Screenshot Jendela Unity Package Manager dengan item drop-down "Tambahkan dari tarball" item dropdown dipilih

  3. Pilih tarball yang diinginkan di file browser.

Beberapa versi Unity yang lebih lama tidak mendukung penambahan tarball secara langsung. Dalam hal ini, Anda harus:

  1. Ekstrak file .tgz.
  2. Klik ikon + di pojok kiri atas jendela Package Manager dan pilih Add package from disk untuk membuka file browser.

    Screenshot Jendela Unity Package Manager dengan item dropdown "Tambahkan paket dari disk"

  3. Pilih folder yang diekstrak di file browser.

Pastikan juga mengimpor file .tgz untuk dependensi paket, yang dapat ditemukan di halaman arsip pada bagian paket yang diinginkan.

Misalnya, jika Anda menginstal com.google.firebase.storage, Anda akan menginstal file .tgz ini dalam urutan berikut:

  1. Pengelola Dependensi Eksternal (com.google.external-dependency-manager)
  2. Firebase Core (com.google.firebase.app)
  3. Firebase Auth (com.google.firebase.auth)
  4. Firebase Storage (com.google.firebase.storage)

Jika ingin menambahkan semua file .tgz sekaligus, tanpa khawatir tentang urutannya, Anda dapat mengikuti petunjuk di tab manifest.json.

Kontrol versi

Jika Anda menggunakan software kontrol versi untuk mengelola file project, sebaiknya tambahkan file .tgz yang relevan ke kontrol versi. Anda dapat mengedit manifest.json project secara manual (lihat petunjuk di atas) dan merujuk file .tgz lokal menggunakan jalur relatif.

Jika Anda menggunakan git, sebaiknya Git Large File Storage (LFS) untuk mengelola file .tgz besar.

Melakukan migrasi dari paket UPM ke Paket aset

Dalam beberapa kasus, Anda dapat beralih dari menggunakan Unity Package Manager untuk mengelola paket Google ke menginstal paket pada folder Assets.

Pastikan semua paket Google dihapus dari Unity Package Manager menggunakan salah satu metode berikut:

UI Package Manager

  1. Buka jendela Unity Package Manager.
  2. Pilih In Project pada menu drop-down di kiri atas.

    Screenshot Jendela Package Manager Unity dengan item dropdown "Dalam Project"

  3. Ketikkan com.google di kotak penelusuran untuk memfilter paket Google.

    Screenshot Jendela Unity Package Manager dengan "com.google" di kotak penelusuran dengan panel kiri yang hanya berisi Paket Goaogle

  4. Klik setiap nama paket, lalu klik Remove.

manifes.json

  1. Gunakan editor teks untuk membuka Packages/manifest.json pada folder project Unity Anda.
  2. Periksa apakah ada paket dari Google di bawah "dependensi". Nama paket harus diawali dengan "com.google", misalnya "com.google.firebase.app".
  3. Hapus baris tersebut, lalu simpan file json.
  4. Saat kembali fokus, Unity akan memuat ulang file manifest.json dan menghapus paket yang dihapus.

Setelah meng-uninstal paket tersebut dari Unity Package Manager, Anda dapat mendownload dan mengimpor file .unitypackage pengganti dari halaman arsip.

Melakukan migrasi dari paket Asset ke paket UPM

Dalam beberapa kasus, Anda dapat beralih dari menginstal produk di bawah hierarki Aset ke menginstal dan melacak produk dengan Unity Package Manager.

Jika tidak yakin metode penginstalan mana yang Anda gunakan, di UI Unity, periksa apakah paket Google yang diinginkan muncul di tab Project, di bagian Asset.

Untuk bermigrasi ke paket UPM:

  1. Pastikan semua paket Google dihapus dari folder Aset.

    • Untuk meng-uninstal paket Firebase, ikuti petunjuk ini.
    • Untuk meng-uninstal Plugin Play untuk Unity, hapus folder GooglePlayPlugins di bagian Assets.
  2. Instal paket menggunakan Unity Package Manager, seperti yang dijelaskan di atas.

Petunjuk Migrasi untuk Produk Tertentu

Lihat di sini untuk mengetahui petunjuk Firebase.