Firebase'i Unity projenize ekleyin

Firebase Unity SDK'larımızla Unity oyunlarınızı güçlendirin.

Firebase'i Unity projenize eklemenin ne kadar kolay olduğunu göstermek için MechaHamster adlı örnek bir oyun hazırladık. Firebase'i bir oyuna eklemeyi denemek istiyorsanız GitHub'daki başlangıç sürümünü kullanın. Tamamlanmış bir sürüm istiyorsanız App Store veya Google Play Store üzerinden indirebilirsiniz.

MechaHamster (GitHub)

MechaHamster (App Store)

MechaHamster (Play Store)


Oyunlarınızı Firebase ile güçlendirme hakkında daha fazla bilgi edinmek için Firebase oyunlar sayfamızı ziyaret edin.

Firebase Unity SDK'sının hangi Firebase ürünlerini desteklediğini

Firebase'i Unity projenize zaten eklediyseniz? Firebase Unity SDK'sının en yeni sürümünü kullandığınızdan emin olun.

Ön koşullar

  • Unity 2021 LTS veya sonraki sürümleri yükleyin. Unity 2020 desteği dikkate alınır desteği sonlandırılmıştır ve sonraki önemli aşamalardan sonra kullanabilirsiniz. Önceki sürümler de uyumlu olabilir ancak etkin bir şekilde çalışmayacaktır desteklenir.

  • (Yalnızca Apple platformları) Aşağıdakileri yükleyin:

    • Xcode 13.3.1 veya sonraki sürümler
    • CocoaPods 1.12.0 veya sonraki sürümler

  • Unity projenizin aşağıdaki koşulları karşıladığından emin olun:

    • iOS için — iOS 13 veya sonraki sürümleri hedefler
    • tvOS için: tvOS 13 veya sonraki sürümleri hedefler.
    • Android için: API düzeyi 21'i (Lollipop) veya üstünü hedefler.

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

    • Apple platformları için: Fiziksel bir cihaz kurun veya iOS ya da tvOS kullanın. simülatörüdür.

    • Android için: Emülatörler, Google Play ile bir emülatör resmi kullanmalıdır.

Unity projeniz yoksa ve yalnızca bir Firebase ürününü denemek istiyorsanız hızlı başlangıç örneklerimizden birini indirebilirsiniz.

1. adım: Firebase projesi oluşturun

Firebase'i Unity projenize eklemeden önce, Unity projenize bağlanacak bir Firebase projesi oluşturmanız gerekir. Firebase projeleri hakkında daha fazla bilgi edinmek için Firebase Projelerini Anlama başlıklı makaleyi inceleyin.

2. Adım: Uygulamanızı Firebase'e kaydedin

Firebase projenize bağlanacak bir veya daha fazla uygulama ya da oyun kaydedebilirsiniz.

  1. Firebase konsoluna gidin.

  2. Projeye genel bakış sayfasının ortasındaki Unity simgesini tıklayın () kurulum iş akışını başlatın.

    Firebase projenize daha önce bir uygulama eklediyseniz platform seçeneklerini görüntülemek için Uygulama ekle'yi tıklayın.

  3. Kaydetmek istediğiniz Unity projenizin derleme hedefini seçin, ya da her iki hedefi aynı anda kaydetmeyi seçebilirsiniz.

  4. Unity projenizin platforma özgü kimliklerini girin.

    • iOS için: Unity projenizin iOS kimliğini iOS paketi Kimlik girin.

    • Android için: Unity projenizin Android kimliğini Android paketi name alanında oturum açın.
      . Paket adı ve uygulama kimliği terimleri genellikle kullanabilirsiniz.

  5. (İsteğe bağlı) Unity projenizin platforma özgü takma adlarını girin.
    Bu takma adlar, dahili ve kolaylık sağlayan tanımlayıcılardır ve yalnızca Firebase konsolunda size görünür.

  6. Uygulamayı kaydet'i tıklayın.

3. Adım: Firebase yapılandırma dosyalarını ekleyin

  1. Platforma özel Firebase yapılandırma dosyalarınızı Firebase konsol kurulumu iş akışı.

    • iOS için: GoogleService-Info.plist dosyasını indir'i tıklayın.

    • Android için: google-services.json dosyasını indir'i tıklayın.

  2. Unity projenizin Proje penceresini açıp yapılandırma dosyalarınızı Assets klasörüne taşıyın.

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

4. Adım: Firebase Unity SDK'larını ekleyin

  1. Firebase konsolunda Firebase Unity SDK'sını indir'i tıklayın, ardından SDK'yı uygun bir yerde açın.

  2. Açık Unity projenizde şuraya gidin: Öğeler > Paketi İçe Aktar > Özel Paket.

  3. Arşivden çıkarılan SDK'dan, uygulamanızda kullanmak istediğiniz desteklenen Firebase ürünlerini seçin.

    Analytics etkin

    • Google Analytics için Firebase paketini 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ünlerinin paketlerini ekleyin. Örneğin, Firebase Authentication ve Firebase Realtime Database özelliklerini kullanmak için:
    FirebaseAuth.unitypackage ve FirebaseDatabase.unitypackage

  4. Unity Paketini İçe Aktar penceresinde İçe Aktar'ı tıklayın.

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

