Sidekick SDK

تتوفّر حزمة تطوير البرامج (SDK) الخاصة بأداة Sidekick للمطوّرين الذين يستوفون الشروط التالية:

• نشر الإصدارات على شكل حزمة APK بدلاً من "مجموعة حزمات تطبيق Android"‏ (AAB)
• تحتاج إلى الوصول إلى Sidekick، ولكنك تستخدم حلاً غير متوافق لمكافحة التلاعب.

لإضافة حزمة تطوير البرامج Sidekick، أضِف com.google.android.play:sidekick إلى التبعيات. تأكَّد من تضمين مستودع Maven من Google (maven.google.com) كأحد المستودعات المُدرَجة.

على سبيل المثال، في ملف build.gradle.kts الخاص بالوحدة، أضِف ما يلي:

dependencyResolutionManagement {
  repositories {
    google()
    // Other repositories
  }
}

dependencies {
  // Other dependencies
  implementation("com.google.android.play:sidekick:+")
}

متطلبات التنفيذ

• الحد الأدنى لمستوى حزمة تطوير البرامج (SDK): يتطلّب أحدث إصدار من Sidekick المستوى minSdkVersion من واجهة برمجة التطبيقات 23.
• سير عمل الاختبار: لا يمكن إجراء الاختبارات إلا من خلال مسارات الاختبار الداخلي أو الاختبار المغلق باستخدام Google Play Console.
• إيقاف الميزة: إذا كنت بحاجة إلى إيقاف الميزة، عليك إعادة نشر تطبيقك بعد إزالة حزمة SDK أو التواصل مع فريق الدعم لطلب إيقافها عن بُعد.

الألعاب التي تستخدم عمليات متعدّدة

إذا كانت أنشطة لعبتك تعمل في عملية منفصلة (استخدِم السمة android:process في علامات <application> ضمن AndroidManifest.xml)، عليك تعديل ملف البيان عن طريق إضافة موفّري المحتوى التاليين. ولا يلزم إجراء أي تغييرات أخرى على الرمز.

<application>
  [...]
  <provider
      android:name="com.google.android.play.deku.DekuContentProvider$Process1"
      android:authorities="insert.your.package.name.here.deku.contentprovider1"
      android:exported="false"
      android:process=":insert_name_of_process1_here" />

  <provider
      android:name="com.google.android.play.deku.DekuContentProvider$Process2"
      android:authorities="insert.your.package.name.here.deku.contentprovider2"
      android:exported="false"
      android:process=":insert_name_of_process2_here" />

  [...] <!-- Up to 5 processes ($Process1, $Process2, ..., $Process5) -->
</application>

النشر على Google Play

• لنشر إصدارات على Google Play باستخدام حزمة Sidekick SDK، عليك ملء نموذج تسجيل حزمة Sidekick SDK. ستتم الموافقة على لعبتك في غضون أسبوع إلى أسبوعَين، وبعد ذلك يمكنك تحميل الإصدارات التي تم دمج حزمة Sidekick SDK فيها كالمعتاد.
• حتى بعد إكمال عملية دمج حزمة تطوير البرامج (SDK) الخاصة بميزة Sidekick، يجب تفعيل الإعداد في Play Console. يُرجى التأكّد من تحديد الخيار إضافة Sidekick في "ألعاب Play" إلى حِزم التطبيقات التي يتم تحميلها. ستتحقّق وحدة التحكّم من حالة حزمة SDK بدون تكرارها.