توفير تنسيقات مرنة للتطبيقات المصغّرة

توضّح هذه الصفحة التحسينات التي تم إجراؤها على حجم التطبيقات المصغّرة وزيادة المرونة التي تم تقديمها في الإصدار 12 من Android (المستوى 31 لواجهة برمجة التطبيقات). ويوضّح أيضًا كيفية تحديد حجم التطبيق المصغّر.

استخدام واجهات برمجة تطبيقات محسّنة لتنسيقات وأشكال التطبيقات المصغّرة

بدءًا من الإصدار Android 12 (المستوى 31 من واجهة برمجة التطبيقات)، يمكنك توفير حجم أكثر تنقيحًا. والتخطيطات المرنة عن طريق اتباع ما يلي، كما هو موضح في الأقسام التالية:

1. تحديد قيود إضافية لحجم التطبيقات المصغّرة

2. توفير تنسيقات متجاوبة أو تنسيقات دقيقة التصميم.

في الإصدارات السابقة من Android، كان من الممكن الحصول على نطاقات أحجام التطبيقات المصغّرة باستخدام الإضافات OPTION_APPWIDGET_MIN_WIDTH، OPTION_APPWIDGET_MIN_HEIGHT، OPTION_APPWIDGET_MAX_WIDTH، وOPTION_APPWIDGET_MAX_HEIGHT، ثم تقدير حجم التطبيق المصغّر، ولكن لا يعمل هذا المنطق في كل الحالات. بالنسبة إلى التطبيقات المصغّرة التي تستهدف الإصدار 12 من نظام التشغيل Android أو الإصدارات الأحدث، ننصح بتوفير تنسيقات متجاوبة أو بالضبط .

تحديد قيود إضافية لحجم التطبيقات المصغّرة

يضيف نظام التشغيل Android 12 واجهات برمجة تطبيقات تتيح لك التأكّد من تحديد حجم التطبيقات المصغّرة بشكل أكثر موثوقية على الأجهزة المختلفة التي تختلف أحجام شاشاتها.

بالإضافة إلى minWidth الحالية، minHeight، minResizeWidth, وminResizeHeight السمات، فاستخدم السمات appwidget-provider الجديدة التالية:

• targetCellWidth وtargetCellHeight: تحديد الحجم المستهدف للتطبيق المصغّر من حيث خلايا شبكة مشغّل التطبيقات في حال حذف محددة، يتم استخدام هاتين السمتين بدلاً من minWidth أو minHeight.

• maxResizeWidth وmaxResizeHeight: تحديد الحد الأقصى للحجم الذي يسمح المشغل للمستخدم بتغيير حجم الأداة إليه.

يوضح XML التالي كيفية استخدام سمات المقاس.

<appwidget-provider
  ...
  android:targetCellWidth="3"
  android:targetCellHeight="2"
  android:maxResizeWidth="250dp"
  android:maxResizeHeight="110dp">
</appwidget-provider>

توفير تخطيطات سريعة الاستجابة

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

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

يوضح مثال الرمز التالي كيفية تقديم قائمة بالتنسيقات.

Kotlin

override fun onUpdate(...) {
    val smallView = ...
    val tallView = ...
    val wideView = ...

    val viewMapping: Map<SizeF, RemoteViews> = mapOf(
            SizeF(150f, 100f) to smallView,
            SizeF(150f, 200f) to tallView,
            SizeF(215f, 100f) to wideView
    )
    val remoteViews = RemoteViews(viewMapping)

    appWidgetManager.updateAppWidget(id, remoteViews)
}

Java

@Override
public void onUpdate(...) {
    RemoteViews smallView = ...;
    RemoteViews tallView = ...;
    RemoteViews wideView = ...;

    Map<SizeF, RemoteViews> viewMapping = new ArrayMap<>();
    viewMapping.put(new SizeF(150f, 100f), smallView);
    viewMapping.put(new SizeF(150f, 200f), tallView);
    viewMapping.put(new SizeF(215f, 100f), wideView);
    RemoteViews remoteViews = new RemoteViews(viewMapping);

    appWidgetManager.updateAppWidget(id, remoteViews);
}

لنفترض أن التطبيق المصغّر يحتوي على السمات التالية:

<appwidget-provider
    android:minResizeWidth="160dp"
    android:minResizeHeight="110dp"
    android:maxResizeWidth="250dp"
    android:maxResizeHeight="200dp">
</appwidget-provider>

يعني مقتطف الرمز السابق ما يلي:

