Unreal Engine-də Android paketlənməsi: layihəni APK kimi hazırlamaq üçün bələdçi

Bu bələdçidə nə öyrənəcəksiniz?

Unreal Engine-də hazırlanmış memarlıq təqdimatını, interyer layihəsini və ya interaktiv vizuallaşdırmanı Android cihazda sınamaq üçün layihə parametrlərini qurmaq, cihazı qoşmaq və quraşdırma paketi yaratmaq lazımdır. Bu bələdçi Epic-in Android Quick Start və paketləmə sənədlərindəki iş axınını izləyərək ilkin hazırlıqdan APK yaradılmasına qədər əsas mərhələləri izah edir. Google Play üçün AAB seçimi və cihaz uyğunluğunda nəzərə alınmalı tekstura formatları da nəzərdən keçirilir.

Bu iş axını masaüstü Unreal Editor layihəsini telefona ötürüb sınaqdan keçirmək istəyənlər üçün uyğundur. Burada göstərilən addımlar memarlıq tətbiqinin və ya xüsusi yayım sisteminin qurulduğu anlamına gəlmir; layihənin növündən asılı olaraq əlavə parametrlər tələb oluna bilər.

Tələblər: proqram təminatı, layihə və Android cihazı

Epic-in Quick Start sənədində Unreal Engine-in aktual versiyası 5.8 kimi göstərilir. Eyni mənbədə Android Studio üçün Koala 2024.1.2 Patch 1 versiyası, Android SDK üçün tövsiyə edilən SDK 35, NDK r27c və OpenJDK 21.0.3 qeyd olunur. Tələblər mühərrik versiyası ilə əlaqəli olduğundan, quraşdırmaya başlamazdan əvvəl istifadə etdiyiniz UE versiyasının sənədlərini yoxlamaq vacibdir.

SDK, NDK və JDK komponentlərini əl ilə quraşdırmaq əvəzinə Unreal Engine daxilindəki Turnkey alətindən istifadə etmək mümkündür. Epic-in məlumatına görə, Turnkey mühərrik versiyası ilə yoxlanmış komponentləri quraşdırmağa kömək edir. Android cihazında Developer Mode və USB debugging aktiv edilməli; cihaz kompüterə qoşulanda məlumatlara girişə və tələb olunan drayverin quraşdırılmasına icazə verilməlidir.

Mənbədə UE 5.8 üçün Android 8 və ya daha yeni əməliyyat sistemi, eləcə də 64 bit Arm əsaslı prosessor tələbləri göstərilir. Qrafik API-lər arasında OpenGL ES 3.2 ilə uyğun drayverlərə malik Android 10 və ya daha yeni cihazlarda Vulkan 1.1 də var. Hədəf cihazı seçərkən bu uyğunluq göstəriciləri yoxlanmalıdır.

Layihəni Android üçün hazırlamaq

1. Mobil layihə yaradın. Unreal Editor-də Project Browser ekranının Games bölməsindən uyğun şablon seçin. Layihə parametrlərində Blueprint və ya C++ seçilə bilər. Target Platform dəyərini Mobile, keyfiyyət parametrini isə Scalable seçərək layihəni yaradın. Mövcud layihə üzərində işləyirsinizsə, bu parametrləri və layihənin mobil tələblərini ayrıca yoxlayın.

2. Android alətlər zəncirini quraşdırın. Editor menyusunda Platforms > SDK Management > Android > Install SDK yolunu izləyin və ekrandakı təlimatlara əməl edin. Android Studio quraşdırılmayıbsa, Turnkey onu quraşdıra bilər; həmçinin komanda sətri alətlərini və mühərrik versiyası üçün lazım olan SDK, NDK və JDK komponentlərini quraşdırıb müvafiq mühit dəyişənlərini təyin edə bilər. Müəyyən Android Studio versiyasını sabitləmək və ya başsız build mühiti qurmaq lazımdırsa, Epic-in təkmil SDK quraşdırma sənədindən istifadə edin.

3. Android layihə parametrlərini tamamlayın. Edit > Project Settings bölməsindən Platforms > Android hissəsinə keçin. APK Packaging sahəsində Android Package Name dəyərini layihəyə uyğun təyin edin. Minimum SDK Version və Target SDK Version sahələrini məqsədinizə uyğun qurun. Layihənin Android üçün hələ konfiqurasiya edilmədiyi barədə xəbərdarlıq görünərsə, lazımi platforma fayllarını yaratmaq üçün Configure Now seçin. SDK lisenziyasını qəbul etmə düyməsi aktivdirsə, lisenziyanı da qəbul edin.

4. Cihazda sürətli sınaq aparın. Android cihazını USB kabeli ilə qoşun; ilk yayım üçün USB bağlantısı tövsiyə olunur. Developer Mode və USB debugging-in aktiv olduğunu, cihazdakı bağlantı icazəsinin verildiyini yoxlayın. Unreal Editor-də əsas alətlər panelindəki Platforms menyusunu açın və cihazı Quick Launch Current Level bölməsindən seçin. Quick Launch layihəni cook edib paketləyərək cihaza göndərir. Əməliyyatın gedişini Editor-də izləmək mümkündür; ötürmə başa çatdıqdan sonra layihə avtomatik başlamazsa, tətbiqi cihazdan əl ilə aça bilərsiniz.

5. APK paketləyin. Müstəqil quraşdırıla bilən Android paketi üçün Platforms > Package Project > Android menyusundan Android (Multi:ASTC,DXT,ETC2) seçimini edin. Sonra Platforms > Package Project > Package Project yolu ilə paketləmə pəncərəsini açın, hədəf qovluğu seçin və prosesi başladın. Yaradılan fayllara APK və OBB daxil ola bilər; qoşulmuş cihaza quraşdırma və ya silmə üçün .bat faylları da ola bilər. Digər paketləmə sənədlərində çıxış formatının və quraşdırma köməkçi fayllarının əməliyyat sistemindən asılı olaraq dəyişə bildiyi göstərilir.

