Fused Library-এর মাধ্যমে একাধিক Android লাইব্রেরি একটি হিসেবে প্রকাশ করুন

অনেক মডিউল সহ প্রোজেক্টে, প্রোজেক্টের স্পষ্ট স্ট্রাকচার বজায় রাখার চেষ্টা করার সময় আপনার ব্যবহারকারীদের কাছে Android লাইব্রেরি ডিস্ট্রিবিউট করা চ্যালেঞ্জিং হতে পারে। অনেক ক্ষেত্রে, যতটা ভাবা হয় তার চেয়ে অনেক বেশি লাইব্রেরি প্রকাশ করতে হয়।

Android Gradle প্লাগ-ইনের সাথে বান্ডেল করা ফিউজড লাইব্রেরি প্লাগ-ইন একাধিক Android লাইব্রেরি মডিউলকে একটি প্রকাশযোগ্য Android লাইব্রেরিতে প্যাকেজ করতে সাহায্য করে। এটি আপনাকে আপনার লাইব্রেরির সোর্স কোড এবং মডুলারাইজ করতে দেয় আপনার বিল্ডের মধ্যে রিসোর্স যেমন আপনি উপযুক্ত মনে করেন, আপনার এক্সপোজার এড়ানোর সময় প্রজেক্টের স্ট্রাকচার একবার ডিস্ট্রিবিউট করা হয়েছে।

একটি লাইব্রেরি হিসেবে ডিস্ট্রিবিউট করলে নিম্নলিখিত সুবিধা পাওয়া যেতে পারে:

  • সরলীকৃত ডিপেন্ডেন্সি: একাধিক লাইব্রেরি ডিপেন্ডেন্সির পরিবর্তে একটি মাত্র AAR ব্যবহার করে, যা আপনার ব্যবহারকারীদের জন্য প্রোজেক্ট সেট-আপ এবং ভার্সন ম্যানেজমেন্টকে আরও সহজ করে তোলে
  • লাইব্রেরির সাইজ কমানো: কোড সঙ্কোচন উন্নত করতে পারে, যার ফলে ছোট AAR হয়
  • উন্নত নিরাপত্তা: প্রকাশিত লাইব্রেরির ইন্টার্নাল ইমপ্লিমেন্টেশন সংক্রান্ত বিবরণের উপর আরও ভালো নিয়ন্ত্রণ অফার করতে পারে

ফিউজড লাইব্রেরি তৈরি করুন

ফিউজড লাইব্রেরি তৈরি করতে, আপনাকে একটি নতুন Android মডিউল তৈরি করতে হবে, ডিপেন্ডেন্সি যোগ করতে হবে এবং তারপরে ফিউজড লাইব্রেরি প্রকাশ করতে হবে।

পূর্বশর্ত

Fused Library প্লাগ-ইন ব্যবহার করতে, AGP 9.0 বা তার পরবর্তী যেকোনও ভার্সন ব্যবহার করুন। Fused Library প্লাগ-ইনের আগের ভার্সনে আলাদা আচরণ ও সমস্যা ছিল যা AGP 9.0-তে সমাধান করা হয়েছে।

নতুন ফিউজড লাইব্রেরি মডিউল যোগ করুন

প্লাগ-ইন ব্যবহার করতে, আপনার প্রোজেক্টে একটি নতুন Android মডিউল যোগ করতে হবে:

এই উদাহরণে, ফিউজড লাইব্রেরি মডিউলকে myFusedLibrary বলা হবে।

  1. settings.gradle.kts ফাইলে include(":myFusedLibrary") যোগ করুন।
  2. gradle/libs.versions.toml ফাইলের [plugins] বিভাগের নিচে android-fusedlibrary = { id = "com.android.fused-library", version.ref = "agp" } যোগ করুন।
  3. সবচেয়ে উপরের লেভেলের build.gradle.kts ফাইলে প্লাগ-ইন ব্লকে alias(libs.plugins.android.fusedlibrary) apply false যোগ করুন।
  4. myFusedLibrary মডিউল তৈরি করতে, myFusedLibrary নামে একটি নতুন ডিরেক্টরি তৈরি করুন ('আমার অ্যাপ্লিকেশন' > নতুন > ডিরেক্টরি বিকল্পে ডানদিকের বোতামে ক্লিক করুন)।
  5. myFusedLibrary মডিউলে একটি build.gradle.kts ফাইল তৈরি করুন (myFusedLibrary মডিউলে ডানদিকের বোতামে ক্লিক করুন > নতুন > ফাইল)।
  6. myFusedLibrary/build.gradle.kts ফাইলে নিম্নলিখিত টেক্সট পেস্ট করুন:

Kotlin

