Sidekick SDK

تتوفّر حزمة Sidekick SDK للمطوّرين الذين:

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

لإضافة حزمة Sidekick SDK، أضِف 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 أن يكون مستوى حزمة تطوير البرامج (SDK) 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" إلى حِزم التطبيقات التي يتم تحميلها. ستتحقّق أداة Play Console من حالة حزمة SDK بدون تكرارها.
مربّع الاختيار &quot;إضافة Sidekick في ألعاب Play إلى حزم التطبيقات التي يتم تحميلها&quot; في Play Console
مربّع الاختيار إضافة Sidekick في "ألعاب Play" إلى حِزم التطبيقات التي يتم تحميلها (انقر لتكبير الصورة).
  • إذا كنت تستخدم حزمة تطوير البرامج (SDK) الخاصة بـ Sidekick لتفعيل Sidekick، قد يظهر لك تحذير "ميزة Sidekick في ألعاب Play غير مفعَّلة" عند تحميل الحزمة. هذا أمر متوقَّع لأنّ Play Console لا تُدخِل أي رمز برمجي في حِزمة تطبيقك.
تحذير &quot;ميزة Sidekick في ألعاب Play غير مفعّلة&quot; في Play Console.
مربّع الاختيار تحذير بشأن إيقاف Sidekick في "ألعاب Play" (انقر لتكبير الصورة).