Як оптимізувати код та ресурси за допомогою R8 у ваших Android-додатках

Останнє оновлення: 18 листопада 2026
Автор: TecnoDigital
  • R8 видаляє код та ресурси, які ніхто не використовує, переписує решту та скорочує назви, щоб створювати менші програми зі швидшим запуском та меншою кількістю проблем із зависанням.
  • Бажано ввімкнути оптимізацію в релізній збірці та налаштувати правила збереження, які є основною перешкодою, що заважає R8 працювати на повну потужність.
  • Аналізатор конфігурації R8 вимірює, скільки коду доступно для стиснення, оптимізації та обфускації, а також позначає широкі, дубліковані або непотрібні правила.
  • Виконання завдання за допомогою пакетів додатків, легких зображень, налаштувань мови та щільності, а також постійного вимірювання розміру суттєво впливає на швидкість завантаження.

Розробник додатків для Android працює з технічною документацією на MacBook у професійному середовищі.

Стиснення програми Android — це не просто видалення окремих файлів; це делікатний баланс між розміром, швидкістю запуску та використанням пам’яті. Вбудований оптимізатор Android, R8, виконує значну частину цієї роботи без необхідності писати жодного рядка коду : він аналізує, який код та ресурси фактично використовуються, видаляє те, що ніхто не використовує, і переписує те, що залишилося, щоб працювати з меншими накладними витратами. Користувачі вашої програми помічають швидший час запуску, менше використання пам’яті, більш плавний інтерфейс і менше повідомлень про збої.

Головне — дати йому простір для роботи. Чим більшу частину вашої кодової бази може використовувати R8, тим кращі результати. Надто широкі правила збереження є найпоширенішою перешкодою , оскільки вони блокують класи та методи, які можуть не викликатися динамічно, разом з їхніми залежностями. Удосконалення цих правил, вимірювання та повторне тестування — це цикл, який відділяє просто випущений додаток від справді налаштованого.

Що саме робить R8 і чому йому варто довіряти?

Екран ноутбука, на якому показано інструменти аналізу коду та даних, що представляють процес оптимізації за допомогою R8.

R8 працює в серії пов'язаних фаз. Спочатку він аналізує ваші фактичні точки входу, такі як дії або служби, заявлені в маніфесті, будує карту всього, на що посилаються, і відкидає все, що знаходиться поза цією картою . Потім він переходить до логічної оптимізації: заміна викликів тілом викликаного методу, об'єднання класів та інтерфейсів, спрощення структур та зменшення накладних витрат на виконання. Нарешті, він скорочує назви класів, полів та методів, тому щось на кшталт com.example.MyActivity може зрештою називатися aba, що призводить до економії метаданих.

  • Менше мертвого кодуЗалежності, які ви використовуєте лише у невеликому відсотку, перестають нести всю їхню вагу.
  • Більш ефективне виконанняВставка методів та об'єднання класів зменшує кількість викликів та навантаження на пам'ять.
  • Легші DEX-файлиОбфускація зберігає метадані та пришвидшує завантаження класів.
  • Скориговані ресурсиПочинаючи з версії 8.12 плагіна Gradle, R8 також бере участь в оптимізації ресурсів.

З точки зору користувача, це означає швидший запуск, зменшення споживання пам'яті, покращений рендеринг та меншу кількість проблем із зависанням програм. Офіційна рекомендація чітка: увімкніть оптимізацію у релізній збірці . Для щоденного тестування або розробки бібліотек це зазвичай не варто робити, оскільки час компіляції збільшується, а налагодження ускладнюється, коли змінюються назви.

Увімкнути оптимізацію на основі версії плагіна Gradle

Якщо ви працюєте з останніми версіями плагіна Android для Gradle, все значно спростили. Просто ввімкніть один прапорець у блоці оптимізації типу збірки релізу та помістіть свої правила keep у певний набір вихідного коду, з файлами, що закінчуються на .keep, наприклад, у src/main/keepRules. Цей новий підхід охоплює як код, так і ресурси, і включає правила платформи за замовчуванням, еквівалентні історичним правилам ProGuard з оптимізацією, тому немає потреби оголошувати додаткові файли.

У проектах, пов'язаних з попередніми версіями плагіна, стандартний підхід передбачає два параметри в типі збірки релізу: один, який увімкне мінімізацію коду, та інший, який увімкне зменшення ресурсів. Розумний підхід полягає в тому, щоб увімкнути обидва параметри одночасно та додати оптимізований файл правил, згенерований самою системою, а також власний файл правил, якщо потрібно. Змішування збірок релізу без цих параметрів – один із найточніших способів роздати мегабайти вашим користувачам.

Повний режим та оптимізоване скорочення ресурсів

