টাইল রান ও ডিবাগ করা

টাইল অ্যাপ নয়, তাই আলাদা আলাদা মেকানিজম ব্যবহার করে ডিপ্লয় ও লঞ্চ করা হয়। কোনও ডিভাইসে ডেভেলপার বিকল্প চালু করা থাকলে (ইমুলেটরে এই ফিচারগুলি ডিফল্ট হিসেবে চালু করা থাকে), টাইলের ডেভেলপমেন্টে সহায়তা করে এমন অতিরিক্ত ফিচার Android Studio এবং adb, দু'টিতেই ব্যবহার করার জন্য উপলভ্য হয়ে যায়।

টাইল ডেপ্লয় করা

আপনার টাইল ডেপ্লয় করতে, আপনার অ্যাপ তৈরি ও রান করুন নিবন্ধে বর্ণিত পদ্ধতি অনুযায়ী, Android Studio ব্যবহার করে কোনও ফিজিক্যাল ডিভাইস বা এমুলেটরে আপনার অ্যাপ ইনস্টল করতে পারেন। তারপরে, সাধারণ ব্যবহারকারীদের মতো একই ধাপ অনুসরণ করে, ম্যানুয়ালি টাইল ক্যারোজেল এ টাইল যোগ করুন।

অ্যাক্টিভ ডেভেলপমেন্টের সময়, আপনি Android Studio-এর "Wear OS টাইল" রান/ডিবাগ কনফিগারেশন ফিচার ব্যবহার করা সহজ ও দ্রুত বলে মনে করতে পারেন। এই পদ্ধতি আপনার টাইল অটোমেটিক প্রয়োগ ও অ্যাক্টিভেট করে, যার ফলে অতিরিক্ত ম্যানুয়াল ধাপ ছাড়াই সাথে সাথেই ইন্টার‍্যাক্ট করা যায়।

অটোমেটিক কনফিগারেশন তৈরি করা

টাইল ডেপ্লয় ও রান করার সবচেয়ে সহজ উপায় হল গটারে থাকা "রান সার্ভিস" আইকন ব্যবহার করা। আগে থেকে না থাকলে এটি অটোমেটিক রান কনফিগারেশন তৈরি করে। আরও তথ্যের জন্য Wear OS রান/ডিবাগ কনফিগারেশন দেখুন।

গাটারে লাল তীরচিহ্ন দিয়ে "▷" দেখানো স্ক্রিনশট
গাটারে "▷" আইকনে ক্লিক করুন
রান কনফিগারেশন ড্রপডাউনের দিকে নির্দেশ করা লাল তীরচিহ্ন এবং লাল রঙে আউটলাইন করা "TestTileService" কনফিগারেশন বিকল্প দেখানো স্ক্রিনশট
"রান কনফিগারেশন" অটোমেটিক তৈরি হয়

ম্যানুয়ালি কনফিগারেশন তৈরি করা

অটোমেটিক কনফিগারেশন কাজ না করলে অথবা আপনি যদি ফলাফল আরও বেশি কন্ট্রোল করতে চান, তাহলে নিম্নলিখিত নির্দেশাবলী দেখুন। স্ক্রিনশটগুলি Android Studio Meerkat (2024.3.1) থেকে নেওয়া হয়েছে।

  1. টাইটেল বার থেকে "⋮" ("হ্যামবার্গার") বিকল্প বেছে নিন।

    স্ক্রিনশটে লাল তীরচিহ্ন দিয়ে টাইটেল বারে থাকা "⋮" ("হ্যামবার্গার") বিকল্পটি দেখানো হয়েছে।
  2. "এডিট করুন…" বিকল্প বেছে নিন।

    ড্রপ-ডাউন তালিকার 'কনফিগারেশন' বিভাগের প্রথম বিকল্প হল "এডিট করুন…"।
  3. যে ডায়ালগটি দেখা যাবে তাতে কনফিগারেশন যোগ করতে "+" বেছে নিন।

    "+"-এর দিকে নির্দেশ করা লাল তীরচিহ্ন সহ স্ক্রিনশট।
  4. নতুন কনফিগারেশনের ধরন হিসেবে "Wear OS টাইল" বেছে নিন।

    "Wear OS টাইল" কনফিগারেশন বিকল্পের দিকে নির্দেশ করা লাল তীরচিহ্ন সহ স্ক্রিনশট।
  5. আপনার কনফিগারেশনের নাম লিখুন এবং উপযুক্ত মডিউল ও টাইল বেছে নিন।

    ডায়ালগ উইন্ডোর বিভিন্ন অংশকে নির্দেশ করে তিনটি লাল তীরচিহ্ন সহ স্ক্রিনশট।
  6. "ঠিক আছে" বিকল্পে ট্যাপ করুন। টাইটেল বারে আপনার কনফিগারেশন দেখা যাবে। "▷" ("রান করুন") বোতামে ট্যাপ করুন এবং আপনার টাইল ডিপ্লয় ও অ্যাক্টিভেট করা হবে।

