Wear OS 5.1

آخرین نسخه Wear OS را که در دستگاه‌های منتخب و در شبیه‌ساز رسمی اندروید استودیو موجود است، بررسی کنید. پس از به‌روزرسانی نسخه SDK هدف، بررسی کنید که برنامه شما مطابق انتظار اجرا شود.

Wear OS 5.1 مبتنی بر اندروید ۱۵ (سطح API 35) است، که شما را ملزم می‌کند برنامه‌هایی را که از قبل API سطح ۳۴ را برای Wear OS 5 هدف قرار داده‌اند، آزمایش کنید.

یک دستگاه پشتیبانی شده را برای آزمایش آماده کنید

Wear OS 5.1 می‌تواند روی دستگاه‌های زیر اجرا شود:

• گوگل پیکسل واچ ۳
• گوگل پیکسل واچ ۲
• ساعت گوگل پیکسل

دستگاه شما باید یک به‌روزرسانی نرم‌افزاری از طریق هوا (OTA) دریافت کند. همچنین می‌توانید با انجام یکی از موارد زیر، دستگاه خود را به صورت دستی به‌روزرسانی کنید:

• از برنامه تنظیمات ، به سیستم > به‌روزرسانی‌های سیستم بروید.
• بعد از فعال کردن گزینه‌های توسعه‌دهنده ، یک فایل ایمیج نرم‌افزاری خاص را روی دستگاه‌هایی که از اتصال داده USB (سیمی) پشتیبانی می‌کنند، فلش کنید. به عنوان مثال، می‌توانید یک فایل ایمیج کارخانه‌ای یا یک فایل ایمیج کامل OTA را فلش کنید.

آماده سازی شبیه ساز برای آزمایش

برای اجرای Wear OS 5.1 در شبیه‌ساز رسمی، ابتدا باید فایل سیستمی که روی شبیه‌ساز اجرا می‌شود را دانلود و نصب کنید. سپس باید یک دستگاه مجازی ایجاد کنید که این فایل سیستمی را اجرا کند.

تصویر سیستم را دانلود و نصب کنید

برای دانلود و نصب ایمیج سیستم صحیح، مراحل زیر را انجام دهید:

1. آخرین نسخه Android Studio Ladybug Feature Drop یا اگر هنوز این کار را نکرده‌اید، نسخه‌های جدیدتر آن را دانلود و نصب کنید.
2. در اندروید استودیو، به Tools > SDK Manager بروید.

3. در تب SDK Platforms ، گزینه Show Package Details را انتخاب کنید و بخش Android 15.0 ("VanillaIceCream") را که شامل مصنوعات برای API level 35-ext15 است، باز کنید. سپس، یکی از گزینه‌های Wear OS 5.1 ARM 64 v8a System Image یا Wear OS 5.1 Intel x86_64 Atom System Image را انتخاب کنید:

   

4. روی تأیید کلیک کنید. وقتی پنجره تأیید تغییر ظاهر شد، دوباره روی تأیید کلیک کنید.

5. صبر کنید تا اندروید استودیو فایل سیستم را دانلود و نصب کند، و سپس روی Finish کلیک کنید.

ایجاد یک دستگاه مجازی

برای ایجاد یک دستگاه مجازی که این تصویر سیستم را در شبیه‌ساز رسمی اجرا می‌کند، این مراحل را دنبال کنید:

1. در اندروید استودیو، با انتخاب Tools > Device Manager، Device Manager را باز کنید. پنجره Device Manager ظاهر می‌شود.
2. در نوار ابزار درون پنل مدیریت دستگاه ، روی «افزودن یک دستگاه جدید» ضربه بزنید > ایجاد دستگاه مجازی .
3. در قسمت Form Factor ، گزینه Wear OS و سپس یک پروفایل سخت‌افزاری را انتخاب کنید. روی Next کلیک کنید.
4. یک تصویر سیستم Wear OS 5.1 برای استفاده انتخاب کنید. تصویر سیستم باید سطح API 35 داشته باشد.
5. روی «بعدی» کلیک کنید، و سپس روی «پایان» کلیک کنید.

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

برای آزمایش برنامه خود روی این دستگاه مجازی که ایجاد کرده‌اید، مراحل زیر را انجام دهید:

1. به نوار ابزار اندروید استودیو بروید و دستگاه مجازی را انتخاب کنید.
2. روی اجرا ضربه بزنید .
3. برنامه خود را روی دستگاه مجازی نصب کنید و گردش‌های کاری مختلف کاربرپسندی که برنامه شما از آنها استفاده می‌کند را مرور کنید.

تغییراتی که بر همه برنامه‌ها تأثیر می‌گذارند

هنگام آزمایش برنامه خود در Wear OS 5.1، بررسی کنید که برنامه شما چگونه تغییرات رفتار سیستم را که بر همه برنامه‌ها در Android 15 تأثیر می‌گذارد ، مدیریت می‌کند، که از همان سطح API Wear OS 5.1 استفاده می‌کند.

چندین تغییر رفتاری در Wear OS 5.1 اعمال نمی‌شوند:

• فضاهای خصوصی در Wear OS 5.1 پشتیبانی نمی‌شوند.
• ممکن است انیمیشن‌های پیش‌بینی‌کننده‌ی بازگشت نمایش داده نشوند.

نسخه SDK هدف برنامه خود را به‌روزرسانی کنید

شما می‌توانید با به‌روزرسانی نسخه SDK هدف برنامه خود به سطح API 35، سازگاری برنامه خود را با Wear OS 5.1 بهبود بخشید. (این همان سطح API است که اندروید 15 از آن استفاده می‌کند.)

