Unreal Engine Android paketleme: projeyi APK olarak hazırlama rehberi

Bu rehberde ne öğreneceksiniz?

Unreal Engine’de hazırlanan bir mimari sunum, iç mekân çalışması veya etkileşimli görselleştirme projesini Android cihazda denemek için proje ayarlarının yapılması, cihazın bağlanması ve bir kurulum paketi oluşturulması gerekir. Bu rehber, Epic’in Android hızlı başlangıç ve paketleme belgelerindeki iş akışını izleyerek başlangıçtan APK üretimine kadar temel adımları anlatıyor. Google Play’e yönelik AAB seçeneği ve cihaz uyumluluğunda dikkate alınması gereken doku biçimleri de ele alınıyor.

İş akışı, masaüstündeki Unreal Editor projesini telefona aktarıp test etmek isteyenler için uygundur. Buradaki adımlar bir mimari uygulama ya da özel bir dağıtım sistemi kurulduğu anlamına gelmez; proje türüne göre ek ayar gerekebilir.

Gereksinimler: yazılım, proje ve Android cihaz

Epic’in hızlı başlangıç belgesinde güncel Unreal Engine sürümü 5.8 olarak listeleniyor. Aynı kaynak, Android Studio için Koala 2024.1.2 Patch 1 sürümünü, Android SDK için önerilen SDK 35’i, NDK r27c’yi ve OpenJDK 21.0.3’ü belirtiyor. Gereksinimler motor sürümüyle ilişkili olduğundan, kurulumdan önce kullanılan UE sürümünün belgelerine bakılması önemli.

SDK, NDK ve JDK bileşenlerini elle kurmak yerine Unreal Engine içindeki Turnkey aracıyla hazırlamak mümkün. Epic’e göre Turnkey, motor sürümüyle doğrulanmış bileşenleri kurmaya yardımcı oluyor. Android cihaz tarafında Geliştirici Modu ve USB hata ayıklama açılmalı; cihaz bilgisayara bağlandığında veri erişimi ve gerekli sürücü kurulumu onaylanmalı.

Kaynakta UE 5.8 için Android 8 veya daha yeni işletim sistemi ve 64 bit Arm tabanlı işlemci gereksinimleri sıralanıyor. Grafik API’leri arasında OpenGL ES 3.2 ile uyumlu sürücülere sahip Android 10 veya daha yeni cihazlarda Vulkan 1.1 bulunuyor. Bunlar hedef cihaz seçerken kontrol edilmesi gereken uyumluluk başlıklarıdır.

Projeyi Android için hazırlama

1. Mobil proje oluşturun. Unreal Editor’ün Project Browser ekranında Games bölümünden uygun bir şablon seçin. Proje varsayılanlarında Blueprint veya C++ tercih edilebilir. Target Platform değerini Mobile, kalite ayarını Scalable yapıp projeyi oluşturun. Mevcut bir projeyle çalışılıyorsa bu ayarları ve projenin mobil gereksinimlerini ayrıca kontrol edin.

2. Android araç zincirini kurun. Editor menüsünden Platforms > SDK Management > Android > Install SDK yolunu izleyin ve ekrandaki yönlendirmeleri takip edin. Turnkey, Android Studio mevcut değilse kurabilir; ayrıca komut satırı araçlarını ve motor sürümü için gereken SDK, NDK ve JDK bileşenlerini yükleyip ilgili ortam değişkenlerini ayarlayabilir. Belirli bir Android Studio sürümünü sabitlemek veya başsız bir derleme ortamı kurmak gerekiyorsa Epic’in gelişmiş SDK kurulum belgesi kullanılmalı.

3. Android proje ayarlarını tamamlayın. Edit > Project Settings içinden Platforms > Android bölümüne gidin. APK Packaging alanındaki Android Package Name değerini projeye uygun biçimde belirleyin. Minimum SDK Version ve Target SDK Version alanlarını hedefinize göre ayarlayın. Proje Android için henüz yapılandırılmamış uyarısı görünürse Configure Now seçeneğiyle gerekli platform dosyalarını oluşturun. SDK lisansını kabul etme düğmesi etkinse lisans onayı da tamamlanmalı.

4. Cihazda hızlı test yapın. Android cihazı USB kablosuyla bağlayın; ilk dağıtım için USB bağlantısı öneriliyor. Geliştirici Modu ve USB hata ayıklamanın etkin olduğunu, cihazdaki bağlantı izninin verildiğini doğrulayın. Unreal Editor’de ana araç çubuğundaki Platforms menüsünü açın ve cihazı Quick Launch Current Level bölümünden seçin. Quick Launch, projeyi pişirip paketleyerek cihaza gönderir. İşlem ilerlemesi Editor’de görülebilir; aktarım tamamlandığında proje otomatik başlamazsa uygulama cihazdan elle açılabilir.

5. APK paketleyin. Tek başına kurulabilen bir Android paketi için Platforms > Package Project > Android menüsünden Android (Multi:ASTC,DXT,ETC2) seçeneğini kullanın. Ardından Platforms > Package Project > Package Project yoluyla paketleme penceresini açın, hedef klasörü seçin ve işlemi başlatın. Oluşan dosyalar arasında APK ve OBB bulunabilir; bağlı cihaza kurulum veya kaldırma için .bat dosyaları da yer alabilir. Diğer paketleme belgelerinde çıktı biçimi ve kurulum yardımcılarının işletim sistemine göre değişebildiği gösteriliyor.

