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

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

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

إعدادات تصميم وحدة الميزات

عند إنشاء وحدة ميزات جديدة باستخدام "استوديو Android"، يطبّق بيئة التطوير المتكاملة مكوّن 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 Studio وحدة الميزات، يتيح ظهورها لوحدة التطبيق الأساسي من خلال إضافة السمة 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 Studio تطبيقك تلقائيًا باستخدام حِزم التطبيقات، بل ينشئ بيئة التطوير المتكاملة حِزم APK ويُثبّتها على جهازك، وهي حِزم محسَّنة من حيث سرعة النشر وليس حجم حِزمة APK. لإعداد Android Studio لإنشاء حِزم APK وتجارب فورية ونشرها من حِزمة تطبيق بدلاً من ذلك، عليك تعديل إعدادات التشغيل/تصحيح الأخطاء.

استخدام وحدات الميزات لتخصيص عملية التسليم

تتمثّل إحدى المزايا الفريدة لوحدات الميزات في إمكانية تخصيص طريقة تنزيل الميزات المختلفة لتطبيقك على الأجهزة التي تعمل بالإصدار 5.0 من نظام التشغيل Android (المستوى 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)، يمكنك استخدام أداة تحليل حِزم APK لفحص حزمة APK الخاصة بوحدة الميزات وتحديد اسم الحزمة:

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

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

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

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

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

مراجع إضافية

لمزيد من المعلومات حول استخدام الوحدات النمطية للميزات، يمكنك تجربة المراجع التالية.

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

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

الفيديوهات

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

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

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

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

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

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

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

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