فعال کردن بهینه‌سازی برنامه با R8

برای ارائه بهترین تجربه کاربری، باید برنامه‌تان را بهینه‌سازی کنید تا حد امکان کوچک و سریع باشد. بهینه‌ساز برنامه ما، به‌نام R8، با برداشتن کدها و منابع استفاده‌نشده، بازنویسی کد برای بهینه‌سازی عملکرد زمان اجرا، و غیره، برنامه‌تان را ساده‌سازی می‌کند. برای کاربران شما، این یعنی:

  • زمان شروع سریع‌تر
  • کاهش استفاده از حافظه
  • بهبود عملکرد زمان اجرا و پردازش
  • خطاهای ANR کمتر

نمای کلی بهینه‌سازی R8

R8 از فرایندی چندمرحله‌ای برای بهینه‌سازی برنامه شما ازنظر اندازه و سرعت استفاده می‌کند. عملیات‌های کلیدی شامل موارد زیر است:

  • کوچک کردن کد (یا Tree Shaking): R8 کد غیرقابل‌دسترس را از برنامه و وابستگی‌های کتابخانه آن شناسایی و حذف می‌کند. با تحلیل نقاط ورودی برنامه‌تان (مثل Activities یا Services تعریف‌شده در مانیفست)، R8 نموداری از کد ارجاع‌شده می‌سازد و هرچیزی را که ارجاع‌نشده باقی بماند برمی‌دارد.

  • بهینه‌سازی‌های منطقی: R8 کد شما را بازنویسی می‌کند تا کارایی اجرا را بهبود بخشد و سربار را کاهش دهد. تکنیک‌های کلیدی عبارت‌اند از:

    • درون‌خطی کردن روش: R8 سایت فراخوانی روش را با بدنه واقعی روش فراخوانده‌شده جایگزین می‌کند. این کار سربار فراخوانی تابع را حذف می‌کند و به R8 اجازه می‌دهد بهینه‌سازی‌های بیشتری انجام دهد.

    • ادغام کلاس: R8 مجموعه‌های کلاس‌ها و میاناهای مختلف را در یک کلاس واحد ترکیب می‌کند. این کار تعداد کلاس‌ها را در برنامه کاهش می‌دهد و درنتیجه فشار حافظه را کم می‌کند و سرعت راه‌اندازی را بهبود می‌بخشد.

  • مبهم‌سازی (که به آن کوچک‌سازی هم می‌گویند): برای کاهش اندازه فایل DEX، R8 نام کلاس‌ها، فیلدها، و روش‌ها را کوتاه می‌کند (برای مثال، com.example.MyActivity می‌تواند به a.b.a تبدیل شود).

از نسخه ۸.۱۲.۰ افزایه Android Gradle‏ (AGP)، ‏R8 منابع را نیز به‌عنوان بخشی از مراحل بهینه‌سازی خود بهینه‌سازی می‌کند. برای اطلاعات بیشتر، کاهش منابع بهینه‌شده را ببینید.

فعال کردن بهینه‌سازی

برای فعال کردن بهینه‌سازی برنامه برای برنامه‌تان، از DSL مناسب براساس نسخه AGP پروژه‌تان استفاده کنید. توصیه می‌کنیم بهینه‌سازی برنامه را فقط در نسخه نهایی برنامه‌تان که قبل‌از انتشار آزمایش می‌کنید (معمولاً ساخت نسخه پخش) فعال کنید، زیرا بهینه‌سازی‌ها زمان ساخت پروژه را افزایش می‌دهند و به‌دلیل نحوه اصلاح کد، می‌توانند اشکال‌زدایی را دشوارتر کنند.

برای AGP نسخه ۹.۳ و بالاتر

برای فعال کردن بهینه‌سازی برنامه برای AGP نسخه ۹.۳ و بالاتر:

  • ‫enable = true را در بلوک optimization در اسکریپت ساخت سطح برنامه ساخت نسخهٔ پخش خود تنظیم کنید.
  • قوانین حفظ خود را به فایلی با پسوند .keep در مجموعه منبع src/<variant>/keepRules اضافه کنید. برای مثال، 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 قدیمی برای نسخه‌های AGP پایین‌تر از ۹.۳

