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

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

ملاحظة مُهمة: تم تقسيم مكتبة Java Core Java وKotlin في Google Play إلى عدة مكتبات منفصلة، واحدة لكل ميزة. انتقِل إلى المكتبات الجديدة للاستفادة من المنتجات الجديدة التي تم إضافتها. لمزيد من المعلومات، يُرجى الاطّلاع على دليل نقل البيانات.

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

• تنزيل مراجع لغوية إضافية
• إدارة عرض وحدات الميزات
• إدارة إرسال حِزم مواد العرض
• تشغيل التحديثات داخل التطبيق
• طلب مراجعات داخل التطبيق

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

نقل البيانات من Play Core Java ومكتبة Kotlin

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

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

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

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

1. تعديل أي عبارات استيراد حالية لعناصر "مهام Google" من "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.2.1'

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

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.2.1")

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

دمج مكتبة عرض الميزات في 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 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.1'

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

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.1")

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

دمج مكتبة التحديثات داخل التطبيق من 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")
    ...
}

بنود الخدمة الخاصة بحزمة تطوير البرامج الأساسية في Play

تاريخ آخر تعديل: 24 أيلول (سبتمبر) 2020

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