يجب تحديث إصدار حزمة تطوير البرامج (SDK) المستهدَف لتطبيقك لنظام التشغيل Wear OS 4.

بعد تحديث تطبيقك استعدادًا لإصدار Wear OS 4، يمكنك تحسين توافق تطبيقك مع هذا الإصدار من Wear OS من خلال استهداف الإصدار Android 13 (المستوى 33 من واجهة برمجة التطبيقات).

في حال تحديث إصدار حزمة تطوير البرامج (SDK) المستهدَف، يجب معالجة تغييرات سلوك النظام التي تسري على التطبيقات التي تستهدف الإصدار 12 من نظام التشغيل Android أو الإصدارات الأحدث، وكذلك على التطبيقات التي تستهدف الإصدار 13 من نظام التشغيل Android أو الإصدارات الأحدث. وعلى وجه الخصوص، يجب مراعاة التغييرات على الأذونات ومكوّنات التطبيق وسلوك التنقل الموضحة لاحقًا في هذا الدليل.

تعديل ملف الإصدار

لتحديث إصدار حزمة تطوير البرامج (SDK) المستهدَف، افتح الملف build.gradle أو build.gradle.kts على مستوى الوحدة وعدِّله باستخدام قيم Android 13.

تعتمد طريقة تنسيق القيم في ملف الإصدار على إصدار المكوّن الإضافي لنظام Gradle المتوافق مع Android (AGP) الذي تستخدمه.

7.0.0 AGP أو أعلى

إذا كنت تستخدم الإصدار 7.0.0 من AGP أو إصدار أحدث، عليك تعديل ملف build.gradle أو build.gradle.kts في تطبيقك بالقيم التالية لنظام التشغيل Android 13:

رائع

android {
    compileSdk 33
    ...
    defaultConfig {
        targetSdk 33
    }
}

Kotlin

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

4.2.0 AGP أو أقل

إذا كنت تستخدم الإصدار 4.2.0 من AGP أو الإصدارات الأقدم، عليك تعديل ملف build.gradle أو build.gradle.kts في تطبيقك بالقيم التالية لنظام التشغيل Android 13:

رائع

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

Kotlin

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

تغييرات على الأذونات

يسرد هذا القسم العديد من التغييرات على الأذونات التي تؤثر في التطبيقات بعد استهدافها لنظام التشغيل Android 13.

إذن أجهزة استشعار الجسم في الخلفية

للحصول على معلومات من أجهزة استشعار الجسم الشائعة، مثل معدّل نبضات القلب، يمكنك طلب إذن BODY_SENSORS_BACKGROUND في الخلفية.

اطّلِع على مزيد من المعلومات في دليل طلب الوصول إلى بيانات أجهزة استشعار الجسم في الخلفية.

إذن المنبّه المحدد

لاستخدام المنبّهات المحدَّدة الوقت بدقة، والتي تُعرَف أيضًا باسم المنبّهات الدقيقة، عليك الإفصاح عن إذن USE_EXACT_ALARM أو SCHEDULE_EXACT_ALARM.

يمكنك استخدام منبهات غير محددة بدلاً من ذلك، ما لم تعتمد القدرات الأساسية لتطبيقك على المنبّهات المحدَّدة الوقت، مثل تطبيق المنبّه أو تطبيق التقويم. يمكن لمعظم التطبيقات جدولة المهام والأحداث باستخدام المنبّهات غير الدقيقة.

اطّلع على مزيد من المعلومات حول كيفية تعيين تنبيه دقيق.

أذونات الوسائط الدقيقة

إذا كان تطبيقك يحتاج إلى الوصول إلى ملفات الوسائط التي أنشأتها تطبيقات أخرى، عليك طلب أذونات الوسائط الدقيقة، والتي تبدأ بـ READ_MEDIA_*، بدلاً من إذن READ_EXTERNAL_STORAGE. إذا سبق أن تم منح تطبيقك الإذن READ_EXTERNAL_STORAGE، سيمنح النظام تلقائيًا الأذونات المطلوبة لاستخدام الوسائط الدقيقة.

مزيد من المعلومات حول أذونات الوسائط الدقيقة

التغييرات على مكوّنات التطبيق والتنقّل

يسرد هذا القسم العديد من التغييرات على مكوّنات التطبيق وسلوك التنقّل التي تؤثر في التطبيقات بعد استهداف Android 13.

متطلبات تصدير مكوّنات التطبيق

إذا كان تطبيقك يحتوي على أنشطة أو خدمات أو أجهزة استقبال بث تستخدم فلاتر النية بالشراء، عليك الإفصاح بشكل واضح عن السمة android:exported لمكوّنات التطبيق هذه.

مزيد من المعلومات حول تصدير المكوّنات بطريقة أكثر أمانًا

تحديد قابلية تغيُّر الأغراض المعلَّقة

عليك تحديد ما إذا كان كل عنصر PendingIntent في تطبيقك قابلاً للتغيير أو غير قابل للتغيير. في معظم الحالات، استخدِم كائنات PendingIntent غير القابلة للتغيير لحماية سلامة البيانات داخل الغرض.

اطّلِع على مزيد من المعلومات عن كيفية تحديد قابلية التغيّر للأهداف التي تنتظر المراجعة.

قيود إطلاق الخدمات التي تعمل في المقدّمة

في معظم الحالات، لا يمكن لتطبيقك بدء الخدمات التي تعمل في المقدّمة أثناء التشغيل في الخلفية.

تعرّف على مزيد من المعلومات حول القيود المفروضة على بدء خدمة تعمل في المقدّمة من الخلفية.

قيود الترامبولين على الإشعارات

بعد تفاعل المستخدم مع الإشعار، لا يمكنك الاتصال بـ startActivity() داخل خدمة أو جهاز استقبال البث. يُعرف هذا المكوِّن الخاص بالتطبيق البيني الذي لا يمكن استخدامه سوى بإطلاق نشاط باسم ترامبولين الإشعارات.

يمكنك الاطّلاع على مزيد من المعلومات حول القيود المفروضة على الترامبولين في الإشعارات.