plugins {
    alias(libs.plugins.android.fusedlibrary)
    `maven-publish`
}

androidFusedLibrary {
    namespace = "com.example.myFusedLibrary"
    minSdk = 21
}

dependencies { }

গ্ৰুভি

plugins {
    id 'com.android.fused-library'
}

androidFusedLibrary {
    namespace 'com.example.myFusedLibrary'
    minSdk 21
}

dependencies {

}

ডিপেন্ডেন্সি যোগ করুন

ফিউজড লাইব্রেরির মূল কার্যকারিতা হল ডিপেন্ডেন্সি বান্ডেল করা। প্লাগ-ইন লোকাল প্রোজেক্ট ডিপেন্ডেন্সি ও এক্সটার্নাল লাইব্রেরি যোগ করার সুবিধা দেয়। প্যাকেজ করা ডিপেন্ডেন্সি নির্দিষ্ট করতে, include কনফিগারেশন ব্যবহার করুন। ট্রানজিটিভ ডিপেন্ডেন্সি প্যাকেজ করা হয়নি।

যেমন:

Kotlin

dependencies {
    include(project(":image-rendering"))
    include("mycoolfonts:font-wingdings:5.0")
}

গ্ৰুভি

dependencies {
    include project(':image-rendering')
    include 'mycoolfonts:font-wingdings:5.0'
}
দেখুন

আপনার ফিউজ করা লাইব্রেরি প্রকাশ করুন

ফিউজড লাইব্রেরি প্রকাশ করার আগে, Android লাইব্রেরি প্রকাশ করা সম্পর্কে আপনার জেনে নেওয়া উচিত। ফিউজড লাইব্রেরি প্রকাশ করা Android লাইব্রেরি প্রকাশ করার মতোই, তবে কিছু মূল পার্থক্য রয়েছে যা ফিউজড লাইব্রেরি সঠিকভাবে প্রকাশ করার জন্য আপনাকে অবশ্যই বিবেচনা করতে হবে:

  • এছাড়াও, Fused Library প্লাগ-ইন প্রয়োগ করা হয়েছে এমন যেকোনও মডিউলে Maven Publish প্লাগ-ইন প্রয়োগ করতে হবে।
  • প্রকাশনাটি অবশ্যই fusedLibraryComponent থেকে ইনহেরিট করতে হবে কারণ এটি ফিউজড লাইব্রেরি আর্টিফ্যাক্ট কম্পাইল করার জন্য প্রয়োজনীয় ডিপেন্ডেন্সি প্রদান করে।

প্রকাশনার কনফিগারেশনের একটি উদাহরণ এখানে দেওয়া হল:

Kotlin

plugins {
    alias(libs.plugins.android.fusedlibrary)
    `maven-publish`
}

androidFusedLibrary { … }

dependencies { … }

publishing {
    publications {
        register<MavenPublication>("release") {
             groupId = "my-company"
             artifactId = "my-fused-library"
             version = "1.0"
             from(components["fusedLibraryComponent"])
        }
    }
}

গ্ৰুভি

plugins {
    id 'com.android.fused-library'
    id 'maven-publish'
}

androidFusedLibrary { … }

dependencies { … }

