বিচক্ষণতার সাথে লাইব্রেরি বেছে নিন

অ্যাপ অপ্টিমাইজেশন চালু করতে, আপনাকে অবশ্যই এমন লাইব্রেরি ব্যবহার করতে হবে যা Android অপ্টিমাইজেশনের সাথে মানানসই। Android অপ্টিমাইজেশনের জন্য কোনও লাইব্রেরি কনফিগার করা না থাকলে—যেমন, এটি যদি সংশ্লিষ্ট নিয়মাবলী বান্ডেল না করে রিফ্লেকশন ব্যবহার করে—তাহলে এটি Android অ্যাপের জন্য উপযুক্ত নাও হতে পারে। এই পৃষ্ঠায় ব্যাখ্যা করা হয়েছে যে কেন কিছু লাইব্রেরি অ্যাপ অপ্টিমাইজেশনের জন্য বেশি উপযুক্ত এবং আপনাকে বেছে নিতে সাহায্য করার জন্য সাধারণ পরামর্শ প্রদান করে।

লাইব্রেরি বেছে নেওয়ার সময় সাধারণ পরামর্শ

আপনার লাইব্রেরি অ্যাপ অপ্টিমাইজেশনের সাথে মানানসই কিনা তা নিশ্চিত করতে এইসব পরামর্শ ব্যবহার করুন।

রিফ্লেকশনের চেয়ে কোডজেনকে বেশি পছন্দ করা হয়

রিফ্লেকশনের পরিবর্তে কোড জেনারেশন (codegen) ব্যবহার করে এমন লাইব্রেরি বেছে নিন। codegen-এর মাধ্যমে, অপ্টিমাইজার নির্ধারণ করতে পারে যে রানটাইমে আসলে কোন কোড ব্যবহার করা হয় এবং কোন কোড সরানো যেতে পারে। কোনও লাইব্রেরি codegen নাকি reflection ব্যবহার করে তা বলা কঠিন হতে পারে, তবে কিছু লক্ষণ আছে—সাহায্যের জন্য পরামর্শ দেখুন।

কোডজেন বনাম রিফ্লেকশন সম্পর্কে আরও তথ্যের জন্য, লাইব্রেরি লেখকদের জন্য অপ্টিমাইজেশন দেখুন।

রিফ্লেকশন ব্যবহার করা হয়েছে কিনা তা চেক করুন (উন্নত)

কোনও লাইব্রেরি রিফ্লেকশন ব্যবহার করে কিনা তা আপনি সেটির কোড পরীক্ষা করে বলতে পারবেন। লাইব্রেরি রিফ্লেকশন ব্যবহার করলে, এটি সংশ্লিষ্ট কিপ রুল প্রদান করে কিনা তা চেক করুন। কোনও লাইব্রেরি নিম্নলিখিত কাজগুলি করলে, সেটি সম্ভবত রিফ্লেকশন ব্যবহার করে:

  • kotlin.reflect বা java.lang.reflect প্যাকেজ থেকে ক্লাস বা পদ্ধতি ব্যবহার করে।
  • Class.forName বা classLoader.getClass ফাংশন ব্যবহার করে।
  • রানটাইমে অ্যানোটেশন পড়ে, যেমন এটি যদি val value = myClass.getAnnotation() বা val value = myMethod.getAnnotation() ব্যবহার করে অ্যানোটেশন ভ্যালু স্টোর করে এবং তারপর value-এর সাথে কিছু করে।
  • নিম্নলিখিত উদাহরণের মতো, স্ট্রিং হিসেবে মেথডের নাম ব্যবহার করে মেথড কল করে:

    // Calls the private `processData` API with reflection
    myObject.javaClass.getMethod("processData", DataType::class.java)
    ?.invoke(myObject, data)
    

অপ্টিমাইজেশন সংক্রান্ত সমস্যা চেক করুন

