نظرة عامة على مكتبات Google Play الأساسية

توضّح هذه الصفحة مكتبات Google Play الأساسية وكيفية إضافتها إلى مشروعك.

مكتبات Google Play الأساسية هي واجهة وقت التشغيل لتطبيقك مع "متجر Google Play". في ما يلي بعض الإجراءات التي يمكنك اتّخاذها:

تتوفّر مكتبات Play الأساسية بلغات Java والبرمجة الأصلية وUnity. لمزيد من المعلومات حول أحدث الإصدارات، يُرجى الاطّلاع على ملاحظات الإصدار.

نقل البيانات من مكتبة Play الأساسية في Java وKotlin

تم تقسيم مكتبة Play الأساسية Java وKotlin إلى عدة مكتبات Android لكل ميزة. يؤدي ذلك إلى تقليل الحجم الذي تضيفه مكتبات Play الأساسية إلى تطبيقك، كما يتيح دورات إصدار أسرع للميزات الفردية.

ظلّ سلوك كل ميزة ثابتًا في عملية النقل هذه، والتغيير الوحيد الملحوظ هو أنّ الإصدارات الجديدة قد اعتمدت Task API في "خدمات Google Play".

استخدِم القائمة أدناه لنقل البيانات إلى المكتبات الجديدة والاستفادة من الميزات الجديدة وإصلاحات الأخطاء. إذا كنت تستخدم ميزات متعددة في Google Play، يمكنك ببساطة استيراد مكتبات متعددة في ملف build.gradle في آنٍ واحد.

الخطوات الشائعة لنقل البيانات

  1. عدِّل أي عبارات استيراد حالية لعناصر Task من import com.google.android.play.core.tasks.*; إلى import com.google.android.gms.tasks.*;. لم يتم تغيير أي من أسماء الصفوف.
  2. أزِل أي عمليات استيراد لمكتبات Play Core القديمة في ملف build.gradle.

دمج مكتبة "عرض المواد في Play"

أنيق

// In your app's build.gradle file:
...
dependencies {
    // This dependency is downloaded from the Google's Maven repository.
    // So, make sure you also include that repository in your project's build.gradle file.
    implementation 'com.google.android.play:asset-delivery:2.3.0'

    // For Kotlin users also add the Kotlin extensions library for Play Asset Delivery:
    implementation 'com.google.android.play:asset-delivery-ktx:2.3.0'
    ...
}

Kotlin

// In your app's build.gradle.kts file:
...
dependencies {
    // This dependency is downloaded from the Google's Maven repository.
    // So, make sure you also include that repository in your project's build.gradle file.
    implementation("com.google.android.play:asset-delivery:2.3.0")

    // For Kotlin users also import the Kotlin extensions library for Play Asset Delivery:
    implementation("com.google.android.play:asset-delivery-ktx:2.3.0")
    ...
}

دمج مكتبة "عرض الميزات في Play"

أنيق

// In your app's build.gradle file:
...
dependencies {
    // This dependency is downloaded from the Google's Maven repository.
    // So, make sure you also include that repository in your project's build.gradle file.
    implementation 'com.google.android.play:feature-delivery:2.1.0'

    // For Kotlin users, also add the Kotlin extensions library for Play Feature Delivery:
    implementation 'com.google.android.play:feature-delivery-ktx:2.1.0'
    ...
}

Kotlin

// In your app's build.gradle.kts file:
...
dependencies {
    // This dependency is downloaded from the Google's Maven repository.
    // Make sure you also include that repository in your project's build.gradle file.
    implementation("com.google.android.play:feature-delivery:2.1.0")

    // For Kotlin users, also import the Kotlin extensions library for Play Feature Delivery:
    implementation("com.google.android.play:feature-delivery-ktx:2.1.0")
    ...
}

دمج Play In-App Review Library

أنيق

