জেটপ্যাক কম্পোজ API-এর জন্য স্টাইল নির্দেশিকা

আপনি যদি আপনার অ্যাপের জন্য কম্পোজ কোড লেখেন অথবা কম্পোজ লাইব্রেরি ও এপিআই তৈরি করেন, তবে আপনার কোডকে স্কেলেবল, অধিক পারফর্ম্যান্ট এবং ইকোসিস্টেমের বাকি অংশের সাথে সামঞ্জস্যপূর্ণ করতে সেরা অনুশীলনগুলো অনুসরণ করুন।

যারা Compose ব্যবহার করে কোড লেখেন, তাদের জন্য নিম্নলিখিত ডকুমেন্টগুলোতে নির্দেশিকা দেওয়া হয়েছে:

• জেটপ্যাক কম্পোজের জন্য এপিআই নির্দেশিকা : জেটপ্যাক কম্পোজ কম্পাইলার প্লাগইন এবং রানটাইম ব্যবহারকারী যেকোনো সিস্টেমের জন্য প্যাটার্ন, সর্বোত্তম অনুশীলন এবং নির্দেশনামূলক শৈলী নির্দেশিকার রূপরেখা দেয়। এতে নিম্নলিখিত বিষয়গুলো অন্তর্ভুক্ত রয়েছে:
  • কোটলিন কোডিং কনভেনশনের উপর ভিত্তি করে কম্পোজের জন্য কোটলিন স্টাইল নির্দেশিকা
  • @Composable ফাংশন এবং এপিআই-এর জন্য নির্দেশিকা যা কম্পোজ রানটাইম সক্ষমতার উপর ভিত্তি করে তৈরি।
  • যেসব এপিআই কম্পোজ ইউআই টুলকিট ব্যবহার ও সম্প্রসারণ করে, তাদের জন্য নির্দেশিকা
  • কম্পোজ এপিআই ডিজাইন করার সময় ব্যবহারের ক্ষেত্রগুলো সমাধানের জন্য প্যাটার্ন
• জেটপ্যাক কম্পোজে @Composable কম্পোনেন্টের জন্য এপিআই নির্দেশিকা : @Composable UI কম্পোনেন্ট তৈরি এবং ব্যবহারের জন্য একগুচ্ছ নির্দেশিকা ও সুপারিশ প্রদান করে, যার মধ্যে নিম্নলিখিত বিষয়গুলি অন্তর্ভুক্ত রয়েছে:
  • উপাদান তৈরি এবং স্তরবিন্যাস করা
  • একটি নতুন উপাদানের নামকরণ
  • উপাদান নির্ভরতা প্রকাশ করা
  • @Composable কম্পোনেন্টগুলিতে প্যারামিটার
  • কম্পোনেন্ট-সম্পর্কিত ক্লাস এবং ফাংশন তৈরির জন্য সঠিক প্যাটার্ন অনুসরণ করা
  • @Composable কম্পোনেন্টগুলির ডকুমেন্টেশন
  • উপাদানগুলির জন্য প্রবেশগম্যতা উন্নত করা
  • পূর্ববর্তী সংস্করণের সাথে সামঞ্জস্য বজায় রেখে কম্পোনেন্ট এপিআই আপডেট করা

দর্শক

এই নির্দেশিকাগুলো নিম্নলিখিত তিন ধরনের পাঠকগোষ্ঠীর জন্য লেখা হয়েছে:

• যেসব ডেভেলপার জেটপ্যাক কম্পোজ (Jetpack Compose) ব্যবহার করে অ্যাপ তৈরি করেন । আপনি এই দলের অন্তর্ভুক্ত যদি আপনার অ্যাপের কোনো অংশে জেটপ্যাক কম্পোজ ব্যবহার করে থাকেন।
• যারা জেটপ্যাক কম্পোজ ফ্রেমওয়ার্ক নিয়ে কাজ করছেন । আপনি এই গ্রুপের অন্তর্ভুক্ত যদি আপনি androidx.compose লাইব্রেরিগুলোতে অবদান রাখেন।
• যেসব ডেভেলপার Jetpack Compose-এর উপর ভিত্তি করে লাইব্রেরি তৈরি করেন । আপনি এই দলের অন্তর্ভুক্ত যদি আপনি Compose API অথবা Compose UI এলিমেন্টের লাইব্রেরি তৈরি করেন। Compose কম্পোনেন্টের এই লাইব্রেরিগুলো সর্বজনীনভাবে উপলব্ধ হতে পারে অথবা আপনার কোম্পানি বা দলের জন্য স্থানীয় হতে পারে।

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

প্রতিটি ডেভেলপার গোষ্ঠীর জন্য প্রয়োজনীয়তা সম্পর্কে আরও তথ্যের জন্য, RFC2119 দেখুন।

কাঠামো এবং নির্দেশিকা তৈরিতে অবদান রাখুন

আমরা androidx কোডবেসের নির্বাচিত লাইব্রেরিগুলিতে এবং স্টাইল নির্দেশিকাগুলিতে ( Compose API নির্দেশিকা এবং @Composable কম্পোনেন্ট নির্দেশিকা ) অবদানকে স্বাগত জানাই।

অবদান রাখতে, androidx কন্ট্রিবিউশন গাইডে দেওয়া নির্দেশনাগুলো অনুসরণ করুন।