নতুন লাইব্রেরি বিবেচনা করার সময়, লাইব্রেরির ইস্যু ট্র্যাকার এবং অনলাইন আলোচনা দেখুন, যাতে ছোট করা বা অ্যাপ অপ্টিমাইজেশন কনফিগার করার সাথে সম্পর্কিত কোনও সমস্যা আছে কিনা তা চেক করা যায়। যদি থাকে, তাহলে সেই লাইব্রেরির বিকল্প খোঁজার চেষ্টা করুন। নিম্নলিখিত বিষয়গুলি মনে রাখবেন:

  • AndroidX লাইব্রেরি এবং Hilt-এর মতো লাইব্রেরি অ্যাপ অপ্টিমাইজেশনের সাথে ভালভাবে কাজ করে কারণ তারা বেশিরভাগই রিফ্লেকশনের পরিবর্তে কোডজেন ব্যবহার করে। তারা রিফ্লেকশন ব্যবহার করলে, শুধুমাত্র প্রয়োজনীয় কোড রাখার জন্য ন্যূনতম নিয়ম প্রদান করে।
  • অবজেক্ট ইনস্ট্যানশিয়েট বা সিরিয়ালাইজ করার সময় বয়লারপ্লেট কোড এড়াতে সিরিয়ালাইজেশন লাইব্রেরি প্রায়শই রিফ্লেকশন ব্যবহার করে। রিফ্লেকশন-ভিত্তিক পদ্ধতির (যেমন JSON-এর জন্য Gson) পরিবর্তে, এইসব সমস্যা এড়াতে codegen ব্যবহার করে এমন লাইব্রেরি খুঁজুন, যেমন Kotlin Serialization বা codegen সহ Moshi ব্যবহার করে।
  • সম্ভব হলে, প্যাকেজ-ওয়াইড কিপ রুল সহ লাইব্রেরি এড়িয়ে চলুন। প্যাকেজ-ওয়াইড কিপ রুল সমস্যার সমাধান করতে সাহায্য করতে পারে, তবে ব্রড কিপ রুল অবশেষে শুধুমাত্র প্রয়োজনীয় কোড রাখার জন্য রিফাইন করা উচিত। আরও তথ্যের জন্য, ইনক্রিমেন্টালভাবে অপ্টিমাইজেশন গ্রহণ করা দেখুন।
  • থার্ড-পার্টি লাইব্রেরি ব্যবহার করে এমন অ্যাপ প্রকাশ করার আগে, R8 কনফিগারেশন অ্যানালাইজার ব্যবহার করে এটির প্রদান করা নিয়ম অডিট করুন। রিপোর্ট পর্যালোচনা করে আপনি যাচাই করতে পারবেন যে লাইব্রেরির কিপ রুল খুব বেশি ব্রড কিনা, যা R8-কে আপনার কোডবেসে গুরুত্বপূর্ণ অপ্টিমাইজেশন করতে বাধা দেয়। এই চেক নিশ্চিত করে যে আপনার বেছে নেওয়া লাইব্রেরি আপনার অ্যাপের পারফর্ম্যান্স লক্ষ্যের সাথে সামঞ্জস্যপূর্ণ এবং অপ্রয়োজনীয় কনফিগারেশন ব্লট প্রবর্তন করে না।
  • লাইব্রেরির জন্য আপনাকে ডকুমেন্টেশন থেকে আপনার প্রোজেক্টের ফাইলে, বিশেষ করে প্যাকেজ-ওয়াইড কিপ রুল, কিপ রুল কপি এবং পেস্ট করতে হবে না। এইসব নিয়ম দীর্ঘমেয়াদে অ্যাপ ডেভেলপারের পক্ষে মেনে চলা কঠিন হয়ে পড়ে এবং সময়ের সাথে সাথে এগুলি অপ্টিমাইজ ও পরিবর্তন করাও কঠিন।

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

আপনি নতুন লাইব্রেরি যোগ করার পরে অপ্টিমাইজেশন চালু করুন এবং কোনও সমস্যা আছে কিনা তা চেক করুন। কোনও সমস্যা থাকলে, সেই লাইব্রেরির বিকল্প খুঁজুন অথবা কিপ রুল লিখুন। কোনও লাইব্রেরি অপ্টিমাইজেশনের সাথে মানানসই না হলে, সেই লাইব্রেরির সাথে একটি বাগ ফাইল করুন।

খারাপ রাখার নিয়ম ফিল্টার করুন (উন্নত)

'রাখুন' সংক্রান্ত নিয়মগুলি যোগ করা হয়। এর অর্থ হল, লাইব্রেরি ডিপেন্ডেন্সিতে অন্তর্ভুক্ত কিছু নিয়ম সরানো যাবে না এবং আপনার অ্যাপের অন্যান্য অংশের কম্পাইলেশনকে প্রভাবিত করতে পারে। উদাহরণস্বরূপ, যদি কোনও লাইব্রেরিতে কোড অপ্টিমাইজেশন বন্ধ করার নিয়ম অন্তর্ভুক্ত থাকে, তাহলে সেই নিয়মটি আপনার পুরো প্রোজেক্টের জন্য অপ্টিমাইজেশন বন্ধ করে দেয়।

