Ikuti serangkaian webinar gratis untuk membantu mengembangkan bisnis Anda di Google Play. Daftar sekarang

Mendukung arsitektur 64 bit

Mulai 1 Agustus 2019, semua aplikasi yang dipublikasikan di Google Play harus mendukung arsitektur 64 bit. CPU 64-bit memberikan pengalaman yang lebih cepat dan lebih interaktif kepada pengguna. Penambahan aplikasi dalam versi 64-bit akan memberikan peningkatan performa, membuka peluang inovasi di masa depan, dan membuat Anda siap untuk menerapkan aplikasi pada perangkat yang menggunakan hardware 64-bit.

Panduan ini menjelaskan langkah-langkah yang dapat Anda lakukan sekarang untuk memastikan bahwa aplikasi 32-bit Anda siap mendukung perangkat 64-bit.

Menilai aplikasi Anda

Jika aplikasi Anda hanya menggunakan kode yang ditulis dalam bahasa pemrograman Java atau Kotlin, termasuk semua library atau SDK, berarti aplikasi Anda sudah siap untuk perangkat 64 bit. Jika aplikasi Anda menggunakan kode native, atau Anda tidak yakin kode apa yang digunakan, sebaiknya nilai aplikasi Anda dan ambil tindakan.

Pemeriksaan status cepat

Untuk memeriksa dengan cepat apakah aplikasi Anda siap untuk persyaratan 64 bit atau tidak, buka Konsol Play lalu tinjau rilis yang sudah ada untuk melihat apakah rilis tersebut telah mematuhi persyaratan:

Jika terdapat masalah terkait persyaratan 64 bit, Konsol Play akan menampilkan peringatan untuk rilis draf Anda. Berikut ini contohnya:

Jika Anda melihat peringatan, ikuti langkah berikut untuk menyiapkan aplikasi.

Apakah aplikasi Anda menggunakan kode native?

Hal pertama yang harus dilakukan adalah memeriksa apakah aplikasi Anda menggunakan kode native. Aplikasi Anda menggunakan kode native jika:

  • Menggunakan kode C/C ++ (native) pada aplikasi.
  • Terhubung dengan library native pihak ketiga.
  • Dibuat oleh pembuat aplikasi pihak ketiga yang menggunakan library native.

Apakah aplikasi Anda menyertakan library 64-bit?

Cara paling sederhana untuk memeriksa ketersediaan library 64-bit pada aplikasi adalah dengan memeriksa struktur file APK Anda. Saat dibuat, APK akan dikemas dengan semua library native yang diperlukan oleh aplikasi. Library native disimpan di berbagai folder berdasarkan ABI. Anda tidak harus mendukung setiap arsitektur 64 bit, tetapi untuk setiap arsitektur 32 bit native yang Anda dukung, Anda harus menyertakan arsitektur 64 bit yang terkait.

Untuk arsitektur ARM, library 32 bit ada di armeabi-v7a dan untuk 64-bit di arm64-v8a.

Untuk arsitektur x86, temukan x86 untuk 32 bit dan x86_64 untuk 64 bit.

Hal pertama yang perlu dilakukan adalah memastikan bahwa Anda memiliki library native di kedua folder ini. Ringkasnya:

Platform Folder library 32-bit Folder library 64-bit
ARM lib/armeabi-v7a lib/arm64-v8a
x86 lib/x86 lib/x86_64

Perlu diingat bahwa bergantung pada aplikasi Anda, mungkin akan ada set library yang sama persis di setiap folder, mungkin juga tidak. Tujuannya adalah untuk memastikan bahwa aplikasi Anda berjalan dengan benar di lingkungan 64-bit.

Pada umumnya, APK atau paket yang dibuat untuk arsitektur 32-bit dan 64-bit akan memiliki folder untuk kedua ABI, masing-masing dengan set library native yang terkait. Jika tidak ada dukungan untuk 64-bit, Anda akan melihat folder ABI 32-bit tetapi tidak melihat folder 64-bit.

Mencari library native menggunakan APK Analyzer

