Unity projenize Firebase ekleyin

Firebase Unity SDK'larımızla Unity oyunlarınızı 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 örnek bir oyun olan MechaHamster yaptık.

MechaHamster (GitHub)

MechaHamster (App Store)

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 2018.4 veya sonraki sürümünü yükleyin. Daha önceki sürümler de uyumlu olabilir ancak aktif olarak desteklenmeyecektir. Unity 2018.4 desteğinin kullanımdan kaldırıldığı kabul edilir ve bir sonraki ana sürümden sonra artık aktif olarak desteklenmeyecektir.

• (yalnızca iOS) 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 10 veya üstünü hedefler

  • Android için — API seviyesi 19 (KitKat) veya üzerini hedefler

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

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

    Bulut Mesajlaşma'yı kullanmak istiyor musunuz?

    iOS'ta Bulut Mesajlaşma için ön koşullar şunlardır:

    • Fiziksel bir iOS cihazı kurun.
    • Apple Geliştirici hesabınız için bir Apple Anında Bildirim Kimlik Doğrulama Anahtarı edinin.
    • XCode'da App > Capabilities altında 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.

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

Adım 1 : Bir Firebase projesi oluşturun

Unity projenize Firebase eklemeden önce Unity projenize bağlanmak için 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 projenize bağlanmak için bir veya daha fazla uygulama veya oyun kaydedebilirsiniz.

1. Firebase konsoluna gidin.

2. Projeye genel bakış sayfasının ortasında, kurulum iş akışını başlatmak için Unity simgesine ( 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 hangi yapı hedefini kaydetmek istediğinizi seçin, hatta şimdi 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 buluyorsunuz?

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

   • iOS için — Yapı Ayarları > iOS seçeneğine gidin.

   • Android için — Android > Oyuncu Ayarları > Diğer Ayarlar'a gidin.

   Unity projenizin kimliği, Paket Tanımlayıcı değeridir (örnek ID: com.yourcompany.yourproject ).

5. (İsteğe bağlı) Unity projenizin platforma özel takma adlarını girin.
   Bu takma adlar dahili, kullanışlı tanımlayıcılardır ve yalnızca siz Firebase konsolunda görebilirsiniz.

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

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

1. Firebase konsol kurulum iş akışında platforma özel 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.

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

   • Firebase yapılandırma dosyası, projeniz için benzersiz, ancak gizli olmayan tanımlayıcılar içerir. Bu yapılandırma dosyası hakkında daha fazla bilgi edinmek için Firebase Projelerini Anlayın sayfasını ziyaret edin.

   • Firebase yapılandırma dosyanızı istediğiniz zaman yeniden indirebilirsiniz.

   • Yapılandırma dosyası adının sonuna (2) gibi ek karakterler eklenmediğinden emin olun.

2. Unity projenizin Proje penceresini açın, ardından yapılandırma dosya(lar)ı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ını ekleyin

1. Firebase konsolunda, Firebase Unity SDK'yı İndir'i tıklayın, ardından SDK'yı uygun bir yerde açın.

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

   • Firebase Unity SDK, platforma özel değildir.

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

3. Sıkıştırılmamış 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ünleri için paketleri ekleyin. Örneğin, Firebase Authentication ve Firebase Realtime Database'i kullanmak için:
     FirebaseAuth.unitypackage ve FirebaseDatabase.unitypackage

   Analytics etkinleştirilmedi

   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 öğesine tıklayın.

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

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

Android için Firebase Unity SDK'sı, SDK'nın kullanılabilmesi için 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'sı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 kayıtlı ve Firebase'i kullanacak şekilde yapılandırıldı.

Yine de kurulum yapmakta 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 düzenleyicisinde ve masaüstü platformlarında test etmek, ardından daha sonra geliştirme aşamasında 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üzenleyicisinin içinden çalışabilen bir Firebase Unity SDK alt kümesi sağlıyoruz.

1. Mobil platformla aynı talimatları izleyerek bir masaüstü platform 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 Modunda çalıştırın.

   Firebase Unity SDK, Unity'nin düzenleme modunda da çalıştırılabilir ve düzenleyici 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.

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

Desteklenen Firebase ürünleri

Başvuru belgelerinde Unity Firebase kitaplıkları hakkında daha fazla bilgi edinin.

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

Desteklenen Firebase ürünleri (masaüstü)

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'taki bağımsız masaüstü yapılarında kullanılmasına olanak tanır.

Firebase, Windows, macOS ve Linux için derlerken 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

• Örnek Firebase uygulamalarını keşfedin.

• Uygulamanızı başlatmaya hazırlanın:

  • Google Cloud Console'da projeniz için bütçe uyarıları ayarlayın.
  • Projenizin birden fazla Firebase hizmetinde kullanımının genel bir resmini elde etmek için Firebase konsolundaki Kullanım ve faturalandırma panosunu izleyin.
  • Firebase başlatma kontrol listesini inceleyin.

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