Unity projenize Firebase ekleyin

Senin kadar Güç Unity bizim Firebase Birlik SDK'larıyla oyunlar.

Sizin Birlik projeye Firebase fiş ne kadar kolay göstermek için, size GitHub, App Store ve Google Play Store'dan indirebileceğiniz, örnek bir oyun, MechaHamster yaptı.

MechaHamster (GitHub)

MechaHamster (App Store)

MechaHamster (Play Store)


Bizim de Firebase ile oyunlarınızı açılıyor ilgili daha fazla bilgi edinin Firebase oyun sayfasından .

Firebase'i Unity projenize zaten eklediniz mi? Eğer en son sürümünü kullandığınızdan emin olun Firebase Birlik SDK .

Önkoşullar

  • Unity 2017.4 veya sonraki sürümünü yükleyin. Daha önceki sürümler de uyumlu olabilir ancak aktif olarak desteklenmeyecektir.

  • (sadece iOS) aşağıdaki yükleyin:

    • Xcode 9.4.1 veya üstü
    • CocoaPods 1.10.0 veya üstü
  • Unity projenizin şu gereksinimleri karşıladığından emin olun:

    • İOS'ta - iOS 10 veya daha yüksek hedefler
    • Hedefler API düzeyinde 16 (Jelly Bean) veya daha yüksek - Android İçin

  • Uygulamanızı çalıştırmak için fiziksel bir cihaz kurun veya bir öykünücü kullanın.

    • IOS için - fiziksel IOS aygıt kurma ya da IOS simülatörü kullanın.

    • Android için - Emulators Google Play ile bir emülatör resim kullanmak gerekir.

Zaten bir Birlik projesi var ve sadece Firebase ürünü denemek istemiyorsanız, bizim birini indirebilirsiniz hızlı başlangıç örneklerinin .

1. Adım: Bir Firebase projesi oluşturma

Unity projenize Firebase eklemeden önce Unity projenize bağlanmak için bir Firebase projesi oluşturmanız gerekir. Ziyaret Firebase Projeleri Anlayın Firebase projeleri hakkında daha fazla bilgi edinmek.

2. Adım: Firebase ile uygulamanızı kaydedin

Firebase projenize bağlanmak için bir veya daha fazla uygulama veya oyun kaydedebilirsiniz.

  1. Git Firebase konsoluna .

  2. Proje genel bakış Sayfanın ortasında, Birlik simgesine (tıklayın kurulum iş akışını başlatmak için).

    Zaten Firebase projeye bir uygulamayı eklediyseniz, platformu seçeneklerini görüntülemek için uygulama ekleme tıklayın.

  3. Unity projenizin hangi yapı hedefini kaydetmek istediğinizi seçin, hatta şimdi her iki hedefi de aynı anda kaydetmeyi seçebilirsiniz.

  4. Unity projenizin platforma özel kimliklerini girin.

    • İOS için - sizin Birlik projenin iOS Kimliği girin iOS paketi kimliği alanına.

    • Android için - sizin Birlik projesinin Android Kimliği girin Android paketi adı alanına.
      Terimleri paket adı ve uygulama kimliği sıklıkla birbirinin yerine kullanılır.

  5. (İsteğe bağlı) Birlik projenin platforma özel takma ad (lar) girin.
    Bu takma adlar dahili, kullanışlı tanımlayıcılardır ve yalnızca Firebase konsolunda siz görebilirsiniz.

  6. Kayıt uygulamasını tıklayın.

3. Adım: Firebase yapılandırma dosyaları ekleme

  1. Firebase konsol kurulum iş akışında platforma özel Firebase yapılandırma dosya(lar)ınızı edinin.

    • İOS'ta - İndir GoogleService-Info.plist'ni tıklayın.

    • Android için - tıklayın indirin google-services.json.

  2. Daha sonra içine yapılandırma dosyasını (lar) hareket ettir, Birlik projesinin Proje penceresini açın Assets klasöründe.

  3. Geri Firebase konsolunda, kurulum iş akışında, İleri'yi tıklayın.

Adım 4: Firebase Birlik SDK'larını ekle

  1. Firebase konsolunda, uygun bir yere SDK unzip sonra, İndir Firebase Birlik SDK tıklayın.

    • Sen indirebilirsiniz Firebase Birlik SDK herhangi bir zamanda tekrar.

    • Firebase Unity SDK, platforma özel değildir.

  2. Aktif gezinme açık Birlik projesi,> İçe Paketi> Özel Paket içinde.

  3. Fermuarını açıp SDK itibaren seçmek desteklenen Firebase ürünleri uygulamanızda kullanmak istediğiniz.

    Analytics etkinleştirildi

    • Google Analytics için Firebase paketi ekleyin: FirebaseAnalytics.unitypackage
    • Uygulamanızda kullanmak istediğiniz diğer Firebase ürünlerinin paketlerini ekleyin. Örneğin, Firebase Authentication ve Firebase Realtime Database'i kullanmak için:
      FirebaseAuth.unitypackage ve FirebaseDatabase.unitypackage

    Analytics etkinleştirilmedi

    Uygulamanızda kullanmak istediğiniz Firebase ürünleri için paketleri ekleyin. Örneğin, Firebase Authentication ve Firebase Realtime Database'i kullanmak için:
    FirebaseAuth.unitypackage ve FirebaseDatabase.unitypackage

  4. İthalat Birlik Paketi penceresinde, Al'ı tıklatın.

  5. Geri Firebase konsolunda, kurulum iş akışında, İleri'yi tıklayın.

