Unity için Google paketlerini yükleme

Unity için Google paketleri iki farklı biçimde dağıtılır:

  • Öğe paketleri:
    • .unitypackage uzantınız var.
    • Projenizin Assets dizinine yükleyin.
    • Unity 5 ve sonraki sürümlerde içe aktarılabilir.
    • Genellikle bağımlı paketleri içerir.
  • Unity Paket Yöneticisi (UPM) paketleri:
    • .tgz uzantınız var.
    • Projenizin Packages dizinine yükleyin.
    • Unity 2018.4 ve sonraki sürümlerde içe aktarılabilir.
    • Ayrı olarak yüklenmesi gereken bağımlı paketlere referans verin.

Paketler sayfası, kullanılabilir tüm paketler için en son .unitypackage dosyasını içerir.

Arşiv sayfası, tüm paket sürümleri için .unitypackage ve .tgz dosyalarını içerir.

Aşağıda, her iki paket türünü de yüklemeyle ilgili talimatların yanı sıra türe geçişle ilgili taşıma talimatlarını bulabilirsiniz.

Bu yükleme seçenekleri hakkında bilgi edindikten sonra Firebase için ürüne özel ek talimatları incelemeyi unutmayın.

.unitypackage dosya içeren öğe paketleri içe aktarılıyor

Unity menü seçeneğini Assets > Import package > Custom Package seçip tüm öğeleri içe aktararak .unitypackage dosyasını içe aktarın. Bu işlem, paket içeriklerini, Assets dizini altına projenize ekler.

.tgz dosyalı UPM paketlerini içe aktarma (2018.4+)

Aşağıdaki yöntemlerden birini kullanarak .tgz dosyayı projenize aktarın:

manifest.json

  1. Projenizin Packages klasörünün yanında yeni bir klasör oluşturun ve GooglePackages olarak adlandırın.
  2. .tgz dosyayı bu klasöre yerleştirin.
  3. Bir metin düzenleyici kullanarak Unity proje klasörünüzün altında Packages/manifest.json dosyasını açın.
  4. Yüklemek istediğiniz her paket için bir giriş ekleyin ve paket adını Packages/manifest.json dosyasıyla göreli olarak diskteki konumla eşleyin. .tgz dosya yoluna file: eklediğinizden emin olun. Örneğin, com.google.firebase.storage ve bağımlılıklarını yüklüyorsanız manifest.json dosyanız şu şekilde görünür:

    {
      "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. Manifest.json dosyasını kaydedin.

  6. Unity tekrar odaklanmaya başladığında manifest.json dosyasını yeniden yükler ve yeni eklenen paketleri içe aktarır.

Unity'nin bazı eski sürümleri, manifest.json dosyasındaki .tgz dosyalarını desteklemez. Bu durumda:

  1. Sıkıştırılmış .tgz dosyalarını açın.
  2. Çıkarılan klasörü GooglePackages klasörüne yerleştirin.
  3. Manifest.json dosyanızı düzenleyerek, .tgz dosyası yerine ayıklanan klasörün yolunu kullanın. Örneğin:

    {
      "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...
      }
    }
    

Paket Yöneticisi kullanıcı arayüzü

  1. Unity'nin Paket Yöneticisi penceresini açın.
  2. Paket Yöneticisi penceresinin sol üst köşesindeki + simgesini tıklayın ve dosya tarayıcısını açmak için Add package from tarball öğesini seçin.

    ile Unity Package Manager Window'un ekran görüntüsü

  3. Dosya tarayıcısında istediğiniz tarball'u seçin.

Unity'nin bazı eski sürümleri doğrudan tarball eklemeyi desteklemez. Bu durumda şunları yapmanız gerekir:

  1. .tgz dosyasını açın.
  2. Paket Yöneticisi penceresinin sol üst köşesindeki + simgesini tıklayın ve dosya tarayıcısını açmak için Add package from disk öğesini seçin.

    ile Unity Package Manager Window'un ekran görüntüsü

  3. Dosya tarayıcısında ayıklanan klasörü seçin.

