Android Gradle প্লাগ-ইন (AGP) আপগ্রেড অ্যাসিস্ট্যান্ট হল Android Studio-এর একটি টুল যা আপনার প্রোজেক্টে ব্যবহৃত AGP-এর ভার্সন আপগ্রেড করতে সাহায্য করে।
Android স্কিল
GitHub-এ দেখুনAGP 9 আপগ্রেড
android skills add agp-9-upgradeআপনার বিল্ড কনফিগার করার জন্য নতুন ফিচার, অন্যান্য Gradle প্লাগ-ইন দ্বারা ব্যবহারের জন্য নতুন API এবং Android Studio-এর সাথে প্রোজেক্ট বিল্ডের ইন্টিগ্রেশন রিফাইন করার সাথে সম্পর্কিত AGP পরিবর্তনের জন্য ঘন ঘন রিলিজ করা হয়। আপনার প্রোজেক্টে ব্যবহৃত AGP-এর ভার্সন আপগ্রেড করলে আপনি লেটেস্ট ফিচারের সুবিধা পাবেন।
আপগ্রেড অ্যাসিস্ট্যান্টের জন্য সাজেস্ট করা প্রোজেক্ট স্ট্রাকচার সম্পর্কে আরও তথ্যের জন্য, এই পৃষ্ঠায় সেট-আপ দেখুন।
AGP Upgrade Assistant-এর ব্যবহারিক তথ্য
AGP ভার্সন আপগ্রেড করার জন্য প্রয়োজনীয় পরিবর্তনগুলি করতে AGP Upgrade Assistant আপনাকে সাহায্য করে। Upgrade Assistant-এর সবচেয়ে সাধারণ ব্যবহারগুলি নিচে দেওয়া হল:
সিনট্যাক্স পরিবর্তন: আপগ্রেড অ্যাসিস্ট্যান্ট AGP-এর পুরনো ভার্সনের জন্য আপনার বিল্ড ফাইলগুলিকে AGP-এর নতুন ভার্সনের জন্য প্রয়োজনীয় ফাইলগুলিতে অনুবাদ করার চেষ্টা করে। AGP ডেভেলপ করার সাথে সাথে, ইন্টারফেসকে সাপোর্ট করার জন্য বিল্ড ফাইল আপডেট করা হয়, কারণ সময়ের সাথে সাথে সেগুলি পরিবর্তন করা হয়, বন্ধ করে দেওয়া হয় বা কাজ করে না।
AGP ও Gradle-এর মধ্যে কম্প্যাটিবিলিটি সংক্রান্ত প্রয়োজনীয়তা: আপগ্রেড অ্যাসিস্ট্যান্ট AGP ও Gradle-এর মধ্যে কম্প্যাটিবিলিটি সংক্রান্ত প্রয়োজনীয়তা সম্পর্কে জানে এবং আপনার AGP-এর ভার্সনের জন্য প্রয়োজনীয় Gradle-এর ভার্সন আপনি ব্যবহার করছেন কিনা তা নিশ্চিত করতে সাহায্য করে।
AGP ও থার্ড-পার্টি Gradle প্লাগ-ইনের মধ্যে কম্প্যাটিবিলিটি সংক্রান্ত প্রয়োজনীয়তা: Upgrade Assistant, AGP ও কিছু থার্ড-পার্টি Gradle প্লাগ-ইনের মধ্যে কম্প্যাটিবিলিটি সংক্রান্ত প্রয়োজনীয়তা সম্পর্কে জানে এবং আপনার AGP ভার্সনের জন্য প্রয়োজনীয় থার্ড-পার্টি Gradle প্লাগ-ইনের ভার্সন আপনি ব্যবহার করছেন কিনা তা নিশ্চিত করতে সাহায্য করে।
সাধারণত, আপগ্রেড অ্যাসিস্ট্যান্ট বিল্ড ফাইল আপডেট করা এবং AGP আপগ্রেডের পরে সম্পর্কিত ত্রুটি মেসেজ বোঝা সহজ করে তোলে। এছাড়াও, আপগ্রেড অ্যাসিস্ট্যান্ট ব্যাখ্যা করে যে কেন প্রস্তাবিত পরিবর্তনগুলি প্রয়োজনীয়।
AGP আপগ্রেড অ্যাসিস্ট্যান্ট কীভাবে ব্যবহার করবেন
আপগ্রেড অ্যাসিস্ট্যান্ট ব্যবহার করতে, আপনার প্রোজেক্ট স্ট্রাকচার টুলের সাথে মানানসই কিনা তা নিশ্চিত করুন এবং তারপরে Android Studio থেকে এটি রান করুন, যেমনটি আপগ্রেড অ্যাসিস্ট্যান্ট রান করুন-এ বর্ণনা করা হয়েছে।
আপনার প্রোজেক্ট সেট-আপ করুন
আপগ্রেড অ্যাসিস্ট্যান্ট চালানোর আগে, আপনার প্রোজেক্ট সঠিকভাবে ফর্ম্যাট করা এবং ব্যাক-আপ নেওয়া হয়েছে কিনা তা নিশ্চিত করুন। AGP Upgrade Assistant সঠিকভাবে সেট-আপ করা হয়েছে কিনা তা নিশ্চিত করতে, নিম্নলিখিত বিভাগগুলি পড়ুন।
Gradle বিল্ড ফাইল ও ডোমেন-নির্দিষ্ট ভাষা ব্যবহার করে আপনার প্রোজেক্ট স্ট্রাকচার করুন
AGP আপগ্রেড অ্যাসিস্ট্যান্টের থেকে সেরা সুবিধা পেতে, নিম্নলিখিত ধাপগুলি অনুসরণ করুন:
- Gradle বিল্ড ফাইল ব্যবহার করে বিল্ড কনফিগার করুন: Upgrade Assistant
Gradle বিল্ড ফাইলের স্ট্যাটিক বিশ্লেষণের উপর নির্ভর করে। Upgrade Assistant-এর থেকে সবচেয়ে বেশি সুবিধা পেতে, এইসব বিল্ড ফাইল ব্যবহার করে আপনার বিল্ড কনফিগার করুন। আপনার প্রোজেক্টের
gradleসাবডিরেক্টরিরlibs.versions.tomlফাইলে উল্লেখ করা ডিপেন্ডেন্সি ও প্লাগ-ইন রেফার করতে Gradle ভার্সন ক্যাটালগ ব্যবহার করুন।
- ডিক্লারেটিভ বিল্ড ডোমেন-নির্দিষ্ট ভাষা ব্যবহার করুন: Gradle বিল্ড ফাইল Groovy বা Kotlin-এ প্রকাশ করা হয়। তবে, প্রোজেক্ট কনফিগারেশনের এক্সপ্রেশন যত বেশি ডিক্লেরেটিভ হবে, আপগ্রেড অ্যাসিস্ট্যান্টের পক্ষে আপগ্রেডের জন্য অ্যাডজাস্টমেন্ট প্রয়োজন এমন সব জায়গা খুঁজে পাওয়ার সম্ভাবনা তত বেশি হবে।
কোনও প্রোজেক্ট এইসব সীমাবদ্ধতা মেনে চললেও, আপগ্রেড অ্যাসিস্ট্যান্ট ক্লিন আপগ্রেড করতে নাও পারে। কীভাবে সমস্যার সমাধান করবেন বা বাগ সম্পর্কে অভিযোগ করবেন সেই সম্পর্কে নির্দেশিকার জন্য সমস্যার সমাধান করুন দেখুন।
আপনার প্রোজেক্টের ব্যাক-আপ নিন
আপগ্রেড অ্যাসিস্ট্যান্ট ব্যবহার করার আগে, আমরা সাজেস্ট করি যে আপনার প্রোজেক্টে যেন কোনও আনকমিটেড পরিবর্তন না থাকে, যেমনটি আপনার ভার্সন কন্ট্রোল সিস্টেমে দেখা যায়। আপনি ভার্সন কন্ট্রোল ব্যবহার না করলে, এই মুহূর্তে শেষবার জানা ভাল ভার্সনের ব্যাক-আপ ব্যবহার করুন।
আপগ্রেড অ্যাসিস্ট্যান্ট রান করার পরে এবং প্রোজেক্ট সফলভাবে তৈরি ও পরীক্ষা করা হয়ে গেলে, আপনি প্রোজেক্টের নতুন ভার্সন আপনার ভার্সন কন্ট্রোল সিস্টেমে কমিট করতে পারবেন।
আপগ্রেড অ্যাসিস্ট্যান্ট চালান
আপগ্রেড অ্যাসিস্ট্যান্ট চালাতে, এই ধাপগুলি অনুসরণ করুন:
আপগ্রেড অ্যাসিস্ট্যান্ট চালু করতে, টুল > AGP আপগ্রেড অ্যাসিস্ট্যান্ট বিকল্পে নেভিগেট করুন অথবা বিজ্ঞপ্তি প্রম্পটে ক্লিক করুন, যেমনটি ছবি ১-এ দেখানো হয়েছে।
যে টুল উইন্ডোটি দেখা যায়, সেটি ডিফল্ট আপগ্রেডের বিবরণ দেখায়, যার মধ্যে রয়েছে AGP-এর প্রোজেক্টের বর্তমান ভার্সন এবং Android Studio-এর এই ভার্সন দ্বারা সমর্থিত লেটেস্ট ভার্সন।
ছবি ১. বিজ্ঞপ্তি প্রম্পটের মাধ্যমে AGP আপগ্রেড অ্যাসিস্ট্যান্ট টুল উইন্ডো লঞ্চ করা হয়েছে। প্রয়োজনীয় ও সাজেস্ট করা ধাপগুলি চেক করুন।
বাঁদিকের প্যানেলে, চেকবক্স সহ ট্রি আপগ্রেডের প্রতিটি ধাপের বিবরণ দেয়, সেগুলি আপডেট করা প্রয়োজন নাকি সাজেস্ট করা হয়েছে এবং সেগুলি অন্য ধাপের জন্য পূর্বশর্ত কিনা সেই অনুযায়ী বিভাগ করা হয়েছে। প্রধান প্যানেলে প্রতিটি ধাপ সম্পর্কে আরও বিবরণ দেখতে ট্রি থেকে আলাদা আলাদা আইটেম বেছে নিন।
আপগ্রেড রান করতে, প্রয়োজনীয় ও আপনার পছন্দের ধাপ বেছে নিয়ে বেছে নেওয়া ধাপ রান করুন বিকল্পে ক্লিক করুন।
আপগ্রেড অ্যাসিস্ট্যান্ট প্রোজেক্ট বিল্ড ফাইল পরিবর্তন করে এবং Android Studio-র সাথে নতুন প্রোজেক্ট বিল্ড সিঙ্ক করার চেষ্টা করে। আপনার কাছে অসংখ্য মডিউল থাকলে, এটি করতে কিছুটা সময় লাগতে পারে, কারণ প্লাগ-ইন এবং লাইব্রেরির নতুন ভার্সন ডাউনলোড করতে হতে পারে।
আপগ্রেড করার পরের রিপোর্ট পর্যালোচনা করুন। এই রিপোর্টে সেইসব ধাপের বিবরণ দেওয়া আছে যেগুলি সম্পূর্ণ করা হয়েছে এবং আপগ্রেড সফল হয়েছে নাকি হয়নি। এছাড়াও, আপগ্রেড করার পরে প্রোজেক্ট তৈরি বা পরীক্ষা করার সময় কোনও সমস্যা হলে, আপগ্রেড অ্যাসিস্ট্যান্টের মাধ্যমে করা পরিবর্তনগুলি আগের অবস্থায় ফিরিয়ে আনার জন্য একটি অ্যাকশন অন্তর্ভুক্ত করে।
প্রোজেক্টটি Android Studio-এর সাথে সিঙ্ক হয়ে গেলে, প্রোজেক্টটি তৈরি করুন এবং আপগ্রেড করার ফলে কোনও কার্যকারিতা পরিবর্তিত হয়েছে কিনা তা যাচাই করতে টেস্ট স্যুট রান করুন।
আপনার প্রোজেক্ট ঠিক অবস্থায় আছে কিনা তা যাচাই করার পরে, আপনার প্রোজেক্টের নতুন ভার্সন আপনার ভার্সন কন্ট্রোল সিস্টেমে কমিট করুন।
সমস্যার সমাধান করা
আপগ্রেড অ্যাসিস্ট্যান্ট আপগ্রেড করার সাজেশন দিলেও আপগ্রেড করা না গেলে, সাধারণত বিল্ড ফাইলে পরিবর্তন করার কারণে এটি হয়, যার ফলে সিঙ্ক করা যায় না। সমস্যাটি আলাদা করে সমাধান করতে এইসব ধাপ অনুসরণ করুন:
প্রথমে, সিঙ্ক না হওয়ার কারণ হিসেবে যে সমস্যাটি দেখানো হয়েছে সেটি দেখুন। কখনও কখনও, সমস্যার স্পষ্ট কারণ থাকে, যা আপনি প্রোজেক্টের বিল্ড ফাইলে সমাধান করতে পারেন।
ত্রুটি মেসেজটি স্পষ্ট না হলে বা সমস্যার কারণটি স্পষ্ট না হলে, আপগ্রেডটিকে ছোট ছোট ধাপে ভাগ করার জন্য প্রোজেক্টটিকে তার আসল অবস্থায় ফিরিয়ে আনুন। ভার্সন কন্ট্রোল বা ব্যাক-আপ থেকে আসল অবস্থা ফিরিয়ে আনুন এবং প্রোজেক্টটি আসল অবস্থায় আছে কিনা এবং Android Studio-এর সাথে সিঙ্ক করা আছে কিনা তা নিশ্চিত করুন।
দুই ধরনের আপগ্রেড ব্রেকডাউন অনুসরণ করে সমস্যাটি তদন্ত করুন:
AGP-এর অন্য কোনও ভার্সনে আপগ্রেড করুন যা লেটেস্ট ভার্সন নয়। যদি আপগ্রেডটি ভুল হয়ে যায় তবে এটি একটি বড় সংখ্যক সংস্করণের আপগ্রেড ছিল, সমস্যাটি আলাদা করার সর্বোত্তম উপায় হল ছোট ছোট আপগ্রেডের একটি সিরিজ করা, সংস্করণ থেকে সংস্করণে, প্রথম আপগ্রেডটি খুঁজে পেতে যা সমস্যাটি ট্রিগার করে।
আপগ্রেড করার সময়, একবারে একটি করে ধাপ সম্পূর্ণ করুন। আপনি একবার নির্ধারণ করলে আপগ্রেড যা সমস্যাটি ট্রিগার করে, এটি চালু করা সম্ভব হতে পারে আপগ্রেডে পৃথক পদক্ষেপ বন্ধ। যদি এটি সম্ভব হয়, চেষ্টা করুন কোনটি তা খুঁজে বের করতে একবারে প্রতিটি ধাপ করুন ত্রুটির জন্য দায়ী। আপনি যদি সমস্যা সৃষ্টিকারী ধাপটি খুঁজে না পান, তাহলে Gradle বা AGP-এর সাথে কম্প্যাটিবিলিটি সংক্রান্ত সমস্যার জন্য আপনি ব্যবহার করছেন এমন অন্য কোনও Gradle প্লাগ-ইনের রিলিজ নোট চেক করুন। কখনও কখনও, নতুন রিলিজে বাতিল করা বা ইন্টার্নাল API-এর ব্যবহারের সমস্যার সমাধান করা হয়।
সমস্যা সম্পর্কে অভিযোগ করুন। কখনও কখনও প্রস্তুতির সব ধাপ এবং সিঙ্ক সফল হলেও চূড়ান্ত আপগ্রেড ধাপটি এখনও ব্যর্থ হয়। এই ক্ষেত্রে, সমস্যা সম্পর্কে অভিযোগ জানান। আপনি নিজে সমস্যার সমাধান করতে পারলেও, বাগ ট্র্যাকারে আসল সমস্যা সম্পর্কে অভিযোগ জানান, যাতে ডেভেলপমেন্ট টিম সমস্যার সমাধান করতে পারে।