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 adında ö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'daki sürümlere göz atın.

MechaHamster (GitHub)

MechaHamster (App Store)

MechaHamster (Play Store)

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

Firebase'i Unity projenize zaten eklediniz mi? 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. Önceki sürümler de uyumlu olabilir ancak etkin bir şekilde desteklenmez.

• (Yalnızca Apple platformları) Şunları yükleyin:

  • Xcode 26.2 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 15 veya sonraki sürümleri hedefler.
  • tvOS için: tvOS 15 veya sonraki sürümleri hedefler.
  • Android için: API düzeyi 24 (Nougat) veya sonraki sürümleri hedeflemelidir.

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

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

    Cloud Messaging kullanmak istiyor musunuz?

    iOS veya tvOS'te Cloud Messaging için ön koşullar şunlardır:

    • Fiziksel cihaz kurun.
    • Apple Geliştirici hesabınız için bir Apple Push Bildirimi Kimlik Doğrulama Anahtarı alın.
    • XCode'da App > Capabilities (Uygulama > Özellikler) bölümünde Push Bildirimleri'ni etkinleştirin.

  • Android için: Emülatörler, Google Play'de bir emülatör görüntüsü 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 ekleyebilmek için Unity projenize bağlanacak bir Firebase projesi oluşturmanız gerekir. Firebase projeleri hakkında daha fazla bilgi edinmek için Firebase Projelerini Anlama sayfasını ziyaret edin.

2. adım: Uygulamanızı Firebase'e kaydetme

Firebase projenize bağlamak 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ından Unity simgesini (plat_unity) 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 kaydetmek istediğiniz derleme hedefini seçin. İsterseniz her iki hedefi de aynı anda kaydetmeyi seçebilirsiniz.

4. Unity projenizin platforma özel kimliklerini 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.

   Unity projenizin kimliğini nerede bulabilirsiniz?

   Unity projenizi Unity IDE'nizde açın, ardından her platformun ayarlar bölümüne gidin:

   • iOS için: Build Settings > iOS'e gidin.

   • Android için: Android > Player Settings (Oynatıcı Ayarları) > Other Settings (Diğer Ayarlar) bölümüne gidin.

   Unity projenizin kimliği, Paket Kimliği değeridir (örnek kimlik: com.yourcompany.yourproject).

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österilir.

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

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

1. Firebase konsolu kurulum iş akışında platformunuza özel Firebase yapılandırma dosyalarını alın.

   • 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.

   Bu yapılandırma dosyası hakkında bilmeniz gerekenler nelerdir?

   • Firebase yapılandırma dosyasında projenize ve uygulamanıza özgü, gizli olmayan tanımlayıcılar bulunur. Bu yapılandırma dosyası hakkında daha fazla bilgi edinmek için Firebase Projelerini Anlama başlıklı makaleyi inceleyin.

   • Firebase yapılandırma dosyanızı dilediğiniz zaman tekrar indirebilirsiniz.

   • Yapılandırma dosyanıza fazladan karakter (ör. (2)) eklenmediğinden emin olun.

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

3. Firebase konsoluna geri dönüp kurulum iş akışında İleri'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 yere açın.

   • Firebase Unity SDK'sını dilediğiniz zaman tekrar indirebilirsiniz.

   • Firebase Unity SDK'sı platforma özgü değildir.

2. Açık Unity projenizde Assets (Öğeler) > Import Package (Paketi İçe Aktar) > Custom Package'a (Özel Paket) gidin.

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

   Analytics etkinleştirildi

   • 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 ürünlerini 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 ürünlerini kullanmak için:
   FirebaseAuth.unitypackage ve FirebaseDatabase.unitypackage

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

5. Firebase konsoluna geri dönüp kurulum iş akışında İleri'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. Hangi ürünlerin bu bağımlılığa sahip olduğunu öğ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 başlatma 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.
  }
});

Hazırsınız. Unity projeniz Firebase'i kullanacak şekilde kaydedilmiş ve yapılandırılmış olmalıdır.

Ancak kurulumda sorun yaşıyorsanız Unity sorun giderme ve SSS sayfasını ziyaret edin.

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

Oyun oluştururken genellikle oyununuzu önce Unity düzenleyicisinde ve masaüstü platformlarda test etmek, ardından geliştirme sürecinin ilerleyen aşamalarında mobil cihazlara dağıtıp test etmek ç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ştururken 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çenek çakışmasını önlemek için önemlidir.

Desteklenen Firebase ürünleri

Unity Firebase kitaplıkları hakkında daha fazla bilgiyi referans dokümanlarında bulabilirsiniz.

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

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

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

Firebase Unity SDK'sı, ürünlerin bir 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'taki bağımsız masaüstü derlemelerinde kullanılabilir.

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

Sonraki adımlar

• Örnek Firebase uygulamalarını inceleyin.

• Uygulamanızı kullanıma sunmaya hazırlanma:

  • Google Cloud konsolunda projeniz için bütçe uyarıları ayarlayın.
  • Projenizin birden fazla Firebase hizmetindeki kullanımına dair genel bir fikir edinmek için Firebase konsolundaki Kullanım ve faturalandırma kontrol panelini izleyin.
  • Firebase lansman yapılacaklar listesini inceleyin.

• Firebase ve Unity projenizle ilgili sorun mu yaşıyorsunuz? Unity sorun giderme ve SSS sayfasını ziyaret edin.