Wear OS-এ Jetpack Compose ব্যবহার করুন

Wear OS এর জন্য কম্পোজ মোবাইলের জন্য কম্পোজের মত। যাইহোক, কিছু মূল পার্থক্য আছে। এই নির্দেশিকা আপনাকে মিল এবং পার্থক্যের মধ্য দিয়ে চলে।

Wear OS-এর জন্য কম্পোজ করা হল Android Jetpack-এর অংশ, এবং আপনার ব্যবহার করা অন্যান্য Wear Jetpack লাইব্রেরির মতো এটি আপনাকে আরও ভাল কোড দ্রুত লিখতে সাহায্য করে। Wear OS অ্যাপের জন্য ইউজার ইন্টারফেস তৈরি করার জন্য এটি আমাদের প্রস্তাবিত পদ্ধতি।

আপনি যদি জেটপ্যাক কম্পোজ টুলকিট ব্যবহার করার সাথে অপরিচিত হন তবে কম্পোজ পাথওয়েটি দেখুন। মোবাইল কম্পোজের অনেক ডেভেলপমেন্ট নীতি Wear OS-এর জন্য কম্পোজে প্রযোজ্য। একটি ঘোষণামূলক UI ফ্রেমওয়ার্কের সাধারণ সুবিধা সম্পর্কে আরও তথ্যের জন্য কেন রচনা করবেন দেখুন। Wear OS এর জন্য রচনা সম্পর্কে আরও জানতে, GitHub-এ Wear OS পাথওয়ের জন্য রচনা এবং Wear OS নমুনা সংগ্রহস্থল দেখুন।

Wear OS-এ জেটপ্যাক কম্পোজে মেটেরিয়াল ডিজাইন

Wear OS-এ Jetpack Compose Material 2.5- এর বাস্তবায়ন অফার করে, যা আপনাকে আরও আকর্ষক অ্যাপ অভিজ্ঞতা ডিজাইন করতে সাহায্য করে। Wear OS-এর মেটেরিয়াল ডিজাইনের উপাদানগুলি Wear Material Theming- এর উপরে তৈরি করা হয়েছে। এই থিমিং হল ম্যাটেরিয়াল ডিজাইন কাস্টমাইজ করার এবং আপনার পণ্যের ব্র্যান্ডকে আরও ভালভাবে প্রতিফলিত করার একটি পদ্ধতিগত উপায়।

সামঞ্জস্য

Wear OS এর জন্য রচনা করা ঘড়িতে কাজ করে যা Wear OS 3.0 (API লেভেল 30) সমর্থন করে এবং যে ঘড়িগুলি Wear OS 2.0 (API লেভেল 25 এবং তার উপরে) ব্যবহার করে। Wear OS-এর জন্য কম্পোজ 1.4 সংস্করণ ব্যবহার করার জন্য androidx.compose লাইব্রেরির 1.7 সংস্করণ এবং Kotlin 1.9.0 ব্যবহার করা প্রয়োজন৷ আপনি BOM ম্যাপিং ব্যবহার করতে পারেন এবং কম্পোজ সামঞ্জস্যতা পরীক্ষা করতে Kotlin সামঞ্জস্য মানচিত্র রচনা করতে পারেন

সারফেস

Wear OS-এর জন্য রচনা Wear OS-এ অ্যাপ তৈরি করা সহজ করে তোলে। আরও তথ্যের জন্য অ্যাপস দেখুন। Wear OS নির্দেশিকাগুলির সাথে সামঞ্জস্যপূর্ণ ব্যবহারকারীর অভিজ্ঞতা তৈরি করতে আমাদের অন্তর্নির্মিত উপাদানগুলি ব্যবহার করুন। উপাদান সম্পর্কে আরও তথ্যের জন্য, আমাদের নকশা নির্দেশিকা দেখুন।

সেট আপ করা হচ্ছে

Wear OS-এর সাথে Jetpack Compose ব্যবহার করা অন্য যেকোন Android প্রকল্পের জন্য Jetpack Compose ব্যবহার করার মতই। প্রধান পার্থক্য হল জেটপ্যাক কম্পোজ ফর ওয়ার পরিধান-নির্দিষ্ট লাইব্রেরি যোগ করে যা ঘড়ির জন্য তৈরি ইউজার ইন্টারফেস তৈরি করা সহজ করে। কিছু ক্ষেত্রে এই উপাদানগুলি তাদের অ-পরিধান অংশগুলির মতো একই নাম শেয়ার করে, যেমন androidx.wear.compose.material.Button এবং androidx.compose.material.Button

