টুল অ্যাট্রিবিউট রেফারেন্স

Jetpack Compose সরাসরি Kotlin-এ UI ডিজাইন-টাইম টুলিং ম্যানেজ করলেও, প্রোজেক্ট-লেভেল কনফিগারেশনের জন্য tools: নেমস্পেস এখনও অপরিহার্য। Android XML ফাইল, যেমন AndroidManifest.xml এবং res/raw/keep.xml, tools: অ্যাট্রিবিউট ব্যবহার করে Lint সংক্রান্ত সতর্কতা ম্যানেজ করে এবং রিসোর্স শ্রিঙ্কার কনফিগার করে।

আপনি অ্যাপ তৈরি করার সময়, বিল্ড টুল এইসব অ্যাট্রিবিউট সরিয়ে দেয় যাতে আপনার APK সাইজ বা রানটাইম আচরণে কোনও প্রভাব না পড়ে।

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

<RootTag xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:tools="http://schemas.android.com/tools" >

সমস্যা ম্যানেজ করার অ্যাট্রিবিউট

নিম্নলিখিত অ্যাট্রিবিউট লিন্ট সংক্রান্ত সতর্কতামূলক মেসেজ দমন করতে সাহায্য করে:

tools:ignore

এর জন্য: যেকোনও এলিমেন্ট

ব্যবহার করেছে: Lint

এই অ্যাট্রিবিউট লিন্ট সমস্যার আইডি কমা দিয়ে আলাদা করা তালিকা গ্রহণ করে, আপনি এই এলিমেন্ট বা এর কোনও ডিসেন্ডেন্টে টুলকে উপেক্ষা করতে চান।

যেমন, আপনি টুলকে MissingTranslation সমস্যা এড়িয়ে যেতে বলতে পারেন:

<string name="show_all_apps" tools:ignore="MissingTranslation">All</string>

tools:targetApi

উদ্দেশ্য: যেকোনও এলিমেন্ট

ব্যবহার করে: Lint

এই অ্যাট্রিবিউট Java কোডে @TargetApi অ্যানোটেশন বা Kotlin কোডে @RequiresApi অ্যানোটেশনের মতোই কাজ করে। এটি আপনাকে API লেভেল (পূর্ণসংখ্যা বা কোড নেম হিসেবে) নির্দিষ্ট করতে দেয় যা এই এলিমেন্টকে সাপোর্ট করে।

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

যেমন, আপনি এই অ্যাট্রিবিউট ব্যবহার করতে পারেন কারণ আপনি নিজের AndroidManifest.xml-এ এমন একটি <service> ঘোষণা করছেন যা API লেভেল ৩৪ ও তার থেকে উন্নত ভার্সনে উপলভ্য ফোরগ্রাউন্ড সার্ভিস টাইপ ব্যবহার করে, কিন্তু আপনার প্রোজেক্টের minSdkVersion এর থেকে কম:

<service
    android:name=".playback.MediaPlaybackService"
    android:foregroundServiceType="mediaPlayback"
    xmlns:tools="http://schemas.android.com/tools"
    tools:targetApi="34" />

tools:locale

এর জন্য: <resources>

ব্যবহার করে: Lint, Android Studio এডিটর

এটি টুলকে জানায় যে প্রদত্ত <resources> এলিমেন্টে রিসোর্সের জন্য ডিফল্ট ভাষা বা লোকেল কী, যাতে বানান পরীক্ষক থেকে সতর্কতা এড়ানো যায়। অন্যথায়, টুলটি ধরে নেয় যে ভাষাটি ইংরেজি।

ভ্যালুটি অবশ্যই একটি সঠিক লোকেল কোয়ালিফায়ার হতে হবে।

যেমন, ডিফল্ট স্ট্রিংয়ের জন্য ব্যবহৃত ভাষা ইংরেজি নয়, স্প্যানিশ, তা বোঝাতে আপনি এটি আপনার ডিফল্ট values/strings.xml ফাইলে যোগ করতে পারেন:

<resources xmlns:tools="http://schemas.android.com/tools"
    tools:locale="es">

রিসোর্স সরিয়ে দেওয়ার অ্যাট্রিবিউট

নিম্নলিখিত অ্যাট্রিবিউট আপনাকে কঠোর রেফারেন্স চেক চালু করতে এবং রিসোর্স সরিয়ে দেওয়া ফিচার ব্যবহার করার সময় নির্দিষ্ট রিসোর্স রাখা বা বাতিল করা হবে কিনা তা ঘোষণা করতে দেয়।

রিসোর্স সরিয়ে দেওয়ার সুবিধা চালু করতে, আপনার build.gradle ফাইলে shrinkResources প্রপার্টি true-এ সেট করুন, এর পাশাপাশি কোড সরিয়ে দেওয়ার জন্য minifyEnabled সেট করুন।

যেমন:

গ্ৰুভি

android {
    ...
    buildTypes {
        release {
            shrinkResources true
            minifyEnabled true
            proguardFiles getDefaultProguardFile('proguard-android.txt'),
                    'proguard-rules.pro'
        }
    }
}

Kotlin

android {
    ...
    buildTypes {
        getByName("release") {
            isShrinkResources = true
            isMinifyEnabled = true
            proguardFiles(
                getDefaultProguardFile("proguard-android.txt"),
                "proguard-rules.pro"
            )
        }
    }
}

tools:shrinkMode

এর জন্য: <resources>