Android Studio-তে প্রিভিউ টাইল

Android Studio Koala ফিচার ড্রপ থেকে শুরু করে, আপনি নিজের Wear OS অ্যাপের টাইলের স্ন্যাপশট দেখতে পারবেন। আপনার টাইলের চেহারা যদি বিভিন্ন অবস্থার ভিত্তিতে পরিবর্তিত হয়, তাহলে এই প্যানেলটি বিশেষভাবে উপযোগী। যেমন, ডিভাইসের ডিসপ্লে সাইজ বা কোনও স্পোর্টস ইভেন্ট হাফটাইমে পৌঁছানোর মতো বিভিন্ন কন্টেন্ট।

প্রিভিউ প্যানেলে গ্রুপের নাম
    প্রিভিউ অ্যানোটেশনে দেওয়া গ্রুপের নামের সাথে মিলছে
Android Studio-তে টাইল প্রিভিউ প্যানেল।

ডিপেন্ডেন্সি যোগ করা

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

dependencies {
    implementation("androidx.wear.tiles:tiles-tooling-preview:1.6.2")
    debugImplementation("androidx.wear.tiles:tiles-tooling:1.6.2")
    implementation("androidx.wear:wear-tooling-preview:1.0.0")
}

টাইল প্রিভিউ কনফিগার করা

বিভিন্ন Wear OS ডিসপ্লে সাইজে আপনার টাইলের চেহারা কেমন হবে তার প্রিভিউ দেখতে, @Preview অ্যানোটেশন যোগ করুন এবং device প্যারামিটার পাস করুন। মনে রাখবেন যে এই @Preview অ্যানোটেশনটি আপনি কম্পোজ করা যায় এমন প্রিভিউয়ের জন্য যে প্যাকেজ ব্যবহার করেন তার থেকে আলাদা প্যাকেজের।

@Preview(device = WearDevices.SMALL_ROUND)
@Preview(device = WearDevices.LARGE_ROUND)
fun tilePreview(context: Context) = TilePreviewData { request ->
    TilePreviewHelper.singleTimelineEntryTileBuilder(
        buildMyTileLayout(context, request.deviceConfiguration)
    ).build()
}

রিসোর্স যোগ ও রেজিস্টার করা

আপনার টাইল Android রিসোর্স ব্যবহার করলে, আপনাকে সেগুলি TilePreviewData-এর onTileResourceRequest প্যারামিটারের মধ্যে রেজিস্টার করতে হবে, যেমনটি নিম্নলিখিত কোড স্নিপেটে দেখানো হয়েছে:

@Preview(device = WearDevices.SMALL_ROUND)
fun previewWithResources(context: Context) = TilePreviewData(
    onTileResourceRequest = { request ->
        Resources.Builder()
            .setVersion(RESOURCES_VERSION)
            .addIdToImageMapping(
                myImageId,
                getImageById(R.drawable.animated_walk)
            )
            .build()
    },
    onTileRequest = { request ->
        TilePreviewHelper.singleTimelineEntryTileBuilder(
            buildMyTileLayout(context, request.deviceConfiguration)
        ).build()
    }
)

