Google berkomitmen untuk mendorong terwujudnya keadilan rasial bagi komunitas Kulit Hitam. Lihat caranya.

Membuat multi-APK untuk ukuran layar yang berbeda-beda

Jika Anda memublikasikan aplikasi ke Google Play, sebaiknya build dan upload Android App Bundle. Setelah Anda melakukannya, Google Play akan otomatis membuat dan menayangkan APK yang dioptimalkan untuk setiap konfigurasi perangkat pengguna, sehingga pengguna hanya mendownload kode dan resource yang diperlukan untuk menjalankan aplikasi Anda. Memublikasikan multi-APK akan berguna jika Anda tidak memublikasikan aplikasi ke Google Play. Namun, Anda harus mem-build, menandatangani, dan mengelola setiap APK sendiri.

Saat mengembangkan aplikasi Android guna memanfaatkan multi-APK di Google Play, penting untuk menerapkan beberapa praktik terbaik dari awal, dan mencegah lebih banyak lagi kerumitan yang tidak perlu pada proses pengembangan. Tutorial ini menunjukkan cara membuat multi-APK aplikasi, yang masing-masing mencakup kelas ukuran layar yang berbeda. Anda juga akan mendapatkan beberapa alat yang diperlukan untuk mempermudah pemeliharaan codebase multi-APK.

Mengonfirmasi bahwa Anda memerlukan multi-APK

Saat mencoba membuat aplikasi yang berfungsi di berbagai ukuran perangkat Android, Anda tentu ingin agar aplikasi memanfaatkan semua ruang yang tersedia di perangkat yang lebih besar, tanpa mengorbankan kompatibilitas atau kegunaan pada layar yang lebih kecil. Mungkin di awal akan tampak seolah-olah dukungan multi-APK adalah solusi terbaik, tetapi ini sering kali tidak sesuai harapan. Bagian Menggunakan APK Tunggal pada panduan developer multi-APK berisi informasi yang berguna tentang cara menyelesaikan ini dengan satu APK, termasuk cara menggunakan support library kami. Anda juga harus membaca panduan untuk mendukung beberapa layar, dan bahkan ada support library yang dapat Anda download menggunakan SDK Android, yang memungkinkan Anda menggunakan fragmen pada perangkat pra-Honeycomb (membuat dukungan multi-layar dalam satu APK jauh lebih mudah).

Jika Anda dapat mengelolanya, membatasi aplikasi ke satu APK memiliki beberapa keuntungan, termasuk:

  • Publikasi dan pengujian lebih mudah
  • Hanya ada satu codebase yang harus dikelola
  • Aplikasi Anda dapat beradaptasi dengan perubahan konfigurasi perangkat
  • Pemulihan aplikasi berfungsi di seluruh perangkat
  • Anda tidak perlu khawatir tentang preferensi pasar, perilaku akibat "upgrade" dari satu APK ke APK berikutnya, atau kesesuaian APK dengan tiap kelas perangkatnya

Bagian selanjutnya dari tutorial ini mengasumsikan bahwa Anda telah meneliti topik, mempelajari materi dalam referensi yang ditautkan, dan menentukan bahwa multi-APK adalah jalur yang tepat untuk aplikasi Anda.

Membuat diagram kebutuhan Anda

Mulailah dengan membuat diagram sederhana untuk menentukan dengan cepat berapa banyak APK yang Anda butuhkan, dan ukuran layar yang dicakup setiap APK. Untungnya, tidak sulit membuat diagram kebutuhan Anda secara cepat, mudah, dan memiliki referensi untuk nanti. Mulailah dengan deretan sel yang merepresentasikan berbagai ukuran layar yang tersedia di platform Android.

small normal large xlarge

Sekarang warnai diagram sehingga setiap warna merepresentasikan APK. Berikut adalah salah satu contoh cara aar Anda dapat menerapkan setiap APK pada rentang ukuran layar tertentu.

small normal large xlarge

Tergantung kebutuhan, Anda juga dapat memiliki dua APK, “small dan lainnya”, atau “xlarge dan lainnya”. Pemberian warna pada diagram juga mempermudah komunikasi antar-tim. Kini Anda cukup menyebut setiap APK sebagai “biru”, “hijau”, atau “merah”, berapa pun banyaknya jenis layar yang tercakup.