Повний режим R8 був активним за замовчуванням протягом багатьох років і застосовує більш агресивні припущення щодо використання відображення та динамічних викликів. Якщо хтось коли-небудь писав властивість, яка його вимикає, краще її видалити : якщо її не ввімкнути, це зменшує потенціал оптимізатора. Однак повний режим може вимагати додаткових правил у проектах з великою кількістю динамічного коду, тому завжди тестуйте його за допомогою реальної релізної збірки, а не лише за допомогою модульних тестів.

  Запитання на співбесіду з SQL та Python для рекламних технологій: повний посібник

Оптимізоване стиснення ресурсів з'явилося у версії 8.12 плагіна, а починаючи з версії 9.0, воно застосовується автоматично, коли стиснення ресурсів увімкнено. Ідея полягає в тому, щоб розглядати ресурси як частину графа коду : раніше інструмент пакування генерував правила збереження, які зберігали недоступні ресурси та код, що посилаються один на одного; тепер, якщо колекція коду та ресурсів не використовується, вона не захищена та зникає. У додатках з багатьма варіаціями форм-фактора було виміряно зменшення розміру понад п'ятдесят відсотків.

Аналізатор конфігурації R8 та його три показники

Крупний план смартфона з мінімалістичним, гнучким та оптимізованим інтерфейсом програми.

Цей аналізатор – це інструмент, який показує, чи допомагає ваша конфігурація, чи заважає. Він генерує статистику про те, який відсоток вашої кодової бази фактично піддається скороченню, оптимізації та обфускації . Якщо показник скорочення становить 66 відсотків, це означає, що R8 може видалити код з двох третин вашої кодової бази; якщо показник оптимізації однаковий, він може застосовувати вставку методів, об'єднання класів та інші методи лише до двох третин. Показник обфускації вимірює, скільки коду можна скоротити, щоб зберегти метадані.

Окрім загальних показників, у звіті детально описано вплив кожного правила збереження та властивостей оптимізації, які воно блокує. У ньому також визначено правила, що походять зі сторонніх бібліотек , що дуже корисно, оскільки автори цих бібліотек не знайомі з вашою конкретною реалізацією та іноді пишуть настільки загальні правила, що вони паралізують оптимізацію в частинах вашої програми, які абсолютно не пов'язані з її функціональністю.

Як створити звіт, не витрачаючи часу

Для швидкого налаштування правил існує спеціальне завдання Gradle, яке аналізує конфігурацію випуску без пакування APK або пакета. Цикл зворотного зв'язку набагато коротший , а HTML-звіт відображається в папці reports модуля в каталозі, призначеному для R8. Це рекомендований варіант, коли ви налаштовуєте правила та хочете побачити негайний ефект від кожної зміни.

Якщо ви надаєте перевагу автоматичному аналізу, будь-яка релізна збірка також генерує HTML-файл у результатах зіставлення. Ви можете вимкнути цю автоматичну генерацію за допомогою відповідної експериментальної властивості, якщо вона вам не потрібна. У старіших версіях плагіна вирішенням проблеми є додавання останньої версії R8 до шляху класів проекту та запуск збірки із системною властивістю, що вказує каталог, де слід зберегти звіт.

Удосконалюйте правила збереження, не порушуючи роботу програми

Мета полягає в тому, щоб зберегти лише те, що дійсно доступне через рефлексію, нічого більше, нічого менше. Почніть з вивчення правил, які блокують оптимізацію у величезній кількості класів , перегляньте, які елементи вони захищають, і перевірте, чи вони насправді викликаються динамічно. Потім звузьте область застосування: замість того, щоб зберігати весь пакет з усіма його членами, обмежте правило певними класами та членами. А перед впровадженням змін виконайте тести, які охоплюють уражені класи, поля та методи.

Також будьте обережні з підпорядкованими правилами. Якщо одне правило захищає весь пакет, а інше — клас у цьому пакеті, то друге не робить жодного внеску, а перше блокує оптимізацію, яка вам може бути непотрібною. Визначте, яке з двох правил правильне: якщо вузьке правило добре написано, видаліть широке та розблокуйте решту пакета; якщо широке правило правильне, все одно видаліть його, але перепишіть так, щоб воно впливало лише на те, що є важливим. Потім знову запустіть аналізатор і скомпілюйте повний реліз, щоб перевірити, чи все ще працює.

Дублікати, невикористані та бібліотечні правила

Аналізатор визначає два явних джерела безладу: правила, які не відповідають жодному класу, методу чи полю в поточній збірці, та ідентичні правила, що повторюються в одному файлі або в різних файлах. Перші часто залишаються як сміття після рефакторингу або видалення залежностей ; другі ускладнюють обслуговування, не додаючи жодної користі. Їх очищення полегшує читання та налагодження конфігурації.

