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 olmalıdır.
  • 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ınız olmalıdır.
  • 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 verir.

Paketler sayfasında, mevcut tüm 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şle ilgili taşıma talimatlarını bulabilirsiniz.

Bu yükleme seçeneklerini öğrendikten sonra Firebase ile ilgili ürüne özel ek talimatları inceleyin.

OpenUPM'i kullanarak paketleri içe aktarma

OpenUPM kayıt defteri aracılığıyla Unity projenize harici paketler ekleyebilirsiniz. OpenUPM, uygulamanızı sahtekarlık ve kötüye kullanıma karşı korumaya yardımcı olan Google Play Integrity eklentisi gibi birçok faydalı eklenti ve SDK'yı barındırır.

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 şu komutla yükleyebilirsiniz:

openupm add com.google.play.integrity

OpenUPM

1. Düzenle > Proje Ayarları > Paket Yöneticisi Unity menü seçeneğini belirleyerek paket yöneticisi ayarlarını açın.

2. OpenUPM'yi Paket Yöneticisi penceresine kapsamlı bir 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 Pencere > Paket Yöneticisi'ni seçerek paket yöneticisi menüsünü açın.

4. Yönetici kapsamı açılır menüsünü Kayıt otoritelerim'i 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ıyla öğe paketlerini içe aktarma

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

Not: Paketi Unity'nin Paket Yöneticisi penceresini kullanarak zaten yüklediyseniz yeni sürümü içe aktarmadan önce paketin eski sürümünü kaldırın. Talimatlar için aşağıya bakın.

UPM paketlerini .tgz dosyalarıyla içe aktarma (2018.4 ve sonraki sürümler)

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 adını GooglePackages olarak ayarlayın.
2. .tgz dosyalarını bu klasöre yerleştirin.
3. Unity proje klasörünüzde 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. Bu girişte, paket adını Packages/manifest.json dosyasına göre diskteki konumla eşleyin. .tgz dosya yoluna file: eklediğinizden emin olun. Örneğin, com.google.firebase.storage ve bağımlılarını yüklüyorsanız manifest.json dosyanız şöyle 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 yeniden 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ında .tgz dosyalarını desteklemez. Bu durumda:

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 ayıklanan klasörün yolunu kullanacak şekilde düzenleyin. Ö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ıyı açmak için Add package from tarball'ı seçin.

   

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

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

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ıyı açmak için Add package from disk'ı seçin.

   

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

3. Dosya gezgininde 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ı, arşiv sayfasında istediğiniz paketin bölümünde bulabilirsiniz.

Örneğin, com.google.firebase.storage'ü yüklüyorsanız bu .tgz dosyalarını aşağıdaki 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ırayla ekleme yapmadan tüm .tgz dosyalarını tek seferde eklemek istiyorsanız manifest.json sekmesindeki talimatları uygulayabilirsiniz.

Not: Paketi .unitypackage dosyasıyla zaten yüklediyseniz yeni bir dosya eklemeden önce paketin bu sürümünü sildiğinizden emin olun. Talimatlar için aşağıya bakın.

Sürüm denetimi

Proje dosyalarınızı yönetmek için sürüm kontrol yazılımı kullanıyorsanız ilgili .tgz dosyalarını sürüm kontrolüne eklemenizi öneririz. Projenizin manifest.json dosyasını manuel olarak düzenleyebilir (Yukarıdaki talimatları inceleyin) 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 Büyük Dosya Depolama (LFS)'yı kullanmanızı öneririz.

UPM paketlerinden öğe paketlerine taşıma

Bazı durumlarda, Google paketlerini yönetmek için Unity Paket Yöneticisi'ni kullanmak yerine paketleri Assets klasörüne yüklemeyi tercih edebilirsiniz.

Aşağıdaki yöntemlerden birini kullanarak 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 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 proje klasörünüzde Packages/manifest.json dosyasını açmak için bir metin düzenleyici kullanın.
2. "Dependencies" (Bağımlılar) bölümünde 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 paketleri Unity Package Manager'dan kaldırdıktan sonra arşiv sayfasından değişim amaçlı .unitypackage dosyalarını indirip içe aktarabilirsiniz.

Öğe paketlerinden UPM paketlerine taşıma

Bazı durumlarda, öğeler ağacında ürün yüklemekten Unity Paket Yöneticisi ile ürün yüklemeye ve izlemeye geçmek isteyebilirsiniz.

Hangi yükleme yöntemini kullandığınızdan emin değilseniz Unity kullanıcı arayüzünde, Öğeler'in altındaki Proje sekmesinde istenen Google paketlerinin 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 Eklentileri'ni kaldırmak üzere Assets altındaki GooglePlayPlugins klasörünü silin.

2. Paketleri, yukarıda açıklandığı gibi Unity Paket Yöneticisi'ni kullanarak yükleyin.

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

Firebase talimatları için buraya bakın.