برنامه‌های Wear OS خوداتکا دربرابر غیرخوداتکا

توصیه می‌کنیم برنامه‌های Wear OS مستقل از تلفن کار کنند تا کاربران بتوانند بدون دسترسی به تلفن Android یا iOS، کارها را در ساعت تکمیل کنند. اگر برنامه ساعت شما به تعامل با تلفن نیاز دارد، باید برنامه Wear OS خود را به‌عنوان غیرمستقل علامت‌گذاری کنید و اقداماتی انجام دهید تا مطمئن شوید که برنامه تلفن برای کاربر دردسترس است.

برنامه‌ریزی کردن برنامه

می‌توانید از Android App Bundle استفاده کنید تا به‌طور خودکار Android Package Kit (APK) بهینه‌شده برای پیکربندی دستگاه هر کاربر تحت همان فهرستگان برنامه تولید شود. این کار به کاربران اجازه می‌دهد فقط کد و منابعی را که برای اجرای برنامه‌تان نیاز دارند بارگیری کنند.

برای کسب اطلاعات درباره راه‌اندازی برنامه برای توزیع ازطریق «فروشگاه Google Play»، به بسته‌بندی و توزیع برنامه‌های Wear OS و راهنمای شروع کار با بسته‌های ترکیبی برنامه Android مراجعه کنید.

برای برنامه‌های جدید، سطح میانای برنامه‌سازی کاربردی هدف باید ۳۴ یا بالاتر باشد. برای اطلاعات بیشتر، به برآورده کردن الزامات سطح میانای برنامه‌سازی کاربردی هدف Google Play مراجعه کنید. هدف‌یابی جدیدترین سطح میانای برنامه‌سازی کاربردی دردسترس کمک می‌کند مطمئن شوید برنامه‌تان در نسخه‌های فعلی پلاتفرم به‌خوبی کار می‌کند.

برای اطلاعات درباره درخواست‌های شبکه و دسترسی به شبکه با پهنای باند بالا، به دسترسی به شبکه و همگام‌سازی در Wear OS مراجعه کنید.

تعریف کردن برنامه به‌عنوان برنامه Wear OS

باید برچسب <uses-feature> را در فایل مانیفست Android برنامه‌تان تعریف کنید. برای نشان دادن اینکه برنامه ساعت است، ورودی‌ای مانند زیر اضافه کنید:

<uses-feature android:name="android.hardware.type.watch" />

شناسایی برنامه به‌عنوان مستقل یا غیرمستقل

برنامه ساعت یا مستقل یا غیرمستقل درنظر گرفته می‌شود:

  • مستقل: برنامه‌ای کاملاً مستقل که برای ویژگی‌های اصلی به برنامه تلفن نیاز ندارد. اگرچه پیام‌واره‌های «باز کردن در تلفن» قابل‌قبول است، برنامه باید روش‌های جایگزینی برای تکمیل عملکرد برنامه (مانند پیوند کوتاه یا رمزینه پاسخ‌سریع) بدون وابستگی به تلفن متصل‌شده ارائه دهد.
  • غیرمستقل: برنامه وابسته‌ای که برای ویژگی‌های اصلی به برنامه‌ای در تلفن یا دستگاه دیگری نیاز دارد. این گزینه برای برنامه‌هایی مناسب است که نمی‌توانند به‌راحتی روش جایگزینی (مثل رمزینه پاسخ‌سریع یا پیوند کوتاه) برای تکمیل عملکرد اصلی برنامه (مثل اصالت‌سنجی) ارائه دهند.

توجه: حتی برای برنامه‌های غیرمستقل، کاربران می‌توانند برنامه Wear OS را قبل‌از برنامه تلفن همراه نصب کنند. بنابراین، اگر برنامه Wear OS شما تشخیص دهد که دستگاه دستی نزدیک فاقد برنامه همراه لازم است، از کاربر بخواهید برنامه همراه را نصب کند.

Google درطول ارائه برنامه، دقت وضعیت مستقل برنامه را اعتبارسنجی می‌کند. این مقدار بر نمایان بودن برنامه‌ها در «فروشگاه Play» در دستگاه‌های مستقل، مانند دستگاه‌های Wear OS که با دستگاه‌های دستی مرتبط نشده‌اند، تأثیر می‌گذارد. برنامه‌های غیرمستقل—و همچنین برنامه‌هایی که توسعه‌دهندگان به‌اشتباه آن‌ها را به‌عنوان «مستقل» تعیین می‌کنند—برای کاربران این دستگاه‌های غیرمتصل دردسترس نیستند.