// In your app's build.gradle file:
...
dependencies {
    // This dependency is downloaded from the Google's Maven repository.
    // Make sure you also include that repository in your project's build.gradle file.
    implementation 'com.google.android.play:review:2.0.2'

    // For Kotlin users, also add the Kotlin extensions library for Play In-App Review:
    implementation 'com.google.android.play:review-ktx:2.0.2'
    ...
}

Kotlin

// In your app's build.gradle.kts file:
...
dependencies {
    // This dependency is downloaded from the Google's Maven repository.
    // Make sure you also include that repository in your project's build.gradle file.
    implementation("com.google.android.play:review:2.0.2")

    // For Kotlin users, also import the Kotlin extensions library for Play In-App Review:
    implementation("com.google.android.play:review-ktx:2.0.2")
    ...
}

دمج مكتبة تحديث التطبيق داخل التطبيق من Play

أنيق

// In your app's build.gradle file:
...
dependencies {
    // This dependency is downloaded from the Google's Maven repository.
    // Make sure you also include that repository in your project's build.gradle file.
    implementation 'com.google.android.play:app-update:2.1.0'

    // For Kotlin users, also add the Kotlin extensions library for Play In-App Update:
    implementation 'com.google.android.play:app-update-ktx:2.1.0'
    ...
}

Kotlin

// In your app's build.gradle.kts file:
...
dependencies {
    // This dependency is downloaded from the Google's Maven repository.
    // Make sure you also include that repository in your project's build.gradle file.
    implementation("com.google.android.play:app-update:2.1.0")

    // For Kotlin users, also import the Kotlin extensions library for Play In-App Update:
    implementation("com.google.android.play:app-update-ktx:2.1.0")
    ...
}

بنود خدمة حزمة تطوير البرامج (SDK) لمكتبة Play الأساسية

تاريخ آخر تعديل: 24 سبتمبر 2020
  1. يعني استخدامك لحزمة تطوير البرامج (SDK) لمكتبة Play الأساسية أنّك توافق على هذه البنود إلى جانب بنود خدمة Google APIs والمُشار إليها هنا بـ "بنود خدمة واجهات برمجة التطبيقات". في حال حدوث تعارُض بين هذين النوعين من البنود، ستكون لهذه البنود في هذا المستند الأولوية على "بنود خدمة واجهات برمجة التطبيقات". يُرجى قراءة هذه البنود إلى جانب "بنود خدمة واجهات برمجة التطبيقات" بعناية.
  2. في هذه البنود، يشير مصطلح "واجهات برمجة التطبيقات" إلى كلّ من واجهات برمجة التطبيقات المقدَّمة من Google، وخدمات المطورين الأخرى، والبرامج المرتبطة، بما في ذلك أي "رمز برمجي قابل لإعادة التوزيع".
  3. يشير مصطلح "رمز برمجي قابل لإعادة التوزيع" إلى أي رموز كائنات أو ملفات عناوين مُقدَّمة من Google تطلب البيانات من "واجهات برمجة التطبيقات".
  4. بموجب هذه البنود و"بنود خدمة واجهات برمجة التطبيقات"، لا يجوز لك نسخ أي "رمز برمجي قابل لإعادة التوزيع" وتوزيعه إلّا بغرض تضمينه في برنامجك الذي يستخدم واجهات برمجة التطبيقات. وتمتلك Google وجهاتها المرخِّصة جميع الحقوق وحقوق الملكية والمصالح في ما يخص أي "رمز برمجي قابل لإعادة التوزيع"، بما في ذلك جميع حقوق الملكية الفكرية وغيرها من حقوق الملكية. لا يجوز لك تعديل أي "رمز برمجي قابل لإعادة التوزيع" أو ترجمته أو إنشاء أعمال اشتقاقية منه.
  5. يجوز لشركة Google إجراء تغييرات على هذه البنود في أي وقت وإرسال إشعار إليك ومنحك الفرصة لرفض متابعة استخدام حزمة تطوير البرامج (SDK) لمكتبة Play الأساسية. ستنشر Google إشعارًا بالتعديلات على البنود على الرابط: https://developer.android.com/guide/playcore/license. ولن يتم تطبيق التغييرات بأثر رجعي.