برای فعال کردن بهینه‌سازی برنامه، isMinifyEnabled = true (برای بهینه‌سازی کد) و isShrinkResources = true (برای بهینه‌سازی منابع) را در اسکریپت ساخت سطح برنامه ساخت نسخه پخش تنظیم کنید. توصیه می‌کنیم همیشه هر دو تنظیم را فعال کنید.

‫DSL قدیمی (Kotlin)

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"),

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

‫DSL قدیمی (Groovy)

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')

            ...
        }
    }
}

بهبود بهینه‌سازی R8

مزایای عملکردی R8 مستقیماً با میزان پایگاه کدی که R8 می‌تواند بهینه‌سازی کند مرتبط است. برای بهره‌مندی از حداکثر مزایای R8، روال‌های مطلوب را دنبال کنید:

برای کمک به شما در پالایش قوانین حفظ، از R8 Configuration Analyzer استفاده کنید.

«تحلیل‌گر پیکربندی» R8 به شما امکان می‌دهد کارهای زیر را انجام دهید:

  • با نظارت بر سنجه‌های ارائه‌شده توسط گزارش «تحلیل‌گر پیکربندی» R8، کیفیت کلی پیکربندی R8 را ردیابی و بهبود دهید.
  • گسترده‌ترین قوانین نگهداری را پیدا کنید - قوانینی که بیشترین بهینه‌سازی را جلوگیری می‌کنند
  • و بدانید که چه بهینه‌سازی‌ای را برای پالایش آن‌ها جلوگیری می‌کنند.

«تحلیل‌گر پیکربندی» R8 در AGP نسخه 9.3.0-alpha05 یا از R8 نسخه 9.3.7-dev دردسترس است. برای اطلاعات بیشتر، به تحلیل پیکربندی R8 مراجعه کنید.

کاهش منابع را برای برنامه‌های کوچک‌تر بهینه‌سازی کنید

نسخه ۸.۱۲.۰ از AGP کاهش منابع بهینه‌سازی‌شده را معرفی می‌کند که هدف آن ادغام بهینه‌سازی منابع و کد برای ایجاد برنامه‌های حتی کوچک‌تر و سریع‌تر است. قبل‌از بهینه‌سازی کاهش منابع، «ابزار بسته‌بندی دارایی Android»‏ (AAPT2) قوانین نگهداری را تولید می‌کرد که به‌طور مؤثری کاهش منابع را جدا از کد درنظر می‌گرفت، و اغلب کدها یا منابع غیرقابل‌دسترسی را که به یکدیگر ارجاع می‌دادند حفظ می‌کرد.

با کاهش منابع بهینه‌سازی‌شده، منابع به‌عنوان بخشی از کد برنامه درنظر گرفته می‌شوند و نمودار مرجع را تشکیل می‌دهند. وقتی به مجموعه‌ای از کدها یا منابع ارجاع داده نشود، قانون نگهداری از آن محافظت نمی‌کند و می‌توان آن را برداشت.

فعال کردن کاهش منابع بهینه‌سازی‌شده

برای فعال کردن خط لوله کاهش منابع بهینه‌سازی‌شده جدید برای AGP نسخه ۸.۱۲ یا ۸.۱۳، موارد زیر را به فایل gradle.properties پروژه‌تان اضافه کنید:

android.r8.optimizedResourceShrinking=true

اگر از AGP نسخه ۹.۰.۰ یا جدیدتر استفاده می‌کنید، نیازی به تنظیم android.r8.optimizedResourceShrinking=true ندارید. وقتی isShrinkResources = true در پیکربندی ساخت شما فعال باشد، کاهش منابع بهینه‌سازی‌شده به‌طور خودکار اعمال می‌شود.

تنظیمات بهینه‌سازی R8 را درستی‌سنجی و پیکربندی کنید

برای فعال کردن R8 برای استفاده از قابلیت‌های بهینه‌سازی کامل آن، خط زیر را از فایل gradle.properties پروژه‌تان بردارید (اگر وجود دارد):

android.enableR8.fullMode=false

توجه داشته باشید که فعال کردن بهینه‌سازی برنامه، درک ردیابی پشته را دشوار می‌کند، به‌ویژه اگر R8 نام کلاس یا روش را تغییر دهد. برای دریافت ردیابی‌های پشته‌ای که به‌درستی با کد منبع شما مطابقت دارد، به بازیابی ردیابی پشته‌ای اصلی مراجعه کنید.

