বিশ্বব্যাপী বিকল্প যোগ করুন

R8 বিশ্বব্যাপী বিকল্পগুলি প্রদান করে যা হয় অ্যাপ জুড়ে R8 এর অপ্টিমাইজেশন পরিবর্তন করে অথবা প্রতিটি কিপ নিয়মকে প্রভাবিত করে। এই বিকল্পগুলি proguard-rules.pro ফাইলে, কিপ নিয়মের সাথে রক্ষণাবেক্ষণ করা হয়। এই বিশ্বব্যাপী বিকল্পগুলির মধ্যে কয়েকটি অতিরিক্ত অপ্টিমাইজেশন কনফিগার করে, অন্যগুলি অপ্টিমাইজেশনের কিছু দিক বন্ধ করে দেয়।

অতিরিক্ত অপ্টিমাইজেশনের জন্য বিশ্বব্যাপী বিকল্পগুলি

নিম্নলিখিত বিশ্বব্যাপী বিকল্পগুলি অতিরিক্ত অপ্টিমাইজেশন সক্ষম করে:

• -repackageclasses [<optional-package-name>] : অ্যাপের আকার কমাতে ক্লাসগুলিকে একটি একক প্যাকেজে পুনঃপ্যাকেজ করে। যদি আপনি ঐচ্ছিক প্যাকেজের নাম সরবরাহ না করেন, তাহলে ক্লাসগুলিকে নামহীন (ডিফল্ট) প্যাকেজে স্থানান্তরিত করা হয়। এটি অ্যাপের জন্য প্রস্তাবিত সেটিং কারণ এটি ক্লাসের নাম থেকে প্যাকেজ প্রিফিক্স বাদ দিয়ে ছোট DEX ফাইল তৈরি করে। যেহেতু Android Gradle Plugin (AGP) 9.1, এটি অ্যাপগুলির জন্য ডিফল্ট কনফিগারেশন। এই অপ্টিমাইজেশন থেকে বেরিয়ে আসতে, -dontrepackage ব্যবহার করুন।
• -allowaccessmodification : R8 কে আরও বিস্তৃত অপ্টিমাইজেশন করার জন্য ক্লাস, ক্ষেত্র এবং পদ্ধতির দৃশ্যমানতা পরিবর্তন (সাধারণত প্রশস্ত) করতে দেয়। proguard-android-optimize.txt ব্যবহার করার সময় সক্ষম করা হয়। যেহেতু Android Gradle Plugin (AGP) 8.2, আপনি যদি R8 দিয়ে সম্পূর্ণ অপ্টিমাইজেশন সক্ষম করেন তবে এটি ডিফল্ট কনফিগারেশন।

• -processkotlinnullchecks [level] : R8 কে Kotlin Intrinsics null checks পরিবর্তন করে কেবল ত্রুটি বার্তাটি মুছে ফেলতে হবে অথবা স্পষ্ট null check সম্পূর্ণরূপে মুছে ফেলতে হবে।

  দুর্বলতম থেকে শক্তিশালীতম level মানগুলির নিম্নলিখিত প্রভাব রয়েছে:

  • keep চেক পরিবর্তন করে না।
  • remove_message প্রতিটি চেক মেথড কলকে কলের প্রথম আর্গুমেন্টে getClass() এর কলে পুনর্লিখন করে (কার্যকরভাবে নাল চেকটি ধরে রাখে, কিন্তু কোনও বার্তা ছাড়াই)।
  • remove সম্পূর্ণরূপে চেকগুলি সরিয়ে দেয়।

  ডিফল্টরূপে R8 remove_message ব্যবহার করে। -processkotlinnullchecks এর যেকোনো স্পেসিফিকেশন এটিকে ওভাররাইড করে। একাধিকবার নির্দিষ্ট করা হলে সবচেয়ে শক্তিশালী মান ব্যবহার করা হয়।

  -processkotlinnullchecks AGP 9.0.0 থেকে সমর্থিত।

অতিরিক্ত অপ্টিমাইজেশন সক্ষম করা একটি কনফিগারেশনের উদাহরণ নিচে দেওয়া হল:

-repackageclasses
-allowaccessmodification

অপ্টিমাইজেশন সীমিত করার জন্য বিশ্বব্যাপী বিকল্পগুলি

নিম্নলিখিত গ্লোবাল বিকল্পগুলি আপনাকে অ্যাপ অপ্টিমাইজেশনের কিছু দিক বন্ধ করতে দেয় এবং যখন আপনি আপনার Keep নিয়মগুলি সংশোধন করেন বা প্রথমবারের মতো R8 চালু করেন তখন এটি সহায়ক।