6. Cihaza quraşdırıb yoxlayın. Paketləmə bitdikdən sonra çıxış qovluğunu yoxlayın. Mənbədə təsvir olunan Windows quraşdırma axınında cihaz USB ilə qoşulu olarkən Install_[ProjectName]_Development.bat faylı işə salınır. Cihaz qoşulu deyilsə, bu faylın quraşdırma aparmayacağını nəzərə alın. Linux üçün sənəddə terminaldan quraşdırma skriptini işə salmaq və bağlantını adb devices əmri ilə yoxlamaq addımları verilir. Quraşdırmadan sonra tətbiqin cihazda açıldığını təsdiqləyin.

Tekstura formatı və AAB seçimi

Tekstura formatının seçimi paketin nəzərdə tutulduğu cihazların avadanlığı ilə əlaqəlidir. Epic-in paketləmə bələdçisində ETC2 OpenGL 3.x sinfindəki cihazlarda dəstəklənən seçim kimi təqdim olunur, ASTC isə blok ölçüsü vasitəsilə keyfiyyətə nəzarət imkanı verən daha yeni format kimi izah edilir; ASTC-nin yalnız bəzi cihazlarda mövcud olduğu qeyd olunur. Mənbədə DXT NVIDIA Tegra GPU-ları ilə əlaqələndirilir. Quick Start bələdçisindəki çoxformatlı seçim ASTC, DXT və ETC2 formatlarını eyni paketləmə axınında təqdim edir. Hədəf cihaz qrupu məlum olmadan bir formatın bütün cihazlara uyğun olduğunu düşünmək olmaz.

Google Play-də yayım üçün AAB yaratmaq da mümkündür. Bunun üçün Project Settings > Platforms > Android bölməsindəki App Bundles hissəsində Generate Bundle (AAB) seçimini aktiv edin. Paketləmə yükləmə üçün AAB və sınaq məqsədilə universal APK yarada bilər. AAB mağazaya istifadəçinin cihazına uyğun APK yaratmağa imkan verir. Epic-in sənədinə görə, son APK ölçüsü üçün limit 150 MB-dır; bu limit AAB-yə deyil, AAB-dən yaradılan APK-ya tətbiq olunur. AAB-lər OBB faylları ilə yayımlana bilməz.

Memarlıq və archviz iş axınına təsiri

Bu üsul layihəni yalnız masaüstü ekranda deyil, Android cihazda da yoxlamaq istəyən memarlıq və interyer dizaynı komandaları üçün yayım yolu təqdim edir. Məsələn, interaktiv təqdimat layihəsini cihazda açıb yoxlamaq mümkündür; lakin mənbələrdə performans və ya vizual keyfiyyət ölçmələri verilmədiyindən, hər hədəf cihazda ayrıca sınaq aparılmalıdır. Xüsusilə tekstura formatı və cihazın dəstəklədiyi qrafik API yoxlanmalıdır.

Cihazda sürətli sınaq üçün Quick Launch, müstəqil quraşdırma faylı yaratmaq üçün APK, Google Play-də yayım üçün isə AAB axını nəzərdən keçirilə bilər. Avadanlıq uyğunluğu ilə yanaşı SDK versiyaları, layihə konfiqurasiyası və lisenziyanın qəbulu da prosesin tərkib hissəsidir. Yayımlanacaq layihələrdə hədəf mağazanın SDK tələblərini ayrıca yoxlamaq lazımdır.

Tez-tez rast gəlinən xətalar

• Cihaz görünmür: Developer Mode və USB debugging-i yoxlayın; ekrandakı bağlantı icazəsini təsdiqləyin. İlk yayımda USB-dən istifadə etmək tövsiyə olunur.

• Quraşdırma skripti işləmir: Cihazın kabel vasitəsilə qoşulduğundan əmin olun. Linux-da adb devices bağlantını yoxlamağa kömək edə bilər.

• SDK və ya layihə konfiqurasiyası natamamdır: Turnkey quraşdırmasını tamamlayın; Android layihə parametrlərində Configure Now xəbərdarlığını və SDK lisenziyasını yoxlayın.

• Paket hədəf cihaza uyğun deyil: Tekstura formatı və qrafik API dəstəyini hədəf cihazlara əsasən qiymətləndirin; mənbələrdə müxtəlif cihazların fərqli formatları dəstəkləyə biləcəyi qeyd olunur.

Növbəti addımlar

İlkin quraşdırma və cihaz sınağından sonra hədəf Android cihazlarını və yayım formatını dəqiqləşdirin. Google Play-ə göndərməyi planlaşdırırsınızsa, aktual hədəf SDK tələblərini nəzərə alın: Epic-in sənədində 31 avqust 2025-ci ildən etibarən yeni tətbiqlər və yeniləmələr üçün Android 15 (API 35) hədəfinin tələb olunduğu, UE 5.7 və ya daha yenisinin bu dəstəyi təmin etdiyi bildirilir. Müxtəlif mağazaların tələbləri fərqlənə bildiyindən, müvafiq yayım təlimatlarını da nəzərdən keçirin.

Mənbə və lisenziya

Bu təlim Epic Games-in Unreal Engine Android Quick Start və Android layihələrinin paketlənməsi sənədlərindəki məlumatlar əsasında Azərbaycan dilinə uyğunlaşdırılıb. Hər iki mənbə Epic Games-in rəsmi tərtibatçı sənədləridir və açıq istifadə lisenziyası ilə təqdim olunur.