আপনার এমন লাইব্রেরি এড়িয়ে চলা উচিত যেগুলিতে এমন কোড রেখে দেওয়ার নিয়ম আছে যা আসলে মুছে ফেলা উচিত। তবে, আপনাকে যদি সেগুলি ব্যবহার করতেই হয়, তাহলে নিম্নলিখিত কোডে যেভাবে দেখানো হয়েছে, সেইভাবে আপনি নিয়মগুলি ফিল্টার করতে পারবেন:

// If you're using AGP 8.4 and higher
buildTypes {
    release {
        optimization.keepRules {
          it.ignoreFrom("com.somelibrary:somelibrary")
        }
    }
}

// If you're using AGP 7.3-8.3
buildTypes {
    release {
        optimization.keepRules {
          it.ignoreExternalDependencies("com.somelibrary:somelibrary")
        }
    }
}

ব্রড লাইব্রেরি নিয়মের জন্য সাজেস্ট করা ওয়ার্কফ্লো

R8 কনফিগারেশন অ্যানালাইজার যদি প্রকাশ করে যে কোনও লাইব্রেরি অত্যধিক বিস্তৃত নিয়ম বান্ডেল করে, তাহলে সেই নিয়মগুলি শুধুমাত্র লোকাল বিল্ডে ফিল্টার করুন, প্রোডাকশন বিল্ডে নয়। নিয়মগুলি আপনার অ্যাপকে কতটা প্রভাবিত করে তা পরীক্ষা করতে, এই ধাপগুলি অনুসরণ করুন:

  1. লাইব্রেরি আপডেট করুন: R8 কনফিগারেশন অ্যানালাইজার ফ্ল্যাগ করা লাইব্রেরির লেটেস্ট ভার্সন ব্যবহার করছেন কিনা তা নিশ্চিত করুন, কারণ নতুন ভার্সনগুলি আরও সংকীর্ণ গ্রাহক রাখার নিয়ম পাঠাতে পারে। লেটেস্ট ভার্সন খুঁজে পেতে, লাইব্রেরির ডকুমেন্টেশন বা এর Maven রিপোজিটরি চেক করুন। এছাড়াও, Android Studio অনেক ডিপেন্ডেন্সির নতুন ভার্সন ফ্ল্যাগ করে। আপডেট করার পরে, R8 কনফিগারেশন অ্যানালাইজার আবার রান করে চেক করুন যে ব্রড কিপ রুল এখনও আছে কিনা।
  2. লোকালি সম্ভাব্য উন্নতি চেক করুন: লাইব্রেরির বান্ডেল করা কনজিউমার নিয়ম আপনার লোকাল কিপ নিয়ম ফাইলে কপি করুন, বান্ডেল করা নিয়ম ফিল্টার করুন যেমন খারাপ কিপ নিয়ম ফিল্টার করুন-এ দেখানো হয়েছে এবং কপি করা নিয়ম সংক্ষিপ্ত করুন। আপনার অ্যাপের সঙ্কোচন, অপ্টিমাইজেশন এবং অস্পষ্টতা স্কোর তুলনা করার জন্য নিয়মগুলি সংকীর্ণ করার আগে এবং পরে R8 কনফিগারেশন বিশ্লেষক চালান।
  3. ফলাফল রিপোর্ট করুন: লাইব্রেরি মেইনটেনারের কাছে একটি বাগ রিপোর্ট ফাইল করুন যার মধ্যে আপনার R8 কনফিগারেশন অ্যানালাইজার রিপোর্ট থেকে প্রাপ্ত অভিজ্ঞতামূলক ডেটা রয়েছে (উদাহরণস্বরূপ, তাদের ওয়াইল্ডকার্ড নিয়ম দ্বারা সংরক্ষিত রেফারেন্স না করা ক্লাস বা পদ্ধতির নির্দিষ্ট সংখ্যা প্রদর্শন করা)।

কেস স্টাডি: অপ্টিমাইজেশনের কারণে Gson কেন কাজ করা বন্ধ করে দেয়

