نظرة عامة على عرض الميزات في Play

يستخدم نموذج عرض التطبيقات في Google Play حِزم تطبيقات Android لإنشاء حِزم APK محسَّنة وعرضها بما يتناسب مع إعدادات جهاز كل مستخدِم، بحيث لا ينزّل المستخدمون سوى الرمز والموارد التي يحتاجون إليها لتشغيل تطبيقك.

يستخدم Play Feature Delivery إمكانات متقدمة لحِزم التطبيق، ما يسمح بتقديم ميزات معينة من تطبيقك بشروط أو تنزيلها عند الطلب. لتنفيذ ذلك، عليك أولاً فصل هذه الميزات عن تطبيقك الأساسي في وحدات ميزات.

ضبط إصدار وحدة الميزات

عند إنشاء وحدة ميزات جديدة باستخدام "استوديو Android"، يطبّق IDE مكوّن Gradle الإضافي التالي على ملف build.gradle في الوحدة.

// The following applies the dynamic-feature plugin to your feature module.
// The plugin includes the Gradle tasks and properties required to configure and build
// an app bundle that includes your feature module.

plugins {
  id 'com.android.dynamic-feature'
}

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

العناصر التي لا يجب إدراجها في إعدادات إصدار وحدة الميزات

ولأن كل وحدة من الميزات تعتمد على الوحدة الأساسية، فإنها تكتسب أيضًا بعض الإعدادات الخاصة. لذا، يجب حذف ما يلي في ملف build.gradle لوحدة الميزات:

• توقيع الإعدادات: يتم توقيع حِزم التطبيقات باستخدام إعدادات توقيع التوقيع التي تحدِّدها في الوحدة الأساسية.
• السمة minifyEnabled: يمكنك تفعيل تقليص الرموز لمشروع تطبيقك بالكامل من إعدادات تصميم الوحدة الأساسية فقط. لذا، يجب عليك حذف هذه الخاصية من وحدات الميزات. ومع ذلك، يمكنك تحديد قواعد ProGuard إضافية لكل وحدة من الميزات.
• versionCode وversionName: عند إنشاء حِزمة تطبيقك، تستخدم أداة Gradle معلومات إصدار التطبيق التي توفّرها الوحدة الأساسية. يجب حذف هذه السمات من ملف build.gradle الخاص بوحدة الميزات.

إنشاء علاقة بالوحدة الأساسية

عندما ينشئ "استوديو Android" وحدة الميزات، يتم عرضه للوحدة الأساسية من خلال إضافة السمة android.dynamicFeatures إلى ملف build.gradle في الوحدة الأساسية، كما هو موضّح أدناه:

// In the base module’s build.gradle file.
android {
    ...
    // Specifies feature modules that have a dependency on
    // this base module.
    dynamicFeatures = [":dynamic_feature", ":dynamic_feature2"]
}

بالإضافة إلى ذلك، يتضمن "استوديو Android" الوحدة الأساسية بصفتها تابعة لوحدة الميزة، كما هو موضّح أدناه:

// In the feature module’s build.gradle file:
...
dependencies {
    ...
    // Declares a dependency on the base module, ':app'.
    implementation project(':app')
}

تحديد قواعد ProGuard إضافية

على الرغم من أنّ إعدادات تصميم الوحدة الأساسية فقط هي التي يمكنها تفعيل تقليص الرموز لمشروع تطبيقك، يمكنك توفير قواعد ProGuard مخصّصة مع كل وحدة ميزة باستخدام السمة proguardFiles، كما هو موضّح أدناه.

android.buildTypes {
     release {
         // You must use the following property to specify additional ProGuard
         // rules for feature modules.
         proguardFiles 'proguard-rules-dynamic-features.pro'
     }
}

يتم دمج قواعد ProGuard هذه مع قواعد الوحدات الأخرى (بما في ذلك الوحدة الأساسية) في وقت الإصدار. لذلك، بينما قد تحدد كل وحدة ميزات مجموعة جديدة من القواعد، تنطبق هذه القواعد على جميع الوحدات في مشروع التطبيق.

نشر تطبيقك

أثناء تطوير تطبيقك بدعم لوحدات الميزات، يمكنك نشر تطبيقك على جهاز متصل كما تفعل عادةً عن طريق تحديد تشغيل > تشغيل من شريط القوائم (أو بالنقر على تشغيل في شريط الأدوات).

إذا كان مشروع تطبيقك يتضمن وحدة ميزات واحدة أو أكثر، يمكنك اختيار الميزات التي تريد تضمينها عند نشر تطبيقك من خلال تعديل إعدادات التشغيل/تصحيح الأخطاء الحالية كما يلي:

1. اختر Run (تشغيل) > Edit Configurations (تعديل الإعدادات) من شريط القوائم.
2. من اللوحة اليمنى في مربّع الحوار عمليات ضبط التشغيل/تصحيح الأخطاء، اختَر إعدادات تطبيق Android المطلوبة.
3. ضمن الميزات الديناميكية المراد نشرها في علامة التبويب الإعدادات العامة، ضَع علامة في المربّع بجانب كل وحدة ميزات تريد تضمينها عند نشر تطبيقك.
4. انقر على حسنًا.