5. adım: Google Play Hizmetleri sürüm şartlarını onaylayın

Android için Firebase Unity SDK'sı, Google Play services'ı gerektirir. SDK'nın kullanılabilmesi için bu sürümün güncel olması gerekir.

Aşağıdaki using ifadesini ve başlatma kodunu kabul edersiniz. SDK'daki diğer yöntemleri çağırmadan önce Google Play services sürümünü kontrol edebilir ve isteğe bağlı olarak Firebase Unity SDK'sı tarafından gereken sürüme güncelleyebilirsiniz.

using Firebase.Extensions;

Firebase.FirebaseApp.CheckAndFixDependenciesAsync().ContinueWithOnMainThread(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.
  }
});

Artık hazırsınız. Unity projeniz Firebase'i kullanacak şekilde kaydedildi ve yapılandırıldı.

Ancak kurulum konusunda sorun yaşıyorsanız şu sayfayı ziyaret edin: Unity sorunlarını giderme ve SSS.

Masaüstü iş akışı oluşturma (beta)

Bir oyun oluştururken, oyununuzu uygulama içinde test etmek çoğu zaman Önce Unity Editor ve masaüstü platformlarında, ardından mobil cihazlarda dağıtıp test edin geliştirmede kullanılabilir. Bu iş akışını desteklemek için Windows, macOS, Linux ve Unity düzenleyicisinde çalışabilen Firebase Unity SDK'larının bir alt kümesini sunuyoruz.

  1. Aşağıdaki talimatları uygulayarak bir masaüstü platformu Unity projesi oluşturun: ( Uygulamanızı Firebase'e kaydedin adımına bakın).

  2. Unity projenizi Unity IDE'de çalıştırın veya Unity'nizi derlemek için seçin masaüstü projesidir.

  3. (İsteğe bağlı) Unity projenizi Düzenleme Modu'nda çalıştırın.

    Firebase Unity SDK'sı, Unity'nin düzenleme modunda da çalıştırılarak düzenleyici eklentilerinde kullanılabilir.

    1. Düzenleyici tarafından kullanılan bir FirebaseApp oluşturduğunuzda, varsayılan örneğidir.

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

      Bu, Unity IDE tarafından kullanılan örnekle Unity projeniz tarafından kullanılan örnek arasındaki seçeneklerde çakışmayı önlemek için önemlidir.

Desteklenen Firebase ürünleri

Unity Firebase kitaplıkları hakkında daha fazla bilgi edinmek için referans dokümanlarını inceleyin.

Mobil cihazlar için kullanılabilen Firebase kitaplıkları

Firebase Unity SDK'sı şu Firebase ürünlerini destekler: Apple ve Android:

Firebase ürünü Unity paketi
AdMob AdMob Unity Eklentisi'nde ayrı olarak dağıtılır.
Analytics FirebaseAnalytics.unitypackage
App Check FirebaseAppCheck.unitypackage
Authentication FirebaseAuth.unitypackage
Cloud Firestore FirebaseFirestore.unitypackage
Cloud Functions FirebaseFunctions.unitypackage
Cloud Messaging FirebaseMessaging.unitypackage
(önerilen) FirebaseAnalytics.unitypackage
Cloud Storage FirebaseStorage.unitypackage
Crashlytics FirebaseCrashlytics.unitypackage
(önerilir) FirebaseAnalytics.unitypackage
Dynamic Links FirebaseDynamicLinks.unitypackage
(önerilir) FirebaseAnalytics.unitypackage
Realtime Database FirebaseDatabase.unitypackage
Remote Config FirebaseRemoteConfig.unitypackage
(önerilen) FirebaseAnalytics.unitypackage

Masaüstü için kullanılabilir Firebase kitaplıkları

Firebase Unity SDK'sı masaüstü iş akışı desteği içeriyor kullanarak Firebase'in belirli kısımlarının Unity düzenleyici ve Windows, macOS ve Linux'taki bağımsız masaüstü derlemelerinde.

Firebase ürünü (masaüstü) Unity paketi
App Check FirebaseAppCheck.unitypackage
Authentication FirebaseAuth.unitypackage
Cloud Functions FirebaseFunctions.unitypackage
Cloud Firestore FirebaseFirestore.unitypackage
Cloud Storage FirebaseStorage.unitypackage
Realtime Database FirebaseDatabase.unitypackage
Remote Config FirebaseRemoteConfig.unitypackage

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

Sonraki adımlar