اختبار كيفية تعامل تطبيقك مع التغيّرات في السلوك

تستند معاينة المطوّر على Wear OS 5 إلى إصدار Android 14 (المستوى 34 لواجهة برمجة التطبيقات)، وهو إصدار أحدث مقارنةً بالإصدار الذي يعمل عليه Wear OS 4 (الإصدار 13 من Android أو المستوى 33 من واجهة برمجة التطبيقات). لذلك، عند إعداد تطبيق Wear OS للاستخدام في برنامج "معاينة المطوِّر" على نظام التشغيل Wear OS 5، عليك التعامل مع تغييرات سلوك النظام التي تؤثر في جميع التطبيقات في Android 14، بالإضافة إلى التغييرات في التطبيقات التي تستهدف الإصدار 14 من نظام التشغيل Android.

تغييرات على Wear OS 5 تؤثر في جميع التطبيقات

تؤثر تغييرات السلوك التالية في حالات الاستخدام والمكتبات الخاصة بنظام Wear OS. تؤثّر هذه التغييرات في جميع التطبيقات التي تعمل على نظام التشغيل Wear OS 5 بغض النظر عن إصدار حزمة تطوير البرامج (SDK) المستهدَف.

لوحة بيانات الخصوصية

تتم إضافة دعم "معاينة المطوِّر" من Wear OS 5 إلى لوحة بيانات الخصوصية التي تم إطلاقها في البداية على الأجهزة الجوّالة التي تعمل بالإصدار 12 من نظام التشغيل Android.

توفّر لوحة بيانات الخصوصية للمستخدمين عرضًا مركزيًا لاستخدام البيانات في كل تطبيق، بما في ذلك التفاصيل التالية:

  • أنواع البيانات التي يتم الوصول إليها، مثل الموقع الجغرافي والميكروفون
  • مدى حداثة الوصول إلى أنواع البيانات هذه.

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

تتطلب معظم مصادر البيانات المعقدة استخدام ”تنسيق خلفية شاشة الساعة“.

في الإصدارات القادمة من Wear OS، بما في ذلك "معاينة المطوِّر" على Wear OS 5، يجب استخدام "تنسيق خلفية شاشة الساعة" لإتاحة الإضافات التي تحتوي على بيانات المستخدمين. ننصحك بتحديث خلفية شاشة الساعة لاستخدام ”تنسيق خلفية شاشة الساعة“. مزيد من المعلومات حول هذه التغييرات على الإضافات

إيقاف التغيير مؤقتًا لأغراض الاختبار

وتكون هذه الميزة ممكّنة بشكل افتراضي. لإيقاف علامة الميزة التي تتوافق مع هذا التغيير لأغراض الاختبار، استخدِم الأمر التالي:

adb shell device_config put wear_services \
  com.google.wear.services.infra.flags.restrict_complications_flag false && \
  adb reboot

تغييرات Wear OS 5 تؤثر في التطبيقات التي تستهدف الإصدار 14 من نظام التشغيل Android

لا تؤثّر التغييرات التالية في تطبيقك إلا في حال تحديث إصدار حزمة تطوير البرامج (SDK) المستهدَف إلى الإصدار Android 14، وهو الإصدار الذي تستند إليه "معاينة المطوِّر" على نظام التشغيل Wear OS 5.

يمكن نقل التطبيقات المفعّلة دائمًا إلى الخلفية.

بدءًا من إصدار "معاينة المطوِّر" من Wear OS 5، ينقل النظام التطبيقات قيد التشغيل دائمًا إلى الخلفية بعد ظهورها في "وضع الإضاءة السينمائية" لفترة زمنية معيّنة. ويمكن للمستخدمين ضبط المهلة في إعدادات النظام.

إذا كان تطبيقك قيد التشغيل دائمًا يعرض معلومات حول مهمة مستخدم جارية، مثل تشغيل الموسيقى أو جلسة تمرين، قد تحتاج إلى إبقاء النشاط الجاري مرئيًا حتى تنتهي المهمة. ولإجراء ذلك، يمكنك استخدام واجهة برمجة تطبيقات النشاط الجاري لنشر إشعار مستمر مرتبط بنشاطك الذي يتم تشغيله دائمًا.

ولكي يتعرّف النظام على النشاط الجاري، يجب أن تشير نيّة اللمس للإشعار الجاري إلى نشاطك الدائم، كما هو موضّح في مقتطف الرمز التالي:

// Create a pending intent that point to your always-on activity
val touchIntent =
    PendingIntent.getActivity(
        context,
        0,
        Intent(context, MyAlwaysOnActivity::class.java),
        PendingIntent.FLAG_MUTABLE or PendingIntent.FLAG_UPDATE_CURRENT
    )

val notificationBuilder =
    NotificationCompat.Builder(this, CHANNEL_ID)
    // ...
    .setOngoing(true)

val ongoingActivity =
    OngoingActivity.Builder(
        applicationContext, NOTIFICATION_ID, notificationBuilder
    )
    // ...
    .setTouchIntent(touchIntent)
    .build()

ongoingActivity.apply(applicationContext)

notificationManager.notify(
    NOTIFICATION_ID,
    notificationBuilder.build()
)

إيقاف التغيير مؤقتًا لأغراض الاختبار

