نگاه Wear

اعلام وابستگی‌ها

برای افزودن وابستگی به glance-wear، باید مخزن Google Maven را به پروژه‌تان اضافه کنید. برای اطلاعات بیشتر، مخزن Maven در Google را بخوانید.

وابستگی‌های آرتیفکت‌های موردنیازتان را در فایل build.gradle برای برنامه یا واحدتان اضافه کنید:

dependencies {
    implementation "androidx.glance.wear:wear:1.0.0-alpha20"

    implementation "androidx.glance.wear:wear-core:1.0.0-alpha20"
}

dependencies {
    implementation("androidx.glance.wear:wear:1.0.0-alpha20")

    implementation("androidx.glance.wear:wear-core:1.0.0-alpha20")
}

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

بازخورد

بازخوردتان به بهبود Jetpack کمک می‌کند. اگر مشکلات جدیدی پیدا کردید یا ایده‌هایی برای بهبود این کتابخانه دارید، به ما اطلاع دهید. لطفاً قبل‌از ایجاد کتابخانه جدید، مشکلات موجود در این کتابخانه را بررسی کنید. با کلیک کردن روی دکمه ستاره می‌توانید رأی خود را به یک مشکل موجود اضافه کنید.

ایجاد مشکل جدید

برای کسب اطلاعات بیشتر، به مستندات «پیگیری مسائل» مراجعه کنید.

Glance Wear Version 1.0

نسخه 1.0.0-alpha20

۷ اکتبر ۲۰۲۶

‫androidx.glance.wear:wear:1.0.0-alpha20،‏ androidx.glance.wear:wear-core:1.0.0-alpha20، و androidx.glance.wear:wear-tooling-preview:1.0.0-alpha20 منتشر شدند. نسخه 1.0.0-alpha20 شامل این تعهدات است.

تغییرات میانای برنامه‌سازی کاربردی

• ‫CATEGORY_PROVIDER_CONFIG،‏ EXTRA_CONFIG_WIDGET_ID، و EXTRA_CONFIG_PROVIDER_COMPONENT ثابت به GlanceWearWidget برای مدیریت هدف‌های پیکربندی ارائه‌دهنده ابزاره اضافه شد. (I32fa4)
• نام پارامتر useSafeFallbackRendererVersion در WearWidgetPreview به useBaselineHostVersion تغییر کرد. (I07bca)

رفع اشکال‌ها

• به‌روزرسانی‌های ابزاره در «شبیه‌ساز سینی ابزاره» هنگام فراخوانی triggerUpdateAll در ساخت‌های اشکال‌زدایی‌شده اصلاح شد. (I22d3f)
• مقدار پیش‌فرض useSafeFallbackRendererVersion در WearWidgetPreview را از true به false تغییر دادیم تا پیش‌نمایش‌ها به‌طور پیش‌فرض با جدیدترین نسخه پردازنده رندر شوند. (Ied6b9)

نسخه 1.0.0-alpha19

‫۲۳ سپتامبر ۲۰۲۶

‫androidx.glance.wear:wear:1.0.0-alpha19،‏ androidx.glance.wear:wear-core:1.0.0-alpha19، و androidx.glance.wear:wear-tooling-preview:1.0.0-alpha19 منتشر شدند. نسخه 1.0.0-alpha19 شامل این تعهدات است.

فقط تغییرات آزمایشی داخلی.

نسخه 1.0.0-alpha18

۹ سپتامبر ۲۰۲۶

‫androidx.glance.wear:wear:1.0.0-alpha18،‏ androidx.glance.wear:wear-core:1.0.0-alpha18، و androidx.glance.wear:wear-tooling-preview:1.0.0-alpha18 منتشر شدند. نسخه 1.0.0-alpha18 شامل این تعهدات است.

تغییرات میانای برنامه‌سازی کاربردی

• ‫useSafeFallbackRendererVersion پارامتر به WearWidgetPreview اضافه شد تا پیش‌نمایش ابزارک‌ها با مجموعه عملیات پشتیبانی‌شده جایگزین ایمن برای میزبان‌های قدیمی‌تر امکان‌پذیر شود. (I9c324)

رفع اشکال‌ها

• ‫compileSdk برای کتابخانه‌های Compose به نسخه ۳۷.۱ به‌روز شد. این کار مستلزم به‌روزرسانی انتقالی compileSdk برای همه برنامه‌ها و کتابخانه‌هایی است که از Compose استفاده می‌کنند. (I05b0f)
• بررسی lint اضافه شد تا درباره استفاده‌های پارامتر fontFamily اضافی در ابزارک‌های Wear هشدار دهد. (I7730c)

