این صفحه راهنمایی برای ساخت اولین برنامه خود برای Wear OS با استفاده از یک الگو از اندروید استودیو ارائه میدهد. این برنامه روشهای مختلف مشاهده اطلاعات در یک نگاه در دستگاههای Wear OS را نشان میدهد و برخی از بهترین شیوهها را برای توسعه برنامهها در این پلتفرم معرفی میکند.
این راهنما بر اساس دانش قبلی شما در مورد پلتفرم اندروید و محیط توسعه یکپارچه اندروید استودیو (Android Studio IDE) تهیه شده است. اگر کاملاً با اندروید آشنا نیستید، با استفاده از این آزمایشگاه کدنویسی، یک برنامه بسازید . برای کسب اطلاعات بیشتر در مورد قابلیتهای اندروید استودیو، به صفحه «ملاقات با اندروید استودیو» مراجعه کنید.
یک برنامه Wear OS ایجاد کنید
پس از دانلود و نصب آخرین نسخه اندروید استودیو، مراحل ایجاد پروژه جدید (New Project) را تکمیل کنید:
- اندروید استودیو را باز کنید و سپس به مسیر File > New > New Project بروید. پنجره New Project ظاهر میشود.
 - در پنل قالبها ، Wear OS را انتخاب کنید. سپس، در پنل اصلی، Empty Wear App را انتخاب کنید.
 - نامی برای پروژه خود انتخاب کنید و سپس روی Finish کلیک کنید. اندروید استودیو وابستگیهای لازم را دانلود کرده و پروژه شما را میسازد.
 
اکنون آمادهاید تا اولین برنامه خود را روی Wear OS اجرا کنید.
اجرای یک برنامه روی شبیهساز
یک راه ساده برای اجرای برنامه Wear OS شما روی یک شبیهساز است.
پیکربندی یک شبیهساز
برای پیکربندی یک شبیهساز در اندروید استودیو، مراحل زیر را دنبال کنید:
- در SDK Manager، تب SDK Tools را باز کنید. تأیید کنید که آخرین نسخه Android SDK Platform-Tools را دارید. SDK Manager را ببندید.
 - به ابزارها > مدیریت دستگاه بروید.
 - گزینه «ایجاد» (+) را انتخاب کنید. ویزارد پیکربندی دستگاه مجازی ظاهر میشود.
 - در قسمت دستهبندی ، Wear OS و یک پروفایل سختافزاری مانند Wear OS Small Round را انتخاب کنید. روی Next کلیک کنید.
 - مگر اینکه به سفارشیسازیهای خاصی نیاز داشته باشید، تنظیمات پیشفرض را در این صفحه نگه دارید. اندروید استودیو به طور پیشفرض آخرین API و تصویر سیستم را انتخاب میکند. روی Finish کلیک کنید.
 
برای اطلاعات بیشتر در مورد استفاده از شبیهسازها، به راهنمای نحوه اجرای برنامهها در شبیهساز اندروید مراجعه کنید.
برنامه را در شبیهساز باز کنید
-  در نوار ابزار اصلی، ابزارک اجرا (Run Widget) را پیدا کنید. از منوی کشویی دستگاه، شبیهساز ایجاد شده را انتخاب کرده و روی دکمه اجرا (Run) کلیک کنید. 
 دکمه برای راه اندازی برنامه. - پس از چند لحظه، پیام «سلام...» در شبیهساز ظاهر میشود.
 
اجرای یک برنامه روی ساعت فیزیکی (اختیاری)
اجرا و اشکالزدایی برنامه روی یک ساعت فیزیکی به شما امکان میدهد تا تجربه کلی کاربر را بهتر ارزیابی کنید. این امر به ویژه در صورتی که برنامه شما به سختافزار خاصی مانند حسگرها یا پردازنده گرافیکی متکی باشد، اهمیت دارد.
برای اجرای یک برنامه روی یک ساعت فیزیکی، دستگاه را برای آزمایش آماده کنید و سپس آن را به دستگاه توسعه خود متصل کنید.
آماده سازی ساعت برای آزمایش
برای آمادهسازی ساعت خود برای آزمایش، با انجام مراحل زیر، اشکالزدایی ADB را فعال کنید:
- در ساعت، منوی تنظیمات (Settings) را باز کنید.
 -  به پایین منو بروید. اگر هیچ گزینهای از گزینههای توسعهدهندگان ظاهر نشد، مراحل فرعی زیر را انجام دهید. در غیر این صورت، به مرحله بعدی بروید.