اگر R8 فعال است، باید نمایه‌های راه‌اندازی ایجاد کنید تا عملکرد راه‌اندازی حتی بهتر شود.

اگر بهینه‌سازی برنامه را فعال کنید و این کار باعث ایجاد خطا شود، چند راهبرد برای رفع آن‌ها وجود دارد:

اگر به بهینه‌سازی سرعت ساخت خود علاقه‌مند هستید، برای اطلاعات درباره نحوه پیکربندی R8 براساس محیط خود، به پیکربندی نحوه اجرای R8 مراجعه کنید.

تغییرات رفتار نسخه AGP و R8

جدول زیر ویژگی‌های کلیدی معرفی‌شده در نسخه‌های مختلف «افزایه Android Gradle»‏ (AGP) و کامپایلر R8 را نشان می‌دهد.

نسخه AGP ویژگی‌های معرفی‌شده
‫۳-۹ DSL ساده‌شده:بلوک جدید `optimization {}` به پیکربندی کمتری نیاز دارد - کاهش منابع بهینه‌سازی‌شده همیشه فعال است، قوانین حفظ پیش‌فرض Android انصرافی است.

مجموعه منبع `keepRules`: اگر از DSL جدید استفاده می‌کنید، باید قوانین حفظ را در مجموعه منبع src/<variant>/keepRules و در فایل‌هایی با پسوند .keep قرار دهید. مجموعه‌های منبع با DSL قدیمی نیز سازگار هستند.

قوانین مصرف‌کننده KMP (Kotlin MultiPlatform): KMP دیگر نیازی به تنظیم publish = true ندارد و از مجموعه منبع src/<variant>/keepRules با افزونه .keep پشتیبانی می‌کند.

توجه داشته باشید که DSL قدیمی هنوز پشتیبانی می‌شود.
‫۱-۹ کلاس‌ها به‌طور پیش‌فرض دوباره بسته‌بندی می‌شوند: R8 کلاس‌ها را دوباره بسته‌بندی می‌کند (آن‌ها را به بسته بی‌نام در سطح بالا منتقل می‌کند) تا DEX را بیشتر فشرده کند و نیاز به مشخص کردن گزینه -repackageclasses را ازبین ببرد. برای کسب اطلاعات درباره نحوه عملکرد این ویژگی و نحوه انصراف دادن، گزینه‌های سراسری را ببینید.
‫۹.۰ کاهش منابع بهینه‌سازی‌شده: به‌طور پیش‌فرض فعال است (بااستفاده از android.r8.optimizedResourceShrinking کنترل می‌شود). کاهش منابع بهینه‌سازی‌شده به ادغام کاهش منابع با خط لوله بهینه‌سازی کد کمک می‌کند و منجر به برنامه‌های کوچک‌تر و سریع‌تر می‌شود. با بهینه‌سازی هم‌زمان ارجاع‌های کد و منبع، منابعی را که منحصراً از کد استفاده‌نشده ارجاع داده شده‌اند شناسایی و حذف می‌کند. این پیشرفت قابل‌توجهی نسبت‌به فرایندهای بهینه‌سازی جداگانه قبلی است.

این به‌ویژه برای برنامه‌هایی مفید است که منابع و کد قابل‌توجهی را در بخش‌های مختلف با ابعاد متفاوت هم‌رسانی می‌کنند، و بهبودهای اندازه‌گیری‌شده‌ای بیش‌از ۵۰٪ در اندازه برنامه دارند. کاهش اندازه حاصل منجر به بارگیری‌های کوچک‌تر، نصب‌های سریع‌تر، و تجربه کاربری بهتر با راه‌اندازی سریع‌تر، پرداز زدن بهبودیافته، و خطاهای ANR کمتر می‌شود.

فیلتر کردن قانون کتابخانه: پشتیبانی از گزینه‌های سراسری (برای مثال، -dontobfuscate) در قوانین مصرف‌کننده کتابخانه حذف شده است و برنامه‌ها آن‌ها را فیلتر خواهند کرد. برای اطلاعات بیشتر، افزودن گزینه‌های جهانی را ببینید.