نسخه 1.0.0-alpha17

۲۶ اوت ۲۰۲۶

‫androidx.glance.wear:wear:1.0.0-alpha17،‏ androidx.glance.wear:wear-core:1.0.0-alpha17، و androidx.glance.wear:wear-tooling-preview:1.0.0-alpha17 منتشر شدند. نسخه 1.0.0-alpha17 شامل این تعهدات است.

ویژگی‌های جدید

• بررسی‌های lint در «نمای اجمالی Wear» اضافه شد تا اطمینان حاصل شود که هر <container> در <wearwidget-provider> «زبان نشانه‌گذاری توسعه‌پذیر» برای «فراداده ابزارک» به‌طور صریح نوعی مشخصه را که پشتیبانی می‌شود مشخص می‌کند و انواع تکراری را تعریف نمی‌کند. (I52c9a، b/464458215)

نسخه 1.0.0-alpha16

‫۱۲ اوت ۲۰۲۶

‫androidx.glance.wear:wear:1.0.0-alpha16،‏ androidx.glance.wear:wear-core:1.0.0-alpha16، و androidx.glance.wear:wear-tooling-preview:1.0.0-alpha16 منتشر شدند. نسخه 1.0.0-alpha16 شامل این تعهدات است.

ویژگی‌های جدید

• اعتبارسنجی Lint برای فراداده <wearwidget-provider> XML اضافه شد تا مطمئن شویم عناصر پیکربندی الزامی (مثل container و previewImage) وجود دارند. (Ia9983،‏ b/464458215)
• هشدار خطای Lint برای تنظیم پس‌زمینه سیاه یا شفاف برای «ابزاره Wear» اضافه شد (Idedb0، b/529269573)
• عملیات CORE_TEXT«نگارش از دور» برای نمایه «ابزاره‌های Wear» فعال شد. این کار به RemoteText اجازه می‌دهد از ویژگی‌های قلم متغیر، مثل محورهای قلم، ارتفاع خط، و غیره، در «پردازنده‌های میزبان» پشتیبانی‌شده استفاده کند و درصورت عدم پشتیبانی، به‌طور خودکار به حالت بازگشتی برود.

رفع اشکال‌ها

• «اسناد کیت توسعه نرم‌افزار» برای AssociateWithGlanceWearWidget شرح براساس بازخورد توسعه‌دهندگان به‌روز شد

نسخه 1.0.0-alpha15

۲۹ ژوئیه ۲۰۲۶

‫androidx.glance.wear:wear:1.0.0-alpha15،‏ androidx.glance.wear:wear-core:1.0.0-alpha15، و androidx.glance.wear:wear-tooling-preview:1.0.0-alpha15 منتشر شدند. نسخه 1.0.0-alpha15 شامل این تعهدات است.

ویژگی‌های جدید

• وقتی پس‌زمینه خالی برای سند «ابزاره Wear» تنظیم می‌شود، هشدار Lint اضافه شد. (Ic6475، b/529269573)

نسخه 1.0.0-alpha14

‫۱۵ ژوئیه ۲۰۲۶

‫androidx.glance.wear:wear:1.0.0-alpha14،‏ androidx.glance.wear:wear-core:1.0.0-alpha14، و androidx.glance.wear:wear-tooling-preview:1.0.0-alpha14 منتشر شدند. نسخه 1.0.0-alpha14 شامل این تعهدات است.

تغییرات میانای برنامه‌سازی کاربردی

• ارائه‌دهندگان پارامتر پیش‌نمایش RoundAllWidgetPreviewParams، RoundSmallWidgetPreviewParams، و RoundLargeWidgetPreviewParams را برای ابزاره‌های Wear «نگاه اجمالی» کاملاً گرد اضافه کرده‌ایم. (If5336، b/512405233)

ویژگی‌های جدید

• کتابخانه Linter را برای ابزارک‌های «نگاه سریع» در Wear راه‌اندازی و اضافه کرده‌ایم.(If4218، b/527402079)
  • بررسی lint اضافه شد تا مطمئن شود زیرکلاس‌های GlanceWearWidgetService کلاس ابزاره مرتبط خود را بااستفاده از گزارمان @AssociateWithGlanceWearWidget به‌طور صریح اعلام می‌کنند. (Idc575، b/477024153)