ব্যবহার করে: রিসোর্স সরিয়ে দেওয়ার সাথে বিল্ড টুল

এই অ্যাট্রিবিউট আপনাকে বিল্ড টুল নিম্নলিখিতগুলি ব্যবহার করবে কিনা তা নির্দিষ্ট করতে দেয়:

  • নিরাপদ মোড: স্পষ্টভাবে উল্লেখ করা হয়েছে এমন সব রিসোর্স রাখুন এবং Resources.getIdentifier-এ কল করার মাধ্যমে যেগুলি ডায়নামিকভাবে রেফার করা হতে পারে।
  • স্ট্রিক্ট মোড: শুধুমাত্র সেইসব রিসোর্স রাখুন যেগুলি কোড বা অন্যান্য রিসোর্সে স্পষ্টভাবে উল্লেখ করা আছে।

ডিফল্ট হিসেবে নিরাপদ মোড (shrinkMode="safe") ব্যবহার করা হয়। এর পরিবর্তে স্ট্রিক্ট মোড ব্যবহার করতে, এখানে দেখানো অনুযায়ী <resources> ট্যাগে shrinkMode="strict" যোগ করুন:

<?xml version="1.0" encoding="utf-8"?>
<resources xmlns:tools="http://schemas.android.com/tools"
    tools:shrinkMode="strict" />

আপনি স্ট্রিক্ট মোড চালু করলে, যেসব রিসোর্স সরিয়ে দেওয়া হয়েছে কিন্তু আপনি আসলে রাখতে চান, সেগুলি রেখে দিতে আপনাকে tools:keep ব্যবহার করতে হতে পারে এবং আরও বেশি রিসোর্স স্পষ্টভাবে সরিয়ে দিতে tools:discard ব্যবহার করতে হতে পারে।

আরও তথ্যের জন্য, আপনার রিসোর্স সঙ্কুচিত করুন দেখুন।

tools:keep

এর জন্য: <resources>

ব্যবহার করে: রিসোর্স সরিয়ে দেওয়ার সাথে বিল্ড টুল

অব্যবহৃত রিসোর্স সরিয়ে দেওয়ার জন্য রিসোর্স সরিয়ে দেওয়ার ফিচার ব্যবহার করার সময়, এই অ্যাট্রিবিউট আপনাকে সেইসব রিসোর্স নির্দিষ্ট করতে দেয় যেগুলি আপনি রাখতে চান, সাধারণত কারণ সেগুলি রানটাইমে পরোক্ষভাবে রেফারেন্স করা হয়, যেমন ডায়নামিকভাবে তৈরি করা রিসোর্সের নাম Resources.getIdentifier-এ পাস করার মাধ্যমে।

ব্যবহার করতে, আপনার রিসোর্স ডিরেক্টরিতে (যেমন, res/raw/keep.xml) <resources> ট্যাগ সহ একটি XML ফাইল তৈরি করুন এবং tools:keep অ্যাট্রিবিউটে রাখার জন্য প্রতিটি রিসোর্সকে কমা দ্বারা আলাদা করা তালিকা হিসেবে নির্দিষ্ট করুন। আপনি ওয়াইল্ডকার্ড হিসেবে অ্যাস্টেরিস্ক অক্ষর ব্যবহার করতে পারবেন।

যেমন:

<?xml version="1.0" encoding="utf-8"?>
<resources xmlns:tools="http://schemas.android.com/tools"
    tools:keep="@layout/used_1,@layout/used_2,@layout/*_3" />

আরও তথ্যের জন্য, আপনার রিসোর্স সঙ্কুচিত করুন দেখুন।

tools:discard

এর জন্য: <resources>

ব্যবহার করে: রিসোর্স সরিয়ে দেওয়ার সাথে বিল্ড টুল

অব্যবহৃত রিসোর্স সরিয়ে দেওয়ার জন্য রিসোর্স সরিয়ে দেওয়ার ফিচার ব্যবহার করার সময়, এই অ্যাট্রিবিউট আপনাকে ম্যানুয়ালি বাতিল করতে চান এমন রিসোর্স নির্দিষ্ট করতে দেয়, সাধারণত কারণ রিসোর্সটি রেফারেন্স করা হয়েছে কিন্তু এমনভাবে যা আপনার অ্যাপকে প্রভাবিত করে না বা কারণ Gradle প্লাগইন ভুলভাবে অনুমান করেছে যে রিসোর্সটি রেফারেন্স করা হয়েছে।

ব্যবহার করতে, আপনার রিসোর্স ডিরেক্টরিতে (যেমন, res/raw/keep.xml) <resources> ট্যাগ সহ একটি XML ফাইল তৈরি করুন এবং tools:discard অ্যাট্রিবিউটে বাদ দেওয়ার জন্য প্রতিটি রিসোর্স কমা দিয়ে আলাদা করা তালিকা হিসেবে উল্লেখ করুন। আপনি ওয়াইল্ডকার্ড হিসেবে অ্যাস্টেরিস্ক অক্ষর ব্যবহার করতে পারবেন।

যেমন:

<?xml version="1.0" encoding="utf-8"?>
<resources xmlns:tools="http://schemas.android.com/tools"
    tools:discard="@layout/unused_1" />

আরও তথ্যের জন্য, আপনার রিসোর্স সঙ্কুচিত করুন দেখুন।

অতিরিক্ত রিসোর্স

কন্টেন্ট দেখে