• يتوافق smallView مع المقاسات من 160dp (minResizeWidth) × 110dp (minResizeHeight) إلى 160dp × 199dp (نقطة الحدّ الأدنى التالية هي 1dp).
• تتوفّر ميزة "tallView" من 160 بكسل مستقل الكثافة × 200 بكسل مستقل الكثافة إلى 214 بكسل مستقل الكثافة (نقطة النهاية التالية - 1) × 200 بكسل مستقل الكثافة.

• يتوافق wideView مع الحجم الذي يتراوح بين 215dp × 110dp (minResizeHeight) و250 (maxResizeWidth) × 200dp (maxResizeHeight).

  ملاحظة: من الممكن أن يكون حجم الأداة أكبر من maxResizeWidth × maxResizeHeight. الاطّلاع على تغيير حجم التطبيقات المصغّرة السمات لمعرفة المزيد من التفاصيل.

يجب أن يتيح التطبيق المصغّر نطاق الحجم من minResizeWidth × minResizeHeight إلى maxResizeWidth × maxResizeHeight. ضمن هذا النطاق، يمكنك تحديد نقطة الانقطاع لتبديل التخطيطات.

الشكل 1. مثال على تنسيق متجاوب

تقديم تنسيقات دقيقة

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

لتنفيذ هذا الحل، يجب أن ينفِّذ تطبيقك الخطوات التالية:

1. حدث "الحمولة الزائدة" AppWidgetProvider.onAppWidgetOptionsChanged()، الذي يتم استدعاؤه عند تغيير مجموعة الأحجام

2. استخدِم AppWidgetManager.getAppWidgetOptions()، الذي يعرض Bundle يحتوي على الأحجام.

3. الوصول إلى مفتاح AppWidgetManager.OPTION_APPWIDGET_SIZES من Bundle

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

يوضّح مثال الرمز البرمجي التالي كيفية تقديم تنسيقات دقيقة.

Kotlin

override fun onAppWidgetOptionsChanged(
        context: Context,
        appWidgetManager: AppWidgetManager,
        id: Int,
        newOptions: Bundle?
) {
    super.onAppWidgetOptionsChanged(context, appWidgetManager, id, newOptions)
    // Get the new sizes.
    val sizes = newOptions?.getParcelableArrayList<SizeF>(
            AppWidgetManager.OPTION_APPWIDGET_SIZES
    )
    // Check that the list of sizes is provided by the launcher.
    if (sizes.isNullOrEmpty()) {
        return
    }
    // Map the sizes to the RemoteViews that you want.
    val remoteViews = RemoteViews(sizes.associateWith(::createRemoteViews))
    appWidgetManager.updateAppWidget(id, remoteViews)
}

// Create the RemoteViews for the given size.
private fun createRemoteViews(size: SizeF): RemoteViews { }

Java

@Override
public void onAppWidgetOptionsChanged(
    Context context, AppWidgetManager appWidgetManager, int appWidgetId, Bundle newOptions) {
    super.onAppWidgetOptionsChanged(context, appWidgetManager, appWidgetId, newOptions);
    // Get the new sizes.
    ArrayList<SizeF> sizes =
        newOptions.getParcelableArrayList(AppWidgetManager.OPTION_APPWIDGET_SIZES);
    // Check that the list of sizes is provided by the launcher.
    if (sizes == null || sizes.isEmpty()) {
      return;
    }
    // Map the sizes to the RemoteViews that you want.
    Map<SizeF, RemoteViews> viewMapping = new ArrayMap<>();
    for (SizeF size : sizes) {
        viewMapping.put(size, createRemoteViews(size));
    }
    RemoteViews remoteViews = new RemoteViews(viewMapping);
    appWidgetManager.updateAppWidget(id, remoteViews);
}

// Create the RemoteViews for the given size.
private RemoteViews createRemoteViews(SizeF size) { }

تحديد حجم التطبيق المصغّر

يجب أن يحدِّد كل تطبيق مصغّر targetCellWidth وtargetCellHeight للأجهزة التي تعمل بالإصدار 12 من نظام التشغيل Android أو الإصدارات الأحدث، أو minWidth وminHeight لجميع إصدارات Android، ما يشير إلى الحد الأدنى للمساحة التي يستهلكها التطبيق المصغّر تلقائيًا. ومع ذلك، عندما يضيف المستخدمون أداة إلى الشاشة الرئيسية، فإنه بشكل عام أكثر من الحد الأدنى للعرض والارتفاع اللذين تحدّدهما.