Paketin bağımlılıkları için .tgz dosyalarını da içe aktardığınızdan emin olun. Bu dosyaları, istenen paketin bölümünün altındaki arşiv sayfasında bulabilirsiniz.

Örneğin, com.google.firebase.storage uygulamasını yüklüyorsanız bu .tgz dosyasını şu sırayla yüklersiniz:

  1. Dış Bağımlılık Yöneticisi (com.google.external-dependency-manager)
  2. Firebase Core (com.google.firebase.app)
  3. Firebase Kimlik Doğrulaması (com.google.firebase.auth)
  4. Firebase Depolama Alanı (com.google.firebase.storage)

Sırayla ilgili endişe duymadan tüm .tgz dosyalarını tek seferde eklemeyi tercih ederseniz manifest.json sekmesindeki talimatları uygulayabilirsiniz.

Sürüm denetimi

Proje dosyalarınızı yönetmek için sürüm denetimi yazılımı kullanıyorsanız ilgili .tgz dosyalarını sürüm denetimine eklemenizi öneririz. Projenizin manifest.json öğesini manuel olarak düzenleyebilir (yukarıdaki talimatlara bakın) ve göreli yolları kullanarak yerel .tgz dosyalarına referans verebilirsiniz.

Git kullanıyorsanız büyük .tgz dosyalarını yönetmek için Git Large File Storage (LFS).

UPM paketlerinden Öğe paketlerine geçiş

Bazı durumlarda, Google paketlerini yönetmek için Unity Paket Yöneticisi'ni kullanmaktan, Öğeler klasörü altında paket yüklemeye geçiş yapmak isteyebilirsiniz.

Aşağıdaki yöntemlerden biri kullanılarak tüm Google paketlerinin Unity Paket Yöneticisi'nden kaldırıldığından emin olun:

Paket Yöneticisi kullanıcı arayüzü

  1. Unity'nin Paket Yöneticisi penceresini açın.
  2. Sol üstteki açılır menüden In Project'i seçin.

    ile Unity Package Manager Window'un ekran görüntüsü

  3. Google paketlerini filtrelemek için arama çubuğuna com.google yazın.

    Şu özelliklere sahip Unity Package Manager Window'un ekran görüntüsü:

  4. Her bir paket adını, ardından Remove simgesini tıklayın.

manifest.json

  1. Bir metin düzenleyici kullanarak Unity proje klasörünüzün altında Packages/manifest.json dosyasını açın.
  2. Google'dan "bağımlılıklar" altında paket olup olmadığını kontrol edin. Paket adı "com.google" ile başlamalıdır (ör. "com.google.firebase.app").
  3. Bu satırları silin ve json dosyasını kaydedin.
  4. Unity tekrar odaklanmaya başladığında manifest.json dosyasını yeniden yükler ve silinen paketleri kaldırır.

Bu paketleri Unity Paket Yöneticisi'nden kaldırdıktan sonra, yeni .unitypackage dosyalarını arşiv sayfasından indirip içe aktarabilirsiniz.

Öğe paketlerinden UPM paketlerine geçiş

Bazı durumlarda, Öğe ağacı altında ürün yüklemekten Unity Paket Yöneticisi ile ürün yüklemeye ve izlemeye geçiş yapmak isteyebilirsiniz.

Hangi yükleme yöntemini kullandığınızdan emin değilseniz Unity kullanıcı arayüzünde istenen Google paketlerinin Proje sekmesindeki Öğeler bölümünde görünüp görünmediğini kontrol edin.

UPM paketlerine geçiş yapmak için:

  1. Tüm Google paketlerinin Öğeler klasöründen kaldırıldığından emin olun.

    • Firebase paketlerini kaldırmak için bu talimatları uygulayın.
    • Unity için Play Eklentileri'ni kaldırmak istiyorsanız Assets altındaki GooglePlayPlugins klasörünü silin.
  2. Yukarıda açıklandığı gibi, Unity Paket Yöneticisi'ni kullanarak paketleri yükleyin.

Ürüne Özel Taşıma Talimatları

Firebase talimatları için buraya bakın.