অ্যান্ড্রয়েড স্টুডিওতে একটি নতুন অ্যাপ তৈরি করুন

জেটপ্যাক রচনা অন্তর্ভুক্ত একটি নতুন প্রকল্প তৈরি করতে, নিম্নরূপ এগিয়ে যান:

  1. আপনি যদি অ্যান্ড্রয়েড স্টুডিওতে স্বাগতম উইন্ডোতে থাকেন, তাহলে একটি নতুন অ্যান্ড্রয়েড স্টুডিও প্রকল্প শুরু করুন ক্লিক করুন। আপনার যদি ইতিমধ্যে একটি অ্যান্ড্রয়েড স্টুডিও প্রকল্প খোলা থাকে তবে মেনু বার থেকে ফাইল > নতুন > আমদানি নমুনা নির্বাচন করুন।
  2. পরিধানের জন্য রচনার জন্য অনুসন্ধান করুন এবং Wear OS স্টার্টারের জন্য রচনা নির্বাচন করুন।
  3. আপনার প্রকল্প উইন্ডো কনফিগার করুন , নিম্নলিখিত করুন:
    1. আবেদনের নাম সেট করুন।
    2. আপনার নমুনার জন্য প্রকল্প অবস্থান চয়ন করুন.
  4. শেষ ক্লিক করুন.
  5. প্রজেক্টের build.gradle ফাইলটি সঠিকভাবে কনফিগার করা হয়েছে কিনা যাচাই করুন, যেমন Gradle বৈশিষ্ট্য ফাইলে বর্ণনা করা হয়েছে।

এখন আপনি Wear OS এর জন্য রচনা ব্যবহার করে একটি অ্যাপ তৈরি করা শুরু করতে প্রস্তুত৷

জেটপ্যাক কম্পোজ টুলকিট নির্ভরতা

Wear OS-এর সাথে Jetpack Compose ব্যবহার করতে, আপনাকে আপনার অ্যাপের build.gradle ফাইলে Jetpack Compose টুলকিট নির্ভরতা অন্তর্ভুক্ত করতে হবে। Wear OS-এর সাথে সম্পর্কিত বেশিরভাগ নির্ভরতা পরিবর্তনগুলি উপরের স্থাপত্য স্তরে রয়েছে, নিচের ছবিতে একটি লাল বাক্স দ্বারা বেষ্টিত৷

এর মানে আপনি Jetpack Compose এর সাথে ইতিমধ্যেই ব্যবহার করেন এমন অনেক নির্ভরতা পরিবর্তিত হয় না যখন Wear OS টার্গেট করা হয়। উদাহরণস্বরূপ, UI, রানটাইম, কম্পাইলার এবং অ্যানিমেশন নির্ভরতা একই থাকে।

যাইহোক, Wear OS এর material , foundation এবং navigation লাইব্রেরির নিজস্ব সংস্করণ রয়েছে, তাই আপনি সঠিক লাইব্রেরি ব্যবহার করছেন কিনা তা পরীক্ষা করুন।

যেখানে সম্ভব API-এর WearComposeMaterial সংস্করণ ব্যবহার করুন। যদিও কম্পোজ ম্যাটেরিয়ালের মোবাইল সংস্করণ ব্যবহার করা প্রযুক্তিগতভাবে সম্ভব, এটি Wear OS-এর অনন্য প্রয়োজনীয়তার জন্য অপ্টিমাইজ করা হয় না। উপরন্তু, Wear OS-এর জন্য কম্পোজ ম্যাটেরিয়ালের সাথে কম্পোজ ম্যাটেরিয়াল মিশ্রিত করার ফলে অপ্রত্যাশিত আচরণ হতে পারে। উদাহরণস্বরূপ, যেহেতু প্রতিটি লাইব্রেরির নিজস্ব MaterialTheme ক্লাস রয়েছে, তাই উভয় সংস্করণ ব্যবহার করা হলে রঙ, টাইপোগ্রাফি বা আকারগুলি অসামঞ্জস্যপূর্ণ হওয়ার সম্ভাবনা রয়েছে।

নিম্নলিখিত সারণী Wear OS এবং মোবাইলের মধ্যে নির্ভরতার পার্থক্যগুলিকে রূপরেখা দেয়:

ওএস নির্ভরতা পরিধান করুন

(androidx.wear)

তুলনা মোবাইল নির্ভরতা

(androidx)