در برنامه Wear OS، مقدار عنصر meta-data com.google.android.wearable.standalone را در فایل مانیفست Android تنظیم کنید تا مشخص شود برنامه‌تان مستقل است یا غیرمستقل.

اگر برنامه ساعت شما کاملاً مستقل و خوداتکا است، این موضوع را با تنظیم مقدار com.google.android.wearable.standalone روی true به «فروشگاه Google Play» نشان دهید:

<meta-data
    android:name="com.google.android.wearable.standalone"
    android:value="true" />

اگر برنامه ساعت شما غیرمستقل است و برای ویژگی‌های اصلی به برنامه دیگری وابسته است، مقدار com.google.android.wearable.standalone را روی false تنظیم کنید. این نشان می‌دهد که برنامه ساعت به دستگاه دیگری نیاز دارد، اما بر تبلیغ برنامه شما در «فروشگاه Google Play» تأثیری نمی‌گذارد.

توجه: حتی اگر مقدار com.google.android.wearable.standalone false باشد، برنامه ساعت می‌تواند قبل‌از نصب برنامه تلفن نصب شود. بنابراین، اگر برنامه ساعت شما تشخیص دهد که تلفن همپا برنامه تلفن لازم را ندارد، همان‌طور که در این صفحه شرح داده شده است، از کاربر بخواهید برنامه تلفن را نصب کند.

فضای ذخیره‌سازی داده و کد مشترک

کد را می‌توان بین برنامه Wear OS و برنامه تلفن هم‌رسانی کرد. برای مثال، کد مشترک برای شبکه‌سازی می‌تواند در کتابخانه مشترک باشد.

اختیاراً، کدی که مختص ضریب شکل است می‌تواند در واحدی جداگانه باشد.

می‌توانید از میاناهای برنامه‌سازی کاربردی استاندارد فضای ذخیره‌سازی Android برای ذخیره کردن داده‌ها به‌صورت محلی استفاده کنید، همان‌طور که در تلفن انجام می‌دهید. می‌توانید از DataStore برای ذخیره کردن جفت‌های کلید-مقدار و اشیای تایپ‌شده استفاده کنید، یا می‌توانید از کتابخانه پایداری Room استفاده کنید.

برنامه‌تان را در دستگاه دیگری شناسایی کند

برنامه ساعت و برنامه تلفن متناظر آن هرکدام می‌توانند تشخیص دهند که برنامه دیگر دردسترس است یا نه.

برنامه‌های تلفن و ساعت شما می‌توانند از CapabilityClient برای تبلیغ حضور خود به دستگاه جفت‌شده استفاده کنند. این کار را می‌توانند به‌صورت ایستا یا پویا انجام دهند.

وقتی برنامه‌ای در گره‌ای در شبکه Wear OS کاربر باشد، مثلاً در تلفن، ساعت جفت‌شده، یا در فضای ابری، CapabilityClient به برنامه‌های دیگر اجازه می‌دهد آن را شناسایی کنند. برای اطلاعات بیشتر، کاوش دستگاه‌های خاص بااستفاده از کلاینت قابلیت را ببینید.

اگر یکی از برنامه‌هایتان نمی‌تواند برنامه دیگر را شناسایی کند، می‌توانید از کاربر بخواهید فهرستگان «فروشگاه Play» را در دستگاه تحت‌تأثیرقرارگرفته باز کند. این راه‌حلی است برای برنامه‌های ساعت که برای عملکرد صحیح به حضور برنامه تلفن همراهشان نیاز دارند.

باید بررسی کنید که آیا «فروشگاه Play» در دستگاه دردسترس است یا نه، زیرا همه تلفن‌ها (مثل iPhone) از «فروشگاه Play» پشتیبانی نمی‌کنند.

بخش‌های زیر روال‌های مطلوب را برای دو سناریو شرح می‌دهند:

  • برنامه ساعت مستقل شما به برنامه تلفن نیاز دارد.
  • برنامه تلفن شما به برنامه ساعت مستقلتان نیاز دارد.