وتكون هذه الميزة ممكّنة بشكل افتراضي. لإيقاف علامة الميزة التي تتوافق مع هذا التغيير لأغراض الاختبار، استخدِم الأمر التالي:

adb shell device_config put wear_frameworks \
  com.google.android.clockwork.systemui.flags.ambiactive_components_expirable \
  false && adb reboot

يجب أن تشير تطبيقات تسجيل التمارين الرياضية إلى نوع خدمة تعمل في المقدّمة.

إذا كان تطبيقك يسجّل التمارين كجزء من جلسة تمرين للمستخدم، عليك تحديد health نوع الخدمة التي تعمل في المقدّمة في الخدمة التي تعمل في المقدّمة التي تستدعي ExerciseClient. بالإضافة إلى ذلك، إذا كان بإمكان تطبيقك تتبُّع معلومات الموقع الجغرافي أثناء جلسة التمرين، عليك أيضًا تحديد location نوع الخدمة التي تعمل في المقدّمة:

<manifest ...>
  <uses-permission android:name="android.permission.FOREGROUND_SERVICE" />
    <application ...>
      <!-- If your app can also monitor location information, use
           android:foregroundServiceType="health|location" instead. -->
      <service
          android:name=".MyExerciseSessionRecorder"
          android:foregroundServiceType="health">
      </service>
    </application>
</manifest>

تظل بعض الأجهزة غير المعصم مفتوحة لمدة أطول

على الأجهزة المتوافقة التي تعمل بإصدار "معاينة المطوِّر" من نظام التشغيل Wear OS 5، يرصد النظام ما إذا كان المستخدم يرتدي الجهاز على معصمه. إذا أوقف المستخدم ميزة اكتشاف المعصم ثم أزال الجهاز من معصمه، يحافظ النظام على فتح قفل الجهاز لفترة زمنية أطول مما كان يفعله بخلاف ذلك.

إذا كان تطبيقك يتطلب مستوى أعلى من الأمان، مثلاً عند عرض بيانات يُحتمَل أن تكون حساسة أو خاصة، يُرجى التحقّق أولاً مما إذا كانت ميزة "رصد المعصم" مفعَّلة أم لا:

val wristDetectionEnabled =
        isWristDetectionAutoLockingEnabled(applicationContext)

إذا كانت القيمة المعروضة لهذه الطريقة هي false، اطلب من المستخدم تسجيل الدخول إلى حساب في تطبيقك قبل عرض المحتوى الخاص بالمستخدم.

قد يتداخل المحتوى القابل للسحب مع نقاط تفعيل إيماءة النظام.

بدءًا من إصدار "معاينة المطوِّر" من Wear OS 5، يتعامل النظام مع إيماءات أحداث الحركة بشكل منفصل عن التنقُّل بالإيماءات المُستخدَمة في واجهة مستخدم النظام.

إذا كانت واجهة المستخدم في تطبيقك تحتوي على مساحات كبيرة قابلة للسحب تتداخل مع مناطق إيماءات النظام، قد تحتاج إلى إضافة مستطيلات استبعاد إيماءات النظام لطرق العرض هذه. لإجراء ذلك، يمكنك طلب setSystemGestureExclusionRects() لتوجيه واجهة مستخدم النظام إلى تجاهل إيماءات التنقّل في المناطق المحدّدة. وهذا يشبه طريقة التعامل مع إيماءات التطبيق المتضاربة في تطبيقك على الأجهزة الجوّالة لتقديم تجربة واجهة مستخدم شاملة.

يمكنك استخدام واجهة برمجة التطبيقات setSystemGestureExclusionRects() للردّ على طلبات الإيماءات بشكلٍ مختلف من واجهة مستخدم النظام. على سبيل المثال، قد تعرض واجهة مستخدم النظام تلميحات إضافية عن واجهة المستخدم، مثل شريط أفقي، لتأكيد نية المستخدم.

الضبط غير الخطّي لحجم الخط

بدءًا من إصدار "معاينة المطوِّر" على نظام التشغيل Wear OS 5، سيوفّر النظام تحجيم أكثر سلاسة للخطوط، لا سيما في الحالات التي يختار فيها المستخدمون أحجام خطوط أكبر، في مكوّنات واجهة المستخدم المستندة إلى العرض.

القيود المفروضة على الأهداف الضمنية وتلك التي لا تزال في انتظار المراجعة

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

لا تزال بعض الإشعارات غير قابلة للإغلاق

عند استخدام إصدار تطبيقك المحمول باليد على جهاز يعمل بنظام التشغيل Android 14 (المستوى 34 لواجهة برمجة التطبيقات) أو إصدار أحدث، يمكن للمستخدمين إغلاق الإشعارات التي لا يمكن إغلاقها في الإصدارات السابقة.

ومع ذلك، يظل بالإمكان إغلاق هذه الإشعارات في إصدار "معاينة المطوِّر" من نظام التشغيل Wear OS 5.

تغييرات أخرى من Android 14

من المرجّح أن تؤثّر التغييرات التالية من Android 14 على تطبيق Wear OS الخاص بك.

تغييرات Android 14 التي تؤثر في جميع التطبيقات

تغييرات Android 14 التي تؤثّر في التطبيقات التي تستهدِف المستوى 34 لواجهة برمجة التطبيقات