توفر شاشات Android الرئيسية للمستخدمين شبكة من المساحات المتاحة التي يمكنهم استخدام التطبيقات المصغّرة والأيقونات. يمكن أن تختلف هذه الشبكة حسب الجهاز؛ على سبيل المثال، العديد من توفر الهواتف المحمولة شبكة 5×4، ويمكن أن توفر الأجهزة اللوحية شبكة أكبر. عندما يبدأ تطبيقك المصغّر تضاف، فإنها تمدد لشغل الحد الأدنى من عدد الخلايا، أفقيًا وعموديًا، مطلوبة لتلبية قيود "targetCellWidth" و"targetCellHeight" على أجهزة قيد التشغيل Android 12 أو الإصدارات الأحدث، أو minWidth وminHeight هناك قيود على الأجهزة التي تعمل بنظام التشغيل Android 11 (المستوى 30 لواجهة برمجة التطبيقات) أو الإصدارات الأقدم.

يمكن أن يختلف عرض الخلية وارتفاعها وحجم الهوامش التلقائية المطبَّقة على التطبيقات المصغّرة على مختلف الأجهزة. استخدِم الجدول التالي لتقدير الحد الأدنى لأبعاد الأداة في هاتف شبكي نموذجي 5×4، مع الأخذ في الاعتبار عدد خلايا الشبكة المشغولة التي تريدها:

عدد الخلايا (العرض × الارتفاع)	الحجم المتاح في الوضع العمودي (dp)	الحجم المتاح في الوضع الأفقي (dp)
1x1	57×102 بكسل مستقل الكثافة	‫127×51dp
‫2x1	‫130x102dp	‫269x51dp
3×1	203×102 بكسل مستقل الكثافة	412×51 بكسل مستقل الكثافة
4×1	‫276x102dp	554×51 بكسل مستقل الكثافة
5x1	‫349x102dp	‫697×51dp
5×2	‫349x220dp	‫697×117dp
5×3	349 × 337 بكسل مستقل الكثافة	‫697×184dp
5×4	‫349x455dp	‫697×250dp
...	...	...
n x m	‫(73n - 16) x (118m - 16)	(142n - 15) x (66m - 15)

ملاحظة: يعرض الجدول السابق المقاسات المتاحة على هاتف Google Pixel 4 حتى إظهار التقدير التقريبي للأحجام العامة المتاحة في كل من الصور العمودية والأوضاع الأفقية

استخدِم أحجام الخلايا في الوضع العمودي لتحديد القيم التي تقدّمها السمات minWidth وminResizeWidth وmaxResizeWidth وبالمثل، استخدِم أحجام الخلايا في الوضع الأفقي لتحديد القيم التي تقدّمها للسمات minHeight وminResizeHeight وmaxResizeHeight

ويعود السبب في ذلك إلى أنّ عرض الخلية يكون عادةً أصغر في الوضع العمودي مقارنةً بالوضع الأفقي، وبالمثل، يكون ارتفاع الخلية عادةً أصغر في الوضع الأفقي مقارنةً بالوضع العمودي.

على سبيل المثال، إذا كنت تريد تغيير حجم عرض الأداة إلى خلية واحدة على Google Pixel 4، يجب ضبط minResizeWidth على 56 وحدة بكسل مستقلة الكثافة (dp) كحدّ أقصى للتأكّد من أنّ قيمة سمة minResizeWidth أصغر من 57dp - لأن عرض الخلية لا يقل عن 57 بكسل مستقل الكثافة في الوضع العمودي. وبالمثل، إذا كنت تريد أن يكون ارتفاع التطبيق المصغّر قابلاً للتغيير في خلية واحدة على الجهاز نفسه، عليك ضبط minResizeHeight على 50dp كحد أقصى للتأكّد من أنّ قيمة سمة minResizeHeight أصغر من 51dp، لأنّ ارتفاع الخلية الواحدة هو 51dp على الأقل في الوضع الأفقي.

يمكن تغيير حجم كل تطبيق مصغّر ضمن نطاقات الأحجام بين minResizeWidth/minResizeHeight وmaxResizeWidth/maxResizeHeight السمات، مما يعني أنها بحاجة إلى التكيف مع أي نطاقات أحجام بينها.

ملاحظة: كما ذكرنا سابقًا، من الممكن أن يكون حجم التطبيق المصغّر أكبر من maxResizeWidth x maxResizeHeight. اطّلِع على سمات تحديد حجم التطبيقات المصغّرة لمزيد من التفاصيل.

