了解 2023 年 Google I/O 大会上介绍的 Firebase 亮点。了解详情

Ek Unity kurulum seçenekleri

Hem .NET 3.X hem de .NET 4.X için tüm .unitypackage dosyalarını içeren büyük bir .zip dosyası indirmek yerine, Google APIs for Unity sitesinden ayrı paketleri indirebilirsiniz.

Site şunları sağlar:

  • Varlık paketleri olarak içe aktarılacak ayrı .NET 4.X .unitypackage dosyaları.
  • Unity Paket Yöneticisi kullanılarak içe aktarılacak bireysel .tgz arşivleri.

Bireysel .unitypackage dosyaları gerekli tüm bağımlılıkları içerdiğinden ve .tgz dosyaları bağlı oldukları ilgili .tgz dosyalarının yanında listelendiğinden, bu özellikle uygulamanız tek bir Firebase ürünü kullandığında kullanışlıdır.

Bu sayfa, Unity Paket Yöneticisi ile ilgili talimatlar sağlar, bu nedenle araç hakkında Unity belgelerinden bilgi almak iyi bir fikirdir.

Firebase paketlerini Öğeler olarak içe aktarın

Unity sitesi için Google API'lerinden indirilen .unitypackage dosyalarından Firebase ürünlerini içe aktarırken aşağıdakileri aklınızda bulundurun:

  • Projenizde birden çok Firebase ürünü kullanıyorsanız, tüm Firebase ürünlerini indirmeli ve aynı sürüme yükseltmelisiniz.

  • İçe aktarma yöntemlerini bir projede karıştırmayın. Diğer bir deyişle, Asset paket akışıyla ve Unity Paket Yöneticisi akışını kullanarak Firebase ürünlerini içe aktarmayın.

İndirdikten sonra içe aktarmak için:

  1. Açık Unity projenizde Assets > Import Package > Custom Package seçeneğine gidin.

  2. Unity Paketini İçe Aktar penceresinde, İçe Aktar seçeneğine tıklayın.

Unity Paket Yöneticisini kullanarak Firebase paketlerini içe aktarın

Unity arşivi için Google API'lerinden indirilen .tgz dosyalarından Firebase ürünlerini içe aktarırken aşağıdakileri aklınızda bulundurun:

  • Bu yöntem yalnızca 2018.3+ sürümünde mevcuttur.

  • Projenizde birden çok Firebase ürünü kullanıyorsanız, tüm Firebase ürünlerini indirmeli ve aynı sürüme yükseltmelisiniz.

  • İçe aktarma yöntemlerini bir projede karıştırmayın. Yani Firebase ürünlerini Asset paket akışı ve Unity Paket Yöneticisi akışıyla içe aktarmayın.

  • Her ürün .tgz dosyası için bağımlılıklar, kendi .tgz dosyalarında yan yana bağlanır. Ürün .tgz dosyasını ve bağımlılık .tgz dosyalarını doğru sırayla indirip içe aktarmalısınız:

    1. Dış Bağımlılık Yöneticisi ( com.google.external-dependency-manager )
    2. Firebase Çekirdeği ( com.google.firebase.app )
    3. Projenizde kullanılan Firebase ürünleri. Gerçek Zamanlı Veritabanı veya Bulut Depolama kullanıyorsanız, önce Kimlik Doğrulamayı ( com.google.firebase.auth ) içe aktarın.

İndirdikten sonra, aşağıdaki yöntemlerden birini kullanarak .tgz dosyalarını projenize aktarın:

Paket Yöneticisi Kullanıcı Arayüzü

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

Unity 2019'un bazı eski sürümleri, doğrudan tarball eklemeyi desteklemez. Bu durumda yapmanız gerekenler:

  1. .tgz dosyasını sıkıştırın.
  2. Paket Yöneticisi penceresinin sol üst köşesindeki + simgesine tıklayın ve dosya tarayıcısını açmak için Add package from disk seçin.
  3. Dosya tarayıcısında ayıklanan klasörü seçin.