androidx.wear.compose:compose-material পরিবর্তে androidx.compose.material:material
androidx.wear.compose:কম্পোজ-নেভিগেশন পরিবর্তে androidx.navigation:নেভিগেশন-কম্পোজ
androidx.wear.compose:কম্পোজ-ফাউন্ডেশন ছাড়াও androidx.compose.foundation:ফাউন্ডেশন

নিম্নলিখিত স্নিপেট একটি উদাহরণ দেখায় build.gradle ফাইল যা এই নির্ভরতাগুলি অন্তর্ভুক্ত করে:

dependencies {

    val composeBom = platform("androidx.compose:compose-bom:2024.10.01")

    // General compose dependencies
    implementation(composeBom)
    implementation("androidx.activity:activity-compose:1.9.3")
    implementation("androidx.compose.ui:ui-tooling-preview:1.7.5")
    // Other compose dependencies

    // Compose for Wear OS Dependencies
    implementation("androidx.wear.compose:compose-material:1.4.0")

    // Foundation is additive, so you can use the mobile version in your Wear OS app.
    implementation("androidx.wear.compose:compose-foundation:1.4.0")

    // Wear OS preview annotations
    implementation("androidx.wear.compose:compose-ui-tooling:1.4.0")

    // If you are using Compose Navigation, use the Wear OS version (NOT THE MOBILE VERSION).
    // Uncomment the line below and update the version number.
    // implementation("androidx.wear.compose:compose-navigation:1.4.0")

    // Testing
    testImplementation("junit:junit:4.13.2")
    androidTestImplementation("androidx.test.ext:junit:1.1.3")
    androidTestImplementation("androidx.test.espresso:espresso-core:3.4.0")
    androidTestImplementation("androidx.compose.ui:ui-test-junit4:1.0.3")
    debugImplementation("androidx.compose.ui:ui-tooling:1.0.3")
}

প্রতিক্রিয়া

Wear OS-এর জন্য কম্পোজ করে দেখুন এবং পরামর্শ ও প্রতিক্রিয়া জানাতে সমস্যা ট্র্যাকার ব্যবহার করুন।

বিকাশকারী সম্প্রদায়ের সাথে সংযোগ করতে Kotlin Slack-এ #compose-wear চ্যানেলে যোগ দিন এবং আপনার অভিজ্ঞতা আমাদের জানান।

{% শব্দার্থে %} {% endverbatim %} ,

Wear OS এর জন্য কম্পোজ মোবাইলের জন্য কম্পোজের মত। যাইহোক, কিছু মূল পার্থক্য আছে। এই নির্দেশিকা আপনাকে মিল এবং পার্থক্যের মধ্য দিয়ে চলে।

Wear OS-এর জন্য কম্পোজ করা হল Android Jetpack-এর অংশ, এবং আপনার ব্যবহার করা অন্যান্য Wear Jetpack লাইব্রেরির মতো এটি আপনাকে আরও ভাল কোড দ্রুত লিখতে সাহায্য করে। Wear OS অ্যাপের জন্য ইউজার ইন্টারফেস তৈরি করার জন্য এটি আমাদের প্রস্তাবিত পদ্ধতি।

আপনি যদি জেটপ্যাক কম্পোজ টুলকিট ব্যবহার করার সাথে অপরিচিত হন তবে কম্পোজ পাথওয়েটি দেখুন। মোবাইল কম্পোজের অনেক ডেভেলপমেন্ট নীতি Wear OS-এর জন্য কম্পোজে প্রযোজ্য। একটি ঘোষণামূলক UI ফ্রেমওয়ার্কের সাধারণ সুবিধা সম্পর্কে আরও তথ্যের জন্য কেন রচনা করবেন দেখুন। Wear OS এর জন্য রচনা সম্পর্কে আরও জানতে, GitHub-এ Wear OS পাথওয়ের জন্য রচনা এবং Wear OS নমুনা সংগ্রহস্থল দেখুন।

Wear OS-এ জেটপ্যাক কম্পোজে মেটেরিয়াল ডিজাইন

Wear OS-এ Jetpack Compose Material 2.5- এর বাস্তবায়ন অফার করে, যা আপনাকে আরও আকর্ষক অ্যাপ অভিজ্ঞতা ডিজাইন করতে সাহায্য করে। Wear OS-এর মেটেরিয়াল ডিজাইনের উপাদানগুলি Wear Material Theming- এর উপরে তৈরি করা হয়েছে। এই থিমিং হল ম্যাটেরিয়াল ডিজাইন কাস্টমাইজ করার এবং আপনার পণ্যের ব্র্যান্ডকে আরও ভালভাবে প্রতিফলিত করার একটি পদ্ধতিগত উপায়।

