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'daki veya Google Play Store'deki sürümlere göz atın.

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 bir sürümü yükleyin. Unity 2020 desteği kullanımdan kaldırılmıştır ve bir sonraki büyük sürümden sonra etkin olarak desteklenmeyecektir. Önceki sürümler de uyumlu olabilir ancak etkin olarak desteklenmezler.

  • (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 simülasyon aracı kullanın.

    • 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. Kurulum iş akışını başlatmak için projeye genel bakış sayfasının ortasından Unity simgesini () tıklayın.

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

  3. Unity projenizin hangi derleme hedefini kaydetmek istediğinizi seçin veya dilerseniz her iki hedefi de hemen aynı anda kaydetmeyi seçebilirsiniz.

  4. Unity projenizin platforma özgü kimliklerini girin.

    • iOS için: iOS paketi kimliği alanına Unity projenizin iOS kimliğini girin.

    • Android için: Android paket adı alanına Unity projenizin Android kimliğini girin.
      Paket adı ve uygulama kimliği terimleri genellikle birbirinin yerine kullanılır.

  5. (İsteğe bağlı) Unity projenizin platforma özel 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. Firebase konsolu kurulum iş akışında platforma özel Firebase yapılandırma dosyalarınızı edinin.

    • 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 Öğeler > Paket İçe Aktar > Özel Paket'e gidin.

  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 etkin değil

    Uygulamanızda kullanmak istediğiniz Firebase ürünlerinin paketlerini ekleyin. Örneğin, Firebase Authentication ve Firebase Realtime Database'u 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ındaki bazı ürünler Google Play services gerektirir. Bu bağımlılığa sahip ürünleri öğrenin. Bu ürünlerin kullanılabilmesi için Google Play services güncel olmalıdır.

Uygulamanızın başına aşağıdaki using ifadesini ve ilk kullanıma hazırlama kodunu ekleyin. SDK'daki diğer yöntemleri çağırmadan önce Google Play services sürümünü kontrol edebilir ve isteğe bağlı olarak gerekli 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 kaydedilmiş ve yapılandırılmış olmalıdır.

Kurulum sırasında sorun yaşıyorsanız Unity sorun giderme ve SSS sayfasını ziyaret edin.

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

Oyun oluştururken oyununuzu önce Unity düzenleyicisinde ve masaüstü platformlarda test etmek, ardından geliştirmenin ilerleyen aşamalarında mobil cihazlarda dağıtıp test etmek genellikle çok daha kolaydır. 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. Mobil platform için geçerli olan talimatları uygulayarak masaüstü platformu Unity projesi oluşturun (yukarıdaki Uygulamanızı Firebase'e kaydetme adımından başlayın).

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

  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ılabilir. Bu sayede, düzenleyici eklentilerinde kullanılabilir.

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

    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ında seçenek çatışması yaşanmasını ö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ı, Apple ve Android'de aşağıdaki Firebase ürünlerini destekler:

Firebase ürünü Unity paketi
AdMob AdMob Unity eklentisinde ayrı olarak dağıtılır.
Firebase AI Logic FirebaseAI.unitypackage
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
(önerilen) FirebaseAnalytics.unitypackage
Dynamic Links FirebaseDynamicLinks.unitypackage
(önerilen) FirebaseAnalytics.unitypackage
Realtime Database FirebaseDatabase.unitypackage
Remote Config FirebaseRemoteConfig.unitypackage
(önerilen) FirebaseAnalytics.unitypackage

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

Firebase Unity SDK'sı, bir ürün alt kümesi için masaüstü iş akışı desteği içerir. Bu sayede Firebase'in belirli bölümleri Unity düzenleyicisinde ve Windows, macOS ve Linux'daki bağımsız masaüstü sürümlerinde kullanılabilir.

Firebase ürünü (masaüstü) Unity paketi
Firebase AI Logic FirebaseAI.unitypackage
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ü sürümünü hedeflemek için kodu koşullu olarak derlemeniz gerekmez.

Sonraki adımlar