همچنین می‌توانید نمونه کمک‌کننده‌های Datalayer را مرور کنید که نحوه استفاده از کتابخانه‌های کمک‌کننده‌های Datalayer، بخشی از Horologist را نشان می‌دهد. این کمک‌کننده‌ها به شما امکان می‌دهند اتصال بین دستگاه دستی و دستگاه Wear OS را پایش کنید. برای اطلاعات بیشتر درباره کلاس‌های شرح‌داده‌شده در بخش زیر، به مرجع Wear OS API مراجعه کنید. آن مرجع همچنین شامل اطلاعاتی درباره کلاس PhoneTypeHelper است که حاوی روش getPhoneDeviceType() است که به برنامه Wear OS شما اجازه می‌دهد بررسی کند که آیا تلفن همپا دستگاه Android است یا iOS.

نام‌های قابلیت را برای شناسایی برنامه‌هایتان مشخص کنید

برای برنامه مربوط به هر نوع دستگاه، چه ساعت و چه تلفن، رشته‌ای منحصربه‌فرد برای نام قابلیت در فایل res/values/wear.xml مشخص کنید.

برای مثال، در ماژول تلفن همراه، فایل wear.xml می‌تواند شامل موارد زیر باشد:

<resources xmlns:tools="http://schemas.android.com/tools"
    tools:keep="@array/android_wear_capabilities">
    <string-array name="android_wear_capabilities">
        <item>verify_remote_example_phone_app</item>
    </string-array>
</resources>

در ماژول Wear OS، فایل wear.xml حاوی مقدار متفاوتی برای نام قابلیت است، مانند:

<resources xmlns:tools="http://schemas.android.com/tools"
    tools:keep="@array/android_wear_capabilities">
    <string-array name="android_wear_capabilities">
        <item>verify_remote_example_wear_app</item>
    </string-array>
</resources>

برای اطلاعات بیشتر، کشف دستگاه‌های خاص بااستفاده از کلاینت قابلیت را ببینید.

تشخیص برنامه و باز کردن نشانی وب از ساعت

برنامه ساعت شما می‌تواند تشخیص دهد که آیا تلفن همپای کاربر برنامه تلفن شما را دارد یا نه. این مراحل را دنبال کنید:

  1. از CapabilityClient استفاده کنید تا بررسی کنید آیا برنامه تلفن در تلفن جفت‌شده نصب شده است یا نه. برای اطلاعات بیشتر، نمونه کمک‌کننده‌های Datalayer را در GitHub ببینید.
  2. اگر برنامه تلفن در تلفن نصب نشده است، از روش PhoneDeviceType.getPhoneDeviceType() برای بررسی نوع تلفن استفاده کنید. برای جزئیات، بخش زیر را ببینید.
  3. اگر PhoneDeviceType.DEVICE_TYPE_ANDROID برگردانده شود، تلفن از نوع Android است. برای باز کردن «فروشگاه Play» در تلفن، RemoteActivityHelper.startRemoteActivity() را در دستگاه Wear OS فراخوانی کنید. از شناسه منبع یکسان بازار برای برنامه تلفن خود استفاده کنید، که ممکن است با شناسه منبع یکسان برنامه Wear شما متفاوت باشد. برای مثال، از URI بازار مانند: market://details?id=com.example.android.wearable.wear.finddevices استفاده کنید.
  4. اگر PhoneDeviceType.DEVICE_TYPE_IOS برگردانده شود، تلفن از نوع iOS است و «فروشگاه Play» در آن دردسترس نیست. با تماس با RemoteActivityHelper.startRemoteActivity() در دستگاه Wear OS، «فروشگاه برنامه‌ها» را در iPhone باز کنید. می‌توانید نشانی وب iTunes برنامه‌تان را مشخص کنید، مثلاً https://itunes.apple.com/us/app/yourappname.

    از Wear OS، نمی‌توانید به‌طور برنامه‌نویسی‌شده تعیین کنید که آیا برنامه تلفنتان در دستگاه iOS نصب شده است یا نه. به‌عنوان روال مطلوب، سازوکاری برای کاربر فراهم کنید تا بتواند به‌طور دستی باز شدن App Store را راه‌اندازی کند.

