Catch up on highlights from Firebase at Google I/O 2023. Learn more

Unity projenize Firebase ekleyin

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

Firebase'i Unity projenize bağlamanın ne kadar kolay olduğunu göstermek için GitHub , App Store ve Google Play Store'dan indirebileceğiniz MechaHamster adlı örnek bir oyun yaptık.

MechaHamster (GitHub)

MechaHamster (Uygulama Mağazası)

MechaHamster (Play Store)


Firebase oyunları sayfamızda oyunlarınızı Firebase ile güçlendirme hakkında daha fazla bilgi edinin.

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

Önkoşullar

  • Unity 2019.1 veya üstünü yükleyin. Önceki sürümler de uyumlu olabilir ancak aktif olarak desteklenmeyecektir. Unity 2019.1 desteği kullanımdan kaldırılmıştır ve bir sonraki büyük sürümden sonra artık aktif olarak desteklenmeyecektir.

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

    • Xcode 13.3.1 veya üstü
    • CocoaPods 1.10.0 veya üstü

  • Unity projenizin şu gereksinimleri karşıladığından emin olun:

    • iOS için — iOS 11 veya üstünü hedefler
    • tvOS için - tvOS 12 veya üstünü hedefler
    • Android için — API düzeyi 19 (KitKat) veya üstünü hedefler

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

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

    • Android için — Öykünücüler, Google Play ile birlikte bir öykünücü görüntüsü kullanmalıdır.

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

Adım 1 : Bir Firebase projesi oluşturun

Unity projenize Firebase ekleyebilmeniz için Unity projenize bağlanmak üzere bir Firebase projesi oluşturmanız gerekir. Firebase projeleri hakkında daha fazla bilgi edinmek için Firebase Projelerini Anlayın sayfasını ziyaret edin.

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

Firebase projenizle bağlantı kurmak için 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ındaki Unity simgesine ( ) tıklayın.

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

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

  4. Unity projenizin platforma özgü kimlik(ler)ini girin.

    • iOS için — Unity projenizin iOS kimliğini iOS paket kimliği alanına girin.

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

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

  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 özgü Firebase yapılandırma dosyalarınızı edinin.

    • iOS için — GoogleService-Info.plist'i İndir'i tıklayın.

    • Android için — google-services.json'u İndir'i tıklayın.

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

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

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

  1. Firebase konsolunda, Firebase Unity SDK'yı İndir'i tıklayın, ardından SDK'yı uygun bir yere sıkıştırın.

    • Firebase Unity SDK'yı istediğiniz zaman tekrar indirebilirsiniz.

    • Firebase Unity SDK, platforma özgü değildir.

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

  3. Sıkıştırılmış SDK'dan, uygulamanızda kullanmak istediğiniz desteklenen Firebase ürünlerini seçin.

    Analitik etkinleştirildi

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

    Analitik etkin değil

    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. Unity Paketini İçe Aktar penceresinde, İçe Aktar seçeneğine tıklayın.

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

5. Adım : Google Play hizmetlerinin sürüm gereksinimlerini onaylayın

Android için Firebase Unity SDK, SDK'nın kullanılabilmesi için önce güncel olması gereken Google Play hizmetlerini gerektirir.

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'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 kaydedildi ve Firebase'i kullanacak şekilde yapılandırıldı.

Kurulumda sorun yaşıyorsanız, Unity sorun giderme ve SSS sayfasını ziyaret edin.

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

Bir oyun oluştururken, oyununuzu önce Unity editöründe ve masaüstü platformlarında test etmek, ardından geliştirme aşamasında daha sonra mobil cihazlarda dağıtmak ve test etmek genellikle çok daha kolaydır. Bu iş akışını desteklemek için Windows, macOS, Linux üzerinde ve Unity düzenleyici içinden çalışabilen Firebase Unity SDK'lerinin bir alt kümesini sağlıyoruz.

  1. Bir mobil platformla aynı talimatları izleyerek bir masaüstü platformu Unity projesi kurun (yukarıdaki Uygulamanızı Firebase'e kaydedin adımıyla başlayın).

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

  3. (İsteğe bağlı) Unity projenizi Düzenleme Modunda ç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. 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ına benzersiz bir ad verin.

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

Desteklenen Firebase ürünleri

Referans belgelerde Unity Firebase kitaplıkları hakkında daha fazla bilgi edinin.

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

Firebase Unity SDK, Apple ve Android'de aşağıdaki Firebase ürünlerini destekler:

Firebase ürünü birlik paketi
adMob AdMob Unity Plugin'de ayrı olarak dağıtılır
Analitik FirebaseAnalytics.unitypackage
Uygulama Kontrolü FirebaseAppCheck.unitypackage
kimlik doğrulama FirebaseAuth.unitypackage
Bulut Firestore 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

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

Firebase Unity SDK, bir ürün alt kümesi için masaüstü iş akışı desteği içerir ve Firebase'in belirli bölümlerinin Unity düzenleyicide ve Windows, macOS ve Linux'ta bağımsız masaüstü yapılarında kullanılmasını sağlar.

Firebase ürünü (masaüstü) birlik paketi
Uygulama Kontrolü FirebaseAppCheck.unitypackage
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 derleme yaparken 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