• با انتشار عملیات‌های پشتیبانی‌شده ازطریق WearWidgetParams و افزودن فیلتر کردن نمای عملیات‌های مجاز به آن‌ها، سازگاری با نسخه‌های قدیمی‌تر را برای ابزارک‌هایی که در «میزبان‌های» قدیمی‌تر اجرا می‌شوند بهبود داده‌ایم. (Ib0a1b،‏ I83cb1،‏ [b/526716195])

نسخه 1.0.0-alpha13

۱ ژوئیه ۲۰۲۶

‫androidx.glance.wear:wear:1.0.0-alpha13،‏ androidx.glance.wear:wear-core:1.0.0-alpha13، و androidx.glance.wear:wear-tooling-preview:1.0.0-alpha13 منتشر شدند. نسخه 1.0.0-alpha13 شامل این تعهدات است.

تغییرات میانای برنامه‌سازی کاربردی

• بررسی اجازه را از heartRateAccuracy برداشت (I14269، b/522444636)

رفع اشکال‌ها

• پارامترهای ابزاره Wear به‌شکل «مربع دایره‌دار» را برای پیش‌نمایش براساس بازخورد تجربه کاربری اصلاح کرده‌ایم

نسخه 1.0.0-alpha12

‫۱۷ ژوئن ۲۰۲۶

‫androidx.glance.wear:wear:1.0.0-alpha12،‏ androidx.glance.wear:wear-core:1.0.0-alpha12، و androidx.glance.wear:wear-tooling-preview:1.0.0-alpha12 منتشر شدند. نسخه 1.0.0-alpha12 شامل این تعهدات است.

ویژگی‌های جدید

