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

öğrenin.

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 üstü

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

    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ı edinin.
    • XCode'ta Uygulama > Özellikler bölümünde Push bildirimlerini etkinleştirin.

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

• Google Hesabınızı kullanarak Firebase'de oturum açın.

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.

Firebase projesi oluşturma

1. Firebase konsolunda Proje ekle'yi tıklayın.

   • Mevcut bir Google Cloud projeye Firebase kaynakları eklemek için projenin adını girin veya açılır menüden seçin.

   • Yeni bir proje oluşturmak için bir proje adı girin. İsterseniz proje adının altında görüntülenen proje kimliğini de düzenleyebilirsiniz.

     Firebase, verdiğiniz ada göre Firebase projeniz için benzersiz bir kimlik oluşturur. Firebase projeniz için kaynak ayırdıktan sonra değiştirilemeyeceğinden, bu proje kimliğini düzenlemek istiyorsanız bunu şimdi yapmanız gerekir. Firebase'in proje kimliğini nasıl kullandığı hakkında bilgi edinmek için Firebase Projelerini Anlama başlıklı makaleyi inceleyin.

2. İstenirse Firebase şartlarını inceleyip kabul edin.

3. Devam'ı tıklayın.

4. (İsteğe bağlı) Projeniz için Google Analytics'yi ayarlayın. Bu, aşağıdaki Firebase ürünlerini kullanarak optimum bir deneyim elde etmenizi sağlar: Firebase A/B Testing, Cloud Messaging, Crashlytics, In-App Messaging ve Remote Config (Kişiselleştirme dahil).

   Mevcut bir Google Analytics hesabını seçin veya yeni hesap oluşturun. Yeni bir hesap oluşturursanız Analytics raporlama konumunuzu seçin, ardından projeniz için veri paylaşım ayarlarını ve Google Analytics şartlarını kabul edin.

   Google Analytics'ı daha sonra dilediğiniz zaman Proje ayarlarınızdaki Entegrasyonlar sekmesinden kurabilirsiniz.

5. Proje oluştur'u (veya mevcut bir Google Cloud projesine Firebase ekliyorsanız Firebase ekle'yi) tıklayın.

Firebase, Firebase projeniz için kaynakları otomatik olarak sağlar. İşlem tamamlandığında Firebase konsolunda Firebase projenizin genel bakış sayfasına yönlendirilirsiniz.

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

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

Oyununuzu hem iOS hem de Android'de kullanıma sunuyorsanız Unity projenizin her iki derleme hedefini de aynı Firebase projesiyle kaydedin. Farklı iOS paket kimlikleri veya Android uygulama kimlikleri tanımlanmış birden fazla derleme varyantınız varsa her varyantı aynı Firebase projesine kaydetmeniz gerekir.

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.

   Not: Unity projenizin yalnızca bir derleme hedefini şimdi kaydederseniz daha sonra diğer derleme hedefini kaydetmek için kurulum iş akışına her zaman geri dönebilirsiniz.

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.

   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: Derleme Ayarları > iOS'e gidin.

   • Android için: Android > Oynatıcı Ayarları > Diğer Ayarlar'a gidin.

   Unity projenizin kimliği, paket tanımlayıcısı değeridir (örnek kimlik: com.yourcompany.yourproject).

   Projenizin gerçekten kullandığı kimliği girdiğinizden emin olun. Kimlik değeri büyük/küçük harfe duyarlıdır ve Firebase projenize kaydedilen bu Firebase uygulamaları için değiştirilemez.

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.

   Unity projenizin hem iOS hem de Android derleme hedefini kaydediyorsanız her iki platformun yapılandırma dosyalarını indirip eklemeniz gerekir.

   • 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

   • Firebase yapılandırma dosyasında projenize ö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 dosyasına (2) gibi ek karakterler eklenmediğinden emin olun.

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

Not: Unity SDK'sını ilk kez kullananlar için aşağıdaki kurulum iş akışı önerilir. Firebase, belirli kullanım alanları için alternatif kurulum akışları sunar.

1. Firebase konsolunda Firebase Unity SDK'sını indir'i tıklayın, ardından SDK'yı uygun bir yerde 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 Öğ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.

Önemli: iOS için Firebase Unity SDK'sında yöntem karıştırmayı devre dışı bırakmayın. SDK, karıştırma işlemini gerektirir. Bu işlem olmadan önemli Firebase özellikleri (FCM jetonu işleme gibi) düzgün çalışmaz.

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)

Dikkat: Firebase Unity SDK masaüstü desteği beta bir özelliktir. Bu özellik, yalnızca oyununuzun geliştirilmesi sırasındaki iş akışları için tasarlanmıştır, herkese açık olarak yayınlanan kodlar için değildir.

Oyun oluştururken oyununuzu önce Unity düzenleyicisinde ve masaüstü platformlarında 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.

   Not: Firebase, Unity projenize eklediğiniz mobil Firebase yapılandırma dosyanızı (GoogleService-Info.plist veya google-services.json) bulur. Ardından Firebase, mobil yapılandırma dosyasından otomatik olarak bir masaüstü Firebase yapılandırma dosyası (google-services-desktop.json) oluşturur. Bu masaüstü yapılandırma dosyası, Firebase konsol kurulum iş akışında girdiğiniz Unity proje kimliğini içerir. Bu dosya, uygulamanızı Firebase projenizle ilişkilendirir.
   
   Düzenleyici, masaüstü yapılandırma dosyasını bulamıyorsa StreamingAssets dizininin var olup olmadığını ve masaüstü yapılandırma dosyasının içinde olup olmadığını kontrol edin.

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:

Not: Apple platformlarında her Firebase kitaplığı yalnızca belirli Apple OS platformlarını (iOS, tvOS vb.) destekleyebilir. Unity ve Firebase hakkında daha fazla bilgi edinin bölümünden her kitaplığın desteklediği platformları kontrol edin.

Firebase ürünü	Unity paketi
AdMob	AdMob Unity eklentisinde 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 (ö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.

Dikkat: Firebase Unity SDK masaüstü desteği beta bir özelliktir. Bu özellik, yalnızca oyununuzun geliştirilmesi sırasındaki iş akışları için tasarlanmıştır, herkese açık olarak yayınlanan kodlar için değildir.

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ü sürümünü hedeflemek için kodu koşullu olarak derlemeniz gerekmez.

Sonraki adımlar

• Örnek Firebase uygulamalarını inceleyin.

• Uygulamanızı kullanıma sunmaya hazırlanın:

  • 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 kontrol listesini inceleyin.

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