Зі сторонніми бібліотеками мало можливостей для маневру, оскільки їхні правила постачаються в пакеті, і ви не можете вибірково їх редагувати. Практичний підхід полягає в тому, щоб задокументувати вплив у звіті та повідомити розробника , або тимчасово відтворити ці правила у вашому проєкті, виключивши ширші та вимірявши потенційний виграш, перш ніж вирішити, чи варто ризикувати.

  Повний посібник з LEGO Education SPIKE Prime

ProGuard та R8: схожі, але не ідентичні

Роками ProGuard робив чотири речі: видаляв невикористовувані елементи, оптимізував байт-код, обфускував імена та додавав інформацію для попередньої перевірки. R8 продовжує роботу та йде далі: агресивніше вставляє методи, об'єднує класи, перетворює перерахування на цілі числа, коли це можливо, та краще розуміє функції Kotlin . Він також компілюється швидше та, завдяки спрощенню основної бібліотеки, дозволяє використовувати сучасні Java API на старіших версіях Android.

Щодо правил, R8 приймає правила ProGuard та додає деякі власні модифікатори, такі як ті, що примусово вставляють або запобігають вставці певного методу. Перетворення імен не змінює поведінку, але ускладнює читання стекових трас : воно завжди зберігає файл зіставлення для кожного випуску, щоб відновити оригінальну трасування у разі збою у виробництві.

Типові помилки під час мініфікації та як вийти з проблеми

Ті самі проблеми постійно виникають: «клас не знайдено» через видалений клас, «метод відсутній» через перейменований метод, моделі, які не серіалізовані, оскільки втратили свої назви, або бібліотеки, які припускають, що нічого не зміниться. Діагностика майже завжди включає перевірку того, до чого здійснюється доступ через відображення, та додавання мінімально необхідного правила . Щоб дослідити, увімкніть використання, початкове значення та відображення друку у тимчасовий файл або тимчасово вимкніть певні оптимізації, щоб ізолювати винуватця.

Варто також зазначити, що зовнішні інструменти, які регенерують або виправляють DEX-файли, можуть порушити оптимізацію, ретельно реалізовану R8. Якщо ваш ланцюжок збірки включає такий крок, перегляньте його, перш ніж звинувачувати оптимізатор . А якщо продуктивність збірки викликає занепокоєння, існують налаштування, які дозволяють адаптувати R8 до вашого середовища без шкоди для його переваг.

Зменште кількість ресурсів: зображень, щільності та мов

Ресурси зазвичай складають значну частину пакета. Конвертація растрових зображень у WebP зменшує розмір файлу, зберігаючи якість , а векторні малюнки запобігають дублюванню одного й того ж значка для кожної щільності. Налаштування лише тих сегментів щільності, які ви фактично використовуєте, та обмеження включених мов значно зменшує розмір файлу, особливо в програмах з багатьма перекладами. Для PNG-файлів, які ви не можете конвертувати, існують утиліти стиснення з мінімальними втратами.

Також допомагає програмно розфарбовувати один ресурс у відтінки сірого замість об'єднання кількох кольорових версій, завантажувати великі, непотрібні зображення на вимогу під час запуску та видаляти осиротілі ресурси за допомогою перевірки коду IDE. Якщо на ресурс посилаються лише з непрацюючого коду, оптимізоване скорочення виявляє та видаляє його , чого раніше не траплялося, оскільки два процеси працювали окремо.

Макети, стилі та ієрархії переглядів

Зменшення ієрархій не зменшує розмір APK, але покращує продуктивність, що є іншою половиною мети. Замініть непотрібне вкладення контейнерів добре розробленим ConstraintLayout , видобудьте спільні компоненти за допомогою include та визначте стилі, щоб уникнути дублювання атрибутів. Інспектор макета допомагає виявляти абсурдно глибокі дерева представлень, які уповільнюють інфляцію.

Пакети програм, динамічні модулі та нативні бібліотеки

Публікація у форматі пакетів змінює правила гри: магазин генерує пакети, адаптовані до кожного пристрою, тому кожен користувач завантажує лише той код та ресурси, який йому потрібен. Кількість завантажень значно нижча, ніж у випадку з універсальним APK, оскільки він фільтрує мови, щільність пристроїв та архітектури, які не застосовуються. Крім того, функції можна розподіляти між модулями функцій, які завантажуються на вимогу, на основі умовних або миттєвих критеріїв.

Щодо нативних бібліотек, включення лише тих архітектур, які ви підтримуєте, та увімкнення стиснення запобігає включенню бінарних файлів, які ніхто не запускатиме. Якщо ви компілюєте за допомогою Bazel замість Gradle, ви також можете інтегрувати R8 у конвеєр, хоча варто пам'ятати, що ця підтримка офіційно не підтримується для розробки додатків для Android.

