Mengaktifkan pengoptimalan aplikasi dengan R8

android skills add --skill r8-analyzer

Untuk pengalaman pengguna terbaik, Anda harus mengoptimalkan aplikasi agar berukuran sekecil dan secepat mungkin. Pengoptimal aplikasi kami, yang disebut R8, menyederhanakan aplikasi Anda dengan menghapus kode dan resource yang tidak digunakan, menulis ulang kode untuk mengoptimalkan performa runtime, dan lainnya. Bagi pengguna, hal ini berarti:

• Waktu mulai lebih cepat
• Penggunaan memori yang lebih rendah
• Peningkatan performa rendering dan runtime
• Lebih sedikit ANR

Ringkasan pengoptimalan R8

R8 menggunakan proses multi-fase untuk mengoptimalkan ukuran dan kecepatan aplikasi Anda. Operasi utama mencakup hal berikut:

• Penyingkatan kode (disebut juga tree shaking): R8 mengidentifikasi dan menghapus kode yang tidak dapat dijangkau dari aplikasi Anda dan dependensi library-nya. Dengan menganalisis titik entri aplikasi Anda (seperti Activities atau Services yang ditentukan dalam manifes), R8 membuat grafik kode yang direferensikan dan menghapus semua yang tetap tidak direferensikan.

• Pengoptimalan logis: R8 menulis ulang kode Anda untuk meningkatkan efisiensi eksekusi dan mengurangi overhead. Teknik utama mencakup:

  • Inlining metode: R8 mengganti situs panggilan metode dengan isi sebenarnya dari metode yang dipanggil. Hal ini menghilangkan overhead panggilan fungsi dan memungkinkan R8 melakukan pengoptimalan lebih lanjut.

  • Penggabungan class: R8 menggabungkan kumpulan class dan antarmuka menjadi satu class. Hal ini mengurangi jumlah class dalam aplikasi, menurunkan tekanan memori, dan meningkatkan kecepatan startup.

• Obfuscation (disebut juga minifikasi): Untuk mengurangi ukuran file DEX file, R8 mempersingkat nama class, kolom, dan metode (misalnya, com.example.MyActivity dapat menjadi a.b.a).

Sejak versi 8.12.0 plugin Android Gradle (AGP), R8 juga mengoptimalkan resource sebagai bagian dari fase pengoptimalannya. Untuk mengetahui informasi selengkapnya, lihat Penyingkatan resource yang dioptimalkan.

Mengaktifkan pengoptimalan

Untuk mengaktifkan pengoptimalan aplikasi, gunakan DSL yang sesuai berdasarkan versi AGP project Anda. Sebaiknya aktifkan pengoptimalan aplikasi hanya di versi final aplikasi yang Anda uji sebelum dipublikasikan—biasanya build rilis—karena pengoptimalan meningkatkan waktu build project Anda dan dapat membuat proses debug lebih sulit karena cara pengoptimalan mengubah kode.

Untuk AGP versi 9.3 dan yang lebih tinggi

Untuk mengaktifkan pengoptimalan aplikasi untuk AGP 9.3 dan yang lebih tinggi:

• Tetapkan enable = true di blok optimization dalam skrip build tingkat aplikasi build rilis Anda.
• Tambahkan aturan keep Anda ke file dengan akhiran .keep di src/<variant>/keepRules set sumber. Misalnya, src/main/keepRules/custom-rules.keep.

android {
    buildTypes {
        release {
            optimization {
                enable = true // Enables code and resource optimizations.
            }
        }
    }
}

android {
    buildTypes {
        release {
            optimization {
                enable = true // Enables code and resource optimizations.
            }
        }
    }
}

DSL lama untuk AGP versi yang lebih rendah dari 9.3

Untuk mengaktifkan pengoptimalan aplikasi, tetapkan isMinifyEnabled = true (untuk pengoptimalan kode) dan isShrinkResources = true (untuk pengoptimalan resource) dalam skrip build tingkat aplikasi build rilis Anda. Sebaiknya selalu aktifkan kedua setelan tersebut.

android {
    buildTypes {
        release {

            // Enables code optimizations.
            isMinifyEnabled = true

            // Enables resource shrinking.
            isShrinkResources = true

            proguardFiles(
                // Default file with automatically generated optimization rules.
                getDefaultProguardFile("proguard-android-optimize.txt"),

                ...
            )
            ...
        }
    }
    ...
}

