إنشاء واستخدام حزمة تطوير برامج (SDK) يتم تفعيلها في وقت التشغيل

إنشاء تطبيق تجريبي وإعداده

يوضّح هذا القسم كيفية إعداد تطبيق وتجهيزه لاستخدام حزمة SDK مفعَّلة في وقت التشغيل لإجراء اختبارات محلية.

إعداد تطبيقك

أولاً، أنشئ مشروعًا أو وحدة مستقلة منفصلة.

في هذا السيناريو، لا يحتوي التطبيق على الرمز البرمجي لحزمة SDK، بل يعرّفه على أنّه اعتماد على Maven بدلاً من ذلك.

يتطلّب إنشاء تطبيق يستخدم حزمة تطوير برامج (SDK) مفعَّلة في وقت التشغيل الإصدار 1 من Android Studio Ladybug Canary أو إصدارًا أحدث، والإصدار 8.7.0-alpha01 من "إضافة Gradle المتوافقة مع Android" (AGP) أو إصدارًا أحدث.

1. اتّبِع الخطوات نفسها الموضّحة سابقًا لإعداد بيئة التطوير والجهاز/المحاكي للاختبار.

2. فعِّل "وقت تشغيل حزمة تطوير البرامج (SDK)" باستخدام العلامة الموضّحة في الخطوة 3: إعداد قسم حزمة تطوير البرامج.

   # This enables the Privacy Sandbox for your project on Android Studio.
   android.experimental.privacysandboxsdk.enable=true
   android.experimental.privacysandboxsdk.requireServices=false
   

3. أضِف عنوان URL الخاص بمستودع Maven الذي يضم أدوات "مبادرة حماية الخصوصية" إلى ملف build.gradle ذي المستوى الأعلى في مشروعك.

       allprojects {
           repositories {
               google()
               maven {
                   url "https://maven.privacysandbox.com/v1/repository"
                   }
               }
           }
   

4. احتفِظ بالعنصر التابع في Maven لمكتبة الإعلانات الحالية (حزمة SDK المتوافقة مع وقت التشغيل) المستهدَفة في Maven.

5. أضِف كتلة PrivacySandbox إلى ملف build.gradle الخاص بالمشروع مع إضافة تبعية لمكتبة حزمة SDK واضبط enable على true

   plugins {
       id 'com.android.application'
       id 'org.jetbrains.kotlin.android'
   }
   
   android {
       //...
       privacySandbox {
           enable true
       }
       //...
   }
   
   dependencies {
       // SDK library dependency
       implementation(<maven coordinates to SDK library>)
   }
   

6. يمكن للتطبيق الآن استخدام واجهات برمجة التطبيقات الخاصة بحزمة SDK بالطريقة نفسها الموضّحة في قسم استخدام واجهة برمجة التطبيقات.

إنشاء تطبيقك

يمكنك إنشاء تطبيقاتك على شكل حِزم تطبيقات Android (AAB) كما تفعل عادةً.

اختبار حزمة تطوير البرامج (SDK) محليًا

لتشغيل تطبيقك التجريبي، ثبِّت حزمة تطوير البرامج (SDK) والتطبيق اللذين تم تفعيل وقت التشغيل فيهما على جهازك التجريبي أو المحاكي باستخدام Android Studio.

1. افتح مشروع "استوديو Android" لتطبيق الاختبار.
2. انتقِل إلى تشغيل > تعديل الإعدادات. ستظهر نافذة "إعدادات التشغيل/تصحيح الأخطاء". يمكنك النشر على شكل "حِزمة APK تلقائية" أو "حِزمة APK من الحِزمة".
3. ضمن خيارات التشغيل، اضبط التشغيل على نشاط محدّد.
4. انقر على قائمة الخيارات الإضافية بجانب النشاط واختَر النشاط الرئيسي لعميلك.
5. انقر على تطبيق ثم على موافق.
6. انقر على تشغيل لتثبيت تطبيق العميل وحزمة تطوير البرامج (SDK) على جهاز الاختبار.

إنشاء حزمة SDK لتوزيعها

يجب إنشاء حزمة تطوير البرامج (SDK) على شكل حزمة تطوير برامج (SDK) لنظام التشغيل Android ‏(ASB) قبل نشرها في متجر تطبيقات. حزمة تطوير البرامج (SDK) لنظام التشغيل Android ‏(ASB) هي حزمة نشر غير موقَّعة تعادل حِزم Android App Bundle.

تحوّل أداة Bundletool حزمة تطوير البرامج (SDK) لنظام التشغيل Android أو مشتقتها، وهي أرشيف حزمة تطوير البرامج (SDK) لنظام التشغيل Android (ASAR)، مع حزمة AAB الخاصة بالتطبيق إلى مجموعة من حِزم APK القابلة للتثبيت. يمكن لمطوّري التطبيقات استخدام BundleTool مباشرةً في "استوديو Android" (إصدار Canary حاليًا) لإخراج جميع صيغ حِزم APK.

تأخذ أداة Bundletool حزمة AAB وحزمة ASB ويمكنها عرض مجموعة من صيغ حِزم APK:

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

يمكنك إنشاء ASB بطريقتَين:

• استوديو Android
  1. أنشئ مشروعك. ويمكن إجراء ذلك من خلال استدعاء إنشاء > إعادة إنشاء المشروع.
  2. يتوفّر ملف ASB في وحدة ASB التي يتم تفعيلها في وقت التشغيل ضمن build/outputs/asb/single/<your-asb-module-name>.asb
• سطر أوامر Bundletool - اتّبِع هذه التعليمات.

يجب توقيع حزمة SDK باستخدام مفتاح تحميل قبل أن تتمكّن من نشرها. استخدِم مفتاح التحميل هذا لتوقيع بيان ASB قبل تحميله إلى SDK Console. تستخدم Google شهادة التحميل للتحقّق من هويتك.

في ما يلي نظرة عامة على الخطوات التي يجب اتّخاذها لتوقيع بيان صحة الشهادة:

1. أنشئ ملف تخزين مفاتيح ومفتاح تحميل. وهي مطابقة لإنشاء ملف تخزين مفاتيح ومفتاح تحميل للتطبيقات.
2. وقِّع ASB باستخدام مفتاح التحميل. لإجراء ذلك، أضِف كتلة signingConfig إلى ملف build.gradle مع تحديد المفتاح الذي تم إنشاؤه حديثًا وملف تخزين المفاتيح:

android {
  signingConfig {
    storeFile file(path-to-keystore.jks)
    storePassword "keystorePassword"
    keyAlias "UploadKey"
    keyPassword "keyPassword"
  }
}

يمكن لمتاجر التطبيقات وضع استراتيجيات مختلفة لاستخدام هذه المكوّنات من أجل إتاحة توزيع التطبيقات التي يتم تشغيلها في وقت التشغيل. تعمل "بيئة تشغيل حِزم SDK" باستمرار مع متاجر التطبيقات لتوسيع نطاق التوافق مع حِزم SDK التي يتم تفعيلها في وقت التشغيل.

arrow_back_iosالخطوة 4: استخدام حزمة SDK المفعَّلة في وقت التشغيل