لا ينشر "استوديو Android" تلقائيًا تطبيقك باستخدام حِزم التطبيقات لنشره. بدلاً من ذلك، يعمل IDE على إنشاء ملفات APK وتثبيتها على جهازك والتي تم تحسينها لسرعة النشر، بدلاً من حجم حزمة APK. لضبط تطبيق Android Studio لكي يتم بدلاً من ذلك إنشاء ملفات APK وتجارب فورية من حِزمة تطبيق ونشرها، يجب تعديل إعدادات التشغيل/تصحيح الأخطاء.

استخدام وحدات الميزات للتسليم المخصَّص

تتمثل إحدى المزايا الفريدة لوحدات الميزات في القدرة على تخصيص طريقة ووقت تنزيل الميزات المختلفة لتطبيقك على الأجهزة التي تعمل بالإصدار Android 5.0 (المستوى 21 من واجهة برمجة التطبيقات) أو الإصدارات الأحدث. على سبيل المثال، لتقليل حجم التنزيل الأولي لتطبيقك، يمكنك ضبط ميزات معيّنة ليتم تنزيلها إما عند الطلب أو على الأجهزة التي تدعم إمكانات معيّنة فقط، مثل القدرة على التقاط الصور أو دعم ميزات الواقع المعزّز.

على الرغم من حصولك على عمليات تنزيل محسَّنة للغاية بشكل تلقائي عند تحميل تطبيقك كحزمة تطبيق، تتطلّب خيارات تقديم الميزات الأكثر تقدّمًا وتخصيصًا المزيد من الإعدادات وتقسيم ميزات التطبيق إلى وحدات باستخدام وحدات الميزات. وهذا يعني أن وحدات الميزات تشكِّل اللبنات الأساسية لإنشاء ميزات معيارية يمكنك ضبطها لتنزيل كل منها حسب الحاجة.

ضع في اعتبارك تطبيقًا يتيح للمستخدمين شراء وبيع السلع في سوق على الإنترنت. يمكنك تقسيم كل وظيفة من الوظائف التالية للتطبيق بشكل معقول إلى وحدات ميزات منفصلة:

• تسجيل الدخول إلى الحساب وإنشاؤه
• تصفُّح السوق
• عرض سلعة للبيع
• معالجة الدفعات

يصف الجدول أدناه خيارات التسليم المختلفة التي تدعمها الوحدات وكيف يمكن استخدامها لتحسين حجم التنزيل الأولي لنموذج تطبيق السوق.

إنشاء معرف موارد منتظم (URI) لمورد ما

إذا أردت الوصول إلى مورد مخزّن في وحدة الميزات باستخدام معرّف موارد منتظم (URI)، إليك كيفية إنشاء معرّف موارد منتظم (URI) لمورد وحدة الميزات باستخدام Uri.Builder():

val uri = Uri.Builder()
                .scheme(ContentResolver.SCHEME_ANDROID_RESOURCE)
                .authority(context.getPackageName()) // Look up the resources in the application with its splits loaded
                .appendPath(resources.getResourceTypeName(resId))
                .appendPath(String.format("%s:%s",
                  resources.getResourcePackageName(resId), // Look up the dynamic resource in the split namespace.
                  resources.getResourceEntryName(resId)
                  ))
                .build()

String uri = Uri.Builder()
                .scheme(ContentResolver.SCHEME_ANDROID_RESOURCE)
                .authority(context.getPackageName()) // Look up the resources in the application with its splits loaded
                .appendPath(resources.getResourceTypeName(resId))
                .appendPath(String.format("%s:%s",
                  resources.getResourcePackageName(resId), // Look up the dynamic resource in the split namespace.
                  resources.getResourceEntryName(resId)
                  ))
                .build().toString();

يتم إنشاء كل جزء من المسار إلى المورد في وقت التشغيل، ما يضمن إنشاء مساحة الاسم الصحيحة بعد تحميل حِزم APK المجزّأة.

كمثال على كيفية إنشاء معرف الموارد المنتظم (URI)، لنفترض أن لديك تطبيقًا ووحدات ميزات بهذه الأسماء:

• اسم حزمة التطبيق: com.example.my_app_package
• اسم حزمة موارد الميزة: com.example.my_app_package.my_dynamic_feature

إذا كان resId في مقتطف الرمز أعلاه يشير إلى مورد ملف غير معدَّل اسمه "my_video" في وحدة الميزات، سينتج عن الرمز Uri.Builder() أعلاه ما يلي:

android.resource://com.example.my_app_package/raw/com.example.my_app_package.my_dynamic_feature:my_video

ويمكن بعد ذلك استخدام معرّف الموارد المنتظم (URI) هذا بواسطة تطبيقك للوصول إلى مورد وحدة الميزة.

للتحقق من صحة المسارات في معرّف الموارد المنتظم (URI)، يمكنك استخدام أداة تحليل APK لفحص حزمة APK لوحدة الميزات وتحديد اسم الحزمة:

