بپوشید OS 5.1

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

Wear OS 5.1 مبتنی بر Android 15 (سطح API 35) است که از شما می‌خواهد برنامه‌هایی را که قبلاً سطح API 34 را برای Wear OS 5 هدف قرار داده‌اند، آزمایش کنید.

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

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

• Google Pixel Watch 3 (بلوتوث/Wi-Fi)
• Google Pixel Watch 2 (بلوتوث/Wi-Fi)

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

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

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

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

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

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

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

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

   

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

5. منتظر بمانید تا Android Studio تصویر سیستم را دانلود و نصب کند و سپس روی Finish کلیک کنید.

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

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

1. در Android Studio، با انتخاب Tools > Device Manager، Device Manager را باز کنید. صفحه Device Manager ظاهر می شود.
2. در نوار ابزار در قسمت Device Manager ، روی Add a new device کلیک کنید > ایجاد دستگاه مجازی .
3. در قسمت Form Factor ، Wear OS را انتخاب کنید و یک نمایه سخت افزاری را انتخاب کنید. روی Next کلیک کنید.
4. یک تصویر سیستم Wear OS 5.1 را برای استفاده انتخاب کنید. تصویر سیستم باید دارای سطح API 35 باشد.
5. روی Next کلیک کنید و سپس روی Finish کلیک کنید.

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

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

1. به نوار ابزار اندروید استودیو بروید و دستگاه مجازی را انتخاب کنید.
2. روی Run کلیک کنید .
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 است که Android 15 از آن استفاده می‌کند.)

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

نحوه قالب بندی مقادیر موجود در فایل ساخت خود به نسخه پلاگین Android Gradle (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 به‌روزرسانی کردید، تغییرات را برای برنامه‌هایی که Android 15 را هدف قرار می‌دهند ، که از همان سطح API Wear OS 5.1 استفاده می‌کند، مدیریت کنید.

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

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

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

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

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

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

مسائل شناخته شده

تصویر سیستم حاوی Wear OS 5.1 دارای مشکلات شناخته شده زیر است:

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