android {
    buildTypes {
        release {

            // Enables code optimizations.
            minifyEnabled = true

            // Enables resource shrinking.
            shrinkResources = true

            // Default file with automatically generated optimization rules.
            proguardFiles getDefaultProguardFile('proguard-android-optimize.txt')

            ...
        }
    }
}

Meningkatkan pengoptimalan R8

Manfaat performa R8 berkorelasi langsung dengan seberapa banyak codebase yang dapat dioptimalkan R8. Untuk mendapatkan manfaat maksimal dari R8, ikuti praktik terbaik:

• Aktifkan R8 dalam mode penuh
• Aktifkan obfuscation, pengoptimalan, dan penyingkatan
• Aktifkan penyingkatan resource dan penyingkatan resource yang dioptimalkan
• Perbaiki aturan keep untuk memungkinkan pengoptimalan class, kolom, dan metode secara maksimal.

Untuk membantu Anda memperbaiki aturan keep, gunakan R8 Configuration Analyzer.

R8 Configuration Analyzer memungkinkan Anda melakukan hal berikut:

• Melacak dan meningkatkan kualitas konfigurasi R8 secara keseluruhan dengan memantau metrik yang disediakan oleh laporan R8 Configuration Analyzer.
• Menemukan aturan keep terluas—yang mencegah pengoptimalan paling banyak
• dan memahami pengoptimalan yang dicegah untuk memperbaikinya.

R8 Configuration Analyzer tersedia di AGP versi 9.3.0-alpha05 atau dari R8 versi 9.3.7-dev. Untuk mengetahui informasi selengkapnya, lihat Menganalisis konfigurasi R8.

Mengoptimalkan penyingkatan resource untuk aplikasi yang lebih kecil

AGP versi 8.12.0 memperkenalkan penyingkatan resource yang dioptimalkan, yang bertujuan untuk mengintegrasikan pengoptimalan resource dan kode untuk membuat aplikasi yang lebih kecil dan lebih cepat. Sebelum penyingkatan resource yang dioptimalkan, Android Asset Packaging Tool (AAPT2) menghasilkan aturan keep yang secara efektif memperlakukan penyingkatan resource secara terpisah dari kode, sering kali mempertahankan kode atau resource yang tidak dapat diakses yang saling mereferensikan.

Dengan penyingkatan resource yang dioptimalkan, resource dianggap sebagai bagian dari kode program, yang membentuk grafik referensi. Jika kumpulan kode atau resource tidak direferensikan, kode atau resource tersebut tidak dilindungi oleh aturan keep, dan dapat dihapus.

Mengaktifkan penyingkatan resource yang dioptimalkan

Untuk mengaktifkan pipeline penyingkatan resource yang dioptimalkan untuk AGP 8.12 atau 8.13, tambahkan hal berikut ke file gradle.properties project Anda:

Jika Anda menggunakan AGP 9.0.0 atau versi yang lebih baru, Anda tidak perlu menetapkan android.r8.optimizedResourceShrinking=true. Penyingkatan resource yang dioptimalkan akan otomatis diterapkan saat isShrinkResources = true diaktifkan dalam konfigurasi build Anda.

Memverifikasi dan mengonfigurasi setelan pengoptimalan R8

Untuk mengaktifkan R8 agar dapat menggunakan kemampuan pengoptimalan penuhnya, hapus baris berikut dari file gradle.properties project Anda, jika ada:

bash android.enableR8.fullMode=false # Remove this line from your codebase.

Perhatikan bahwa mengaktifkan pengoptimalan aplikasi membuat pelacakan tumpukan sulit dipahami, terutama jika R8 mengganti nama class atau metode. Untuk mendapatkan pelacakan tumpukan yang sesuai dengan kode sumber Anda, lihat Memulihkan pelacakan tumpukan asli.

Jika R8 diaktifkan, Anda juga harus membuat Profil Startup untuk performa startup yang lebih baik.

Jika Anda mengaktifkan pengoptimalan aplikasi dan menyebabkan error, berikut beberapa strategi untuk memperbaikinya:

• Tambahkan aturan keep agar beberapa kode tidak tersentuh.
• Terapkan pengoptimalan secara bertahap.
• Update kode Anda untuk menggunakan library yang lebih cocok untuk pengoptimalan.

Jika Anda tertarik untuk mengoptimalkan kecepatan build, lihat Mengonfigurasi cara R8 berjalan untuk mengetahui informasi tentang cara mengonfigurasi R8 berdasarkan lingkungan Anda.

Perubahan perilaku versi AGP dan R8

Tabel berikut menguraikan fitur utama yang diperkenalkan dalam berbagai versi plugin Android Gradle (AGP) dan compiler R8.