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

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

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

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

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

لا ينشر استوديو Android تطبيقك تلقائيًا باستخدام حِزم التطبيقات لنشر تطبيقك، بل تنشئ بيئة التطوير المتكاملة (IDE) حِزم APK وتثبّتها على جهازك، وتكون هذه الحِزم محسّنة لسرعة النشر بدلاً من حجم حزمة APK. لضبط استوديو Android لإنشاء حِزم 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) هذا من خلال تطبيقك للوصول إلى مورد وحدة الميزات.

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

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

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

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

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

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

مراجع إضافية

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

منشورات المدوّنات

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

الفيديوهات

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

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

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

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

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

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

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

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