على سبيل المثال، لضبط الحجم التلقائي للأداة في موضعها، يمكنك اضبط السمات التالية:

<appwidget-provider
    android:targetCellWidth="3"
    android:targetCellHeight="2"
    android:minWidth="180dp"
    android:minHeight="110dp">
</appwidget-provider>

هذا يعني أن الحجم الافتراضي للتطبيق المصغّر هو 3×2 الخلايا، كما هو محدد من خلال targetCellWidth وtargetCellHeight — أو 180×110 بكسل مستقل الكثافة، بحيث المحدد في minWidth وminHeight للأجهزة التي تعمل الإصدار 11 من نظام التشغيل Android أو الإصدارات الأقدم وفي الحالة الثانية، يمكن أن تختلف باختلاف الجهاز.

لضبط نطاقات الأحجام المتوافقة لأداة التطبيقات المصغّرة، يمكنك أيضًا ضبط السمات التالية:

<appwidget-provider
    android:minResizeWidth="180dp"
    android:minResizeHeight="110dp"
    android:maxResizeWidth="530dp"
    android:maxResizeHeight="450dp">
</appwidget-provider>

وفقًا لما هو محدّد في السمات السابقة، يمكن تغيير حجم عرض التطبيق المصغّر من 180dp إلى 530dp، ويمكن تغيير حجم ارتفاعه من 110dp إلى 450dp. يمكن بعد ذلك تغيير حجم التطبيق المصغّر من 3×2 إلى 5×2 خلية، شرط استيفاء الشروط التالية:

• يحتوي الجهاز على شبكة 5×4.
• التعيين بين عدد الخلايا والحجم المتاح بالبكسلة في الثانية يتبع الجدول الذي يوضح تقدير الحد الأدنى الأبعاد في هذه الصفحة.
• وتتكيّف الأداة مع نطاق الحجم هذا.

Kotlin

val smallView = RemoteViews(context.packageName, R.layout.widget_weather_forecast_small)
val mediumView = RemoteViews(context.packageName, R.layout.widget_weather_forecast_medium)
val largeView = RemoteViews(context.packageName, R.layout.widget_weather_forecast_large)

val viewMapping: Map<SizeF, RemoteViews> = mapOf(
        SizeF(180f, 110f) to smallView,
        SizeF(270f, 110f) to mediumView,
        SizeF(270f, 280f) to largeView
)

appWidgetManager.updateAppWidget(appWidgetId, RemoteViews(viewMapping))

Java

RemoteViews smallView = 
    new RemoteViews(context.getPackageName(), R.layout.widget_weather_forecast_small);
RemoteViews mediumView = 
    new RemoteViews(context.getPackageName(), R.layout.widget_weather_forecast_medium);
RemoteViews largeView = 
    new RemoteViews(context.getPackageName(), R.layout.widget_weather_forecast_large);

Map<SizeF, RemoteViews> viewMapping = new ArrayMap<>();
viewMapping.put(new SizeF(180f, 110f), smallView);
viewMapping.put(new SizeF(270f, 110f), mediumView);
viewMapping.put(new SizeF(270f, 280f), largeView);
RemoteViews remoteViews = new RemoteViews(viewMapping);

appWidgetManager.updateAppWidget(id, remoteViews);

لنفترض أن الأداة تستخدم التخطيطات سريعة الاستجابة المحددة في الأقسام السابقة من مقتطفات التعليمات البرمجية. وهذا يعني أنّ التنسيق المحدّد على أنّه R.layout.widget_weather_forecast_small يتم استخدامه من 180dp (minResizeWidth) x 110dp (minResizeHeight) إلى 269x279dp (نقاط القطع التالية - 1). وبالمثل، يتم استخدام R.layout.widget_weather_forecast_medium من 270x110dp إلى 270x279dp، وتستخدم R.layout.widget_weather_forecast_large من حجم 270x280 بكسل مستقل الكثافة 530 بكسل مستقل الكثافة (maxResizeWidth) × 450 بكسل مستقل الكثافة (maxResizeHeight).

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

الشكل 2. ‎3×2 R.layout.widget_weather_forecast_small.

الشكل 3. ‎4×2 R.layout.widget_weather_forecast_medium.

الشكل 4. 5×2 R.layout.widget_weather_forecast_medium.

الشكل 5. 5x3 R.layout.widget_weather_forecast_large.

الشكل 6. 5×4 R.layout.widget_weather_forecast_large.