ضبط التسليم الفوري

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

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

• الحد الأقصى للحجم: يجب ألا يزيد الحجم الإجمالي للوحدة الأساسية التي تم تفعيل ميزة التطبيقات الفورية فيها ووحدة الميزات التي تم تفعيل ميزة التطبيقات الفورية فيها عن 10 ميغابايت. لمزيد من المعلومات، يُرجى الاطّلاع على مقالة تفعيل التجارب الفورية من خلال تقليل حجم التطبيق أو اللعبة.
• النشاط في الخلفية: لا يمكن للوحدة التي تم تفعيل ميزة التطبيقات الفورية فيها استخدام الخدمات التي تُشغَّل في الخلفية. بالإضافة إلى ذلك، لا يمكن لهذه الوحدة إرسال إشعارات عند تشغيلها في الخلفية.

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

<manifest xmlns:dist="http://schemas.android.com/apk/distribution"
    ... >
    <dist:module dist:instant="true" />
    ...

بالإضافة إلى ذلك، عند تنزيل تطبيقك وتثبيته، يتم تلقائيًا تنزيل وحدات الميزات التي تم تفعيل ميزة التطبيقات الفورية فيها وتثبيتها مع حزمة APK الأساسية لتطبيقك. لذلك، تتضمّن بيئة التطوير المتكاملة أيضًا ما يلي في وحدة الميزات التي تم تفعيل ميزة التطبيقات الفورية فيها.

    <dist:module ...>
        <dist:delivery>
            <dist:install-time />
        </dist:delivery>
    </dist:module>

يعني هذا السلوك أنّه عند ضبط dist:instant="true"، لا يمكنك أيضًا تضمين <dist:on-demand />. ومع ذلك، يمكنك طلب الوحدات التي تم تفعيل ميزة التطبيقات الفورية فيها عند الحاجة ضمن التجربة الفورية للتطبيق باستخدام مكتبة عرض الميزات في Play.

ضبط وحدة جديدة للتسليم الفوري

لإضافة وحدة ميزات تم تفعيل ميزة التطبيقات الفورية فيها إلى مشروع تطبيقك باستخدام "استوديو Android"، اتّبِع الخطوات التالية:

1. افتح مشروع تطبيقك في بيئة التطوير المتكاملة (IDE)، إذا لم يسبق لك إجراء ذلك.
2. اختَر ملف (File) > جديد (New) > وحدة جديدة (New Module) من شريط القوائم.
3. في مربّع الحوار إنشاء وحدة جديدة، اختَر وحدة ميزات ديناميكية للتطبيقات الفورية وانقر على التالي.

4. في قسم ضبط الوحدة الجديدة، أكمِل ما يلي:

   1. اختَر وحدة التطبيق الأساسية لمشروع تطبيقك من القائمة المنسدلة.
   2. حدِّد اسم الوحدة. تستخدم بيئة التطوير المتكاملة هذا الاسم لتحديد الوحدة كمشروع فرعي في Gradle في ملف إعدادات Gradle. عند إنشاء حِزمة تطبيقك، يستخدم Gradle العنصر الأخير من اسم المشروع الفرعي لإدخال السمة <manifest split> في ملف بيان وحدة الميزات.
   3. حدِّد اسم حزمة الوحدة. يقترح استوديو Android تلقائيًا اسم حزمة يجمع بين اسم الحزمة الجذر للوحدة الأساسية واسم الوحدة الذي حدّدته في الخطوة السابقة.
   4. اختَر الحدّ الأدنى لمستوى واجهة برمجة التطبيقات الذي تريد أن تتوافق معه الوحدة. يجب أن تتطابق هذه القيمة مع قيمة الوحدة الأساسية.

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

      <dist:module
          ...
          dist:title="@string/feature_title">
      </dist:module>
      

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

   6. ضَع علامة في المربّع بجانب دمج إذا أردت أن تكون هذه الوحدة متاحة للأجهزة التي تعمل بنظام التشغيل Android 4.4 (مستوى واجهة برمجة التطبيقات 20) والإصدارات الأقدم والمضمّنة في حِزم APK المتعددة. يُدخل "استوديو Android" ما يلي في بيان الوحدة لإظهار اختيارك.

      <dist:module>
          <dist:fusing dist:include="true" />
      </dist:module>
      

5. انقر على إنهاء.

بعد أن ينتهي "استوديو Android" من إنشاء الوحدة، يمكنك فحص محتواها بنفسك من لوحة المشروع (Project) (انقر على عرض (View) > نوافذ الأدوات (Tool Windows) > المشروع (Project) من شريط القوائم). يجب أن يكون الرمز والموارد والتنظيم التلقائي مشابهًا لتلك الموجودة في وحدة التطبيق العادية.

بعد تنفيذ ميزة تريد تنزيلها عند الطلب، تعرَّف على كيفية طلبها باستخدام مكتبة عرض الميزات في Play.

نشر تطبيقك

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

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

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

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