5. Adım: Onayla Google Play hizmetleri sürüm gereksinimleri

Android için Firebase Birlik SDK gerektirir Google Play hizmetlerini kadar güncel olmalı SDK kullanılmadan önce.

Uygulamanızın başına aşağıdaki kodu ekleyin. SDK'daki diğer yöntemleri çağırmadan önce Google Play hizmetlerini kontrol edebilir ve isteğe bağlı olarak Firebase Unity SDK'sının gerektirdiği sürüme güncelleyebilirsiniz.

Firebase.FirebaseApp.CheckAndFixDependenciesAsync().ContinueWith(task => {
  var dependencyStatus = task.Result;
  if (dependencyStatus == Firebase.DependencyStatus.Available) {
    // Create and hold a reference to your FirebaseApp,
    // where app is a Firebase.FirebaseApp property of your application class.
       app = Firebase.FirebaseApp.DefaultInstance;

    // Set a flag here to indicate whether Firebase is ready to use by your app.
  } else {
    UnityEngine.Debug.LogError(System.String.Format(
      "Could not resolve all Firebase dependencies: {0}", dependencyStatus));
    // Firebase Unity SDK is not safe to use here.
  }
});

Hazırsınız! Unity projeniz kayıtlı ve Firebase'i kullanacak şekilde yapılandırıldı.

Eğer sorun olsa ayarlamalar yapıyorum yaşıyorsanız, ziyaret Birlik sorun giderme ve SSS .

Bir masaüstü iş akışı (beta) kurma

Bir oyun oluştururken, oyununuzu önce Unity düzenleyicisinde ve masaüstü platformlarında test etmek, ardından daha sonra geliştirme aşamasında mobil cihazlarda dağıtmak ve test etmek genellikle çok daha kolaydır. Bu iş akışını desteklemek için, bir sağlamak Firebase Birlik SDK'larının alt kümesini Windows, MacOS, Linux ve içinden Birlik editörü yayınlanabilir.

  1. Bir mobil platform için aynı yönergeleri izleyerek bir masaüstü platform Birlik projesini kurma (başlayın Kayıt Firebase ile uygulama Yukarıdaki adım).

  2. Birlik IDE'nizde Birlik projesini çalıştırın veya masaüstü için Birlik projesini inşa etmek için seçin.

  3. (İsteğe bağlı) Düzenleme Modunda Birlik projesini çalıştırın.

    Firebase Unity SDK, Unity'nin düzenleme modunda da çalıştırılabilir ve editör eklentilerinde kullanılmasına izin verir.

    1. Bir oluşturduğunuzda FirebaseApp editör tarafından kullanılan varsayılan örneği kullanmayın.

    2. Bunun yerine, benzersiz bir ad FirebaseApp.Create() çağrısı.

      Unity IDE tarafından kullanılan örnek ile Unity projeniz tarafından kullanılan örnek arasındaki seçeneklerde bir çakışmayı önlemek için bu önemlidir.

Desteklenen Firebase ürünleri

Birlik Firebase kütüphaneleri hakkında daha fazla bilgi referans belgeleri .

Firebase Birlik SDK iOS ve Android'de aşağıdaki Firebase ürünleri destekler:

Firebase ürünü birlik paketi
AdMob AdMob Unity Plugin'de ayrı olarak dağıtılır
Analitik FirebaseAnalytics.unitypackage
kimlik doğrulama FirebaseAuth.unitypackage
Bulut Firestore (beta) FirebaseFirestore.unitypackage
Bulut İşlevleri FirebaseFunctions.unitypackage
Bulut Mesajlaşma FirebaseMessaging.unitypackage
(önerilir) FirebaseAnalytics.unitypackage
Bulut depolama FirebaseStorage.unitypackage
Crashlytics FirebaseCrashlytics.unitypackage
(önerilir) FirebaseAnalytics.unitypackage
Dinamik Bağlantılar FirebaseDynamicLinks.unitypackage
(önerilir) FirebaseAnalytics.unitypackage
Gerçek Zamanlı Veritabanı FirebaseDatabase.unitypackage
Uzak Yapılandırma FirebaseRemoteConfig.unitypackage
(önerilir) FirebaseAnalytics.unitypackage

Desteklenen Firebase ürünleri (masaüstü)

Firebase Birlik SDK içerir masaüstü iş akışı desteği Windows, MacOS ve Linux üzerine inşa Birlik editörü ve bağımsız masaüstüne kullanılmak üzere Firebase belirli bölümlerine sağlayan ürünlerin bir alt kümesi için.

Firebase ürünü (masaüstü) birlik paketi
kimlik doğrulama FirebaseAuth.unitypackage
Bulut İşlevleri FirebaseFunctions.unitypackage
Bulut Firestore FirebaseFirestore.unitypackage
Bulut depolama FirebaseStorage.unitypackage
Gerçek Zamanlı Veritabanı FirebaseDatabase.unitypackage
Uzak Yapılandırma FirebaseRemoteConfig.unitypackage

Firebase, Windows, macOS ve Linux için derlerken kolaylık sağlamak için kalan masaüstü kitaplıklarını saplama (işlevsel olmayan) uygulamalar olarak sağlar. Bu nedenle, masaüstünü hedeflemek için koşullu olarak kod derlemeniz gerekmez.

Sonraki adımlar