Gson হল একটি সিরিয়ালাইজেশন লাইব্রেরি যা প্রায়ই অ্যাপ অপ্টিমাইজেশনের ক্ষেত্রে সমস্যা সৃষ্টি করে কারণ এটি ব্যাপকভাবে রিফ্লেকশন ব্যবহার করে। নিম্নলিখিত কোড স্নিপেট দেখায় যে কীভাবে Gson সাধারণত ব্যবহার করা হয়, যা রানটাইমে ক্র্যাশ হওয়ার কারণ হতে পারে। লক্ষ্য করুন যে আপনি যখন ব্যবহারকারীর অবজেক্টের তালিকা পেতে Gson ব্যবহার করেন, তখন আপনি কনস্ট্রাক্টরকে কল করেন না বা fromJson() ফাংশনে ফ্যাক্টরি পাস করেন না। নিম্নলিখিতগুলির কোনও একটি ছাড়া অ্যাপ-ডিফাইন করা ক্লাস তৈরি বা ব্যবহার করা হলে, তা থেকে বোঝা যায় যে লাইব্রেরিটি ওপেন-এন্ডেড রিফ্লেকশন ব্যবহার করছে:

  • অ্যাপ ক্লাস যা লাইব্রেরি বা স্ট্যান্ডার্ড ইন্টারফেস বা ক্লাস প্রয়োগ করে
  • KSP-এর মতো কোড জেনারেশন প্লাগ-ইন
class User(val name: String)
class UserList(val users: List<User>)

// This code runs in debug mode, but crashes when optimizations are enabled
Gson().fromJson("""[{"name":"myname"}]""", User::class.java).toString()

Gson-এ R8 কীভাবে কাজ করে তা বুঝতে, Gson গ্রাহক নিয়ম দেখুন। R8 যখন এই কোড বিশ্লেষণ করে এবং কোথাও UserList বা User ইনস্ট্যান্সিয়েট করা হয়েছে বলে দেখতে পায় না, তখন এটি ফিল্ডের নাম পরিবর্তন করতে পারে বা কনস্ট্রাক্টর সরিয়ে দিতে পারে যা ব্যবহার করা হয়েছে বলে মনে হয় না, এর ফলে আপনার অ্যাপ ক্র্যাশ করতে পারে। আপনি যদি একই উপায়ে অন্য কোনও লাইব্রেরি ব্যবহার করেন, তাহলে আপনাকে চেক করে দেখতে হবে যে সেগুলি অ্যাপ অপ্টিমাইজেশনে কোনও বাধা সৃষ্টি করছে কিনা এবং যদি করে, তাহলে সেগুলি এড়িয়ে চলুন।

Gson-এর পরবর্তী ভার্সনের সাথে @SerializedName ব্যবহার করুন

Gson-এর কনজিউমার নিয়মের সাথে মানানসই পদ্ধতিতে আপনার ডেটা মডেল সংজ্ঞায়িত করতে, নিম্নলিখিত স্নিপেটে দেখানো অনুযায়ী @SerializedName-এর মাধ্যমে আপনার ফিল্ড অ্যানোটেট করুন:

import com.google.gson.annotations.SerializedName

class User(@SerializedName("name") val name: String)
class UserList(@SerializedName("users") val users: List<User>)

@SerializedName অ্যানোটেশন ব্যবহার করে, আপনি R8-কে Gson ভার্সন 2.11.0 এবং তার পরবর্তী ভার্সনে বান্ডেল করা নিয়ম রাখুন-এর সাথে আপনার মডেল ক্লাস ম্যাচ করার অনুমতি দেন। R8 অটোমেটিক অ্যানোটেট করা ফিল্ড ও প্রয়োজনীয় কনস্ট্রাক্টর সংরক্ষণ করে, যার ফলে আপনার প্রোজেক্টে ম্যানুয়ালি ProGuard কনফিগারেশন বজায় রাখার প্রয়োজন হয় না এবং আপনি লাইব্রেরির বান্ডেল করা নিয়মের উপর নির্ভর করতে পারেন।

মনে রাখবেন যে Room, Hilt এবং Moshi with codegen কনস্ট্রাক্ট অ্যাপ-নির্ধারিত ধরন, তবে রিফ্লেকশনের প্রয়োজনীয়তা এড়াতে codegen ব্যবহার করুন।