Bu sayfa, Firebase'i kullanırken karşılaşabileceğiniz Unity'ye özgü sorunlar için ipuçları ve sorun giderme sunar.
Başka sorunlarınız mı var veya sorununuzu aşağıda ana hatlarıyla göremiyor musunuz? Pan-Firebase veya ürüne özel SSS için ana Firebase SSS bölümüne göz atmayı unutmayın.
Unity 2017.x ve sonraki sürümleri kullanırken .NET uyumluluğu
Firebase, Unity 2017 ve sonraki sürümlerde deneysel bir derleme seçeneği olarak .NET 4.x'i destekler. Firebase eklentileri, .NET'in önceki sürümlerinde bazı .NET 4.x sınıfları sağlamak için Ayrıştırma SDK'sının bileşenlerini kullanır.
Bu nedenle, Firebase Unity SDK sürüm 5.4.0
ve sonraki sürümleri, Firebase Unity SDK'nın dotnet3
ve dotnet4
dizinlerinde .NET 3.x veya .NET 4.x ile uyumlu eklentiler sağlar.
Projenizde etkinleştirilen .NET sürümüyle uyumlu olmayan bir Firebase eklentisi içe aktarırsanız, Ayrıştırma SDK'sı tarafından uygulanan .NET çerçevesindeki bazı türlerden derleme hataları görürsünüz.
.NET 3.x kullanıyorsanız derleme hatasını çözmek için:
- Tüm platformlar için aşağıdaki DLL'leri kaldırın veya devre dışı bırakın:
-
Parse/Plugins/dotNet45/Unity.Compat.dll
-
Parse/Plugins/dotNet45/Unity.Tasks.dll
-
- Tüm platformlar için aşağıdaki DLL'leri etkinleştirin:
-
Parse/Plugins/Unity.Compat.dll
-
Parse/Plugins/Unity.Tasks.dll
-
.NET 4.x kullanıyorsanız derleme hatasını çözmek için:
- Tüm platformlar için aşağıdaki DLL'leri kaldırın veya devre dışı bırakın:
-
Parse/Plugins/Unity.Compat.dll
-
Parse/Plugins/Unity.Tasks.dll
-
- Tüm platformlar için aşağıdaki DLL'leri etkinleştirin:
-
Parse/Plugins/dotNet45/Unity.Compat.dll
-
Parse/Plugins/dotNet45/Unity.Tasks.dll
-
Başka bir Firebase eklentisi içe aktarırsanız:
- Unity projenizde, projeniz için doğru DLL'leri etkinleştirmek için Varlıklar > Play Hizmetleri Çözümleyici > Sürüm İşleyici > Güncelle'ye gidin.
.NET 4.x projelerinde Unity 2017.1 IL2CPP derlemesi
Firebase, Unity 2017 ve sonraki sürümlerde deneysel bir derleme seçeneği olarak .NET 4.x'i destekler. Firebase eklentileri, .NET'in önceki sürümlerinde bazı .NET 4.x sınıfları sağlamak için Ayrıştırma SDK'sının bileşenlerini kullanır.
Bu nedenle, Firebase Unity SDK sürüm 5.4.0 ve sonraki sürümleri, Ayrıştırma türlerini (örneğin, System.Threading.Tasks.Task
Ayrıştırma uygulaması) .NET çerçevesine ileten tür iletme DLL'leri sağlar. Ne yazık ki, Unity 2017.1.x ile birlikte gönderilen IL2CPP (C#'yi C++'a dönüştüren bir aktarıcı), tür iletme DLL'lerini doğru şekilde işlemez ve bu da aşağıdakine benzer derleme hatalarına neden olur:
Fatal error in Unity CIL Linker Mono.Cecil.ResolutionException: Failed to
resolve System.Threading.Tasks.TaskCompletionSource`1<T>
Unity 2017.1'de .NET 4.x IL2CPP derleme hataları için şu anda kullanılabilecek bir geçici çözüm yoktur, bu nedenle IL2CPP ile derlenmiş projelerde .NET 4.x'i kullanmak için Unity 2017.2 veya sonraki bir sürüme yükseltmeniz gerekir.
Unity 2017.2 ağ iletişimi
Firebase Realtime Database, .NET ağ yığınını kullanarak TLS ağ bağlantıları oluşturur. Unity 2017.2'de .NET 4.6 kullanırken TLS işlevi bozulur ve Realtime Database eklentisinin editörlerde ve masaüstünde başarısız olmasına neden olur.
Bu sorun için bir geçici çözüm yoktur, bu nedenle Unity'nin farklı bir sürümünü, örneğin 2017.1 veya 2017.3 sürümünü kullanmanız gerekir.
Unity 2020'de eksik Firebase Android yapılandırma dosyası
Gradle derlemesini özelleştirme yeteneğine sahip olmayan Unity sürümlerini desteklemek için, Firebase düzenleyici aracı, Assets/Plugins/Android/Firebase/res/values/google-services.xml
bir Android kaynağı olarak paketlenecek şekilde oluşturur. Android derlemesi, böylece Firebase SDK'sı varsayılan FirebaseApp örneğini başlatmak için kullanabilir.
Unity 2020'de tüm Android kaynakları, .androidlib
son ekine sahip dizinlerde olmalıdır. Projeniz Assets/Plugins/Android/Firebase
dizini oluşturan bir Firebase SDK kullanıyorsa, Assets/Plugins/Android Assets/Plugins/Android/Firebase.androidlib
Firebase.androidlib olarak yeniden adlandırın. AndroidManifest.xml
, project.properties
ve res/values/google-services.xml
içerdiğinden emin olun.
Android uygulaması oluştururken tek dex ile ilgili bir sorun
Android uygulaması oluştururken, tek bir dex dosyasına sahip olmakla ilgili bir derleme hatasıyla karşılaşabilirsiniz. Projeniz Gradle derleme sistemini kullanacak şekilde yapılandırılmışsa, hata mesajı aşağıdakine benzer.
Cannot fit requested classes in a single dex file.
Dalvik Executable ( .dex
) dosyaları, Android uygulamaları ( .apk
) için bir dizi sınıf tanımını ve bunlarla ilişkili ek verileri tutmak için kullanılır. Tek bir dex dosyası, 65.536 yönteme referansla sınırlıdır. Projenizdeki tüm Android kitaplıklarındaki toplam yöntem sayısı bu sınırı aşarsa derleme başarısız olur.
Unity, 2017.2'de kullanılmayan kodu çıkarmak için Proguard'ı (veya Unity'nin bazı sürümlerinde bulunan diğer araçları) kullanan Minification'ı tanıttı ve bu da tek bir dex dosyasında başvurulan yöntemlerin toplam sayısını azaltabilir. Seçenek, Player Settings > Android > Publishing Settings > Minify içinde bulunabilir. Seçenekler Unity'nin farklı sürümlerinde farklılık gösterebilir, bu nedenle resmi Unity belgelerine bakın.
Başvurulan yöntemlerin sayısı hala sınırı aşıyorsa, başka bir seçenek de multidex
etkinleştirmektir. Unity'de bunu başarmanın birden fazla yolu vardır:
-
Player Settings
altındaCustom Gradle Template
etkinse,mainTemplate.gradle
öğesini değiştirin. - Dışa aktarılan projeyi oluşturmak için Android Studio kullanıyorsanız, modül düzeyinde
build.gradle
dosyasını değiştirin.
Daha fazla ayrıntı multidex kullanım kılavuzunda bulunabilir.
Unity 2017 ve Unity 2018'de (Firebase Unity SDK 8.0.0 ve üstü) Android derlemeleri için Java 8 desteği ve şeker azaltma
Mayıs 2021'de (Firebase BoM v28.0.0), Firebase tüm Android kitaplıkları için şekerden arındırmayı devre dışı bıraktı ( sürüm notuna bakın). Firebase Unity SDK (8.0.0 ve üstü) ile bir Android uygulaması oluştururken aşağıdaki derleme hatasını görebilirsiniz:
> Error while dexing.
The dependency contains Java 8 bytecode. Please enable desugaring by adding the following to build.gradle
Bu değişiklik, yalnızca Unity 2017 ve Unity 2018'deki Android derlemelerini etkiler. Unity'nin daha yeni sürümleri, gradle derleme dosyalarında varsayılan olarak compileOptions
bloğunu ekler. Unity 2017 ve Unity 2018'de bu derleme hatasını düzeltmek için aşağıdakilerden birini yapın:
Gradle şablonunuza bir
compileOptions
bloğu ekleyin:- Yapı sistemi olarak
Gradle
kullanın. -
Player Settings
altındaCustom Gradle Template
etkinleştirin. Aşağıdaki satırları
mainTemplate.gradle
(veya Android Studio için bir proje dışa aktarıyorsanız modül düzeyindebuild.gradle
):android { compileOptions { sourceCompatibility 1.8 targetCompatibility 1.8 } }
- Yapı sistemi olarak
Alternatif olarak, Android projeniz için minSdkVersion'ı 26 veya üstüne yükseltin.
Ayrıca bkz. Android sorun giderme - yapı hatalarını giderme .
Cocoapod'larla iOS için derleme yaparken karşılaşılan sorunlar
iOS için oluştururken, Cocoapod kurulumu dil yerel ayarı veya UTF-8 kodlaması ile ilgili bir hatayla başarısız olabilir. Şu anda soruna geçici bir çözüm bulmanın birkaç farklı yolu vardır.
Terminalden, doğrudan
pod install
çalıştırın ve ortaya çıkan xcworkspace dosyasını açın.Cocoapods sürümünü 1.10.2'ye düşürün. Sorun yalnızca 1.11 ve daha yeni sürümlerde mevcuttur.
~/.bash_profile
veya eşdeğerinde,export LANG=en_US.UTF-8
ekleyin
Firebase Unity SDK'larının sürümü nasıl güncellenir?
Firebase Unity SDK'larının sürümlerini güncelleme işlemi, bunların başlangıçta nasıl içe aktarıldığına bağlıdır. İşte iki alternatif içe aktarma yöntemi:
- Projenizin
Assets/
dizini altındaki.unitypackage
dosyalarını içe aktarma - Unity Paket Yöneticisi'ni (UPM) kullanarak içe aktarma
- Unity 2018.4+ içindeki paketleri yönetmenin önerilen yolu budur.
- Gelecekteki sürüm güncellemelerini kolaylaştırmak ve
Assets/
dizininizi daha temiz hale getirmek için bu yöntemi kullanın.
Unity projenizde, tüm Firebase paketlerinizi yönetmek için yalnızca bir içe aktarma yöntemi kullanmalısınız. Aşağıdaki talimatlar yalnızca tek tek paketlerin sürümünü güncellemek için değil, aynı zamanda gerekirse paket yönetimini UPM'ye (önerilen içe aktarma yöntemi) taşımak için de kullanılabilir.
Firebase paketleri Assets/
dizinindeyse SDK sürümünü güncellemek için iki seçeneğiniz vardır:
Seçenek 1 (önerilir) : UPM'yi kullanmak için geçiş yapın (Unity 2018.4+ sürümünde mevcuttur)
- Paket yönetimini UPM'ye geçirmek için Firebase tarafından sağlanan talimatları izleyin.
- Bu yöntem,
.unitypackage
iş akışını kullanmaya devam etmekten daha fazla ilk kurulum gerektirse de, sonraki SDK sürüm güncellemelerinin kolaylıkla karşılığını verir.
Seçenek 2 :
Assets/
dizinine aktarmak için.unitypackage
dosyalarını kullanmaya devam edinGüncellenmiş sürüm için paketlerin her birini içe aktarın.
firebase_unity_sdk.zip dosyasını Firebase web sitesinden indirirseniz, tüm
.unitypackages
doğrudotnet
klasöründen içe aktardığınızdan emin olun.- Unity 2019 veya sonraki bir
dotnet4
klasöründen içe aktarın. - Aksi takdirde, Player Settings'de Scripting Runtime Version'ı seçin ve ".NET 3.x" olarak ayarlanmışsa
dotnet3
klasöründen içe aktarın.
- Unity 2019 veya sonraki bir
Önceden içe aktarılan paket sürümlerinin üzerine yazılması, Dış Bağımlılık Yöneticisi tarafından otomatik olarak işlenmelidir (
.unitypackages
içe aktardığınızda otomatik olarak dahil edilir).Ancak, YALNIZCA bu otomatik işlem başarısız olursa, aşağıdaki klasörleri manuel olarak silmeniz ve ardından yukarıdaki içe aktarma adımını yeniden denemeniz gerekir.
-
Assets/Editor Default Resources/Firebase
-
Assets/ExternalDependencyManager
-
Assets/Firebase
-
Assets/Parse
-
Assets/Plugins/iOS/Firebase
-
Firebase paketleri UPM tarafından yönetiliyorsa daha yeni SDK sürümünü .tgz
olarak içe aktarın . Bu içe aktarma, otomatik olarak önceki sürümün üzerine yazacaktır.