manifest.json

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

  4. Paket adını diskteki konumla eşleyerek, içe aktarmak istediğiniz her paket için bir giriş ekleyin. .tgz dosya yoluna file: eklediğinizden emin olun. Örneğin, com.google.firebase.storage ve bağımlılıklarını içe aktarı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ükleyecek ve yeni eklenen paketleri içe aktaracaktır.

Unity'nin bazı eski sürümleri, manifest.json .tgz dosyalarını desteklemez. Bu durumda şunları yapmalısınız:

  1. .tgz dosyasını sıkıştırın.

  2. .tgz dosyası yerine ayıklanan klasörün yolunu kullanmak için manifest.json dosyanızı şu ş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...
  }
}

Unity Paket Yöneticisinden Varlık paketlerine geçiş

Bazı durumlarda, Firebase ürünlerini izlemek için Unity Paket Yöneticisi'ni kullanmaktan, Assets klasörü altındaki ürünleri içe aktarmaya geçmek isteyebilirsiniz.

Hangi içe aktarma yöntemini kullandığınızdan emin değilseniz Unity proje klasörünüzde Packages/manifest.json dosyasını açın. Dosya com.google.firebase ile başlayan girişler içeriyorsa, projeniz içe aktarma için Unity Paket Yöneticisi'ni kullandı.

Varlık paketlerine geçiş yapmak için:

  1. Projenizdeki mevcut Firebase paket sürümlerini not edin ve bunları kaldırın.

    1. Pencere menüsünden Paket Yöneticisi öğesini seçin. Paket Yöneticisi penceresinde "Paketler: Projede" öğesinin seçili olduğundan emin olun.
    2. İçe aktarılan Firebase paketlerinin sürümlerini not edin.
    3. Her paket adına tıklayın, ardından Kaldır'a tıklayın. Dış Bağımlılık Yöneticisi paketini ( .com.google.external-dependency-manager ) ve Firebase paketlerini kaldırdığınızdan emin olun.

  2. Yedek .unitypackage dosyalarını indirin ve içe aktarın. İki seçeneğiniz var:

    • Her paketin en son sürümüne yükseltebiliyorsanız, Firebase Unity SDK zip dosyasını indirin ve Firebase'i Unity projenize ekleme bölümünde açıklandığı şekilde içe aktarın.
    • Geçerli .unitypackage sürümlerini korumanız gerekiyorsa, bu sayfada yukarıda açıklandığı gibi paketleri tek tek indirebilir ve içe aktarabilirsiniz.

Varlık paketlerinden Unity Paket Yöneticisine Geçiş

Bazı durumlarda, Assets klasörü altındaki ürünleri içe aktarmaktan, Unity Paket Yöneticisi ile ürünleri içe aktarmaya ve izlemeye geçmek isteyebilirsiniz.

Hangi içe aktarma yöntemini kullandığınızdan emin değilseniz Unity proje klasörünüzde Packages/manifest.json dosyasını açın. Dosya com.google.firebase ile başlayan girişler içeriyorsa, projeniz zaten içe aktarma için Unity Paket Yöneticisi'ni kullanıyordur.

Unity Paket Yöneticisine geçmek için:

  1. Aşağıdaki yöntemlerden birini kullanarak tüm Firebase paketlerinin ve Dış Bağımlılık Yöneticisi paketinin Assets klasöründen kaldırıldığından emin olun.

    EDM4U kullanıcı arayüzü

    1. Açık Unity projenizde Assets > External Dependency Manager > Version Handler > Uninstall Managed Packages seçeneğine gidin.
    2. Tüm Firebase paketlerini ve Dış Bağımlılık Yöneticisini seçin.
    3. Seçili Paketi Kaldır'ı tıklayın.

    Manuel kaldırma

    Dosya sistemi araçlarını kullanarak aşağıdaki klasörleri manuel olarak silin:

    • Assets/Editor Default Resources/Firebase
    • Assets/ExternalDependencyManager
    • Assets/Firebase
    • Assets/Parse
    • Assets/Plugins/iOS/Firebase

  2. Bu sayfada yukarıda açıklandığı gibi, Unity Paket Yöneticisini kullanarak paketleri içe aktarın.