Виміряйте розмір та слідкуйте за еволюцією

Панель аналітики продуктивності на ноутбуці, що ілюструє вимірювання ресурсів та розміру програми.

Без вимірювання немає оптимізації. Аналізатор APK IDE показує справжній розмір пакета, а спеціальне завдання Gradle може повідомляти про розмір після кожної збірки. Додавання цієї перевірки до безперервної інтеграції автоматизує контроль розміру та запобігає непомітному перевантаженню бінарного файлу кількома новими залежностями.

Як змінилася поведінка між версіями?

Варто переглянути нещодавню еволюцію, оскільки вона пояснює багато застарілих конфігурацій, які більше не є актуальними. Версія 8.0 за замовчуванням увімкнула повний режим ; 8.6 покращила повторне трасування, включаючи повторне трасування файлів та рядків для будь-якого minSdk; 8.12 запровадила оптимізоване скорочення ресурсів та автоматичне повторне трасування в Logcat; 9.0 увімкнула це за замовчуванням, відфільтрувала глобальні опції в правилах споживачів та оптимізувала перевірку Kotlin на null; 9.1 переупакувала класи за замовчуванням; а 9.3 запровадила спрощений блок оптимізації та набір правил .keep.

  Повний посібник з встановлення WLED на ESP32 та керування світлодіодними лампами

З огляду на все це, справді важливе значення має проста процедура: вмикання оптимізації в релізі, періодичний перегляд звіту аналізатора, видалення непотрібних правил, очищення ресурсів та зображень, розповсюдження за допомогою пакетів та вимірювання розміру з кожним релізом. Це невеликі кроки, які разом перетворюють важкий, повільний додаток на такий, що завантажується миттєво та запускається миттєво . А оскільки код та залежності постійно зростають, перегляд має бути постійним: те, що було доопрацьовано сьогодні, стає некоректним, як тільки додається нова бібліотека або включається функція з власними ресурсами.

TecnoDigital

TecnoDigital

Захоплюючись технологіями та розробкою програмного забезпечення, я заглиблююся у світ систем і обчислень з метою сприяння інноваціям і вирішення складних завдань.

Часті запитання

Що саме робить R8 з кодом моєї програми?

Він аналізує оголошені точки входу, створює карту посилань та видаляє все, що недоступне з них. Потім він переписує решту коду для роботи з меншими накладними витратами та скорочує назви класів, полів та методів для економії місця.

Як увімкнути оптимізацію R8 в останніх версіях плагіна Gradle?

Він активується за допомогою прапорця в блоці оптимізації типу збірки релізу, який охоплює як код, так і ресурси. Ваші власні правила розміщуються в певному наборі вихідного коду, у файлах з розширенням .keep.

Яка різниця між скороченням коду та скороченням ресурсів?

Скорочення коду усуває недоступні класи, поля та методи, тоді як скорочення ресурсів видаляє невикористовувані зображення, макети та інші файли. У сучасних версіях обидва завдання інтегровані в один граф посилань, що запобігає збереженню пов'язаних ресурсів виключно із застарілого коду.

Для чого використовується аналізатор конфігурації R8?

Виміряйте відсоток вашої кодової бази, який залишається доступним для стиснення, оптимізації та обфускації, і проаналізуйте вплив кожного правила збереження. За допомогою цих даних ви можете виявити надто широкі правила, дублікати та правила, які більше нічому не відповідають.

Чому широке правило збереження шкодить продуктивності мого додатку?

Оскільки це запобігає впливу R8 не лише на те, що захищає це правило, але й на все, що від нього залежить. Результатом є більше коду в пакеті, більше метаданих і менше місця для застосування вставки методів або об'єднання класів.

Чи краще публікувати за допомогою пакетів додатків, а не універсального APK?

Так, оскільки магазин генерує пакети, адаптовані до кожного пристрою, і кожен користувач завантажує лише ті ресурси мови, щільності та архітектури, які йому потрібні. Це налаштування значно зменшує розмір завантаження, не вимагаючи від вас підтримки окремих артефактів.

Як я можу прочитати трасування стека з обфускованої збірки?

Вам потрібен файл зіставлення, який генерується з кожною збіркою випуску, та для застосування інструменту повторного трасування R8. Останні версії навіть автоматично повторно трасують трасування у вікні Logcat IDE.

Чи варто оптимізувати бібліотеку, яку я збираюся опублікувати?

Повна оптимізація працює найкраще, коли R8 бачить весь граф програми, тому основна частина роботи виконується під час компіляції кінцевої програми. Навіть за таких умов бібліотека може ретельно підготувати свої правила для користувачів, щоб уникнути блокування оптимізації в проектах, які її інтегрують.