সামঞ্জস্য

Wear OS এর জন্য রচনা করা ঘড়িতে কাজ করে যা Wear OS 3.0 (API লেভেল 30) সমর্থন করে এবং যে ঘড়িগুলি Wear OS 2.0 (API লেভেল 25 এবং তার উপরে) ব্যবহার করে। Wear OS-এর জন্য কম্পোজ 1.4 সংস্করণ ব্যবহার করার জন্য androidx.compose লাইব্রেরির 1.7 সংস্করণ এবং Kotlin 1.9.0 ব্যবহার করা প্রয়োজন৷ আপনি BOM ম্যাপিং ব্যবহার করতে পারেন এবং কম্পোজ সামঞ্জস্যতা পরীক্ষা করতে Kotlin সামঞ্জস্য মানচিত্র রচনা করতে পারেন

সারফেস

Wear OS-এর জন্য রচনা Wear OS-এ অ্যাপ তৈরি করা সহজ করে তোলে। আরও তথ্যের জন্য অ্যাপস দেখুন। Wear OS নির্দেশিকাগুলির সাথে সামঞ্জস্যপূর্ণ ব্যবহারকারীর অভিজ্ঞতা তৈরি করতে আমাদের অন্তর্নির্মিত উপাদানগুলি ব্যবহার করুন। উপাদান সম্পর্কে আরও তথ্যের জন্য, আমাদের নকশা নির্দেশিকা দেখুন।

সেট আপ করা হচ্ছে

Wear OS-এর সাথে Jetpack Compose ব্যবহার করা অন্য যেকোন Android প্রকল্পের জন্য Jetpack Compose ব্যবহার করার মতই। প্রধান পার্থক্য হল জেটপ্যাক কম্পোজ ফর ওয়ার পরিধান-নির্দিষ্ট লাইব্রেরি যোগ করে যা ঘড়ির জন্য তৈরি ইউজার ইন্টারফেস তৈরি করা সহজ করে। কিছু ক্ষেত্রে এই উপাদানগুলি তাদের অ-পরিধান অংশগুলির মতো একই নাম শেয়ার করে, যেমন androidx.wear.compose.material.Button এবং androidx.compose.material.Button

অ্যান্ড্রয়েড স্টুডিওতে একটি নতুন অ্যাপ তৈরি করুন

জেটপ্যাক রচনা অন্তর্ভুক্ত একটি নতুন প্রকল্প তৈরি করতে, নিম্নরূপ এগিয়ে যান:

  1. আপনি যদি অ্যান্ড্রয়েড স্টুডিওতে স্বাগতম উইন্ডোতে থাকেন, তাহলে একটি নতুন অ্যান্ড্রয়েড স্টুডিও প্রকল্প শুরু করুন ক্লিক করুন। আপনার যদি ইতিমধ্যে একটি অ্যান্ড্রয়েড স্টুডিও প্রকল্প খোলা থাকে তবে মেনু বার থেকে ফাইল > নতুন > আমদানি নমুনা নির্বাচন করুন।
  2. পরিধানের জন্য রচনার জন্য অনুসন্ধান করুন এবং Wear OS স্টার্টারের জন্য রচনা নির্বাচন করুন।
  3. আপনার প্রকল্প উইন্ডো কনফিগার করুন , নিম্নলিখিত করুন:
    1. আবেদনের নাম সেট করুন।
    2. আপনার নমুনার জন্য প্রকল্প অবস্থান চয়ন করুন.
  4. শেষ ক্লিক করুন.
  5. প্রজেক্টের build.gradle ফাইলটি সঠিকভাবে কনফিগার করা হয়েছে কিনা যাচাই করুন, যেমন Gradle বৈশিষ্ট্য ফাইলে বর্ণনা করা হয়েছে।

এখন আপনি Wear OS এর জন্য রচনা ব্যবহার করে একটি অ্যাপ তৈরি করা শুরু করতে প্রস্তুত৷

জেটপ্যাক কম্পোজ টুলকিট নির্ভরতা

Wear OS-এর সাথে Jetpack Compose ব্যবহার করতে, আপনাকে আপনার অ্যাপের build.gradle ফাইলে Jetpack Compose টুলকিট নির্ভরতা অন্তর্ভুক্ত করতে হবে। Wear OS-এর সাথে সম্পর্কিত বেশিরভাগ নির্ভরতা পরিবর্তনগুলি উপরের স্থাপত্য স্তরে রয়েছে, নিচের ছবিতে একটি লাল বাক্স দ্বারা বেষ্টিত৷