- روی سیستم > درباره یا سیستم > درباره > نسخهها بزنید.
 - مورد شماره ساخت (Build number) را پیدا کنید و هفت بار روی آن ضربه بزنید. اگر ساعت شما با پین یا الگو محافظت میشود، در صورت درخواست، آن را وارد کنید.
 
 - از منوی تنظیمات ، روی گزینههای توسعهدهندگان (Developer options) ضربه بزنید.
 - گزینه اشکالزدایی ADB را فعال کنید.
 
برای اطلاعات بیشتر، به پیکربندی گزینههای توسعهدهنده روی دستگاه مراجعه کنید.
ساعت را به دستگاه توسعه وصل کنید
بعضی از ساعتها به شما امکان اتصال از طریق USB را میدهند. بعضی دیگر نیاز به اتصال بیسیم دارند.
اتصال سیمی را از طریق USB تنظیم کنید
ساعت را با استفاده از مراحل زیر وصل کنید:
- با استفاده از کابل USB، ساعت را به دستگاه توسعه خود وصل کنید.
 - در ساعت، گزینه «همیشه از این رایانه مجاز است» را فعال کنید و سپس روی تأیید ضربه بزنید.
 
یک اتصال بیسیم راهاندازی کنید
اگر اشکالزدایی ساعت از طریق پورت USB امکانپذیر نیست، به بخش اتصال به دستگاه با استفاده از Wi-Fi مراجعه کنید.
برنامه را روی ساعت باز کنید
- در ابزارک اجرا (بخشی از نوار ابزار اصلی)، از منوی کشویی دستگاه برای انتخاب دستگاه فیزیکی خود استفاده کنید.
 -  روی اجرا کلیک کنید 
 دکمه در ویجت اجرا . - پس از چند لحظه، پیام «سلام...» روی دستگاه شما ظاهر میشود.
 
معماری برنامه خود را برنامهریزی کنید
حالا که یک برنامهی پایه در حال اجرا دارید، آمادهاید تا فراتر از الگو حرکت کنید. قبل از شروع افزودن ویژگیهای جدید، فکر کردن به تصمیمات کلیدی معماری که برنامهی شما را شکل میدهند، مفید است. بخشهای بعدی به بررسی برخی از سوالات مهم میپردازند.
مدل اپلیکیشن: مستقل، غیرمستقل یا ترکیبی
در نظر بگیرید که برنامه شما چقدر به یک تلفن جفت شده وابسته است:
- ترکیبی (برای اکثر برنامهها توصیه میشود): این رایجترین و انعطافپذیرترین رویکرد است. ویژگیهای اصلی برنامه بدون تلفن کار میکنند (مانند ردیابی تمرین)، اما وقتی تلفن متصل است، قابلیتهای پیشرفتهتری مانند همگامسازی دادهها یا ارائه پیکربندی آسانتر ارائه میدهد.
 - مستقل: برنامه شما کاملاً به تنهایی کار میکند، بدون اینکه برای ویژگیهای اصلی به تلفن نیاز داشته باشد. این برای برنامههایی که میتوانند به صورت آفلاین کار کنند یا از اتصال اینترنت خود استفاده کنند عالی است. الگوی "Empty Wear App" به طور پیشفرض یک برنامه مستقل ایجاد میکند.
 - غیرمستقل: برنامه شما برای عملکرد اصلی خود به یک تلفن نیاز دارد.
 
برای اطلاعات بیشتر و راهنمایی در مورد این انتخاب، به بخش برنامههای مستقل در مقابل برنامههای غیرمستقل Wear OS مراجعه کنید.
رابط کاربری خود را بسازید
Compose for Wear OS یک چارچوب اعلانی مدرن است که روش پیشنهادی برای ساخت رابطهای کاربری برای برنامههای Wear OS است. الگویی که شما استفاده کردید با Compose ساخته شده است و نقطه شروع بسیار خوبی را در اختیار شما قرار میدهد.
هنگام ساخت با Compose، از کتابخانههایی که بهطور خاص برای Wear OS طراحی شدهاند استفاده کنید. این کتابخانهها اجزای بهینهسازیشده برای ساعت را ارائه میدهند که برای یک تجربه کاربری عالی ضروری هستند.
 برای مثال، به جای یک LazyColumn استاندارد، از TransformingLazyColumn استفاده کنید که به طور خودکار جلوههای مقیاسبندی و شفافیت را به آیتمهای لبه یک صفحه نمایش گرد اعمال میکند.
 به طور مشابه، برای ناوبری، از SwipeDismissableNavHost از کتابخانه ناوبری Wear OS برای ادغام با ژست کشیدن برای رد کردن سیستم استفاده کنید.