APK Analyzer adalah fitur yang memungkinkan Anda mengevaluasi berbagai aspek APK yang dibuat. Dalam kasus ini, kita akan menggunakannya untuk menemukan library native, dan memastikan library 64 bit ada.

  1. Buka Android Studio, lalu buka project apa saja.
  2. Dari menu, pilih Build > Analyze APK

    meluncurkan APK analyzer

  3. Pilih APK yang ingin Anda evaluasi.

  4. Lihat di dalam folder lib, tempat Anda akan menemukan file '.so'. Jika file '.so' tidak dapat ditemukan pada aplikasi Anda, berarti aplikasi Anda sudah siap dan Anda tidak perlu melakukan tindakan apa pun. Jika Anda melihat armeabi-v7a atau x86, berarti Anda memiliki library 32-bit.

  5. Periksa untuk memastikan ada file '.so' yang serupa di folder arm64-v8a atau x86_64.

    meluncurkan APK analyzer

  6. Jika library arm64-v8a atau x86_64 tidak ada, Anda perlu mengupdate proses build untuk mulai membuat dan mengemas artefak tersebut dalam APK Anda.

  7. Jika kedua library sudah dikemas, Anda dapat beralih ke Menguji aplikasi pada perangkat 64-bit.

Mencari library native dengan mengekstrak APK

File APK memiliki struktur seperti file zip, dan juga dapat diekstrak. Jika Anda lebih suka menggunakan command line atau fitur ekstraksi lainnya, mengekstrak APK cocok untuk Anda.

Cukup ekstrak file APK (bergantung pada software ekstraksinya, Anda mungkin perlu mengubah nama file menjadi .zip) dan cari file yang telah diekstrak. Ikuti panduan di atas untuk mengetahui apakah Anda siap mendukung perangkat 64-bit.

Misalnya, Anda dapat menjalankan perintah berikut dari command line:

:: Command Line
    > zipinfo -1 YOUR_APK_FILE.apk | grep \.so$
    lib/armeabi-v7a/libmain.so
    lib/armeabi-v7a/libmono.so
    lib/armeabi-v7a/libunity.so
    lib/arm64-v8a/libmain.so
    lib/arm64-v8a/libmono.so
    lib/arm64-v8a/libunity.so
    

Perhatikan bahwa dalam contoh ini, library armeabi-v7a dan arm64-v8a ada, yang berarti aplikasi Anda mendukung arsitektur 64-bit.

Membuat aplikasi dengan library 64-bit

Berikut ini adalah petunjuk untuk membuat library 64-bit. Namun, perlu Anda ketahui bahwa petunjuk ini hanya mencakup pembuatan kode dan library yang dapat Anda buat dari sumber.

Jika Anda menggunakan SDK atau library eksternal, pastikan Anda menggunakan versi 64-bit dengan mengikuti langkah-langkah di atas. Hubungi pemilik SDK atau library jika versi 64-bit tidak tersedia, dan pertimbangkan hal ini saat merencanakan dukungan Anda untuk perangkat 64-bit.

Membuat aplikasi dengan Android Studio atau Gradle

Sebagian besar project Android Studio menggunakan Gradle sebagai sistem build yang mendasarinya, sehingga bagian ini berlaku pada kedua kasus. Untuk mengaktifkan build untuk kode native, Anda hanya perlu menambahkan arm64-v8a dan/atau x86_64 (tergantung arsitektur yang ingin Anda dukung) ke setelan ndk.abiFilters pada file 'build.gradle' aplikasi Anda:

// Your app's build.gradle
    apply plugin: 'com.android.app'

    android {
       compileSdkVersion 27
       defaultConfig {
           appId "com.google.example.64bit"
           minSdkVersion 15
           targetSdkVersion 28
           versionCode 1
           versionName "1.0"
           ndk.abiFilters 'armeabi-v7a','arm64-v8a','x86','x86_64'
    // ...
    

Membuat aplikasi dengan CMake

Jika aplikasi Anda dibuat menggunakan CMake, Anda dapat membuat build untuk ABI 64 bit dengan meneruskan arm64-v8a ke parameter '-DANDROID_ABI':

:: Command Line
    > cmake -DANDROID_ABI=arm64-v8a … or
    > cmake -DANDROID_ABI=x86_64 …
    

Opsi ini tidak berpengaruh jika Anda menggunakan externalNativeBuild. Lihat bagian Membuat aplikasi dengan Gradle.

Membuat aplikasi dengan ndk-build

Jika aplikasi Anda dibuat dengan ndk-build, Anda dapat membuat build untuk ABI 64 bit dengan memodifikasi file 'Application.mk' menggunakan variabel APP_ABI:

APP_ABI := armeabi-v7a arm64-v8a x86 x86_64
    

Opsi ini tidak berpengaruh jika Anda menggunakan externalNativeBuild. Lihat bagian Membuat aplikasi dengan Gradle.

Melakukan porting kode 32 bit ke 64 bit

Jika kode Anda sudah berjalan pada desktop atau iOS, Anda tidak perlu melakukan tindakan tambahan untuk Android. Jika ini pertama kalinya Anda membuat kode untuk sistem 64 bit, masalah utama yang perlu Anda atasi adalah pointer yang tidak lagi sesuai dengan jenis integer 32 bit, seperti int. Anda perlu mengupdate kode yang menyimpan pointer dalam jenis seperti int, unsigned, atau uint32_t. Pada sistem Unix, long akan mencocokkan ukuran pointer, tetapi berbeda halnya pada Windows. Jadi, Anda perlu menggunakan jenis yang menampakkan intent, seperti uintptr_t atau intptr_t. Gunakan jenis ptrdiff_t untuk menyimpan perbedaan antara kedua pointer.

Anda harus selalu memprioritaskan jenis integer lebar tetap yang spesifik yang ditentukan dalam <stdint.h>, bukannya jenis tradisional seperti int atau long, bahkan untuk non-pointer.

Gunakan flag compiler berikut untuk merekam kasus saat kode Anda salah mengonversi antara pointer dan integer:

-Werror=pointer-to-int-cast
    -Werror=int-to-pointer-cast
    -Werror=shorten-64-to-32
    

Class Java dengan kolom int yang menampung pointer untuk objek C/C++ memiliki masalah yang sama. Telusuri jint di sumber JNI Anda dan pastikan Anda beralih ke long pada sistem Java dan jlong pada sistem C++.

Deklarasi fungsi implisit lebih berbahaya lagi untuk kode 64 bit. C/C++ menganggap bahwa jenis kembalian dari fungsi yang dideklarasikan secara implisit (artinya fungsi yang deklarasinya belum dilihat oleh compiler) adalah int. Jika jenis kembalian sebenarnya untuk fungsi Anda berupa pointer, jenis kembalian ini akan berfungsi dengan baik pada sistem 32 bit di mana pointer akan sesuai dengan int. Namun, pada sistem 64 bit, compiler akan berada di separuh bagian atas pointer Anda. Contoh:

// This function returns a pointer:
    // extern char* foo();

    // If you don't include a header that declares it,
    // when the compiler sees this:
    char* result = foo();

    // Instead of compiling that to:
    result = foo();

    // It compiles to something equivalent to:
    result = foo() & 0xffffffff;

    // Which will then cause a SIGSEGV if you try to dereference `result`.
    

Flag compiler berikut mengubah peringatan deklarasi fungsi implisit menjadi error sehingga Anda dapat menemukan dan memperbaiki masalah ini dengan lebih mudah:

-Werror=implicit-function-declaration
    

Jika menggunakan assembler inline, Anda harus menulis ulang flag compiler atau menggunakan implementasi C/C++ biasa.

Jika Anda memiliki ukuran jenis hard code (misalnya 8 atau 16 byte), ganti dengan ekspresi sizeof(T) yang setara, seperti sizeof(void*).

Jika Anda perlu mengompilasi kode yang berbeda secara kondisional untuk 32 bit dan 64 bit, Anda dapat menggunakan #if defined(__LP64__) untuk perbedaan 32/64 umum, atau __arm__, __aarch64__ (arm64), __i386__ (x86), dan __x86_64__ untuk arsitektur tertentu yang didukung oleh Android.

Anda perlu menyesuaikan string format untuk fungsi yang menyerupai printf atau scanf, karena penentu format tradisional tidak mengizinkan Anda untuk menentukan jenis 64 bit dengan cara yang benar untuk perangkat 32 bit dan juga 64 bit. Makro PRI dan SCN di <inttypes.h> dapat mengatasi masalah ini, PRIxPTR dan SCNxPTR untuk membaca/menulis pointer hex, serta PRId64 dan SCNd64 untuk menulis/membaca nilai 64 bit secara portabel.

Saat melakukan peralihan, Anda perlu menggunakan 1ULL untuk beralih ke konstanta 64 bit, bukannya menggunakan 1, yang hanya 32 bit.

Mengurangi dampak peningkatan ukuran dengan Android App Bundle

Penambahan dukungan arsitektur 64 bit ke aplikasi dapat menyebabkan ukuran APK meningkat. Kami sangat merekomendasikan penggunaan fitur Android App Bundle untuk meminimalkan dampak peningkatan ukuran pada native code 32 dan 64 bit dalam APK yang sama.

Pengalihan aplikasi Anda ke Android App Bundle dapat memperbaiki ukuran APK, dengan menguranginya hingga lebih kecil daripada ukuran saat ini.

Developer game

Kami memahami bahwa memigrasikan mesin game pihak ketiga adalah proses yang intensif dengan waktu pengerjaan yang lama. Untungnya, tiga mesin yang paling sering digunakan sudah mendukung 64-bit:

  • Unreal sejak 2015
  • Cocos2d sejak 2015
  • Unity sejak 2018

Developer Unity

Upgrade ke versi yang mendukung

Unity mulai menyediakan dukungan 64 bit pada versi 2018.2 & 2017.4.16.

Jika menggunakan versi Unity yang tidak mendukung 64-bit, tentukan ke versi mana Anda ingin mengupgrade, dan ikuti panduan yang disediakan Unity untuk memigrasikan lingkungan Anda dengan memastikan bahwa aplikasi Anda diupgrade ke versi yang dapat membuat library 64-bit. Unity merekomendasikan Anda memiliki akses ke fitur dan update terkini dengan mengupgrade ke versi LTS editor terbaru.

Berikut adalah diagram yang merangkum berbagai versi Unity dan tindakan yang perlu Anda lakukan:

Versi Unity Mendukung 64-bit? Tindakan yang disarankan

2018.4 (LTS)

✔️

(Menunggu rilis) Pastikan setelan build Anda menghasilkan library 64-bit.

2018.3

✔️

Pastikan setelan build Anda menghasilkan library 64-bit.

2018.2

✔️

Pastikan setelan build Anda menghasilkan library 64-bit.

2018.1

Memberikan dukungan 64-bit eksperimental.

2017.4 (LTS)

✔️

Didukung pada 2017.4.16. Pastikan setelan build Anda menghasilkan library 64-bit.

2017.3

✖️

Upgrade ke versi yang mendukung 64 bit.

2017.2

✖️

Upgrade ke versi yang mendukung 64 bit.

2017.1

✖️

Upgrade ke versi yang mendukung 64 bit.

<=5.6

✖️

Upgrade ke versi yang mendukung 64 bit.

Mengubah setelan build untuk menghasilkan library 64 bit

Jika menggunakan versi Unity yang mendukung library Android 64 bit, Anda dapat membuat aplikasi versi 64 bit dengan menyesuaikan setelan build. Anda juga perlu menggunakan backend IL2CPP sebagai Scripting Backend Anda (selengkapnya di sini). Untuk menyiapkan project Unity Anda guna membuat arsitektur 64-bit, lakukan hal berikut:

  1. Buka Build Settings dan pastikan Anda membuat build untuk Android dengan memverifikasi bahwa simbol Unity berada di sebelah Platform Android.**
    1. Jika simbol Unity tidak berada di sebelah Platform Android, pilih Android dan klik Switch Platform.
  2. Klik Player settings.

    Player settings di Unity

  3. Buka Player Settings Panel > Settings for Android > Other settings > Configuration

  4. Tetapkan Scripting Backend ke IL2CPP.

  5. Pilih kotak centang **Target Architecture > ARM64.

    menetapkan arsitektur target di Unity

  6. Buat build seperti biasa!

Perhatikan bahwa pembuatan build ARM64 akan mewajibkan semua aset Anda dibuat khusus untuk platform tersebut. Ikuti panduan Unity untuk mengurangi ukuran APK, dan pertimbangkan untuk memanfaatkan fitur Android App Bundle untuk membantu mengurangi peningkatan ukuran.

Kepatuhan terhadap persyaratan arsitektur 64 bit dan Multi-APK

Jika Anda menggunakan dukungan multi-APK dari Google Play untuk memublikasikan aplikasi, perhatikan bahwa kepatuhan terhadap persyaratan 64 bit akan dievaluasi pada tingkat rilis. Namun, persyaratan 64 bit ini tidak berlaku untuk APK atau app bundle yang tidak didistribusikan ke perangkat yang menjalankan Android 9 (Pie) atau yang lebih baru.

Jika salah satu APK Anda ditandai sebagai APK yang tidak mematuhi kebijakan, tetapi versinya lebih lama dan tidak mungkin dibuat mematuhi persyaratan, salah satu strateginya adalah dengan menambahkan atribut maxSdkVersion="27" pada elemen uses-sdk dalam manifes APK tersebut. APK ini tidak akan dikirim ke perangkat yang menjalankan Android 9 (Pie) atau yang lebih baru, dan tidak lagi memblokir kepatuhan.

Kepatuhan terhadap arsitektur 64 bit dan RenderScript

Jika aplikasi Anda menggunakan RenderScript dan dibuat dengan Android Tools versi lama, aplikasi Anda mungkin akan mengalami masalah kepatuhan terhadap persyaratan arsitektur 64 bit. Pada fitur build sebelum versi 21.0.0, compiler dapat membuat bitcode ke dalam file .bc eksternal. File .bc lama ini tidak lagi didukung untuk arsitektur 64 bit, jadi keberadaan file tersebut di dalam APK akan mengakibatkan masalah kepatuhan.

Untuk mengatasi masalah ini, hapus semua file .bc di project Anda, upgrade lingkungan Anda ke build-tools-21.0.0 atau yang lebih baru, dan tetapkan renderscriptTargetApi di Android Studio ke versi 21+, untuk memberi tahu compiler agar tidak menghasilkan file .bc. Lalu, buat ulang aplikasi Anda, periksa apakah file .bc ada, dan upload ke Konsol Play.

Menguji aplikasi pada hardware 64 bit

Aplikasi versi 64-bit Anda harus menawarkan kualitas dan fitur yang sama dengan versi 32-bit. Uji aplikasi Anda untuk memastikan bahwa pengguna yang menggunakan perangkat 64-bit terbaru mendapatkan pengalaman terbaik pada aplikasi Anda.

Untuk mulai menguji aplikasi, Anda harus memiliki perangkat yang mendukung 64-bit. Ada berbagai perangkat populer yang tersedia dan mendukung 64-bit, seperti Google Pixel dan perangkat unggulan lainnya.

Cara termudah untuk menguji APK Anda adalah dengan menginstal aplikasi menggunakan adb. Pada kebanyakan kasus, Anda dapat menyediakan --abi sebagai parameter untuk menunjukkan library yang akan diinstal ke perangkat. Tindakan ini akan menginstal aplikasi dengan hanya library 64-bit di perangkat.

:: Command Line
    # A successful install:
    > adb install --abi armeabi-v7a YOUR_APK_FILE.apk
    Success

    # If your APK does not have the 64-bit libraries:
    > adb install --abi arm64-v8a YOUR_APK_FILE.apk
    adb: failed to install YOUR_APK_FILE.apk: Failure [INSTALL_FAILED_NO_MATCHING_ABIS: Failed to extract native libraries, res=-113]

    # If your device does not support 64-bit, an emulator, for example:
    > adb install --abi arm64-v8a YOUR_APK_FILE.apk
    ABI arm64-v8a not supported on this device
    

Setelah Anda berhasil menginstal, uji aplikasi seperti biasanya untuk memastikan kualitasnya sama dengan versi 32-bit.

Memublikasikan

Setelah merasa aplikasi Anda siap, publikasikan seperti biasa. Jangan lupa untuk terus mengikuti praktik terbaik dalam menerapkan aplikasi Anda. Sebaiknya manfaatkan track pengujian tertutup untuk meluncurkan aplikasi ke sejumlah kecil pengguna guna memastikan kualitas aplikasi Anda konsisten.

Seperti saat meluncurkan update besar, pastikan Anda telah menjalankan pengujian secara menyeluruh pada perangkat yang mendukung 64-bit sebelum memublikasikan ke audiens yang lebih besar.