بررسی‌های تهی Kotlin: به‌طور پیش‌فرض بهینه‌سازی شده است (بااستفاده از -processkotlinnullchecks کنترل می‌شود). این نسخه همچنین بهبودهای قابل‌توجهی در سرعت ساخت معرفی کرده است. برای اطلاعات بیشتر، گزینه‌های سراسری برای بهینه‌سازی بیشتر را ببینید.

بهینه‌سازی بسته‌های خاص: می‌توانید از packageScope برای بهینه‌سازی بسته‌های خاص استفاده کنید. این ویژگی در مرحله پشتیبانی آزمایشی است. برای اطلاعات بیشتر، بهینه‌سازی بسته‌های مشخص‌شده با packageScope را ببینید.

بهینه‌سازی‌شده به‌طور پیش‌فرض: پشتیبانی از getDefaultProguardFile("proguard-android.txt") حذف شده است، زیرا شامل -dontoptimize است که باید از آن اجتناب شود. درعوض، از "proguard-android-optimize.txt" استفاده کنید. اگر لازم است بهینه‌سازی را به‌طور سراسری در برنامه‌تان غیرفعال کنید، پرچم را به‌طور دستی به فایل proguard اضافه کنید.
‫۸.۱۲ کاهش منابع بهینه‌سازی‌شده: پشتیبانی اولیه اضافه شد (بااستفاده از android.r8.optimizedResourceShrinking کنترل می‌شود). کاهش منابع بهینه‌سازی‌شده به ادغام کاهش منابع با خط لوله بهینه‌سازی کد کمک می‌کند. باید آن را به‌صورت دستی در این نسخه AGP فعال کنید.

ردیابی Logcat: پشتیبانی از ردیابی خودکار در پنجره Logcat در «استودیو Android».
۸.۶ ردیابی بهبودیافته: شامل ردیابی نام فایل و شماره خط به‌طور پیش‌فرض برای همه سطوح minSdk (قبلاً به minSdk نسخه ۲۶ به بالا در نسخه ۸.۲ نیاز داشت).

به‌روزرسانی R8 کمک می‌کند مطمئن شوید ردیابی‌های پشته از ساخت‌های مبهم به‌راحتی و به‌وضوح قابل‌خواندن هستند. این نسخه نحوه نگاشت شماره خطوط و فایل‌های منبع را بهبود می‌بخشد و باعث می‌شود ابزارهایی مثل Android Studio Logcat راحت‌تر بتوانند خرابی‌ها را به‌طور خودکار به کد منبع اصلی ردیابی کنند.
۸.۰ حالت کامل به‌طور پیش‌فرض: حالت کامل R8 بهینه‌سازی بسیار قدرتمندتری ارائه می‌دهد. این ویژگی به‌طور پیش‌فرض فعال است. می‌توانید بااستفاده از android.enableR8.fullMode=false انصراف دهید.
۷.۰ حالت کامل دردسترس است: به‌عنوان ویژگی اختیاری بااستفاده از android.enableR8.fullMode=true معرفی شده است. حالت کامل با ایجاد فرضیات سخت‌گیرانه‌تر درباره نحوه استفاده کد شما از بازتاب و سایر ویژگی‌های پویا، بهینه‌سازی‌های قدرتمندتری را اعمال می‌کند. اگرچه این کار اندازه برنامه را کاهش می‌دهد و عملکرد را بهبود می‌بخشد، ممکن است به قوانین نگهداری بیشتری نیاز داشته باشد تا از حذف شدن کدهای ضروری جلوگیری شود.

استفاده از R8 با سیستم‌های ساخت دیگر

درحالی‌که AGP سیستم ساخت توصیه‌شده و رسماً پشتیبانی‌شده برای برنامه‌های Android است، ممکن است از سیستم ساخت جایگزینی مانند Bazel استفاده کنید. اگر از Bazel استفاده می‌کنید، می‌توانید R8 را در خط لوله ساخت خود ادغام کنید تا برنامه‌تان را کوچک، مبهم، و بهینه‌سازی کنید.

برای کسب اطلاعات درباره بهینه‌سازی برنامه Android بااستفاده از Bazel، به rules_android مستندات Bazel مراجعه کنید. توجه داشته باشید که Bazel به‌طور رسمی برای توسعه برنامه Android پشتیبانی نمی‌شود.