ذخیرهسازی و همگامسازی دادهها
نحوه مدیریت دادهها یک انتخاب اصلی در معماری است. برای ماندگاری دادهها روی دستگاه، گزینههای شما مشابه موبایل است، DataStore برای دادههای کلید-مقدار یا اشیاء تایپشده و Room برای دادههای پیچیدهتر و ساختاریافته، گزینههای مدرن پیشنهادی هستند.
- ذخیره دادهها روی دستگاه: برنامه خود را طوری طراحی کنید که آفلاین باشد و دادههای لازم را مستقیماً روی ساعت ذخیره کند تا بدون اتصال به تلفن، همچنان قابل استفاده باشد.
 - همگامسازی دادهها با تلفن: وقتی نیاز به همگامسازی یا پخش دادهها (مانند تنظیمات کاربر یا دادههای تمرین) با یک برنامه تلفن همراه دارید، از API لایه داده استفاده کنید. این API یک کانال ارتباطی فراهم میکند که از طریق بلوتوث و وایفای کار میکند.
 
مدیریت کارهای طولانی مدت
بسیاری از تجربههای اصلی Wear OS، مانند تمرینهای ورزشی یا پخش رسانه، مدت زمان زیادی طول میکشند. مدیریت صحیح این کار برای حفظ قابلیت اطمینان و صرفهجویی در مصرف باتری بسیار مهم است.
- برای وظایف طولانی مدت و آغاز شده توسط کاربر: وقتی کاربر وظیفهای را شروع میکند که حتی در صورت خارج شدن از برنامه (مانند ردیابی دویدن) نیاز به ادامه دارد، باید از یک سرویس پیشزمینه استفاده کنید. در Wear OS، این سرویس را با Ongoing Activity API جفت کنید. این کار یک اعلان مداوم و یک آیکون قابل لمس روی صفحه ساعت ایجاد میکند که به کاربر امکان میدهد به برنامه شما بازگردد.
 - برای کارهای پسزمینهای قابل تعویق: برای کارهایی که لازم نیست فوراً انجام شوند (مانند همگامسازی دورهای دادهها)، از WorkManager استفاده کنید. این برنامه از باتری آگاه است و بهینهسازیهای سیستم مانند حالت Doze را رعایت میکند، و آن را به انتخاب خوبی برای پردازشهای پسزمینهای غیر فوری تبدیل میکند.
 
فراتر از اپلیکیشن فکر کنید: سطوح و قدرت
در نهایت، به یاد داشته باشید که تجربه استفاده از Wear OS چیزی بیش از یک برنامه اصلی است.
- پشتیبانی از سایر سطوح: برای ایجاد یک برنامه با کیفیت بالا و جذاب، برنامهریزی کنید تا از سایر سطوح بهینه شده برای مچ دست نیز پشتیبانی کنید. ایجاد یک کاشی برای اقدامات و اطلاعات سریع و یک بخش کمکی برای نمایش مستقیم دادههای مهم روی صفحه ساعت کاربر را در نظر بگیرید.
 - برای بهرهوری انرژی برنامهریزی کنید: عمر باتری در یک دستگاه پوشیدنی بسیار مهم است. از همان ابتدا، برنامه خود را طوری طراحی کنید که از نظر مصرف انرژی کارآمد باشد. این به معنای توجه به نحوه دریافت دادهها، استفاده از حسگرها و اجرای وظایف پسزمینه است. به تعویق انداختن کار تا زمان شارژ شدن ساعت اغلب یک استراتژی خوب است. میتوانید در راهنمای صرفهجویی در مصرف انرژی اطلاعات بیشتری کسب کنید.
 
برای شما توصیه میشود
- توجه: متن لینک زمانی نمایش داده میشود که جاوا اسکریپت غیرفعال باشد.
 - اتصال ساعت به گوشی
 - استفاده از Jetpack Compose در Wear OS
 - یادداشتهای انتشار