অ্যাপ উইজেট কনফিগার করতে ব্যবহারকারীদের সক্ষম করুন

অ্যাপ উইজেটগুলো কনফিগারযোগ্য হতে পারে। উদাহরণস্বরূপ, একটি ঘড়ির উইজেট ব্যবহারকারীদেরকে কোন টাইম জোন প্রদর্শন করা হবে তা নির্ধারণ করার সুযোগ দেয়।

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

কনফিগারেশন কার্যকলাপ ঘোষণা করুন

ম্যানিফেস্টে কনফিগারেশন অ্যাক্টিভিটি ঘোষণা করা এবং আপনার প্রোভাইডার XML মেটাডেটার ভিতরে এটিকে লিঙ্ক করার পদ্ধতিটি ভিউ-ভিত্তিক এবং গ্ল্যান্স-ভিত্তিক উভয় অ্যাপ উইজেটের ক্ষেত্রেই অভিন্ন।

কনফিগারেশন অ্যাক্টিভিটি কীভাবে ডিক্লেয়ার করতে হয় তা জানতে, Glance কনফিগারেশন ডকুমেন্টেশনের “Compose-first Declare the configuration activity” সেকশনটি দেখুন।

কনফিগারেশন কার্যকলাপ বাস্তবায়ন করুন

যেহেতু কনফিগারেশন অ্যাক্টিভিটিগুলো প্ল্যাটফর্ম লঞ্চার দ্বারা কল করা স্ট্যান্ডার্ড কম্পোনেন্ট, তাই এদের বেসিক লাইফসাইকেল কলব্যাকগুলোকে অবশ্যই সিস্টেমের রিটার্ন ভ্যালু সংক্রান্ত নিয়মগুলো অনুসরণ করতে হবে।

কনফিগারেশন অ্যাক্টিভিটি কীভাবে প্রয়োগ করতে হয় তা জানতে, Glance ডকুমেন্টেশনের "Compose-first Implement the configuration activity" অংশটি দেখুন।

কনফিগারেশন অ্যাক্টিভিটি থেকে উইজেটটি আপডেট করুন।

প্রচলিত ভিউ-ভিত্তিক উইজেটগুলিতে, কনফিগারেশন সম্পন্ন হলে AppWidgetManager এবং একটি RemoteViews লেআউট ইনস্ট্যান্স ব্যবহার করে উইজেটটি আপডেট করা হয়।

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

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

উইজেটের আচরণ (যেমন পরবর্তীতে পুনর্বিন্যাস করার অনুমতি দেওয়া বা প্রাথমিক কনফিগারেশন সেটআপের ধাপগুলো পুরোপুরি এড়িয়ে যাওয়া) স্ট্যান্ডার্ড অ্যান্ড্রয়েড ১২ ফ্ল্যাগ ব্যবহার করে মেটাডেটা অ্যাট্রিবিউটের মধ্যে নিবন্ধিত করা হয়।

ডাইনামিক উইজেট অপশনগুলো কীভাবে ব্যবহার করতে হয় তা জানতে, Glance কনফিগারেশন ডকুমেন্টেশনের Compose-first Widget configuration options সেকশনটি দেখুন।

ব্যবহারকারীদের স্থাপন করা উইজেটগুলি পুনর্বিন্যাস করার সুযোগ দিন

কাস্টম পুনঃকনফিগারযোগ্য সেটআপ ট্রিগার কীভাবে যোগ করতে হয় তা বুঝতে, Glance ডকুমেন্টেশনের "Compose-first Enable users to reconfigure placed widgets" বিভাগটি দেখুন।

উইজেটের ডিফল্ট কনফিগারেশন ব্যবহার করুন

ডিফল্টরূপে কনফিগারেশন সেটআপ কীভাবে এড়িয়ে যাওয়া যায় তা জানতে, Glance ডকুমেন্টেশনের "Compose-first Use the widget's default configuration" বিভাগটি দেখুন।