Firebase'i Unity projenize ekleyin  |  Firebase for Unity (original) (raw)

Firebase Unity SDK'larımızla Unity oyunlarınıza güç katın.

Firebase'i Unity projenize bağlamanın ne kadar kolay olduğunu göstermek için MechaHamster adlı örnek bir oyun oluşturduk. 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)

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

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

Ön koşullar

Henüz bir 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 öncelikle 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 talimatlarını görüntüleyin.

Firebase veya Cloud'da yeniyseniz

Firebase veya Google Cloud'i yeni kullanmaya başladıysanız aşağıdaki adımları uygulayın.
Tamamen yeni bir Firebase projesi (ve temelindeki Google Cloud projesi) oluşturmak istiyorsanız da bu adımları uygulayabilirsiniz.

  1. Firebase konsolunda oturum açın.
  2. Yeni bir Firebase projesi oluşturmak için düğmeyi tıklayın.
  3. Metin alanına bir proje adı girin.
    Bir Google Cloud kuruluşunun parçasıysanız projenizi hangi klasörde oluşturacağınızı isteğe bağlı olarak seçebilirsiniz.
  4. İstenirse Firebase şartlarını inceleyip kabul edin ve Devam'ı tıklayın.
  5. (İsteğe bağlı) Firebase konsolunda yapay zeka yardımını etkinleştirin ("Firebase'de Gemini" olarak adlandırılır). Bu özellik, geliştirme sürecinizi başlatmanıza ve kolaylaştırmanıza yardımcı olabilir.
  6. (İsteğe bağlı) Projeniz için Google Analytics'ı ayarlayın. Bu sayede, aşağıdaki Firebase ürünlerini kullanarak optimum bir deneyim elde edebilirsiniz:Firebase A/B Testing,Cloud Messaging,Crashlytics,In-App Messaging veRemote Config (kişiselleştirme dahil).
    Mevcut bir Google Analytics hesabı seçin veya yeni bir 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.
  7. Proje oluştur'u tıklayın.

Firebase, projenizi oluşturur, bazı başlangıç kaynaklarını sağlar ve önemli API'leri etkinleştirir. İşlem tamamlandığında Firebase konsolunda Firebase projenizin genel bakış sayfasına yönlendirilirsiniz.

Mevcut Cloud projesi

Firebase'i mevcut bir Google Cloud projesiyle kullanmaya başlamak istiyorsanız aşağıdaki adımları uygulayın. Mevcut bir Google Cloud projesine "Firebase ekleme" hakkında daha fazla bilgi edinin ve sorunları giderin.

  1. Mevcut Google Cloud projesine erişmenizi sağlayan hesapla Firebase konsolunda oturum açın.
  2. Yeni bir Firebase projesi oluşturmak için düğmeyi tıklayın.
  3. Sayfanın alt kısmında Firebase'i Google Cloud projesine ekle'yi tıklayın.
  4. Metin alanına mevcut projenin proje adını girmeye başlayın ve ardından görüntülenen listeden projeyi seçin.
  5. Projeyi aç'ı tıklayın.
  6. İstenirse Firebase şartlarını inceleyip kabul edin ve Devam'ı tıklayın.
  7. (İsteğe bağlı) Firebase konsolunda yapay zeka yardımını etkinleştirin ("Firebase'de Gemini" olarak adlandırılır). Bu özellik, geliştirme sürecinizi başlatmanıza ve kolaylaştırmanıza yardımcı olabilir.
  8. (İsteğe bağlı) Projeniz için Google Analytics'ı ayarlayın. Bu sayede, aşağıdaki Firebase ürünlerini kullanarak optimum bir deneyim elde edebilirsiniz:Firebase A/B Testing,Cloud Messaging,Crashlytics,In-App Messaging veRemote Config (kişiselleştirme dahil).
    Mevcut bir Google Analytics hesabı seçin veya yeni bir 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.
  9. Firebase ekle'yi tıklayın.

FirebaseFirebase'i mevcut projenize ekler. İşlem tamamlandığında Firebase konsolunda Firebase projenizin genel bakış sayfasına yönlendirilirsiniz.

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

Firebase projenize bağlanmak 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 simgesini () 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 derleme hedefini kaydetmek istediğinizi seçin. Dilerseniz her iki hedefi de aynı anda kaydedebilirsiniz.
  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 (Derleme Ayarları > iOS) gidin.
      • Android için: Android > Player Settings > Other Settings'e (Android > Oynatıcı Ayarları > Diğer Ayarlar) gidin.

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

  5. (İsteğe bağlı) Unity projenizin platforma özel takma adlarını girin.
    Bu takma adlar dahili, kolaylık tanımlayıcılarıdı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ışında 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.
      Bu yapılandırma dosyası hakkında bilmeniz gerekenler nelerdir?
      • Firebase yapılandırma dosyasında projeniz ve uygulamanız için benzersiz ancak 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ı istediğiniz zaman tekrar indirebilirsiniz.
      • Yapılandırma dosyası adına (2) gibi ek karakterler eklenmediğinden emin olun.
  2. Unity projenizin 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ün ve 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 çıkarı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

Analytics etkinleştirilmedi

Uygulamanızda kullanmak istediğiniz Firebase ürünlerinin paketlerini ekleyin. Örneğin, Firebase Authentication ve Firebase Realtime Database kullanmak için:
FirebaseAuth.unitypackage veFirebaseDatabase.unitypackage 4. Unity Paketini İçe Aktar penceresinde İçe Aktar'ı tıklayın. 5. Firebase konsoluna geri dönün ve kurulum iş akışında İleri'yi tıklayın.

5. adım: Google Play Hizmetleri sürümüyle ilgili şartları 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.
  }
});

Artık 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 oyununuzu önce Unity düzenleyicide ve masaüstü platformlarda test etmek, ardından geliştirme sürecinin 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 uyguladığınız talimatları izleyerek bir masaüstü platformu Unity projesi oluşturun (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 Modu'nda çalıştırın.
    Firebase Unity SDK, 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çeneklerde çakışmayı önlemek için önemlidir.

Desteklenen Firebase ürünleri

Unity Firebase kitaplıkları hakkında daha fazla bilgiyi referans belgelerinde bulabilirsiniz.

Mobil 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, ü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üzenleyicide ve Windows, macOS ve Linux'taki bağımsız masaüstü derlemelerinde 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 geliştirme yaparken kolaylık sağlamak amacıyla kalan masaüstü kitaplıklarını saplama (işlevsel olmayan) uygulamalar olarak sunar. Bu nedenle, masaüstünü hedeflemek için kodu koşullu olarak derlemeniz gerekmez.

Sonraki adımlar