• -dontoptimize : কোড অপ্টিমাইজেশন প্রতিরোধ করে, উদাহরণস্বরূপ মেথড ইনলাইনিং। এই বিকল্পটি ডেভেলপমেন্টের সময় ব্যবহার করা যেতে পারে কিন্তু প্রোডাকশন বিল্ডে ব্যবহার করা উচিত নয়।
• -dontshrink : অ-রেফারেন্সড কোড এবং কোড অপ্টিমাইজেশন অপসারণ প্রতিরোধ করে। এই বিকল্পটি ডেভেলপমেন্টের সময় ব্যবহার করা যেতে পারে কিন্তু প্রোডাকশন বিল্ডে ব্যবহার করা উচিত নয়।
• -dontobfuscate : ক্লাস এবং পদ্ধতির নাম ছোট করা রোধ করে। ডিবাগিংয়ের সময় অস্পষ্টতা বন্ধ করা বিশেষভাবে সহায়ক হতে পারে যাতে স্ট্যাক ট্রেসগুলি পড়া সহজ হয়। এই বিকল্পটি ডেভেলপমেন্টের সময় ব্যবহার করা যেতে পারে তবে প্রোডাকশন বিল্ডে ব্যবহার করা উচিত নয়।
• -keepattributes <attributes> : কমা দ্বারা পৃথক করা বৈশিষ্ট্যের একটি তালিকা গ্রহণ করে যা সংরক্ষণ করা উচিত। আপনি যদি ডিফল্ট proguard-android-optimize.txt ব্যবহার না করেন, তাহলে R8 RuntimeVisibleAnnotations এবং Signature সহ সমস্ত বৈশিষ্ট্য বাদ দেয়, তবে প্রতিফলনের মতো ক্ষেত্রে যদি এই বৈশিষ্ট্যগুলি প্রয়োজন হয় তবে এটি সংরক্ষণ করা সহায়ক হতে পারে। আপনি নির্দিষ্ট করতে পারেন এমন বৈশিষ্ট্যের তালিকার জন্য, Keep বৈশিষ্ট্য দেখুন।

বৈশিষ্ট্যাবলী রাখুন

অ্যাট্রিবিউট হলো আপনার কোডের বিভিন্ন অংশের সাথে সংযুক্ত অতিরিক্ত তথ্য। অ্যাট্রিবিউটগুলো আপনার কোড থেকে অ্যানোটেশন এবং জেনেরিক স্বাক্ষরের মতো তথ্য সংরক্ষণ করে।

কিছু প্রতিফলিত ক্রিয়াকলাপ সফলভাবে সম্পাদনের জন্য নির্দিষ্ট বৈশিষ্ট্যগুলি বজায় রাখা প্রয়োজন। উদাহরণস্বরূপ:

• getEnclosingMethod() অথবা getDeclaredClasses() ব্যবহার করে ভেতরের বা বাইরের ক্লাস স্ট্রাকচার অ্যাক্সেস করার সময়, EnclosingMethod এবং InnerClasses অ্যাট্রিবিউটগুলির প্রয়োজন হয়।
• getTypeParameters() ব্যবহার করে জেনেরিক স্বাক্ষর অ্যাক্সেস করার সময়, Signature বৈশিষ্ট্যটি প্রয়োজন।

• getAnnotation() ব্যবহার করে অ্যানোটেশন অ্যাক্সেস করার সময়, RuntimeVisibleAnnotations অ্যাট্রিবিউট প্রয়োজন।

সাধারণত প্রয়োজনীয় বৈশিষ্ট্য

ডিফল্ট Proguard ফাইল ( proguard-android-optimize.txt অথবা proguard-android.txt ) ব্যবহার করার সময়, Android Gradle প্লাগইন (AGP) নিম্নলিখিত বৈশিষ্ট্যগুলি বজায় রাখে। মনে রাখবেন যে এই বৈশিষ্ট্যগুলির মধ্যে কিছু AGP এর নতুন সংস্করণের প্রয়োজন:

যেসব অ্যাপ proguard-android-optimize.txt ব্যবহার করে, তাদের ক্ষেত্রে AGP দ্বারা সংজ্ঞায়িত keep নিয়মগুলি বেশিরভাগ পরিস্থিতিতেই যথেষ্ট। তবে, যদি আপনি কোনও লাইব্রেরির জন্য কোড লিখছেন, তাহলে আপনার লাইব্রেরির জন্য প্রয়োজনীয় সমস্ত বৈশিষ্ট্যগুলি তার consumer keep rules এ উল্লেখ করা উচিত, এমনকি যদি সেগুলি এই তালিকায় সংজ্ঞায়িত করা থাকে। এটি নিশ্চিত করে যে ডেভেলপাররা যদি proguard-android-optimize.txt অন্তর্ভুক্ত না করার সিদ্ধান্ত নেন তবে আপনার লাইব্রেরিটি শক্তিশালী।

অতিরিক্ত কিপ অ্যাট্রিবিউট

আপনি অতিরিক্ত বৈশিষ্ট্যগুলি নির্দিষ্ট করতে পারেন যা রাখার জন্য রাখা হবে, তবে বেশিরভাগ প্রতিফলিত বা JNI অ্যাক্সেস পরিস্থিতির জন্য এগুলি প্রয়োজন হয় না। তবে, লাইব্রেরি অপ্টিমাইজ করার সময় এর মধ্যে কিছু এখনও ঘন ঘন ব্যবহার করা হতে পারে।