الشكل 2. استخدم أداة تحليل APK لفحص اسم الحزمة في ملف موارد مجمّع.

اعتبارات وحدات الميزات

باستخدام وحدات الميزات، يمكنك تحسين سرعة الإنشاء والسرعة الهندسية وتخصيص تقديم ميزات تطبيقك على نطاق واسع لتقليل حجم التطبيق. ومع ذلك، هناك بعض القيود والحالات الهامشية التي يجب وضعها في الاعتبار عند استخدام وحدات الميزات:

• قد يؤدي تثبيت 50 وحدة من وحدات الميزات أو أكثر على جهاز واحد، من خلال التسليم المشروط أو عند الطلب، إلى حدوث مشكلات في الأداء. يتم تلقائيًا تضمين وحدات وقت التثبيت التي لم يتم ضبطها كوحدات قابلة للإزالة في الوحدة الأساسية ويتم احتسابها كوحدة ميزات واحدة على كل جهاز.
• عليك تحديد عدد الوحدات التي تضبطها على أنّها قابلة للإزالة للتسليم وقت التثبيت إلى 10 وحدات أو أقل. وإلا فقد يزيد وقت تنزيل التطبيق وتثبيته.
• لا يتوفر تنزيل وتثبيت الميزات عند الطلب إلّا للأجهزة التي تعمل بالإصدار 5.0 من نظام التشغيل Android (المستوى 21 من واجهة برمجة التطبيقات) والإصدارات الأحدث. لإتاحة الميزة للإصدارات السابقة من Android، فعِّل ميزة الدمج عند إنشاء وحدة لميزة.
• عليك تفعيل SplitCompat ليتمكن تطبيقك من الوصول إلى وحدات الميزات التي تم تنزيلها التي يتم تقديمها عند الطلب.
• يجب ألا تحدد وحدات الميزات أنشطة في ملف البيان عند ضبط android:exported على true. وذلك لأنه ليس هناك ما يضمن أن الجهاز قد نزّل وحدة الميزة عندما يحاول تطبيق آخر تشغيل النشاط. بالإضافة إلى ذلك، يجب أن يتأكد تطبيقك من أنّه تم تنزيل الميزة قبل محاولة الوصول إلى رمزها وموارده. لمزيد من المعلومات، يُرجى الاطّلاع على إدارة الوحدات المثبَّتة.
• ولأنّ ميزة "تقديم الميزات في Play" تتطلّب منك نشر تطبيقك باستخدام حِزمة تطبيق، عليك الاطّلاع على المشاكل المعروفة المتعلّقة بحزمة التطبيق.

مرجع بيان وحدة الميزات

عند إنشاء وحدة ميزات جديدة باستخدام "استوديو Android"، تتضمّن بيئة تطوير البرامج معظم سمات البيان التي تتطلّبها الوحدة لتعمل مثل وحدة الميزات. بالإضافة إلى ذلك، يتم إدخال بعض السمات من خلال نظام الإنشاء في وقت التجميع، لذلك لا تحتاج إلى تحديدها أو تعديلها بنفسك. يصف الجدول التالي سمات البيان المهمة لوحدات الميزات.

مراجع إضافية

لمعرفة المزيد حول استخدام وحدات الميزات، جرِّب الموارد التالية.

مشاركات المدونة

• ميزات جديدة لمساعدتك في تطوير نشاطك التجاري وإطلاقه وتطويره على Google Play
• آخر تحديثات مجموعة حزمات تطبيق Android، بما في ذلك واجهة برمجة التطبيقات للغات الإضافية
• Patchwork Plaid: قصة مقسّمة إلى وحدات

الفيديوهات الطويلة

• تقديم تجارب تسليم قابلة للتخصيص باستخدام "حزمة التطبيقات" ومشاركة الإصدارات التجريبية بسهولة
• أدوات جديدة لتحسين حجم تطبيقك وزيادة عمليات التثبيت على Google Play

بنود الخدمة وأمان البيانات

يشير الوصول إلى "مكتبة عرض الميزات في Play" أو استخدامها إلى موافقتك على بنود خدمة "مجموعة تطوير البرامج الأساسية في Play". يُرجى قراءة وفهم جميع البنود والسياسات السارية قبل الدخول إلى المكتبة.

أمان البيانات

مكتبات Play الأساسية هي واجهة تشغيل تطبيقك مع "متجر Google Play". وبالتالي، عند استخدام Play Core في تطبيقك، ينفِّذ "متجر Play" عملياته الخاصة، بما في ذلك معالجة البيانات وفقًا لبنود خدمة Google Play. توضّح المعلومات أدناه طريقة تعامل مكتبات Play الأساسية مع البيانات لمعالجة طلبات معيّنة من تطبيقك.

واجهة برمجة التطبيقات للغات الإضافية

عرض الميزات في Play

نسعى إلى الالتزام بالشفافية قدر الإمكان، إلا أنّك وحدك المسؤول عن تحديد كيفية الردّ على نموذج قسم "أمان البيانات" على Google Play بشأن ممارسات جمع بيانات المستخدمين ومشاركتها والحفاظ على أمانها في تطبيقك.