অ্যান্ড্রয়েড স্টুডিও বিল্ড সিস্টেমটি গ্রেডলের উপর ভিত্তি করে, এবং অ্যান্ড্রয়েড গ্রেডল প্লাগইন বেশ কয়েকটি বৈশিষ্ট্য যুক্ত করে যা অ্যান্ড্রয়েড অ্যাপ তৈরির জন্য নির্দিষ্ট। যদিও অ্যান্ড্রয়েড গ্রেডল প্লাগইন (এজিপি) সাধারণত অ্যান্ড্রয়েড স্টুডিওর সাথে লক-স্টেপে আপডেট করা হয়, প্লাগইন (এবং বাকি গ্রেডল সিস্টেম) অ্যান্ড্রয়েড স্টুডিও থেকে স্বাধীনভাবে চলতে পারে এবং আলাদাভাবে আপডেট করা যেতে পারে।
এই পৃষ্ঠাটি ব্যাখ্যা করে যে কীভাবে আপনার গ্রেডল টুলগুলিকে আপ টু ডেট রাখবেন এবং সাম্প্রতিক আপডেটগুলিতে কী আছে৷ অতীতের Android Gradle প্লাগইন সংস্করণগুলির জন্য রিলিজ নোটগুলির জন্য, অতীতের রিলিজ নোটগুলি দেখুন।
অ্যান্ড্রয়েড গ্রেডল প্লাগইনের এই সংস্করণে কী ঠিক করা হয়েছে তা দেখতে, বন্ধ হওয়া সমস্যাগুলি দেখুন।
Android Gradle প্লাগইনে আসন্ন ব্রেকিং পরিবর্তনগুলির একটি উচ্চ-স্তরের সারাংশের জন্য, Android Gradle প্লাগইন রোডম্যাপ দেখুন।
Gradle এর সাথে আপনার Android বিল্ডগুলি কীভাবে কনফিগার করবেন সে সম্পর্কে বিশদ বিবরণের জন্য, নিম্নলিখিত পৃষ্ঠাগুলি দেখুন:
- আপনার বিল্ড কনফিগার করুন
- অ্যান্ড্রয়েড গ্রেডল প্লাগইন ডিএসএল রেফারেন্স
- গ্রেডল ডিএসএল রেফারেন্স
- Gradle কর্মক্ষমতা ব্যবহারকারী গাইড
Gradle বিল্ড সিস্টেম সম্পর্কে আরও তথ্যের জন্য, Gradle ব্যবহারকারী গাইড দেখুন।
অ্যান্ড্রয়েড গ্রেডল প্লাগইন আপডেট করুন
আপনি যখন অ্যান্ড্রয়েড স্টুডিও আপডেট করেন, আপনি স্বয়ংক্রিয়ভাবে সর্বশেষ উপলব্ধ সংস্করণে অ্যান্ড্রয়েড গ্রেডল প্লাগইন আপডেট করার জন্য একটি প্রম্পট পেতে পারেন। আপনি আপডেট গ্রহণ করতে বা ম্যানুয়ালি আপনার প্রকল্পের বিল্ড প্রয়োজনীয়তার উপর ভিত্তি করে একটি সংস্করণ নির্দিষ্ট করতে পারেন।
আপনি অ্যান্ড্রয়েড স্টুডিওতে ফাইল > প্রজেক্ট স্ট্রাকচার > প্রোজেক্ট মেনু অথবা টপ-লেভেল build.gradle.kts
ফাইলে প্লাগইন ভার্সন নির্দিষ্ট করতে পারেন। প্লাগইন সংস্করণটি সেই Android স্টুডিও প্রকল্পে নির্মিত সমস্ত মডিউলের জন্য প্রযোজ্য। নিম্নলিখিত উদাহরণটি build.gradle.kts
ফাইল থেকে প্লাগইনটিকে 8.5.0 সংস্করণে সেট করে:
কোটলিন
plugins { id("com.android.application") version "8.5.0" apply false id("com.android.library") version "8.5.0" apply false id("org.jetbrains.kotlin.android") version "1.9.23" apply false }
গ্রোভি
plugins { id 'com.android.application' version '8.5.0' apply false id 'com.android.library' version '8.5.0' apply false id 'org.jetbrains.kotlin.android' version '1.9.23' apply false }
সতর্কতা: আপনার সংস্করণ সংখ্যায় গতিশীল নির্ভরতা ব্যবহার করা উচিত নয়, যেমন 'com.android.tools.build:gradle:8.5.+'
। এই বৈশিষ্ট্যটি ব্যবহার করে অপ্রত্যাশিত সংস্করণ আপডেট হতে পারে এবং সংস্করণের পার্থক্যগুলি সমাধান করতে অসুবিধা হতে পারে৷
যদি নির্দিষ্ট প্লাগইন সংস্করণটি ডাউনলোড করা না হয়ে থাকে, তাহলে পরের বার আপনি যখন আপনার প্রকল্প তৈরি করবেন বা Android স্টুডিও মেনু বার থেকে File > Sync Project with Gradle Files-এ ক্লিক করবেন তখন Gradle এটি ডাউনলোড করবে।
গ্রেডল আপডেট করুন
আপনি যখন অ্যান্ড্রয়েড স্টুডিও আপডেট করেন, আপনি গ্রেডলকে সর্বশেষ উপলব্ধ সংস্করণে আপডেট করার জন্য একটি প্রম্পট পেতে পারেন। আপনি আপডেট গ্রহণ করতে বা ম্যানুয়ালি আপনার প্রকল্পের বিল্ড প্রয়োজনীয়তার উপর ভিত্তি করে একটি সংস্করণ নির্দিষ্ট করতে পারেন।
Android Gradle প্লাগইনের প্রতিটি সংস্করণের জন্য Gradle-এর কোন সংস্করণ প্রয়োজন তা নিম্নলিখিত সারণীতে রয়েছে। সেরা পারফরম্যান্সের জন্য, আপনার গ্রেডল এবং প্লাগইন উভয়ের সাম্প্রতিক সম্ভাব্য সংস্করণ ব্যবহার করা উচিত।
প্লাগইন সংস্করণ | ন্যূনতম প্রয়োজনীয় Gradle সংস্করণ |
---|---|
8.5 | ৮.৭ |
৮.৪ | 8.6 |
8.3 | ৮.৪ |
8.2 | 8.2 |
8.1 | ৮.০ |
৮.০ | ৮.০ |
7.4 | 7.5 |
পুরানো সংস্করণ
প্লাগইন সংস্করণ | প্রয়োজনীয় Gradle সংস্করণ |
---|---|
7.3 | 7.4 |
7.2 | 7.3.3 |
7.1 | 7.2 |
7.0 | 7.0 |
4.2.0+ | 6.7.1 |
4.1.0+ | 6.5+ |
4.0.0+ | 6.1.1+ |
3.6.0 - 3.6.4 | ৫.৬.৪+ |
3.5.0 - 3.5.4 | 5.4.1+ |
3.4.0 - 3.4.3 | 5.1.1+ |
3.3.0 - 3.3.3 | 4.10.1+ |
3.2.0 - 3.2.1 | 4.6+ |
3.1.0+ | 4.4+ |
3.0.0+ | 4.1+ |
2.3.0+ | 3.3+ |
2.1.3 - 2.2.3 | 2.14.1 - 3.5 |
2.0.0 - 2.1.2 | 2.10 - 2.13 |
1.5.0 | 2.2.1 - 2.13 |
1.2.0 - 1.3.1 | 2.2.1 - 2.9 |
1.0.0 - 1.1.3 | 2.2.1 - 2.3 |
আপনি অ্যান্ড্রয়েড স্টুডিওতে ফাইল > প্রজেক্ট স্ট্রাকচার > প্রোজেক্ট মেনুতে গ্রেডল সংস্করণ নির্দিষ্ট করতে পারেন অথবা কমান্ড লাইন ব্যবহার করে আপনার গ্রেডল সংস্করণ আপডেট করতে পারেন। পছন্দের উপায় হল Gradle Wrapper কমান্ড লাইন টুল ব্যবহার করা, যা gradlew
স্ক্রিপ্ট আপডেট করে। নিচের উদাহরণটি Gradle Wrapper ব্যবহার করে Gradle সংস্করণটিকে 8.5 এ সেট করে। দ্রষ্টব্য, Gradle এবং Gradle Wrapper উভয়কেই আপগ্রেড করতে আপনাকে এই কমান্ডটি দুবার চালাতে হবে (আরো তথ্যের জন্য, Gradle Wrapper আপগ্রেড করা দেখুন)।
gradle wrapper --gradle-version 8.5
তবে এটি কিছু ক্ষেত্রে ব্যর্থ হতে পারে, উদাহরণস্বরূপ যদি আপনি এইমাত্র AGP আপডেট করেছেন এবং এটি আর বর্তমান Gradle সংস্করণের সাথে সঙ্গতিপূর্ণ নয়৷ এই ক্ষেত্রে, আপনাকে gradle/wrapper/gradle-wrapper.properties
ফাইলে গ্রেডল ডিস্ট্রিবিউশন রেফারেন্স সম্পাদনা করতে হবে। নিচের উদাহরণটি gradle-wrapper.properties
ফাইলে Gradle সংস্করণটিকে 8.5 এ সেট করে।
...
distributionUrl = https\://services.gradle.org/distributions/gradle-8.5-bin.zip
...
অ্যান্ড্রয়েড গ্রেডল প্লাগইন এবং অ্যান্ড্রয়েড স্টুডিও সামঞ্জস্য
অ্যান্ড্রয়েড স্টুডিও বিল্ড সিস্টেমটি গ্রেডলের উপর ভিত্তি করে, এবং অ্যান্ড্রয়েড গ্রেডল প্লাগইন (এজিপি) বেশ কয়েকটি বৈশিষ্ট্য যুক্ত করে যা অ্যান্ড্রয়েড অ্যাপ তৈরির জন্য নির্দিষ্ট। নিম্নলিখিত টেবিলে Android স্টুডিওর প্রতিটি সংস্করণের জন্য AGP-এর কোন সংস্করণ প্রয়োজন তা তালিকাভুক্ত করা হয়েছে।
অ্যান্ড্রয়েড স্টুডিও সংস্করণ | প্রয়োজনীয় AGP সংস্করণ |
---|---|
কোয়ালা | 2024.1.1 | 3.2-8.5 |
জেলিফিশ | 2023.3.1 | 3.2-8.4 |
ইগুয়ানা | 2023.2.1 | 3.2-8.3 |
হেজহগ | 2023.1.1 | 3.2-8.2 |
জিরাফ | 2022.3.1 | 3.2-8.1 |
ফ্লেমিংগো | 2022.2.1 | 3.2-8.0 |
পুরানো সংস্করণ
অ্যান্ড্রয়েড স্টুডিও সংস্করণ | প্রয়োজনীয় AGP সংস্করণ |
---|---|
বৈদ্যুতিক ঢল | 2022.1.1 | 3.2-7.4 |
ডলফিন | 2021.3.1 | 3.2-7.3 |
চিপমাঙ্ক | 2021.2.1 | 3.2-7.2 |
বাম্বলবি | 2021.1.1 | 3.2-7.1 |
আর্কটিক ফক্স | 2020.3.1 | 3.1-7.0 |
অ্যান্ড্রয়েড গ্রেডল প্লাগইনে নতুন কী রয়েছে সে সম্পর্কে তথ্যের জন্য, অ্যান্ড্রয়েড গ্রেডল প্লাগইন রিলিজ নোটগুলি দেখুন।
Android API স্তরের জন্য সরঞ্জামগুলির ন্যূনতম সংস্করণ
অ্যান্ড্রয়েড স্টুডিও এবং এজিপির ন্যূনতম সংস্করণ রয়েছে যা একটি নির্দিষ্ট API স্তর সমর্থন করে। আপনার প্রজেক্টের targetSdk
বা compileSdk
প্রয়োজনের তুলনায় অ্যান্ড্রয়েড স্টুডিও বা এজিপি-এর নিম্ন সংস্করণ ব্যবহার করলে অপ্রত্যাশিত সমস্যা দেখা দিতে পারে। আমরা Android OS এর পূর্বরূপ সংস্করণগুলিকে লক্ষ্য করে এমন প্রকল্পগুলিতে কাজ করার জন্য Android Studio এবং AGP-এর সর্বশেষ পূর্বরূপ সংস্করণ ব্যবহার করার পরামর্শ দিই। আপনি একটি স্থিতিশীল সংস্করণের পাশাপাশি অ্যান্ড্রয়েড স্টুডিওর পূর্বরূপ সংস্করণ ইনস্টল করতে পারেন।
অ্যান্ড্রয়েড স্টুডিও এবং এজিপির ন্যূনতম সংস্করণগুলি নিম্নরূপ:
API স্তর | ন্যূনতম অ্যান্ড্রয়েড স্টুডিও সংস্করণ | ন্যূনতম এজিপি সংস্করণ |
---|---|---|
ভ্যানিলাআইসক্রিম প্রিভিউ | জেলিফিশ | 2023.3.1 | ৮.৪ |
34 | হেজহগ | 2023.1.1 | 8.1.1 |
33 | ফ্লেমিংগো | 2022.2.1 | 7.2 |
সংস্করণ পরিবর্তন (নভেম্বর 2020)
অন্তর্নিহিত গ্রেডল বিল্ড টুলের সাথে আরও ঘনিষ্ঠভাবে মিলতে আমরা অ্যান্ড্রয়েড গ্রেডল প্লাগইন (এজিপি) এর সংস্করণ নম্বর আপডেট করছি।
এখানে উল্লেখযোগ্য পরিবর্তনগুলি রয়েছে:
AGP এখন শব্দার্থিক সংস্করণ ব্যবহার করবে, এবং ব্রেকিং পরিবর্তনগুলি বড় রিলিজের জন্য লক্ষ্য করা হবে।
গ্রেডল প্রধান রিলিজের সাথে সারিবদ্ধভাবে প্রতি বছর AGP-এর একটি বড় সংস্করণ প্রকাশিত হবে।
AGP 4.2 এর পরে রিলিজ হবে 7.0 সংস্করণ এবং Gradle সংস্করণ 7.x এ আপগ্রেড করতে হবে। AGP-এর প্রতিটি বড় রিলিজের জন্য অন্তর্নিহিত Gradle টুলে একটি বড় সংস্করণ আপগ্রেডের প্রয়োজন হবে।
এপিআইগুলি প্রায় এক বছর আগে অবচয় করা হবে, প্রতিস্থাপন কার্যকারিতা একই সাথে উপলব্ধ করা হবে। পরবর্তী বড় আপডেটের সময় প্রায় এক বছর পরে অপসারিত APIগুলি সরানো হবে।
সামঞ্জস্য
অ্যান্ড্রয়েড গ্রেডল প্লাগইন 8.5 সমর্থন করে সর্বাধিক API স্তর হল API স্তর 34। এখানে অন্যান্য সামঞ্জস্যের তথ্য রয়েছে:
ন্যূনতম সংস্করণ | ডিফল্ট সংস্করণ | নোট | |
---|---|---|---|
গ্রেডল | ৮.৭ | ৮.৭ | আরও জানতে, Gradle আপডেট করা দেখুন। |
SDK বিল্ড টুলস | 34.0.0 | 34.0.0 | SDK বিল্ড টুল ইনস্টল বা কনফিগার করুন । |
এনডিকে | N/A | 26.1.10909125 | NDK এর একটি ভিন্ন সংস্করণ ইনস্টল বা কনফিগার করুন । |
জেডিকে | 17 | 17 | আরও জানতে, JDK সংস্করণ সেট করা দেখুন। |
প্যাচ রিলিজ
নিচে অ্যান্ড্রয়েড স্টুডিও কোয়ালা এবং অ্যান্ড্রয়েড গ্রেডল প্লাগইন 8.5-এ প্যাচ রিলিজের একটি তালিকা রয়েছে।
অ্যান্ড্রয়েড স্টুডিও কোয়ালা | 2024.1.1 প্যাচ 1 এবং AGP 8.5.1 (জুলাই 2024)
এই ছোটখাট আপডেটে এই বাগ ফিক্সগুলি অন্তর্ভুক্ত রয়েছে।