Unity için Google paketlerini yükleme

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

• Öğe paketleri:
  • .unitypackage uzantısı kullanın.
  • Projenizin Assets dizinine yükleyin.
  • Unity 5 ve sonraki sürümlerde içe aktarılabilir.
  • Genellikle bağımlı paketleri içerir.
• Unity Package Manager (UPM) paketleri:
  • .tgz uzantısı kullanın.
  • Projenizin Packages dizinine yükleyin.
  • Unity 2018.4 ve sonraki sürümlerde içe aktarılabilir.
  • Ayrı olarak yüklenmesi gereken referans bağımlı paketler.

Paketler sayfasında, tüm kullanılabilir paketler için en son .unitypackage dosyaları ve bazı paketler için .tgz dosyaları bulunur.

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

Aşağıda, her iki paket türünü de yükleme talimatlarının yanı sıra bir türden diğerine geçiş yapmayla ilgili taşıma talimatlarını bulabilirsiniz.

Bu yükleme seçeneklerini öğrendikten sonra Firebase ile ilgili ek ürüne özel talimatlara göz atmayı unutmayın.

OpenUPM kullanarak paketleri içe aktarma

OpenUPM kayıt defterini kullanarak Unity projenize harici paketler ekleyebilirsiniz. OpenUPM, uygulamanızı sahtekarlığa ve kötüye kullanıma karşı korumaya yardımcı olan Google Play Integrity eklentisi gibi birçok faydalı eklenti ve SDK'ya ev sahipliği yapar.

Örneğin, OpenUPM'yi kullanarak Google Play Integrity eklentisini nasıl ekleyeceğiniz aşağıda açıklanmıştır.

OpenUPM-CLI

OpenUPM CLI yüklüyse OpenUPM kayıt defterini aşağıdaki komutla yükleyebilirsiniz:

openupm add com.google.play.integrity

OpenUPM

1. Paket yöneticisi ayarlarını açmak için Unity menü seçeneği olan Edit > Project Settings > Package Manager'ı (Düzenle > Proje Ayarları > Paket Yöneticisi) seçin.

2. OpenUPM'yi Paket Yöneticisi penceresine kapsamlı kayıt defteri olarak ekleyin:

   Name: package.openupm.com
   URL: https://package.openupm.com
   Scopes: com.google.external-dependency-manager
    com.google.play.common
    com.google.play.core
    com.google.play.integrity
   

3. Unity menü seçeneği Window > Package Manager'ı belirleyerek paket yöneticisi menüsünü açın.

4. Yönetici kapsamı açılır listesini Kayıtlarım'ı seçecek şekilde ayarlayın.

   

5. Paket listesinden Unity için Google Play Integrity eklentisi paketini seçin ve Yükle'ye basın.

.unitypackage dosyaları içeren öğe paketlerini içe aktarma

.unitypackage dosyasını içe aktarmak için Unity menü seçeneğini belirleyin Assets > Import package > Custom Package ve tüm öğeleri içe aktarın. Bu işlem, paket içeriğini Assets dizini altındaki projenize ekler.

Not: Paketi Unity'nin Package Manager penceresini kullanarak yüklediyseniz yeni sürümü içe aktarmadan önce paketin eski sürümünü kaldırın. Talimatlar için aşağıdaki bölüme bakın.

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

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

manifest.json

1. Projenizin Packages klasörünün yanında yeni bir klasör oluşturun ve bu klasörü GooglePackages olarak adlandırın.
2. .tgz dosyalarını bu klasöre yerleştirin.
3. Unity projenizdeki Packages/manifest.json dosyasını açmak için bir metin düzenleyici kullanın.

4. Yüklemek istediğiniz her paket için bir giriş ekleyin. Paket adını, Packages/manifest.json dosyasına göre diskteki konumla eşleyin. file: dosya yoluna .tgz 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 odaklandığı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 şunları yapmalısınız:

1. .tgz dosyalarının sıkıştırmasını açın.
2. Ayıklanan klasörü GooglePackages klasörüne yerleştirin.

3. manifest.json dosyanızı, .tgz dosyası yerine çıkarılan klasörün yolunu kullanacak şekilde düzenleyin:

   {
     "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 simgesini seçin.

   

3. Dosya tarayıcıda istediğiniz tarball'ı seçin.

Unity'nin bazı eski sürümlerinde tarball'ların doğrudan eklenmesi desteklenmez. Bu durumda yapmanız gerekenler:

1. .tgz dosyasının sıkıştırması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 simgesini seçin.

   

   Not: Unity 2018, + simgesini paket listesi bölmesinin sol alt köşesine yerleştirir.

3. Dosya tarayıcısında çıkarılan klasörü seçin.

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

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

1. Harici Bağımlılık Yöneticisi (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)

Sıra konusunda endişelenmeden tüm .tgz dosyalarını tek seferde eklemek isterseniz manifest.json sekmesindeki talimatları uygulayabilirsiniz.

Not: Paketi .unitypackage dosyasıyla yüklediyseniz yeni bir paket eklemeden önce bu paket sürümünü sildiğinizden emin olun. Talimatlar için aşağıdaki bölüme bakın.

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 dosyasını 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)'ı kullanmanızı öneririz.

UPM paketlerinden öğe paketlerine taşıma

Bazı durumlarda, Google paketlerini yönetmek için Unity Package Manager'ı kullanmaktan, paketleri Assets klasörüne yüklemeye geçmek isteyebilirsiniz.

Aşağıdaki yöntemlerden birini kullanarak tüm Google paketlerinin Unity Package Manager'dan 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 listeden In Project simgesini seçin.

   

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

   

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

manifest.json

1. Unity projenizdeki Packages/manifest.json dosyasını açmak için bir metin düzenleyici kullanın.
2. "dependencies" altında Google'dan herhangi bir 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 yeniden odaklandığında manifest.json dosyasını yeniden yükler ve silinen paketleri kaldırır.

Bu paketlerin Unity Package Manager'dan yüklemesini kaldırdıktan sonra, arşiv sayfasından yedek .unitypackage dosyalarını indirebilir ve içe aktarabilirsiniz.

Öğe paketlerinden UPM paketlerine geçiş

Bazı durumlarda, ürünleri Assets ağacı altında yüklemek yerine Unity Package Manager ile yükleyip izlemek isteyebilirsiniz.

Hangi yükleme yöntemini kullandığınızdan emin değilseniz Unity kullanıcı arayüzünde, Assets bölümündeki Project sekmesinde istediğiniz Google paketinin görünüp görünmediğini kontrol edin.

UPM paketlerine geçmek 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 eklentilerini kaldırmak üzere GooglePlayPlugins klasörünü Assets altında silin.

2. Paketleri Unity Package Manager'ı kullanarak yükleyin. Bu işlem yukarıda açıklanmıştır.

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

Firebase talimatları için burayı inceleyin.