6. Cihaza kurup doğrulayın. Paketleme tamamlandıktan sonra çıktı klasörünü kontrol edin. Windows’ta kaynakta anlatılan kurulum akışı, cihaz USB ile bağlıyken Install_[ProjectName]_Development.bat dosyasını çalıştırıyor. Cihaz bağlı değilse bu dosyanın kurulum yapmayacağını unutmayın. Linux için belgede terminalden kurulum betiği çalıştırma ve bağlantıyı adb devices komutuyla denetleme adımları veriliyor. Kurulum sonrasında uygulamanın cihazda açıldığını doğrulayın.

Doku biçimi ve AAB seçeneği

Doku biçimi seçimi, paketin hedefleneceği cihazların donanımıyla ilişkilidir. Epic’in paketleme kılavuzu ETC2’yi OpenGL 3.x sınıfındaki cihazlarda desteklenen bir seçenek olarak tanımlarken ASTC’yi blok boyutuyla kalite kontrolü sunan daha yeni bir biçim olarak açıklıyor; ASTC’nin yalnızca bazı cihazlarda bulunduğunu belirtiyor. DXT ise kaynakta NVIDIA Tegra GPU’larıyla ilişkilendiriliyor. Hızlı başlangıç kılavuzundaki çoklu seçenek, ASTC, DXT ve ETC2 biçimlerini birlikte paketleme akışında sunuyor. Hedef cihaz grubu bilinmeden tek bir biçimin tüm cihazlara uygun olduğu varsayılmamalı.

Google Play’de dağıtım için AAB üretimi de mümkün. Bunun için Project Settings > Platforms > Android altında App Bundles bölümündeki Generate Bundle (AAB) seçeneği etkinleştiriliyor. Paketleme, yükleme için bir AAB ve test amacıyla evrensel bir APK oluşturabiliyor. AAB, mağazanın kullanıcının cihazına göre APK üretmesini sağlar. Epic’in belgesine göre son APK boyut sınırı 150 MB; bu sınır AAB’ye değil, AAB’den oluşturulan APK’ya uygulanıyor. AAB’ler OBB dosyalarıyla dağıtılamıyor.

Mimarlık ve archviz iş akışına etkisi

Bu yöntem, tasarımı yalnızca masaüstü ekranda değil, Android cihazda da denemek isteyen mimarlık ve iç mimarlık ekipleri için bir dağıtım yolu sunuyor. Örneğin etkileşimli bir sunum projesi cihazda açılarak kontrol edilebilir; ancak performans veya görsel kalite hakkında kaynaklarda ölçüm verilmediğinden, her hedef cihazda ayrı test yapılması gerekir. Özellikle doku biçimi ve cihazın desteklediği grafik API’si doğrulanmalı.

Cihazda hızlı deneme için Quick Launch, bağımsız kurulum dosyası hazırlamak için APK, Google Play dağıtımı içinse AAB akışı değerlendirilebilir. Donanım uyumluluğunun yanında SDK sürümleri, proje yapılandırması ve lisans onayı da sürecin parçalarıdır. Yayına çıkacak projelerde hedef mağazanın SDK koşullarını ayrıca kontrol etmek gerekir.

Sık karşılaşılan hatalar

• Cihaz görünmüyor: Geliştirici Modu ile USB hata ayıklamayı kontrol edin; ekrandaki bağlantı iznini onaylayın. İlk dağıtımda USB kullanılması öneriliyor.

• Kurulum betiği çalışmıyor: Cihazın kabloyla bağlı olduğundan emin olun. Linux’ta adb devices bağlantıyı doğrulamaya yardımcı olabilir.

• SDK veya proje yapılandırması eksik: Turnkey kurulumunu tamamlayın; Android proje ayarlarında Configure Now uyarısını ve SDK lisansını kontrol edin.

• Paket hedef cihazda uygun değil: Doku biçimi ve grafik API’si desteğini hedef cihazlara göre değerlendirin; kaynaklar, farklı cihazların farklı biçimleri destekleyebildiğini belirtiyor.

Sonraki adımlar

İlk kurulum ve cihaz testinden sonra hedef Android cihazlarını ve dağıtım biçimini netleştirin. Google Play’e gönderim planlanıyorsa güncel hedef SDK gereksinimlerini dikkate alın: Epic’in belgesinde, 31 Ağustos 2025’ten itibaren yeni uygulamalar ve güncellemeler için Android 15 (API 35) hedefi gerektiği, UE 5.7 veya daha yenisinin bu desteği sunduğu belirtiliyor. Farklı mağazaların koşulları değişebileceğinden ilgili dağıtım kılavuzlarını da inceleyin.

Kaynak ve lisans

Bu eğitim, Epic Games’in Unreal Engine Android Quick Start ve Android projelerini paketleme belgelerindeki bilgiler temel alınarak Türkçeye uyarlanmıştır. Her iki kaynak da resmi Epic Games geliştirici belgeleridir ve açık kullanım lisansıyla sunulmuştur.