Unity Android: Adım Adım Rehber

Konu, Amaç ve Beklenen Sonuç

Unity’den Android çıktısı almak yalnızca Build düğmesine basmak değildir. Android Build Support, SDK/NDK/JDK araçları, uygulama kimliği, sürüm kodu, hedef API, mimari, grafik API, imzalama ve APK/AAB çıktı türü birbiriyle tutarlı olmalıdır. Unity 6 sürümlerinde platform yapılandırması Build Profiles ve Player Settings üzerinden yönetilir.

Adım Adım Uygulama

1. Adım

1. Unity Hub’da kullanılan Editor sürümü için Android Build Support ile Android SDK & NDK Tools ve OpenJDK modüllerinin kurulu olduğunu doğrula.

2. Adım

2. Build Profiles içinde Android profilini etkinleştir; derlemeye girecek sahneleri ve Development Build gibi test seçeneklerini bilinçli seç.

3. Adım

3. Player Settings’te Package Name, Version ve Bundle Version Code değerlerini tanımla. Yayındaki uygulamada paket kimliğini değiştirmek yeni uygulama kimliği anlamına gelir.

4. Adım

4. Minimum/Target API, Scripting Backend ve Target Architectures ayarlarını kullandığın Unity sürümü ile mağaza gereksinimlerine göre kontrol et. ARM64 desteğini mağaza hedefin için doğrula.

5. Adım

5. Graphics API seçimini gerçek cihaz uyumluluğuyla test et; Vulkan/OpenGLES3 kararını varsayımla değil hedef cihaz matrisiyle ver.

6. Adım

6. Yayın build’i için keystore/alias oluştur veya mevcut anahtarı seç. Anahtarı, parolaları ve Play App Signing ilişkisini güvenli yedekle.

7. Adım

7. Yerel cihaz testi için APK, Google Play dağıtımı için gereksinime uygun AAB üret; Android Logcat ve gerçek cihaz testleriyle açılış, izin, grafik ve performans sorunlarını kontrol et.

Uygulamalı Örnek

Örnek bir mobil oyun için com.studio.oyun paket adı, artan versionCode, IL2CPP/ARM64 ve imzalı AAB yapılandırılır. Önce Development Build + Autoconnect Profiler ile test cihazı ölçülür; sonra Development Build kapatılarak release AAB üretilir. Grafik API seçimi iki farklı GPU ailesinde doğrulanır. Bu örneği kendi projenize uyarlarken değerleri ezberlemek yerine “Unity Android: Adım Adım Rehber” konusundaki aynı neden-sonuç ilişkisini koruyun.

Yaygın Hatalar ve Nedenleri

1. Sadece Editor’de test edip gerçek cihaz build’i almamak.

2. Package Name veya versionCode değerini yanlış yönetmek.

3. SDK/NDK/JDK sürümlerini rastgele elle değiştirip Unity uyumluluğunu bozmak.

4. Release anahtarını kaybetmek veya kaynak depoya koymak.

5. Tek cihazda çalışan grafik API’yi bütün Android cihazları için yeterli sanmak.

6. APK ile mağaza dağıtımı gereksinimini birbirine karıştırmak.

Son Kontrol ve Doğrulama

1. Temiz kurulum ve uygulama üstüne güncelleme senaryolarını ayrı dene. Sonuç “Unity Android: Adım Adım Rehber” için somut kabul ölçütü olarak kullanılmalıdır.

2. Düşük/orta/yüksek sınıf en az üç gerçek cihazda açılış ve UI davranışını kontrol et.

3. Logcat’te kritik exception/ANR/graphics hatalarını incele.

4. Uçak modu ve izin reddi gibi koşullarda uygulamanın kontrollü davrandığını dene.

5. İmzalı release build’in mağaza öncesi iç test kanalında kurulabildiğini doğrula.

Kısa Sonuç

Unity Android: Adım Adım Rehber için kaliteli sonuç, aracı veya ayarı bir kez kullanmaktan değil; doğru sorumluluğu seçip uygulamayı gerçek koşulda doğrulamaktan gelir.

Kaynaklar

Bu makaledeki teknik kavramları doğrulamak ve sürüme bağlı ayrıntıları kontrol etmek için aşağıdaki birincil/resmî kaynaklar kullanılmıştır. Yazılım arayüzleri ve platform gereksinimleri zamanla değişebileceği için özellikle yayın/build/SEO gibi güncel konularda son sürüm dokümantasyonunu kontrol edin.

1. Android Build Settings – Unity: https://docs.unity3d.com/kr/current/Manual/android-build-settings.html

2. Android Player Settings – Unity: https://docs.unity3d.com/kr/current/Manual/class-PlayerSettingsAndroid.html

3. Android Build Process – Unity: https://docs.unity3d.com/kr/6000.0/Manual/android-BuildProcess.html

4. Android environment setup – Unity: https://docs.unity3d.com/6000.0/Documentation/Manual/android-sdksetup.html

5. Android application signing – Unity: https://docs.unity3d.com/6000.0/Documentation/Manual/android-keystore-manager.html

6. Google Play Android App Bundles: https://developer.android.com/guide/app-bundle

7. Profiler Window – Unity Manual: https://docs.unity3d.com/cn/current/Manual/ProfilerWindow.html

8. Profiler API – Unity: https://docs.unity3d.com/cn/6000.0/ScriptReference/Profiling.Profiler.html