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 mencakup paket dependen.
  • Paket Pengelola Paket Unity (UPM):
    • Memiliki ekstensi .tgz.
    • Instal ke direktori Packages project Anda.
    • Dapat diimpor di Unity 2018.4 dan yang lebih baru.
    • Mereferensikan paket dependen yang perlu diinstal secara terpisah.

Halaman Paket berisi file .unitypackage terbaru untuk semua paket yang tersedia, dan file .tgz untuk beberapa paket.

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

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

Setelah Anda terbiasa dengan opsi instalasi ini, pastikan untuk merujuk ke petunjuk khusus produk tambahan untuk Firebase.

Mengimpor paket Asset dengan .unitypackage file

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

Mengimpor paket UPM dengan file .tgz (2018.4+)

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

manifest.json

  1. Buat folder baru di samping folder Packages project Anda dan beri nama GooglePackages.
  2. Tempatkan file .tgz ke dalam folder tersebut.
  3. Menggunakan editor teks untuk membuka Packages/manifest.json di project Unity Anda folder tersebut.
  4. Tambahkan entri untuk setiap paket yang ingin Anda instal, dengan memetakan nama paket ke lokasi pada disk, relatif terhadap file Packages/manifest.json. Pastikan untuk menambahkan file: ke jalur file .tgz. Sebagai misalnya, jika Anda menginstal com.google.firebase.storage dan dependensi, manifest.json Anda 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. Setelah kembali fokus, Unity akan memuat ulang manifest.json dan mengimpor paket yang baru ditambahkan.

Beberapa versi lama Unity tidak mendukung file .tgz dalam 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, sebagai gantinya dari file .tgz, seperti berikut:

    {
      "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 Pengelola Paket

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

    Screenshot Jendela Unity Package Manager dengan

  3. Pilih tarball yang diinginkan di file browser.

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

  1. Buka kompresi file .tgz.
  2. Klik ikon + di sudut kiri atas Pengelola Paket dan pilih Add package from disk untuk membuka browser file.

    Screenshot Jendela Unity Package Manager dengan

  3. Pilih folder yang diekstrak di browser file.

Pastikan Anda juga mengimpor file .tgz untuk dependensi paket. yang dapat Anda temukan tercantum di halaman arsip di bawah bagian paket yang diinginkan.

Misalnya, jika Anda menginstal com.google.firebase.storage, Anda akan instal file .tgz ini dengan 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. Penyimpanan Firebase (com.google.firebase.storage)

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

Kontrol versi

Jika Anda menggunakan perangkat lunak kontrol versi untuk mengelola file proyek Anda, kami sebaiknya tambahkan file .tgz yang relevan ke kontrol versi. Anda dapat secara manual edit manifest.json project Anda (lihat di atas petunjuk) dan referensikan file .tgz lokal menggunakan jalur relatif.

Jika Anda menggunakan git, sebaiknya Penyimpanan File Besar Git (LFS) untuk mengelola file .tgz berukuran besar.

Bermigrasi dari paket UPM ke paket Asset

Dalam beberapa kasus, Anda mungkin ingin beralih dari menggunakan Pengelola Paket Unity untuk mengelola paket Google, hingga menginstal paket di bawah folder {i>Assets<i}.

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

UI Pengelola Paket

  1. Buka jendela Package Manager Unity.
  2. Pilih In Project dari menu dropdown di kiri atas.

    Screenshot Jendela Unity Package Manager dengan

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

    Screenshot Jendela Unity Package Manager dengan

  4. Klik setiap nama paket lalu klik Remove.

manifest.json

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

Setelah Anda meng-uninstal paket-paket tersebut dari {i>Unity Package Manager<i}, Anda dapat download dan impor file .unitypackage pengganti dari arsip halaman.

Bermigrasi dari paket Asset ke paket UPM

Dalam beberapa kasus, Anda mungkin ingin beralih dari menginstal produk di Hierarki aset untuk menginstal dan melacak produk dengan Unity Package Manager.

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

Untuk bermigrasi ke paket UPM:

  1. Pastikan semua paket Google dihapus dari folder Assets.

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

Petunjuk Migrasi khusus produk

Lihat di sini untuk mengetahui petunjuk Firebase.