يوفّر البرنامج التجريبي "مبادرة حماية الخصوصية" على Android واجهات برمجة تطبيقات ثابتة. ونخطط لطرح عدة إصدارات تجريبية خلال عام 2023 يمكنك استخدام إصدارات البرنامج التجريبي لإنشاء حلول واختبارها لإجراء اختبارات إنتاج محدودة على الأجهزة الجوّالة التي تعمل بنظام التشغيل Android 13. سنبدأ في دعم نسبة صغيرة من الأجهزة وزيادة العدد بمرور الوقت. للمشاركة في البرنامج، يمكن للمؤسسات طلب الوصول إلى عدد محدود من الأجهزة، بالإضافة إلى تسجيل أي تطبيقات تستخدم واجهات برمجة تطبيقات "مبادرة حماية الخصوصية".
في ما يتعلّق بـ "وقت تشغيل SDK"، يتوفّر إصدار تجريبي مغلق للمطوّرين يمكنهم من خلاله اختبار توزيع هذه الحزمة من أجل تطبيقات محددة.
لاستخدام الإصدار التجريبي، على المطوّرين تجميع حلولهم باستخدام تحديث إضافة SDK رقم 33 لواجهة برمجة التطبيقات.
إضافات حزمة تطوير البرامج (SDK) لنظام التشغيل Android
يتم تقديم واجهات برمجة التطبيقات الثابتة في الإصدارات التجريبية باستخدام طريقة إصدار إضافات Android SDK الجديدة. تتيح طريقة الإصدار هذه إطلاق ميزات Android الثابتة بين الإصدارات الرئيسية. وهو يتميز بآلية تحديد إصدارات جديدة تجعل واجهات برمجة التطبيقات الجديدة متاحة للتطبيقات على مستويات متعددة من واجهات برمجة التطبيقات باستخدام تحديثات نظام Google Play. تُسمّى إضافة "مبادرة حماية الخصوصية" على Android SDK إضافات الخدمات الإعلانية. اطّلِع على مزيد من المعلومات عن إضافات حزمة تطوير البرامج (SDK) لنظام التشغيل Android.
بدء
للبدء، قم بتنفيذ الخطوات التالية:
الخطوة 1: التسجيل في البرنامج التجريبي والتسجيل فيه
- التسجيل: أكمِل عملية التسجيل لاستخدام واجهات برمجة التطبيقات المتعلّقة بالإعلانات.
- التسجيل: يجب register للمشاركة في البرنامج التجريبي.
ويتيح لك التسجيل ما يلي:
- يمكنك تفعيل أجهزتك الخاصة لأغراض الاختبار الداخلي.
- حدِّد عددًا محدودًا من التطبيقات المنشورة على "متجر Google Play" التي يمكنها مباشرةً دمج واجهات برمجة التطبيقات التي تحافظ على الخصوصية أو تدمج حلول حِزم تطوير البرامج (SDK) التي تستخدم واجهات برمجة التطبيقات.
- يمكنك اختبار توزيع حِزم SDK التي يتم تفعيلها في وقت التشغيل باستخدام "متجر Google Play". هذه الخطوة غير مطلوبة إذا أردت فقط اختبار "وقت تشغيل SDK" على الجهاز.
الخطوة 2: إعداد بيئة التطوير
الخطوة 3: ضبط أذونات AdServices
تضمين الأذونات الخاصة بواجهة برمجة التطبيقات وإعداد الوصول إلى حزمة SDK للموارد التي تديرها واجهة برمجة التطبيقات المستهدَفة
الخطوة 4: إعداد جهاز أو محاكي صورة
لإجراء اختبار شامل، عليك التفاعل مع جهاز متوافق يعمل بنظام التشغيل Android 13 أو استخدام صورة محاكي للحصول على إضافة SDK المناسبة.
الخطوة 5: ضبط الأجهزة لاستخدام "مبادرة حماية الخصوصية" على Android
ضبط الإعدادات لتفعيل (أو إيقاف) "مبادرة حماية الخصوصية" على Android للتشغيل على الأجهزة
تحديد المشاكل المعروفة وحلّها
لتجنُّب المشاكل المعروفة في دمج PP API على الأجهزة التي تعمل بنظام التشغيل Android 12 والإصدارات الأقدم، على المطوِّرين الذين يدمجون واجهات برمجة تطبيقات الخدمات الإعلانية للأجهزة التي تعمل بالإصدار 12 من نظام التشغيل Android والإصدارات الأقدم اتّباع ما يلي:
- تحقَّق من أنّ ملف البيان في تطبيق العميل يحتوي على علامة
<uses-library>في extservices. في ما يلي العلامة الملائمة:
<uses-library
android:name="android.ext.adservices"
android:required="false" />
- في حال استخدام مكتبة
androidx.privacysandbox.adsالنفاثة، يجب استخدام الإصدار 1.1.0-beta05 أو الإصدارات الأحدث.
ما هي موارد المطوّرين المتوفّرة؟
يتضمّن البرنامج التجريبي "مبادرة حماية الخصوصية" على Android الأدوات والموارد التالية:
صور حزمة تطوير البرامج (SDK) ونظام المحاكي
باستخدام "استوديو Android"، يمكنك تنزيل أحدث صور "إضافات الخدمات الإعلانية" وصور نظام المحاكيات من خلال "مدير تطوير البرامج (SDK)". يمكنك الاطّلاع على المزيد من المعلومات حول كيفية إعداد بيئة التطوير وإعداد الوصول إلى واجهة برمجة التطبيقات.
مرجع واجهة برمجة تطبيقات
يتوفر مرجع واجهة برمجة التطبيقات الكامل.
الدعم والتعليقات
أثناء إجراء الاختبارات والتطوير باستخدام "مبادرة حماية الخصوصية" على Android، يمكنك مراجعة ملاحظات الإصدار واستخدام أداة تتبُّع المشاكل للإبلاغ عن المشاكل وتقديم الملاحظات.
تحديث بيئة التطوير
نشدّد على أهمية إبقاء بيئة التطوير محدّثة بأحدث إصدار. ويضمن ذلك حصولك على أحدث الميزات ورموز تصحيح الأمان، وأنّ بيئتك متوافقة مع أحدث إصدارات التبعيات. للبقاء على اطّلاع بالإصدارات الجديدة، يمكنك الاشتراك لتلقّي آخر الأخبار عبر البريد الإلكتروني.