Memasukkan semua kode umum dan resource dalam project library

Baik Anda memodifikasi aplikasi Android yang ada atau memulai dari awal, ini adalah hal pertama yang harus Anda lakukan pada codebase, dan sejauh ini merupakan hal yang paling penting. Semua yang masuk ke project library hanya perlu diupdate sekali (pertimbangkan string yang dilokalkan dari segi bahasa, tema warna, bug yang diperbaiki dalam kode bersama), yang mempersingkat waktu pengembangan Anda serta mengurangi kemungkinan terjadinya kesalahan yang dapat dihindari dengan mudah.

Catatan: Meskipun detail penerapan tentang cara membuat dan menyertakan project library berada di luar cakupan tutorial ini, Anda dapat memperoleh informasi selengkapnya dengan membaca Membuat Library Android.

Jika Anda mengonversi aplikasi yang ada untuk menggunakan dukungan multi-APK, periksa codebase untuk setiap file string yang dilokalkan, daftar nilai, warna tema, tata letak dan ikon menu yang tidak akan berubah di seluruh APK, lalu masukkan semuanya dalam project library. Kode yang tidak akan banyak berubah juga harus dimasukkan ke project library. Anda mungkin perlu memperluas class ini untuk menambahkan satu atau dua metode dari APK ke APK.

Sebaliknya, jika Anda membuat aplikasi dari awal, cobalah sebisa mungkin untuk menulis kode dalam project library terlebih dahulu, lalu pindahkan ke APK individual jika perlu. Cara ini jauh lebih mudah untuk dikelola dalam jangka panjang daripada menambahkannya ke satu library, lalu ke library lain, dan yang lainnya lagi, kemudian beberapa bulan ke depan mencoba mencari tahu apakah blob ini dapat dipindahkan ke bagian library tanpa mengacaukan apa pun.

Membuat project APK baru

Harus ada project Android terpisah untuk setiap APK yang akan Anda rilis. Untuk memudahkan pengaturan, masukkan project library dan semua project APK terkait dalam folder induk yang sama. Ingat juga bahwa setiap APK harus memiliki nama paket yang sama, meskipun tidak harus sama dengan library. Jika Anda memiliki 3 APK yang mengikuti skema yang dijelaskan sebelumnya, direktori utama Anda mungkin akan terlihat seperti berikut:

    alexlucas:~/code/multi-apks-root$ ls
    foo-blue
    foo-green
    foo-lib
    foo-red
    

Setelah project dibuat, tambahkan project library sebagai referensi untuk setiap project APK. Jika dimungkinkan, tentukan Aktivitas awal Anda dalam project library, lalu perluas Aktivitas tersebut dalam project APK Anda. Dengan adanya aktivitas awal yang ditentukan dalam project library, Anda memiliki peluang untuk menempatkan semua inisialisasi aplikasi di satu tempat, sehingga setiap APK tidak harus menerapkan ulang tugas "universal" seperti menginisialisasi Analytics, menjalankan pemeriksaan pemberian lisensi, dan prosedur inisialisasi lainnya yang tidak banyak berubah dari APK ke APK.

Menyesuaikan manifes

Saat pengguna mendownload aplikasi yang menggunakan multi-APK melalui Google Play, APK yang tepat untuk digunakan akan dipilih dengan dua aturan sederhana:

  • Manifes harus menunjukkan bahwa APK tersebut memenuhi syarat
  • Dari APK yang memenuhi syarat, nomor versi tertinggi akan menang

Contohnya, mari lihat beberapa APK yang dijelaskan sebelumnya, dan asumsikan bahwa setiap APK telah ditetapkan untuk mendukung semua ukuran layar yang lebih besar dari ukuran layar “target”. Jika dilihat secara terpisah, kemungkinan rentang setiap APK akan terlihat seperti berikut:

small normal large xlarge
small normal large xlarge
small normal large xlarge

Namun, dengan menggunakan aturan "nomor versi tertinggi yang menang", jika kita menetapkan atribut versionCode di setiap APK seperti merah ≥ hijau ≥ biru, diagram akan secara efektif menciut menjadi seperti ini:

small normal large xlarge

Sekarang, mari asumsikan bahwa APK Merah memiliki beberapa persyaratan yang tidak dimiliki oleh dua yang lain. Halaman Filter di Google Play pada panduan Developer Android memiliki daftar lengkap kemungkinan penyebabnya. Sebagai contoh, anggaplah warna merah membutuhkan kamera depan. Faktanya, tujuan APK Merah secara keseluruhan adalah menggunakan ruang layar ekstra yang tersedia untuk menjalankan hal-hal terkait hiburan dengan kamera depan. Namun, ternyata, tidak semua perangkat xlarge MEMILIKI kamera depan. Mengejutkan!

Untungnya, jika pengguna menjelajahi Google Play dari salah satu perangkat tersebut, Google Play akan melihat manifes tersebut, melihat bahwa Merah mencantumkan kamera depan sebagai persyaratan, dan diam-diam mengabaikannya, yang kemudian menentukan bahwa Merah dan perangkat tersebut tidak berjodoh di dunia digital. Kemudian akan terlihat bahwa Hijau tidak hanya kompatibel dengan perangkat xlarge, tetapi juga tidak peduli apakah ada kamera depan atau tidak! Aplikasi masih dapat didownload dari Google Play oleh pengguna, karena meskipun terjadi hal tak terduga dengan kamera depan, masih ada APK yang mendukung ukuran layar tersebut.

Untuk menyimpan semua APK di “jalur” yang terpisah, penting untuk memiliki skema kode versi yang baik. Fitur yang direkomendasikan dapat ditemukan di area Kode Versi dalam panduan developer kami. Karena contoh kumpulan APK hanya menangani satu dari tiga dimensi, APK cukup dipisah per 1000 APK dan tingkatkan mulai dari angka tersebut. Ini mungkin terlihat seperti:

Biru: 1001, 1002, 1003, 1004...
Hijau: 2001, 2002, 2003, 2004...
Red:3001, 3002, 3003, 3004...

Dengan menyatukan semuanya, Manifes Android Anda mungkin akan terlihat seperti berikut:

Biru:

    <manifest xmlns:android="http://schemas.android.com/apk/res/android"
        android:versionCode="1001" android:versionName="1.0" package="com.example.foo">
        <supports-screens android:smallScreens="true"
            android:normalScreens="true"
            android:largeScreens="true"
            android:xlargeScreens="true" />
        ...
    

Hijau:

    <manifest xmlns:android="http://schemas.android.com/apk/res/android"
        android:versionCode="2001" android:versionName="1.0" package="com.example.foo">
        <supports-screens android:smallScreens="false"
            android:normalScreens="false"
            android:largeScreens="true"
            android:xlargeScreens="true" />
        ...
    

Merah:

    <manifest xmlns:android="http://schemas.android.com/apk/res/android"
        android:versionCode="3001" android:versionName="1.0" package="com.example.foo">
        <supports-screens android:smallScreens="false"
            android:normalScreens="false"
            android:largeScreens="false"
            android:xlargeScreens="true" />
        ...
    

Perhatikan bahwa secara teknis, beberapa APK akan berfungsi dengan tag supports-screens, atau tag compatible-screens. Supports-screens biasanya lebih disukai, dan secara umum, menggunakan kedua tag dalam manifes yang sama adalah ide buruk. Hal ini membuat segalanya semakin rumit, dan meningkatkan kemungkinan untuk error. Selain itu, perhatikan juga bahwa bukan lagi memanfaatkan nilai default (small dan normal selalu true secara default), tetapi manifes secara eksplisit menetapkan nilai untuk setiap ukuran layar. Hal ini tidak akan membuat Anda pusing. Sebagai contoh, manifes dengan SDK target < 9 akan memiliki xlarge yang ditetapkan ke false secara otomatis, karena ukuran tersebut belum ada. Jadi, harus jelas!

Meninjau checklist pra-peluncuran Anda

