উইজেট ব্যবহার করা শুরু করুন

পূর্বশর্ত ও সেট-আপ

শুরু করার আগে, আপনার এনভায়রনমেন্ট নিম্নলিখিত প্রয়োজনীয়তা পূরণ করছে কিনা তা নিশ্চিত করুন।

রানটাইম সংক্রান্ত প্রয়োজনীয়তা

টার্গেট ডিভাইসে Wear উইজেটের জন্য com.google.android.wearable.protolayout.renderer APK-এর ১.৬.১ বা তার পরবর্তী ভার্সন প্রয়োজন।

নিম্নলিখিত উপায়ে রেন্ডারারের মানানসই ভার্সন পান:

  • Wear OS 7 এমুলেটর: Wear OS 7 এমুলেটর ইমেজ ব্যবহার করুন। ৭-এর থেকে কম ভার্সন উপযুক্ত নয়। সেট-আপ সংক্রান্ত নির্দেশাবলীর জন্য, Wear OS 7 এমুলেটর সেট-আপ করুন নিবন্ধটি দেখুন।
  • ফিজিক্যাল ডিভাইস: এমন একটি ফিজিক্যাল Wear OS ডিভাইস ব্যবহার করুন যা Google Play Store থেকে অটোমেটিক আপডেট পায় অথবা Google Play Store-এ সাইন-ইন করা কোনও ডেভেলপার ডিভাইস ব্যবহার করুন।

আপনার ডিভাইসে কোন ভার্সন ইনস্টল করা আছে তা চেক করতে, নিম্নলিখিত কমান্ড ব্যবহার করুন:

adb shell dumpsys package com.google.android.wearable.protolayout.renderer | \
  grep -m 1 versionName | \
  awk -F= '{print $2}'

Gradle কনফিগারেশন

Wear Widget লাইব্রেরি Google Maven-এ উপলভ্য।

১. SDK ভার্সন কনফিগার করুন

আপনার compileSdk এবং targetSdk ৩৭ বা তার বেশি সেট করা আছে কিনা তা নিশ্চিত করুন।

android {
    compileSdk = 37
    // ...
    defaultConfig {
        targetSdk = 37
        // ...
    }
}

২. নির্ভরতা যোগ করুন

আপনার অ্যাপের build.gradle.kts ফাইলে নিম্নলিখিত ডিপেন্ডেন্সি অন্তর্ভুক্ত করুন:

গ্ৰুভি

dependencies {
    // Core Wear Widget and Remote Compose libraries
    implementation "androidx.compose.remote:remote-creation-compose:1.0.0-alpha21"
    implementation "androidx.compose.remote:remote-core:1.0.0-alpha21"
    implementation "androidx.glance.wear:wear:1.0.0-alpha20"
    implementation "androidx.glance.wear:wear-core:1.0.0-alpha20"
    implementation "androidx.wear.compose.remote:remote-material3:1.0.0-alpha13"

    // Tooling for previews (optional, but recommended)
    implementation "androidx.compose.remote:remote-tooling-preview:1.0.0-alpha21"
    implementation "androidx.wear.compose:compose-ui-tooling:1.7.1"
    implementation "androidx.wear.tiles:tiles-tooling-preview:1.6.2"
    debugImplementation "androidx.wear.tiles:tiles-renderer:1.6.2"
}

Kotlin

dependencies {
    // Core Wear Widget and Remote Compose libraries
    implementation("androidx.compose.remote:remote-creation-compose:1.0.0-alpha21")
    implementation("androidx.compose.remote:remote-core:1.0.0-alpha21")
    implementation("androidx.glance.wear:wear:1.0.0-alpha20")
    implementation("androidx.glance.wear:wear-core:1.0.0-alpha20")
    implementation("androidx.wear.compose.remote:remote-material3:1.0.0-alpha13")

    // Tooling for previews (optional, but recommended)
    implementation("androidx.compose.remote:remote-tooling-preview:1.0.0-alpha21")
    implementation("androidx.wear.compose:compose-ui-tooling:1.7.1")
    implementation("androidx.wear.tiles:tiles-tooling-preview:1.6.2")
    debugImplementation("androidx.wear.tiles:tiles-renderer:1.6.2")
}

Hello World উইজেট তৈরি করা

Wear উইজেটে GlanceWearWidgetService এক্সটেন্ড করা একটি পরিষেবা এবং GlanceWearWidget এক্সটেন্ড করা একটি উইজেট ক্লাস থাকে। আপনি @RemoteComposable ফাংশন ব্যবহার করে UI নির্ধারণ করেন।

পরিষেবাটি সংজ্ঞায়িত করুন

পরিষেবা হল এন্ট্রি পয়েন্ট যা সিস্টেমের সাথে যুক্ত থাকে।

আপনার উইজেট নির্ধারণ করতে, এমন একটি পরিষেবা তৈরি করুন যা GlanceWearWidgetService-কে এক্সটেন্ড করে এবং এটিকে @AssociateWithGlanceWearWidget দিয়ে অ্যানোটেট করুন, যাতে পরিষেবাটি উপযুক্ত GlanceWearWidget ক্লাসের সাথে যুক্ত করা যায়।