এর মানে আপনি Jetpack Compose এর সাথে ইতিমধ্যেই ব্যবহার করেন এমন অনেক নির্ভরতা পরিবর্তিত হয় না যখন Wear OS টার্গেট করা হয়। উদাহরণস্বরূপ, UI, রানটাইম, কম্পাইলার এবং অ্যানিমেশন নির্ভরতা একই থাকে।

যাইহোক, Wear OS এর material , foundation এবং navigation লাইব্রেরির নিজস্ব সংস্করণ রয়েছে, তাই আপনি সঠিক লাইব্রেরি ব্যবহার করছেন কিনা তা পরীক্ষা করুন।

যেখানে সম্ভব API-এর WearComposeMaterial সংস্করণ ব্যবহার করুন। যদিও কম্পোজ ম্যাটেরিয়ালের মোবাইল সংস্করণ ব্যবহার করা প্রযুক্তিগতভাবে সম্ভব, এটি Wear OS-এর অনন্য প্রয়োজনীয়তার জন্য অপ্টিমাইজ করা হয় না। উপরন্তু, Wear OS-এর জন্য কম্পোজ ম্যাটেরিয়ালের সাথে কম্পোজ ম্যাটেরিয়াল মিশ্রিত করার ফলে অপ্রত্যাশিত আচরণ হতে পারে। উদাহরণস্বরূপ, যেহেতু প্রতিটি লাইব্রেরির নিজস্ব MaterialTheme ক্লাস রয়েছে, তাই উভয় সংস্করণ ব্যবহার করা হলে রঙ, টাইপোগ্রাফি বা আকারগুলি অসামঞ্জস্যপূর্ণ হওয়ার সম্ভাবনা রয়েছে।

নিম্নলিখিত সারণী Wear OS এবং মোবাইলের মধ্যে নির্ভরতার পার্থক্যগুলিকে রূপরেখা দেয়:

ওএস নির্ভরতা পরিধান করুন

(androidx.wear)

তুলনা মোবাইল নির্ভরতা

(androidx)

androidx.wear.compose:compose-material পরিবর্তে androidx.compose.material:material
androidx.wear.compose:কম্পোজ-নেভিগেশন পরিবর্তে androidx.navigation:নেভিগেশন-কম্পোজ
androidx.wear.compose:কম্পোজ-ফাউন্ডেশন ছাড়াও androidx.compose.foundation:ফাউন্ডেশন

নিম্নলিখিত স্নিপেট একটি উদাহরণ দেখায় build.gradle ফাইল যা এই নির্ভরতাগুলি অন্তর্ভুক্ত করে:

dependencies {

    val composeBom = platform("androidx.compose:compose-bom:2024.10.01")

    // General compose dependencies
    implementation(composeBom)
    implementation("androidx.activity:activity-compose:1.9.3")
    implementation("androidx.compose.ui:ui-tooling-preview:1.7.5")
    // Other compose dependencies

    // Compose for Wear OS Dependencies
    implementation("androidx.wear.compose:compose-material:1.4.0")

    // Foundation is additive, so you can use the mobile version in your Wear OS app.
    implementation("androidx.wear.compose:compose-foundation:1.4.0")

    // Wear OS preview annotations
    implementation("androidx.wear.compose:compose-ui-tooling:1.4.0")

    // If you are using Compose Navigation, use the Wear OS version (NOT THE MOBILE VERSION).
    // Uncomment the line below and update the version number.
    // implementation("androidx.wear.compose:compose-navigation:1.4.0")

    // Testing
    testImplementation("junit:junit:4.13.2")
    androidTestImplementation("androidx.test.ext:junit:1.1.3")
    androidTestImplementation("androidx.test.espresso:espresso-core:3.4.0")
    androidTestImplementation("androidx.compose.ui:ui-test-junit4:1.0.3")
    debugImplementation("androidx.compose.ui:ui-tooling:1.0.3")
}

প্রতিক্রিয়া

Wear OS-এর জন্য কম্পোজ করে দেখুন এবং পরামর্শ ও প্রতিক্রিয়া জানাতে সমস্যা ট্র্যাকার ব্যবহার করুন।

বিকাশকারী সম্প্রদায়ের সাথে সংযোগ করতে Kotlin Slack-এ #compose-wear চ্যানেলে যোগ দিন এবং আপনার অভিজ্ঞতা আমাদের জানান।

{% শব্দার্থে %}
{% endverbatim %}