Sebelum mengupload ke Google Play, periksa kembali item berikut. Ingat bahwa hal ini secara khusus relevan dengan multi-APK, dan sama sekali tidak merepresentasikan checklist lengkap untuk semua aplikasi yang diupload ke Google Play.

  • Semua APK harus memiliki nama paket yang sama
  • Semua APK harus ditandatangani dengan sertifikat yang sama
  • Setiap ukuran layar yang Anda inginkan agar mendukung APK, tetapkan ke true di manifes. Setiap ukuran layar yang ingin Anda hindari, tetapkan ke false
  • Periksa lagi filter manifes Anda untuk informasi yang konflik (APK yang hanya mendukung cupcake di layar XLARGE tidak akan terlihat oleh siapa pun)
  • Setiap manifes APK harus unik di setidaknya satu dari layar, tekstur OpenGL, atau versi platform yang didukung
  • Coba uji setiap APK pada setidaknya satu perangkat. Jika tidak, Anda juga memiliki salah satu emulator perangkat yang paling dapat disesuaikan dalam bisnis yang ada di mesin pengembangan Anda. Cobalah!

Sebaiknya periksa juga APK yang telah dikompilasi sebelum meluncurkannya ke pasar, untuk memastikan tidak ada hal tak terduga yang dapat menyembunyikan aplikasi Anda di Google Play. Penggunaan alat "aapt" sebenarnya cukup sederhana. Aapt (Android Asset Packaging Tool) adalah bagian dari proses build untuk membuat dan memaketkan aplikasi Android Anda, dan juga merupakan alat yang sangat berguna untuk memeriksanya.

    >aapt dump badging
    package: name='com.example.hello' versionCode='1' versionName='1.0'
    sdkVersion:'11'
    uses-permission:'android.permission.SEND_SMS'
    application-label:'Hello'
    application-icon-120:'res/drawable-ldpi/icon.png'
    application-icon-160:'res/drawable-mdpi/icon.png'
    application-icon-240:'res/drawable-hdpi/icon.png'
    application: label='Hello' icon='res/drawable-mdpi/icon.png'
    launchable-activity: name='com.example.hello.HelloActivity'  label='Hello' icon=''
    uses-feature:'android.hardware.telephony'
    uses-feature:'android.hardware.touchscreen'
    main
    supports-screens: 'xlarge'
    supports-any-density: 'true'
    locales: '--_--'
    densities: '120' '160' '240'
    

Saat memeriksa output aapt, pastikan untuk memeriksa bahwa Anda tidak memiliki nilai yang bertentangan untuk supports-screens dan compatible-screens, serta Anda tidak memiliki nilai-nilai "uses-feature" yang tidak diinginkan yang ditambahkan sebagai akibat dari izin yang ditetapkan dalam manifes. Pada contoh di atas, APK tidak akan terlihat oleh sebagian besar perangkat, jika tidak semuanya.

Apa alasannya? Dengan menambahkan izin yang diperlukan SEND_SMS, persyaratan fitur android.hardware.telephony ditambahkan secara implisit. Karena sebagian besar (jika tidak semua) perangkat xlarge adalah tablet tanpa hardware ponsel di dalamnya, Google Play akan memfilter APK dalam kasus ini, hingga perangkat di masa mendatang akan hadir dengan ukuran yang cukup besar untuk dilaporkan sebagai ukuran layar xlarge, dan memiliki hardware ponsel.

Untungnya, hal ini dapat diperbaiki dengan menambahkan kode berikut ke manifes:

    <uses-feature android:name="android.hardware.telephony" android:required="false" />
    

Persyaratan android.hardware.touchscreen juga ditambahkan secara implisit. Jika ingin APK terlihat di TV yang bukan merupakan perangkat layar sentuh, Anda harus menambahkan kode berikut ke manifes:

    <uses-feature android:name="android.hardware.touchscreen" android:required="false" />
    

Setelah Anda melengkapi checklist pra-peluncuran, upload APK ke Google Play. Mungkin diperlukan beberapa saat agar aplikasi muncul saat menjelajahi Google Play. Namun saat aplikasi muncul, lakukan satu pemeriksaan terakhir. Download aplikasi ke perangkat uji apa pun yang mungkin Anda miliki untuk memastikan bahwa APK menargetkan perangkat yang dituju.

Untuk informasi selengkapnya tentang dukungan multi-APK, baca Dukungan multi-APK.