@AssociateWithGlanceWearWidget(HelloWidget::class)
class HelloWidgetService : GlanceWearWidgetService() {
    override val widget: GlanceWearWidget = HelloWidget()
}

উইজেট নির্ধারণ করুন

উইজেট ক্লাস উইজেটের জন্য ডেটা এবং লেআউট প্রদান করে।

class HelloWidget : GlanceWearWidget() {
    override suspend fun provideWidgetData(
        context: Context,
        params: WearWidgetParams,
    ): WearWidgetData {
        return WearWidgetDocument(
            background = WearWidgetBrush.color(Color.Blue.rc),
        ) {
            HelloWidgetContent()
        }
    }
}

কন্টেন্ট নির্ধারণ করুন

রিমোট কম্পোজ কম্পোনেন্ট ব্যবহার করে কন্টেন্ট তৈরি করা হয়েছে।

@RemoteComposable
@Composable
fun HelloWidgetContent() {
    RemoteBox(
        modifier = RemoteModifier.fillMaxSize(),
        contentAlignment = RemoteAlignment.Center,
    ) {
        RemoteText(
            text = "Hello World".rs,
            color = Color.White.rc,
        )
    }
}

Android Studio-তে আপনার উইজেটের প্রিভিউ দেখুন

আপনি androidx.glance.wear:wear-tooling-preview ব্যবহার করে Android Studio-এর ডিজাইন প্যানেলে সরাসরি আপনার উইজেট লেআউটের প্রিভিউ দেখতে পারবেন।

পূর্বনির্ধারিত প্রিভিউ স্যুট

wear-tooling-preview লাইব্রেরি বিভিন্ন কন্টেনার আকার এবং ডিভাইস কনফিগারেশন জুড়ে আপনার লেআউট পরীক্ষা করার জন্য পূর্বনির্ধারিত PreviewParameterProvider স্যুট প্রদান করে:

  • Squircle Suite (SquircleAllWidgetPreviewParams): বৃত্তাকার কোণবিশিষ্ট আয়তক্ষেত্র কন্টেনার।
  • রাউন্ড সুইট (RoundAllWidgetPreviewParams): পিল-আকৃতির কন্টেনার।
  • আয়তাকার সুইট (RectangularAllWidgetPreviewParams): ক্রপ না করা আয়তাকার কন্টেনার যাতে নিরাপদ প্যাডিং আছে। এই প্রিভিউ কনফিগারেশনের মাধ্যমে তৈরি করা ছবি, উইজেট পিকারের মাধ্যমে ব্যবহার করা APK-এম্বেডেড প্রিভিউ ছবি হিসেবে ব্যবহার করার জন্য উপযুক্ত (প্রিভিউ ছবি অ্যাসেট তৈরি করুন দেখুন)।

Android Studio-তে আপনার উইজেটের প্রিভিউ দেখতে, @WearWidgetPreview ব্যবহার করুন:

@Preview
@Composable
fun HelloWidgetPreview(
    @PreviewParameter(SquircleAllWidgetPreviewParams::class) params: WearWidgetParams,
) {
    WearWidgetPreview(
        widget = HelloWidget(),
        params = params,
    )
}

উইজেট কনফিগারেশন XML তৈরি করুন

উইজেটের প্রপার্টি ও কাজ করে এমন সাইজ নির্ধারণ করতে নতুন ফাইল res/xml/hello_widget_info.xml তৈরি করুন। <wearwidget-provider> ট্যাগে কাজ করে এমন XML অ্যাট্রিবিউটের সম্পূর্ণ রেফারেন্সের জন্য, WearWidgetProviderInfo ডকুমেন্টেশন দেখুন।

<wearwidget-provider
    description="@string/hello_widget_description"
    icon="@mipmap/ic_launcher"
    label="@string/hello_widget_label"
    preferredType="SMALL">

    <container
        type="SMALL"
        previewImage="@drawable/widget_preview_small" />
    <container
        type="LARGE"
        previewImage="@drawable/widget_preview_large" />
</wearwidget-provider>

প্রিভিউ ইমেজ অ্যাসেট জেনারেট করুন

<container> এলিমেন্টের previewImage অ্যাট্রিবিউট সিস্টেম উইজেট পিকারে দেখানো ড্রয়েবল অ্যাসেটকে রেফার করে। সঠিক বাউন্ড ও ডেনসিটি সহ প্রিভিউ অ্যাসেট জেনারেট করতে, RectangularAllWidgetPreviewParams (যা ছোট ও বড় কন্টেনার, উভয়ের জন্যই প্রিভিউ ভেরিয়েন্ট জেনারেট করে) সহ Android Studio প্রিভিউ ব্যবহার করুন এবং ৩২০ DPI স্মার্টওয়াচ ডিসপ্লে ডেনসিটি উল্লেখ করুন:

@Preview(
    name = "Widget Preview Asset",
    device = "spec:width=1000dp,height=1000dp,dpi=320",
)
@Composable
fun HelloWidgetCatalogPreview(
    @PreviewParameter(RectangularAllWidgetPreviewParams::class) params: WearWidgetParams,
) {
    WearWidgetPreview(
        widget = HelloWidget(),
        params = params,
    )
}