برای انجام این کار، فایل build.gradle یا build.gradle.kts در سطح ماژول خود را باز کنید و آنها را با مقادیر Wear OS 5.1 به‌روزرسانی کنید.

نحوه‌ی قالب‌بندی مقادیر در فایل ساخت شما به نسخه‌ی افزونه‌ی اندروید گریدل (AGP) که استفاده می‌کنید بستگی دارد.

AGP 7.0.0 یا بالاتر

اگر از AGP 7.0.0 یا بالاتر استفاده می‌کنید، فایل build.gradle یا build.gradle.kts برنامه خود را با مقادیر زیر برای Wear OS 5.1 به‌روزرسانی کنید:

گرووی

android {
    compileSdk 35
    ...
    defaultConfig {
        targetSdk 35
    }
}

کاتلین

android {
    compileSdk = 35
    ...
    defaultConfig {
        targetSdk = 35
    }
}

AGP 4.2.0 یا پایین‌تر

اگر از AGP 4.2.0 یا پایین‌تر استفاده می‌کنید، فایل build.gradle یا build.gradle.kts برنامه خود را با مقادیر زیر برای Wear OS 5.1 به‌روزرسانی کنید:

گرووی

android {
    compileSdkVersion "35"
    ...
    defaultConfig {
        targetSdkVersion "35"
    }
}

کاتلین

android {
    compileSdkVersion = "35"
    ...
    defaultConfig {
        targetSdkVersion = "35"
    }
}

تغییراتی که فقط برنامه‌هایی را که سطح API 35 را هدف قرار می‌دهند، تحت تأثیر قرار می‌دهند

پس از اینکه نسخه SDK هدف خود را به سطح API 35 به‌روزرسانی کردید، تغییرات را برای برنامه‌هایی که اندروید 15 را هدف قرار می‌دهند ، مدیریت کنید، که از همان سطح API Wear OS 5.1 استفاده می‌کند.

ویژگی‌های جدید را کاوش کنید

Wear OS 5.1 چندین ویژگی را برای کمک به بهبود تجربه استفاده از برنامه‌های Wear OS معرفی می‌کند.

توجه: قبل از افزودن این ویژگی‌ها به برنامه خود، برنامه خود را برای مدیریت تغییرات رفتاری که Wear OS 5.1 معرفی می‌کند، آماده کنید.

از جمله ویژگی‌های قابل توجه برای بررسی می‌توان به موارد زیر اشاره کرد:

• پشتیبانی از مدیریت اعتبارنامه: رابط برنامه‌نویسی کاربردی مدیریت اعتبارنامه، یک راهکار احراز هویت یکپارچه ارائه می‌دهد که از جریان‌های ورود به سیستم با استفاده از رمزهای عبور، کلیدهای عبور و هویت‌های یکپارچه (مانند ورود با گوگل ) پشتیبانی می‌کند. اعتبارنامه‌های کاربر در یک ارائه‌دهنده اعتبارنامه ذخیره می‌شوند که اطلاعات حساب را در بین دستگاه‌ها همگام‌سازی می‌کند.
• پخش از طریق بلندگوی ساعت: در دستگاه‌هایی که از پخش رسانه از طریق بلندگوی ساعت پشتیبانی می‌کنند، کاربران می‌توانند در صورت ادغام برنامه شما با Wear Output Switcher ، این بلندگو را به عنوان گزینه خروجی رسانه مورد نظر خود انتخاب کنند.

یادداشت‌های انتشار

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

تاریخ انتشار	۱۸ مارس ۲۰۲۵ برای گوگل پیکسل واچ ۳ LTE، گوگل پیکسل واچ ۲ LTE و گوگل پیکسل واچ (هم بلوتوث/وای‌فای و هم LTE) ۴ مارس ۲۰۲۵ برای گوگل پیکسل واچ ۳ بلوتوث/وای‌فای و گوگل پیکسل واچ ۲ بلوتوث/وای‌فای
ساختن	BP1A.250305.019.W3 در گوگل پیکسل واچ ۳ و گوگل پیکسل واچ ۲ BP1A.250305.019.W2 در ساعت هوشمند گوگل پیکسل AP4A.241205.004.F4 روی شبیه‌ساز
پشتیبانی از شبیه‌ساز	x86 (64 بیتی)، ARM (v8-A)

مشکلات شناخته شده

ایمیج سیستمی که شامل Wear OS 5.1 است، مشکلات شناخته‌شده‌ی زیر را دارد:

• شبیه‌ساز همیشه به کاربر اجازه نمی‌دهد که در طول فرآیند راه‌اندازی پس از بازنشانی دستگاه، حساب کاربری اضافه کند.
• هنگام ضربه زدن روی یک اعلان، برنامه‌ای که اعلان را ارسال کرده است تا زمانی که کاربر صفحه را اسکرول نکند، باز نمی‌شود.
• گاهی اوقات سرویس‌های بهداشتی ویر (Wear Health Services) نمی‌توانند ورزش را شروع کنند.
• اگر در برنامه‌ای که سطح API 35 را هدف قرار می‌دهد، به کتابخانه‌های androidx.wear.tiles یا androidx.wear:wear-phone-interactions دسترسی پیدا کنید، ممکن است یک SecurityException رخ دهد. برای حل این مشکل، به androidx.wear.tiles 1.5.0-alpha05 یا بالاتر، یا androidx.wear:wear-phone-interactions 1.1.0 یا بالاتر ارتقا دهید.