توجه: از RemoteActivityHelper API همان‌طور که در بخش قبلی توضیح داده شده است استفاده کنید تا مشخص کنید که هر نشانی وبی از ساعت در تلفن باز شود، و اینکه به برنامه تلفن نیازی نیست.

جزئیات مربوط به تشخیص نوع تلفن جفت‌شده

در اینجا قطعه کدی وجود دارد که از روش getPhoneDeviceType() برای بررسی نوع تلفنی که ساعت با آن جفت شده است استفاده می‌کند:

var phoneDeviceType: Int = PhoneTypeHelper.getPhoneDeviceType(this)

مقدار برگردانده‌شده توسط روش getPhoneDeviceType() یکی از موارد زیر است:

برگرداندن مقدار شرح
DEVICE_TYPE_ANDROID تلفن همپا دستگاهی با سیستم‌عامل Android باشد.
DEVICE_TYPE_IOS تلفن همپا دستگاه iOS باشد.
DEVICE_TYPE_UNKNOWN تلفن همپا دستگاهی ناشناخته است.
DEVICE_TYPE_ERROR خطایی در تعیین نوع تلفن جفت‌شده رخ داد؛ بررسی دیگری باید بعداً انجام شود.

تشخیص برنامه از تلفن Android شروع می‌شود

تلفن Android شما می‌تواند تشخیص دهد که آیا دستگاه‌های Wear OS کاربر برنامه ساعت شما را دارند یا نه. این مراحل را دنبال کنید:

  1. بااستفاده از NodeClient، همه ساعت‌های متصل به تلفن کاربر را پیدا کنید. برای اطلاعات بیشتر، نمونه کمک‌کننده‌های Datalayer را در GitHub ببینید.
  2. بااستفاده از CapabilityClient، بررسی کنید که برنامه‌تان در کدام‌یک از ساعت‌های کاربر نصب شده است.
  3. اگر برنامه‌تان در همه ساعت‌های کاربر نصب نشده است، به کاربر اجازه دهید «فروشگاه Play» را در بقیه دستگاه‌های Wear OS از تلفن بااستفاده از روش RemoteActivityHelper.startRemoteActivity() باز کند. از شناسه منبع یکسان بازار برای برنامه Wear OS استفاده کنید که ممکن است با شناسه منبع یکسان برنامه تلفنتان متفاوت باشد. برای مثال، از شناسه منبع یکسان بازار مثل این مورد استفاده کنید: market://details?id=com.example.android.wearable.wear.finddevices.

داده‌های مکان برای ساعت‌های جفت‌شده با iPhone

برای ساعت‌های مرتبط‌شده با iPhone، از ارائه‌دهنده تلفیقی مکان (FLP) برای دریافت داده‌های مکان در ساعت استفاده کنید. برای اطلاعات بیشتر، تشخیص مکان در Wear OS را ببینید.

اگر تلفن همپا دردسترس باشد، «ارائه‌دهنده تلفیقی مکان» از تلفن همپا برای داده‌های مکان استفاده می‌کند.

فقط داده‌های ضروری را دریافت کنید

به‌طور کلی، هنگام دریافت داده از اینترنت، فقط داده‌های ضروری را دریافت کنید. درغیراین‌صورت، ممکن است تأخیر، مصرف حافظه، و مصرف باتری غیرضروری ایجاد کنید.

وقتی ساعت ازطریق اتصال «بلوتوث کم‌مصرف» متصل می‌شود، بسته به ساعت، برنامه شما ممکن است فقط به پهنای باند ۴ کیلوبایت در ثانیه دسترسی داشته باشد. بنابراین، مراحل زیر توصیه می‌شود:

  • درخواست‌ها و پاسخ‌های شبکه‌تان را برای داده‌های اضافی که فقط برای برنامه تلفن لازم است ممیزی کنید.
  • تصاویر بزرگ را قبل‌از ارسال ازطریق شبکه به ساعت کوچک کنید.

برای مواردی که به شبکه با پهنای باند بالا نیاز است، دسترسی به شبکه با پهنای باند بالا را ببینید.

نمونه‌های کد اضافی

نمونه کمک‌کننده‌های Datalayer استفاده از APIهای پوشش‌داده‌شده در این صفحه را بیشتر نشان می‌دهد.