نظرة عامة على عرض الميزات في 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" تلقائيًا تطبيقك باستخدام حِزم التطبيقات لنشره. تطبيقك. بدلاً من ذلك، يرتكز بيئة التطوير المتكاملة ينشئ ويثبّت ملفات APK على جهازك محسّنة لسرعة النشر، بدلاً من حجم ملف APK. لإعداد "استوديو Android" من أجل إنشاء التطبيق ونشره بدلاً من ذلك حِزم 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 (المستوى 21 من واجهة برمجة التطبيقات) والإصدارات الأحدث من نظام التشغيل Android فقط تنزيل الميزات وتثبيتها عند الطلب. لإتاحة الميزة على الإصدارات السابقة من Android، مكِّن الدمج عند إنشاء وحدة ميزة.
• فعِّل SegmentCompat (تقسيم)، حتى يتمكّن التطبيق من الوصول إلى وحدات الميزات التي تم تنزيلها والتي يتم عرضها على الطلب.
• يجب ألا تحدد وحدات الميزات الأنشطة في ملف البيان الخاص بها مع تم ضبط android:exported على true هذا لأنه ليس هناك ما يضمن أن الجهاز نزّل وحدة الميزة عند محاولة تطبيق آخر تشغيل الأخرى. بالإضافة إلى ذلك، يجب أن يؤكّد تطبيقك أنّ الميزة تم تنزيله قبل محاولة الوصول إلى التعليمات البرمجية والموارد الخاصة به. لمزيد من المعلومات، يُرجى قراءة إدارة الوحدات المثبَّتة:
• وبما أنّ ميزة "عرض الميزات في Play" تتطلّب منك نشر تطبيقك باستخدام حِزمة تطبيق، تأكّد من أنّك على عِلم بحِزمة التطبيق المشاكل المعروفة.

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

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

مصادر إضافية

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

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

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

الفيديوهات

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

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

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

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

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

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

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

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