প্ল্যাটফর্ম ডেটা সোর্স থেকে নির্দিষ্ট ভ্যালু দেখানো

আপনার টাইল যদি প্ল্যাটফর্ম ডেটা ব্যবহার করে—যেমন হার্ট রেট, ক্যালোরি, দূরত্ব এবং স্টেপ—তাহলে টাইল সেগুলির ডিফল্ট ভ্যালু দেখায়।

নির্দিষ্ট ভ্যালু দেখাতে, TilePreviewData অবজেক্ট তৈরি করার সময় platformDataValues প্যারামিটার সেট করুন, যেমনটি নিম্নলিখিত কোড স্নিপেটে দেখানো হয়েছে:

@Preview(device = WearDevices.SMALL_ROUND)
fun previewWithPlatformOverride(context: Context) = TilePreviewData(
    platformDataValues = PlatformDataValues.of(
        PlatformHealthSources.Keys.HEART_RATE_BPM,
        DynamicDataBuilders.DynamicDataValue.fromFloat(160f)
    ),
    onTileRequest = { request ->
        TilePreviewHelper.singleTimelineEntryTileBuilder(
            buildMyTileLayoutDynamic(context, request.deviceConfiguration)
        ).build()
    }
)

adb ব্যবহার করে টাইল ম্যানিপুলেট করা

ডেভেলপমেন্টের সময় প্রোগ্রাম্যাটিক উপায়ে টাইলের ইনস্টল, সরানো ও অ্যাক্টিভেট করার জন্য adb ব্যবহার করা যেতে পারে ।

নিম্নলিখিত কমান্ডে, ComponentName হল প্যাকেজ নাম এবং সেই প্যাকেজের মধ্যে থাকা ক্লাস দিয়ে তৈরি একটি স্ট্রিং, যেমন com.example.wear.tiles/com.example.wear.tiles.PreviewTileService।

টাইল যোগ করা

COMPONENT_NAME-এর দেওয়া একটি টাইল যোগ করে এবং ইন্ডেক্স রিটার্ন করে।

adb shell am broadcast -a com.google.android.wearable.app.DEBUG_SURFACE --es operation add-tile --ecn component [COMPONENT_NAME]

আউটপুটের উদাহরণ:

Broadcast completed: result=1, data="Index=[0]"

ক্যারোজেলে কোনও টাইল আগে থেকেই থাকলে, সেটি সরিয়ে দিয়ে একই জায়গায় আবার যোগ করা হয়। অন্যথায়, এটি Index[0]-এ যোগ করা হয়। এছাড়াও, ক্যারোজেলটি সর্বাধিক ক্যাপাসিটিতে থাকলে, নতুন টাইল যোগ করার জন্য শেষ টাইলটি সরিয়ে দেওয়া হয়।

show-tile

TILE_INDEX নম্বর ইনডেক্সে থাকা টাইল অ্যাক্টিভেট করো।

adb shell am broadcast -a com.google.android.wearable.app.DEBUG_SYSUI --es operation show-tile --ei index [TILE_INDEX]

আউটপুটের উদাহরণ:

Broadcast completed: result=1

remove-tile

COMPONENT_NAME-এর সাথে যুক্ত ক্যারোজেলের সবকটি টাইল ইনস্ট্যান্স সরিয়ে দেয়।

adb shell am broadcast -a com.google.android.wearable.app.DEBUG_SURFACE --es operation remove-tile --ecn component [COMPONENT_NAME]

আউটপুটের উদাহরণ:

result=1, data="Tile(s) removed."

রিটার্ন ভ্যালু

  • result=0: কোনও ব্রডকাস্ট রিসিভার এই কমান্ডের উত্তর দেয়নি, সম্ভবত কারণ Wear OS ভার্সনটি খুব পুরনো অথবা ডিবাগ প্রসেস চলছে না।
  • result=1: সফল।
  • result>1: সমস্যা।