publishing {
    publications {
        release(MavenPublication) {
            groupId = "my-company"
            artifactId = "my-fused-library"
            version = "1.0"
            afterEvaluate {
            from components.fusedLibraryComponent
        }
    }
}

পরীক্ষা করার জন্য আপনার ফিউজড লাইব্রেরি প্রকাশ করুন

Android অ্যাপ বা Android লাইব্রেরি থেকে প্রকাশিত ফিউজড লাইব্রেরির উপর নির্ভর করে আপনাকে পরীক্ষা করতে হবে। সাজেস্ট করা পদ্ধতি হল, ফিউজড লাইব্রেরিতে প্রকাশ করা এবং স্থানীয় Maven রিপোজিটরিতে এর প্রোজেক্ট ডিপেন্ডেন্সি প্রকাশ করা।

ফিউজড লাইব্রেরি আর্টিফ্যাক্ট লোকাল রিপোজিটরিতে প্রকাশ করতে, নিম্নলিখিত কনফিগারেশনের মতো একটি কনফিগারেশন নির্ধারণ করুন:

Kotlin

plugins {
    alias(libs.plugins.android.fusedlibrary)
    `maven-publish`
}

repositories {
    maven {
        name = "myLocalRepo"
        url = uri(layout.buildDirectory.dir("myLocalRepo"))
    }
}

গ্ৰুভি

plugins {
    id 'com.android.fused-library'
    id 'maven-publish'
}

repositories {
    maven {
        name 'myLocalRepo'
        url layout.buildDirectory.dir('myLocalRepo')
    }
}

আপনার ফিউজ করা লাইব্রেরি আপলোড করুন

আপনার ফিউজ করা লাইব্রেরি ডিস্ট্রিবিউট করতে, আপনার লাইব্রেরি আপলোড করুন দেখুন।

আচরণ ও সুরক্ষা

Android লাইব্রেরি একত্রিত করার ক্ষেত্রে জটিলতা রয়েছে যা প্লাগ-ইনের জন্য অগ্রাধিকার সম্পর্কে যুক্তি দেওয়া চ্যালেঞ্জিং করে তুলতে পারে। যেমন, একই ক্লাসপাথ সহ দুটি লাইব্রেরি থাকলে, লাইব্রেরি ফিউজ করার সময় বিল্ড ব্যর্থ হবে। রিসোর্স মার্জ করার সময় বিভিন্ন লাইব্রেরিতে একই নামের রিসোর্স বেছে নেওয়ার সময় নির্ভরতার ক্রম বিবেচনা করা হবে।

  • ফিউজড লাইব্রেরি শুধুমাত্র Android লাইব্রেরি আর্টিফ্যাক্ট AAR হিসেবে প্রকাশ করা যেতে পারে যাতে ডিপেন্ডেন্সি হিসেবে যোগ করা যায়।
  • ডেটা বাইন্ডিং ব্যবহার করে এমন লাইব্রেরি ফিউজ করার সুবিধা কাজ করে না।
  • আপনি একটি ফিউজড লাইব্রেরির মধ্যে একাধিক বিল্ডের ধরন এবং প্রোডাক্ট ফ্লেভার ফিউজ করতে পারবেন না। বিভিন্ন ভেরিয়েন্টের জন্য আলাদা ফিউজড লাইব্রেরি তৈরি করুন।

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

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

Kotlin

 androidFusedLibrary { aarMetadata { minCompileSdk = 21 minCompileSdkExtension = 1 } }
Java রিসোর্স একই পাথ সহ একাধিক লাইব্রেরিতে Java রিসোর্স ফাইল অনুমোদিত নয় এবং এর ফলে বিল্ড ব্যর্থ হবে।

পরিচিত সমস্যা

Fused Library হল একটি নতুন প্লাগ-ইন এবং এর কিছু পরিচিত সমস্যা আছে যেগুলি সমাধান করার জন্য কাজ করা হচ্ছে যাতে সব ধরনের ব্যবহারের ক্ষেত্রে এটি কাজ করে। আপনি কোনও সমস্যার সম্মুখীন হলে, সমস্যার বিষয়ে অভিযোগ জানাতে পারবেন।

  • সমস্যা #৪৫৪৩০৫৪৪৪: যেসব লাইব্রেরিতে 'proguard.txt' নামে পরিচিত নয় এমন গ্রাহক প্রোগার্ড নিয়ম থাকে, সেগুলি বিল্ড করতে ব্যর্থ হয়। AGP 9.1 এবং তার পরবর্তী ভার্সনে সমাধান করা হয়েছে।
  • সমস্যা #৩৭৪৯৮২৭৩৯: অন্যান্য .aar ফাইলে ফাইল ডিপেন্ডেন্সি যোগ করা হচ্ছে
  • সমস্যা #২৩১৪৩৩২২৫: RenderScript ও Prefab আর্টিফ্যাক্ট ফিউজ করার জন্য কোনও সহায়তা নেই

ফিউজড লাইব্রেরির ডিপেন্ডেন্সি বোঝা

ফিউজড লাইব্রেরির কোনও সোর্স নেই এবং এটি কার্যকরভাবে Android লাইব্রেরিগুলিকে এর একমাত্র সোর্স হিসেবে ব্যবহার করে, তাই কোথা থেকে কী আসে তা বোঝা গুরুত্বপূর্ণ। ফলাফল হিসেবে পাওয়া আর্টিফ্যাক্টে মার্জ করা ডিপেন্ডেন্সি এবং আর্টিফ্যাক্ট তৈরি করার জন্য প্রয়োজনীয় ডিপেন্ডেন্সির তালিকা তৈরি করতে, ফিউজ করা লাইব্রেরিতে gradle :report টাস্ক রান করুন। টাস্কটি একটি JSON রিপোর্ট তৈরি করে যা ফিউজড লাইব্রেরির build/reports ডিরেক্টরিতে সেভ করা হয়।

ইন্টার্নাল প্লাগ-ইন ডিপেন্ডেন্সি সম্পর্কিত অতিরিক্ত তথ্যের জন্য, প্লাগ-ইন কনফিগারেশনের অবস্থা দেখতে gradle :dependencies টাস্ক রান করুন।