রেন্ডার করা প্রিভিউ ছবি এক্সট্র্যাক্ট করতে, নিম্নলিখিত ধাপগুলি সম্পূর্ণ করুন:

  1. Android Studio-তে, প্রিভিউ কম্পোজেবলের জন্য ডিজাইন সারফেস খুলুন।
  2. প্রিভিউ উইন্ডোতে, রেন্ডার করা প্রিভিউতে মাউসের ডানদিকের বোতামে ক্লিক করুন অথবা প্রিভিউ টুলবার ব্যবহার করে ছবি কপি করুন অথবা ছবিটি সেভ করুন। বিকল্প হিসেবে, কম্পোজ প্রিভিউ এক্সট্র্যাক্ট করতে CLI টুলিং বা অটোমেটেড স্ক্রিপ্ট ব্যবহার করুন।
  3. আপনার অ্যাপের res/drawable-nodpi/ ডিরেক্টরিতে ছোট ও বড় ছবির ফাইল সেভ করুন, যেমন res/drawable-nodpi/widget_preview_small.png এবং res/drawable-nodpi/widget_preview_large.png।

AndroidManifest.xml-এ রেজিস্টার করুন

প্রয়োজনীয় ইনটেন্ট ফিল্টার ও মেটাডেটা সহ আপনার AndroidManifest.xml-এ পরিষেবাটি রেজিস্টার করুন।

<service
    android:name=".snippets.widget.HelloWidgetService"
    android:exported="true"
    android:icon="@mipmap/ic_launcher"
    android:label="@string/hello_widget_label"
    android:permission="com.google.android.wearable.permission.BIND_TILE_PROVIDER">

    <intent-filter>
        <action android:name="androidx.glance.wear.action.BIND_WIDGET_PROVIDER" />
        <!-- If you already have a Tile, omit the following line. -->
        <action android:name="androidx.wear.tiles.action.BIND_TILE_PROVIDER" />
    </intent-filter>

    <meta-data
        android:name="androidx.glance.wear.widget.provider"
        android:resource="@xml/hello_widget_info" />

    <meta-data
        android:name="androidx.wear.tiles.PREVIEW"
        android:resource="@drawable/tile_preview" />
</service>

বিল্ড ও ডিপ্লয় করুন

আপনার পরিষেবা এবং উইজেট সংজ্ঞায়িত করার পরে, আপনি আপনার প্রোজেক্ট তৈরি করতে এবং এটি একটি ডিভাইস বা এমুলেটরে ডিপ্লয় করতে পারেন।

বিল্ড ও ইনস্টল করুন

প্রোজেক্ট তৈরি করুন এবং আপনার কানেক্ট করা ডিভাইস বা এমুলেটরে ডিবাগ APK ইনস্টল করুন:

./gradlew :app:installDebug

আপনার উইজেট যোগ করুন ও প্রিভিউ দেখুন

অ্যাপ ইনস্টল করার পরে, ক্যারোজেলে প্রোগ্রাম্যাটিক্যালি উইজেট যোগ করতে এবং স্ক্রিনে এটি দেখাতে adb ব্যবহার করুন।

মনে রাখবেন: Wear Widgets ডিবাগ করার জন্য অন্তর্নিহিত টাইল ইনফ্রাস্ট্রাকচার ব্যবহার করে। এর ফলে, adb কমান্ডের জন্য add-tile এবং show-tile অপারেশন প্রয়োজন।

১. ক্যারোজেলে উইজেট যোগ করুন:

adb shell am broadcast \
  -a com.google.android.wearable.app.DEBUG_SURFACE \
  --es operation add-tile \
  --ecn component <your_package_name>/.HelloWidgetService

২. উইজেট দেখুন:

adb shell am broadcast \
  -a com.google.android.wearable.app.DEBUG_SYSUI \
  --es operation show-tile \
  --ei index 0

প্রোগ্রাম্যাটিক্যালি উইজেট কন্টেন্ট আপডেট করুন

আপনার অ্যাপের অন্তর্নিহিত ডেটা পরিবর্তন হলে (যেমন ডেটা সিঙ্ক, পুশ বিজ্ঞপ্তি বা ব্যবহারকারীর অ্যাকশন পাওয়া), উইজেট কন্টেন্ট রিফ্রেশ করার জন্য সিস্টেমকে বিজ্ঞপ্তি পাঠান।

আপনার উইজেটের সব অ্যাক্টিভ ইনস্ট্যান্সের জন্য আপডেট করার অনুরোধ করতে, আপনার উইজেট ক্লাসে triggerUpdateAll কল করুন:

// Request a content update for all active HelloWidget instances
HelloWidget().triggerUpdateAll(context)

সব অ্যাক্টিভ ইনস্ট্যান্স রিফ্রেশ না করে নির্দিষ্ট কোনও উইজেট ইনস্ট্যান্স আপডেট করতে, টার্গেট ইনস্ট্যান্স আইডি সহ triggerUpdate কল করুন।