• ‫AssociateWithGlanceWearWidget اضافه شد که باید در GlanceWearWidgetService استفاده شود تا مشخص شود با کدام پیاده‌سازی GlanceWearWidget مرتبط است. (Ifcabb، b/514679763)

  • برای مثال:

   @AssociateWithGlanceWearWidget(MyGlanceWearWidget::class)
   class MyGlanceWearWidgetService : GlanceWearWidgetService() {
     override val widget = MyGlanceWearWidget()
   }
   ```
  

• برای پشتیبانی از پس‌زمینه‌های بیت‌مپ در «ابزاره‌های Wear»، image قلم‌مو به WearWidgetBrush اضافه کرده‌ایم. ‫(I9a228،‏ b/513481558)

• ما تابع کمکی @Composable،‏ WearWidgetPreview، را معرفی کرده‌ایم تا با برداشتن کد تکراری موردنیاز برای پیش‌نمایش‌های IDE، توسعه ابزارک‌های Glance Wear را ساده‌تر کنیم.

تغییرات میانای برنامه‌سازی کاربردی

• نام androidx.glance.wear.health.DataType به androidx.glance.wear.health.HealthData تغییر کرد (I4cb0b، b/516746689)
• ‫isHeartRateBpmAvailable برای تعیین اینکه heartRateBpm در میزبان دردسترس است یا نه، آشکار می‌شود. (I5999d،‏ b/514641567)
• ‫RemoteInt عملگر مقایسه آشکار شد. (I5fe3d،‏ b/513228889)
• ‫captureRemoteDocument Flow API و captureSingleRemoteDocument سربار جدید (که RemoteCreationDisplayInfo را می‌گیرد) به‌عنوان میاناهای برنامه‌سازی کاربردی عمومی آشکار شد. (I87b0e،‏ b/513228889)
• ‫@CallSuper را به GlanceWearWidgetService روش چرخه حیات اضافه کردیم

نسخه 1.0.0-alpha11

۳ ژوئن ۲۰۲۶

‫androidx.glance.wear:wear:1.0.0-alpha11،‏ androidx.glance.wear:wear-core:1.0.0-alpha11، و androidx.glance.wear:wear-tooling-preview:1.0.0-alpha11 منتشر شدند. نسخه 1.0.0-alpha11 شامل این تعهدات است.

تغییرات میانای برنامه‌سازی کاربردی

• WearWidgetPreview را برای پیش‌نمایش «ابزاره‌های Wear» در «استودیو Android» اضافه کرده‌ایم. (I36504، b/485147770)
• متغیرهای is*Available (isDailyStepsAvailable، و غیره) را آشکار کنید تا بررسی کنید که آیا نوع داده سلامتی مربوطه دردسترس و معتبر است یا نه. (Ib98a7، b/498179656)
• ‫triggerUpdateAll API به GlanceWearWidget اضافه شد تا به‌روزرسانی را در همه ابزارک‌های برنامه داده‌شده راه‌اندازی کند. (I6ab20،‏ b/510896410)

رفع اشکال‌ها

• اطلاعات نسخه «پردازنده» را در WearWidgetParams به‌عنوان فیلد داخلی اضافه کنید تا از خراب شدن سند تولیدشده با نسخه alpha10 جلوگیری شود. (Idcf8e, b/511263591, b/512830184)
• جریان به‌روزرسانی کشش اجباری را در حالت اشکال‌زدایی یا شبیه‌ساز برای «ابزاره‌های Wear» راه‌اندازی کنید.

نسخه 1.0.0-alpha10

‫۱۹ مه ۲۰۲۶

‫androidx.glance.wear:wear:1.0.0-alpha10،‏ androidx.glance.wear:wear-core:1.0.0-alpha10، و androidx.glance.wear:wear-tooling-preview:1.0.0-alpha10 منتشر شدند. نسخه 1.0.0-alpha10 شامل این تعهدات است.

تغییرات میانای برنامه‌سازی کاربردی

• نمایش glance.wear.health.DataType میانای برنامه‌سازی کاربردی در «ابزاره Wear». توسعه‌دهندگان می‌توانند از این میاناهای برنامه‌سازی کاربردی برای دسترسی به داده‌های سلامت سیستم استفاده کنند.

رفع اشکال‌ها

• حلقه خرابی که در نسخه alpha09 در شبیه‌ساز Wear 7 یا دستگاه‌های دارای رندرکننده ۱.۶ رخ می‌داد با عدم اجازه ارسال محور قلم خالی به «پخش‌کننده» برای «ابزارک Wear Glance» برطرف شد.

نسخه 1.0.0-alpha09

۶ مه ۲۰۲۶

‫androidx.glance.wear:wear:1.0.0-alpha09 و androidx.glance.wear:wear-core:1.0.0-alpha09 منتشر شدند. نسخه 1.0.0-alpha09 شامل این تغییرات است.

تغییرات میانای برنامه‌سازی کاربردی

• ExperimentalGlanceWearApi را اضافه کرده‌ایم که برای ویژگی‌های آزمایشی «نگاه اجمالی» در Wear استفاده خواهد شد. (Id2f76, b/498179813)

رفع اشکال‌ها

• تجزیه‌گر فراداده XML ابزاره Wear به‌روزرسانی شد تا درطول راه‌اندازی از ابزاره‌ها مطلع شود.

نسخه 1.0.0-alpha08

‫۲۲ آوریل ۲۰۲۶

‫androidx.glance.wear:wear:1.0.0-alpha08 و androidx.glance.wear:wear-core:1.0.0-alpha08 منتشر شدند. نسخه 1.0.0-alpha08 شامل این تعهدها است.

رفع اشکال‌ها

• برچسب <queries> به مانیفست کتابخانه glance:wear:wear اضافه شد تا مطمئن شویم PackageManager سرویس‌های صحیح را برای به‌روزرسانی‌های لحظه‌ای پُرسمان می‌کند. (I192787)

موارد دیگر

• «Updates Compose compileSdk to 37» (I6007) که برای glance-wear نیز اعمال می‌شود برگردانده شد، بنابراین الزام compileSdk دیگر در این نسخه ۳۷ نیست.

نسخه 1.0.0-alpha07

۸ آوریل ۲۰۲۶

‫androidx.glance.wear:wear:1.0.0-alpha07 و androidx.glance.wear:wear-core:1.0.0-alpha07 منتشر شدند. نسخه 1.0.0-alpha07 شامل این تعهدات است.

ویژگی‌های جدید

• وقتی WearWidgetBrush خالی است یا مشخص نشده است، پس‌زمینه «ابزاره Wear» پیش‌فرض اضافه می‌شود. (I8300b)
• «میانای برنامه‌سازی کاربردی» getActiveWidgets را به‌روز کنید تا «نوع محتوی» «ابزاره» را برگرداند. (2772eb1)

تغییرات میانای برنامه‌سازی کاربردی

• «میانای برنامه‌سازی کاربردی» به‌روزرسانی «ابزاره» را تغییر دهید تا WidgetInstanceId را بگیرد و برای واکشی شناسه‌ها برای ابزاره‌ای معین، یاور اضافه کنید. اگر شناسه ارائه‌شده نامعتبر باشد یا متعلق به تماس‌گیرنده نباشد، api جدید IllegalArgumentException را پرتاب می‌کند. (I6f3c5، b/446828899)
• گرادیان عمودی و افقی را در WearWidgetBrush اضافه کنید. (If70ae، b/470080675)

نسخه 1.0.0-alpha06

۲۵ مارس ۲۰۲۶

‫androidx.glance.wear:wear:1.0.0-alpha06 و androidx.glance.wear:wear-core:1.0.0-alpha06 منتشر شدند. نسخه 1.0.0-alpha06 شامل این تعهدات است.

ویژگی‌های جدید

• عملیات را برای نمایه «ابزاره‌های Wear» درون‌خطی تعریف کنید.

تغییرات میانای برنامه‌سازی کاربردی

• نام CONTAINER_TYPE_FULLSCREEN را به CONTAINER_TYPE_TILE_COMPAT تغییر دادیم تا ویجت سازگاری تمام‌صفحه را بهتر متمایز کنیم. این شامل برگرداندن تخصیص نوع قبلی FULLSCREEN به LARGE در پارامترهای ابزاره می‌شود.

نسخه 1.0.0-alpha05

۱۱ مارس ۲۰۲۶

‫androidx.glance.wear:wear:1.0.0-alpha05 و androidx.glance.wear:wear-core:1.0.0-alpha05 منتشر شدند. نسخه 1.0.0-alpha05 شامل این تعهدات است.

تغییرات میانای برنامه‌سازی کاربردی

• WearWidgetBrushAPI با روش color را اضافه کرده‌ایم تا برای پس‌زمینه «ابزاره Wear» استفاده شود. (I66f54, b/464273091)
• روش fetchActiveWidgetsForProvider برداشته شد زیرا fetchActiveWidgets ازقبل وجود دارد. (I85e4e، b/486197890)

نسخه 1.0.0-alpha04

۲۵ فوریه ۲۰۲۶

‫androidx.glance.wear:wear:1.0.0-alpha04 و androidx.glance.wear:wear-core:1.0.0-alpha04 منتشر شدند. نسخه 1.0.0-alpha04 شامل این تعهدها است.

تغییرات میانای برنامه‌سازی کاربردی

• میانای برنامه‌سازی کاربردی GlanceWearWidgetManager برای اجازه دادن به «برنامه‌ها» برای پُرسمان کردن ابزاره‌ها و کاشی‌های فعالشان اضافه شد. (I5be95)
• واسط‌های برنامه‌سازی کاربردی را از کتابخانه glance:wear:wear-core به بسته androidx.glance.wear.core منتقل کرده‌ایم. (I429cf)

رفع اشکال‌ها

• نمایش انواع مشترک «ترکیب‌پذیر از دور» و «اصلاح‌گر» (Id1d40)

نسخه 1.0.0-alpha03

‫۱۱ فوریه ۲۰۲۶

‫androidx.glance.wear:wear:1.0.0-alpha03 و androidx.glance.wear:wear-core:1.0.0-alpha03 منتشر شدند. نسخه 1.0.0-alpha03 شامل این تعهدها است.

تغییرات میانای برنامه‌سازی کاربردی

• پشتیبانی از «رویدادهای تعامل» را به GlanceWearWidget اضافه کنید. (Ia4e28، b/469808447)

نسخه 1.0.0-alpha02

‫۲۸ ژانویه ۲۰۲۶

‫androidx.glance.wear:wear:1.0.0-alpha02 و androidx.glance.wear:wear-core:1.0.0-alpha02 منتشر شدند. نسخه 1.0.0-alpha02 شامل این تعهدات است.

ویژگی‌های جدید

• در پارامترهای ابزاره، «تمام‌صفحه» را به «بزرگ» تغییر دهید (ad78d95)

رفع اشکال‌ها

• رفع مشکل استفاده از DataStore که از نمایش چندین نمونه ابزاره جلوگیری می‌کرد (474f3e4)

نسخه 1.0.0-alpha01

‫۱۴ ژانویه ۲۰۲۶

‫androidx.glance.wear:wear:1.0.0-alpha01 و androidx.glance.wear:wear-core:1.0.0-alpha01 منتشر شدند. نسخه 1.0.0-alpha01 شامل این تعهدها است.

• ‫Glance Wear کتابخانه‌ای برای ساختن «ابزاره» برای Wear OS بااستفاده از RemoteCompose است.