إنشاء تطبيق مصغّر بسيط

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

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

للحصول على معلومات عن طريقة تصميم الأداة، اطّلِع على نظرة عامة على أدوات التطبيقات.

مكونات الأداة

لإنشاء أداة، تحتاج إلى المكونات الأساسية التالية:

كائن AppWidgetProviderInfo

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

صف واحد (AppWidgetProvider)

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

عرض التنسيق

تحدِّد التنسيق الأولي للأداة. ويكون التنسيق محدّدًا في XML، كما هو موضّح في هذا المستند.

يوضح الشكل 2 كيف تتناسب هذه المكونات مع التدفق العام لمعالجة أداة التطبيق.

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

• بدءًا من نظام التشغيل Android 12 (المستوى 31 من واجهة برمجة التطبيقات)، يمكنك توفير إعدادات تلقائية والسماح للمستخدمين بإعادة ضبط الأداة لاحقًا. لمزيد من التفاصيل، راجِع استخدام الإعدادات التلقائية للأداة والسماح للمستخدمين بإعادة ضبط التطبيقات المصغّرة التي تم وضعها.
• في Android 11 (المستوى 30 لواجهة برمجة التطبيقات) أو الإصدارات الأقدم، يتم تشغيل هذا النشاط في كل مرة يضيف فيها المستخدم الأداة إلى شاشته الرئيسية.

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

يُرجى تعريف ملف AppWidgetProviderInfo XML.

يحدّد الكائن AppWidgetProviderInfo الصفات الأساسية للتطبيق المصغّر. حدِّد الكائن AppWidgetProviderInfo في ملف موارد XML باستخدام عنصر <appwidget-provider> واحد واحفظه في مجلد res/xml/ الخاص بالمشروع.

يظهر ذلك في المثال التالي:

<appwidget-provider xmlns:android="http://schemas.android.com/apk/res/android"
    android:minWidth="40dp"
    android:minHeight="40dp"
    android:targetCellWidth="1"
    android:targetCellHeight="1"
    android:maxResizeWidth="250dp"
    android:maxResizeHeight="120dp"
    android:updatePeriodMillis="86400000"
    android:description="@string/example_appwidget_description"
    android:previewLayout="@layout/example_appwidget_preview"
    android:initialLayout="@layout/example_loading_appwidget"
    android:configure="com.example.android.ExampleAppWidgetConfigurationActivity"
    android:resizeMode="horizontal|vertical"
    android:widgetCategory="home_screen"
    android:widgetFeatures="reconfigurable|configuration_optional">
</appwidget-provider>

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

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

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

يوضّح الجدول التالي سمات <appwidget-provider> المتعلقة بحجم التطبيقات المصغّرة:

مثال

لتوضيح كيفية تأثير السمات الواردة في الجدول السابق على حجم الأداة، افترض المواصفات التالية:

• يبلغ عرض خلية الشبكة 30 وحدة بكسل مستقلة الكثافة وطولها 50 بكسل مستقل الكثافة.
• يتم تقديم مواصفات السمات التالية:

<appwidget-provider xmlns:android="http://schemas.android.com/apk/res/android"
    android:minWidth="80dp"
    android:minHeight="80dp"
    android:targetCellWidth="2"
    android:targetCellHeight="2"
    android:minResizeWidth="40dp"
    android:minResizeHeight="40dp"
    android:maxResizeWidth="120dp"
    android:maxResizeHeight="120dp"
    android:resizeMode="horizontal|vertical" />

بدءًا من نظام التشغيل Android 12:

استخدِم السمتَين targetCellWidth وtargetCellHeight كحجم تلقائي للتطبيق المصغّر.

يكون حجم الأداة 2x2 افتراضيًا. يمكن تغيير حجم الأداة إلى 2×1 أو حتى 4×3.

نظام التشغيل Android 11 والإصدارات الأقدم:

استخدِم السمتَين minWidth وminHeight لاحتساب الحجم التلقائي للتطبيق المصغّر.

العرض التلقائي = Math.ceil(80 / 30) = 3

الارتفاع التلقائي = Math.ceil(80 / 50) = 2

يكون حجم الأداة 3 × 2 افتراضيًا. يمكن تغيير حجم الأداة إلى 2×1 أو إلى وضع ملء الشاشة.

السمات الإضافية للأداة

يوضّح الجدول التالي سمات <appwidget-provider> التي تتعلق بسمات أخرى غير حجم التطبيقات المصغّرة.

استخدام فئة AppWidgetProvider للتعامل مع عمليات بث التطبيقات المصغّرة

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

تعريف التطبيق المصغّر في البيان

أولاً، يجب تحديد الفئة AppWidgetProvider في ملف AndroidManifest.xml الخاص بتطبيقك، على النحو الموضّح في المثال التالي:

<receiver android:name="ExampleAppWidgetProvider"
                 android:exported="false">
    <intent-filter>
        <action android:name="android.appwidget.action.APPWIDGET_UPDATE" />
    </intent-filter>
    <meta-data android:name="android.appwidget.provider"
               android:resource="@xml/example_appwidget_info" />
</receiver>

يتطلّب العنصر <receiver> السمة android:name التي تحدّد السمة AppWidgetProvider التي تستخدمها الأداة. يجب عدم تصدير المكوِّن ما لم تكن هناك حاجة إلى بث عملية منفصلة على AppWidgetProvider، وهذا لا يحدث عادةً.

يجب أن يشتمل العنصر <intent-filter> على عنصر <action> مع السمة android:name. تحدد هذه السمة أنّ السمة AppWidgetProvider تقبل البث ACTION_APPWIDGET_UPDATE. هذا هو البث الوحيد الذي يجب الإعلان عنه صراحةً. ترسل AppWidgetManager تلقائيًا جميع عمليات بث التطبيقات المصغّرة الأخرى إلى AppWidgetProvider حسب الضرورة.

يحدد العنصر <meta-data> مورد AppWidgetProviderInfo ويتطلّب السمات التالية:

• android:name: تحدّد اسم البيانات الوصفية. استخدِم android.appwidget.provider لتحديد البيانات كأداة وصف AppWidgetProviderInfo.
• android:resource: تحدّد موقع الموارد AppWidgetProviderInfo.

تنفيذ فئة AppWidgetProvider

تزيد الفئة AppWidgetProvider من BroadcastReceiver كفئة ملائمة للتعامل مع عمليات بث التطبيقات المصغّرة. لن تتلقّى سوى عمليات بث الأحداث ذات الصلة بالأداة، مثل حالات تحديث الأداة وحذفها وتفعيلها وإيقافها. عند وقوع أحداث البث هذه، يُطلق على طريقة AppWidgetProvider التالية اسم:

onUpdate()

يسمى ذلك بتحديث الأداة على الفواصل الزمنية التي تحدّدها السمة updatePeriodMillis في AppWidgetProviderInfo. راجِع الجدول الذي يصف السمات الإضافية للأداة في هذه الصفحة للاطّلاع على مزيد من المعلومات.

تُسمّى هذه الطريقة أيضًا عندما يضيف المستخدم التطبيق المصغّر، ما يتيح له إجراء الإعداد الأساسي مثل تحديد معالِجات الأحداث لكائنات View أو بدء مهام لتحميل البيانات من أجل عرضها في التطبيق المصغَّر. ومع ذلك، إذا أعلنت عن نشاط ضبط بدون العلامة configuration_optional، لن يتم استدعاء هذه الطريقة عند إضافة المستخدم للأداة، ولكن يتم طلبها لإجراء التحديثات اللاحقة. ومن مسؤولية نشاط التهيئة أن يجري أول تحديث عند اكتمال التهيئة. راجع السماح للمستخدمين بضبط أدوات التطبيقات للحصول على مزيد من المعلومات.

أهم معاودة الاتصال هي onUpdate(). لمزيد من المعلومات، اطّلِع على مقالة التعامل مع الأحداث من خلال الفئة onUpdate() في هذه الصفحة للحصول على مزيد من المعلومات.

onAppWidgetOptionsChanged()

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

• OPTION_APPWIDGET_MIN_WIDTH: يحتوي على الحد الأدنى لعرض التطبيق المصغّر، بوحدات البكسل التدريجي.
• OPTION_APPWIDGET_MIN_HEIGHT: يحتوي على الحد الأدنى على ارتفاع نموذج التطبيق المصغّر، بوحدات البكسل التدريجي.
• OPTION_APPWIDGET_MAX_WIDTH: يحتوي على الحد الأعلى لعرض نسخة التطبيق المصغّر، بوحدات بكسل مستقل الكثافة.
• OPTION_APPWIDGET_MAX_HEIGHT: يحتوي على الحد الأعلى لارتفاع نموذج التطبيق المصغّر، بوحدات بكسل مستقلّة.
• OPTION_APPWIDGET_SIZES: تحتوي على قائمة بالأحجام المحتملة (List<SizeF>)، بوحدات dp، التي يمكن أن يتخذها مثيل الأدوات. تم طرح هذه الميزة في نظام التشغيل Android 12.

onDeleted(Context, int[])

ويسمى ذلك في كل مرة يتم فيها حذف تطبيق مصغّر من مضيف الأداة.

onEnabled(Context)

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

onDisabled(Context)

ويتم استدعاء هذه العملية عند حذف المثيل الأخير للتطبيق المصغَّر من مضيف الأدوات. ويمكنك هنا تنظيف أي عمل تم إجراؤه في onEnabled(Context)، مثل حذف قاعدة بيانات مؤقتة.

onReceive(Context, Intent)

ويتم استدعاء ذلك لكل عملية بث وقبل كل طريقة من طرق معاودة الاتصال السابقة. ولست بحاجة عادةً إلى تنفيذ هذه الطريقة لأنّ التنفيذ التلقائي AppWidgetProvider يؤدي إلى فلترة جميع عمليات بث التطبيقات المصغّرة واستدعاء الطرق السابقة حسب الحاجة.

يجب الإعلان عن تنفيذ الفئة AppWidgetProvider كمتلقّي بث باستخدام العنصر <receiver> في AndroidManifest. راجِع إعلان أداة في البيان ضمن هذه الصفحة للاطّلاع على مزيد من المعلومات.

التعامل مع الأحداث من خلال فئة onUpdate()

وأهم استدعاء لـ AppWidgetProvider هو onUpdate()، لأنّه يتم استدعاؤه عند إضافة كل تطبيق مصغّر إلى مضيف ما لم تستخدم نشاط ضبط بدون علامة configuration_optional. إذا كانت الأداة تقبل أي أحداث لتفاعل المستخدمين، سجِّل معالِجات الأحداث في معاودة الاتصال هذه. إذا لم ينشئ التطبيق المصغَّر ملفات مؤقتة أو قواعد بيانات أو ينفّذ عملاً آخر يتطلب إزالة البرامج غير المرغوب فيها، قد تكون onUpdate() هي طريقة معاودة الاتصال الوحيدة التي تحتاج إلى تحديدها.

على سبيل المثال، إذا كنت تريد أداة مصغَّرة تتضمّن زرًا يشغِّل نشاطًا عند النقر عليه، يمكنك استخدام طريقة التنفيذ التالية للسمة AppWidgetProvider:

class ExampleAppWidgetProvider : AppWidgetProvider() {

    override fun onUpdate(
            context: Context,
            appWidgetManager: AppWidgetManager,
            appWidgetIds: IntArray
    ) {
        // Perform this loop procedure for each widget that belongs to this
        // provider.
        appWidgetIds.forEach { appWidgetId ->
            // Create an Intent to launch ExampleActivity.
            val pendingIntent: PendingIntent = PendingIntent.getActivity(
                    /* context = */ context,
                    /* requestCode = */  0,
                    /* intent = */ Intent(context, ExampleActivity::class.java),
                    /* flags = */ PendingIntent.FLAG_UPDATE_CURRENT or PendingIntent.FLAG_IMMUTABLE
            )

            // Get the layout for the widget and attach an onClick listener to
            // the button.
            val views: RemoteViews = RemoteViews(
                    context.packageName,
                    R.layout.appwidget_provider_layout
            ).apply {
                setOnClickPendingIntent(R.id.button, pendingIntent)
            }

            // Tell the AppWidgetManager to perform an update on the current
            // widget.
            appWidgetManager.updateAppWidget(appWidgetId, views)
        }
    }
}

public class ExampleAppWidgetProvider extends AppWidgetProvider {

    public void onUpdate(Context context, AppWidgetManager appWidgetManager, int[] appWidgetIds) {
        // Perform this loop procedure for each widget that belongs to this
        // provider.
        for (int i=0; i < appWidgetIds.length; i++) {
            int appWidgetId = appWidgetIds[i];
            // Create an Intent to launch ExampleActivity
            Intent intent = new Intent(context, ExampleActivity.class);
            PendingIntent pendingIntent = PendingIntent.getActivity(
                /* context = */ context,
                /* requestCode = */ 0,
                /* intent = */ intent,
                /* flags = */ PendingIntent.FLAG_UPDATE_CURRENT | PendingIntent.FLAG_IMMUTABLE
            );

            // Get the layout for the widget and attach an onClick listener to
            // the button.
            RemoteViews views = new RemoteViews(context.getPackageName(), R.layout.example_appwidget_layout);
            views.setOnClickPendingIntent(R.id.button, pendingIntent);

            // Tell the AppWidgetManager to perform an update on the current app
            // widget.
            appWidgetManager.updateAppWidget(appWidgetId, views);
        }
    }
}

يحدد AppWidgetProvider طريقة onUpdate() فقط، ويستخدمها لإنشاء PendingIntent يؤدي تشغيل Activity وإرفاقه بزر التطبيق المصغّر باستخدام setOnClickPendingIntent(int, PendingIntent). ويتضمّن تكرارًا تكراريًا لكل إدخال في appWidgetIds، وهي مصفوفة من أرقام التعريف تحدّد كل تطبيق مصغّر أنشأه هذا الموفّر. إذا أنشأ المستخدم أكثر من مثيل واحد من الأداة، سيتم تحديثها جميعًا في آن واحد. ومع ذلك، تتم إدارة جدول زمني واحد فقط في updatePeriodMillis لجميع نُسخ الأداة. على سبيل المثال، إذا تم تحديد جدول التحديث كل ساعتين، وإضافة مثيل ثانٍ من الأداة بعد ساعة واحدة من الأول، سيتم تحديث كليهما خلال الفترة التي تحددها الأولى، مع تجاهل فترة التحديث الثانية. يتم تحديثهما كل ساعتين، وليس كل ساعة.

اطّلِع على نموذج الفئة ExampleAppWidgetProvider.java للحصول على مزيد من التفاصيل.

تلقّي أهداف بث التطبيق المصغّر

AppWidgetProvider هو فئة صغيرة. إذا كنت تريد تلقّي عمليات بث الأداة مباشرةً، يمكنك تنفيذ BroadcastReceiver الخاصة بك أو إلغاء استدعاء onReceive(Context,Intent). النوايا التي يجب الاهتمام بها هي ما يلي:

• ACTION_APPWIDGET_UPDATE
• ACTION_APPWIDGET_DELETED
• ACTION_APPWIDGET_ENABLED
• ACTION_APPWIDGET_DISABLED
• ACTION_APPWIDGET_OPTIONS_CHANGED

إنشاء تنسيق التطبيق المصغّر

يجب تحديد تنسيق أولي للأداة بتنسيق XML وحفظه في دليل res/layout/ الخاص بالمشروع. راجع إرشادات التصميم للحصول على التفاصيل.

يكون إنشاء تنسيق الأداة أمرًا بسيطًا إذا كنت على دراية بالتنسيقات. مع ذلك، تذكَّر أنّ تنسيقات التطبيقات المصغّرة تستند إلى السمة RemoteViews، التي لا تتوافق مع كل نوع من أدوات التنسيق أو العرض. لا يمكنك استخدام طرق عرض مخصّصة أو فئات فرعية لطرق العرض المتوافقة مع "RemoteViews".

يتوافق RemoteViews أيضًا مع ViewStub، وهو رمز View غير مرئي وبحجم صفري ويمكنك استخدامه لتضخيم موارد التنسيق عند وقت التشغيل.

دعم السلوك المرتبط بالحالة

يتيح نظام التشغيل Android 12 إمكانية سلوك المستخدم من خلال تحديد الحالة باستخدام المكوّنات الحالية التالية:

• CheckBox

• Switch

• RadioButton

لا تزال الأداة بلا حالة. يجب أن يخزّن تطبيقك الولاية ويسجّل أحداث التغيير في الولاية.

يوضّح مثال الرمز التالي كيفية تنفيذ هذه المكوّنات.

// Check the view.
remoteView.setCompoundButtonChecked(R.id.my_checkbox, true)

// Check a radio group.
remoteView.setRadioGroupChecked(R.id.my_radio_group, R.id.radio_button_2)

// Listen for check changes. The intent has an extra with the key
// EXTRA_CHECKED that specifies the current checked state of the view.
remoteView.setOnCheckedChangeResponse(
        R.id.my_checkbox,
        RemoteViews.RemoteResponse.fromPendingIntent(onCheckedChangePendingIntent)
)

// Check the view.
remoteView.setCompoundButtonChecked(R.id.my_checkbox, true);

// Check a radio group.
remoteView.setRadioGroupChecked(R.id.my_radio_group, R.id.radio_button_2);

// Listen for check changes. The intent has an extra with the key
// EXTRA_CHECKED that specifies the current checked state of the view.
remoteView.setOnCheckedChangeResponse(
    R.id.my_checkbox,
    RemoteViews.RemoteResponse.fromPendingIntent(onCheckedChangePendingIntent));

قدِّم تنسيقَين: أحدهما يستهدف الأجهزة التي تعمل بالإصدار 12 من نظام التشغيل Android أو الإصدارات الأحدث منه في res/layout-v31، والآخر يستهدف الأجهزة السابقة التي تعمل بالإصدار Android 11 أو الإصدارات الأقدم في مجلد res/layout التلقائي.

تنفيذ الزوايا المستديرة

يوفِّر الإصدار Android 12 مَعلمات النظام التالية لضبط أنصاف الزوايا المستديرة لتطبيقك المصغّر:

• system_app_widget_background_radius: نصف قطر الزاوية لخلفية الأداة، ولا يزيد أبدًا عن 28 بكسل مستقل الكثافة

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

يعرض المثال التالي تطبيقًا مصغّرًا يستخدم "system_app_widget_background_radius" لزاوية الأداة و "system_app_widget_inner_radius" للعروض داخل التطبيق المصغّر.

1 في الزاوية العلوية من التطبيق المصغّر.

2 زاوية عرض داخل التطبيق المصغّر.

اعتبارات مهمة للزوايا المستديرة

• ويمكن لمشغّلي تطبيقات الجهات الخارجية والشركات المصنّعة للأجهزة إلغاء المعلَمة system_app_widget_background_radius لتصبح أصغر من 28 بكسل مستقل الكثافة. تكون المعلمة system_app_widget_inner_radius دائمًا أقل من قيمة system_app_widget_background_radius بمقدار 8 بكسل مستقل الكثافة.
• إذا كان التطبيق المصغّر لا يستخدم العلامة @android:id/background أو كان يحدّد خلفية يتم فيها اقتصاص المحتوى استنادًا إلى المخطط، مع ضبط android:clipToOutline على true، سيحدّد مشغّل التطبيقات تلقائيًا الخلفية ويقسِّم التطبيق المصغّر باستخدام مستطيل بزوايا مستديرة يصل حجمها إلى 16 بكسل مستقل الكثافة. اطَّلِع على التأكد من توافق التطبيق المصغّر مع Android 12.

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

<resources>
  <attr name="backgroundRadius" format="dimension" />
</resources>

<resources>
  <style name="MyWidgetTheme">
    <item name="backgroundRadius">@dimen/my_background_radius_dimen</item>
  </style>
</resources>

<resources>
  <style name="MyWidgetTheme" parent="@android:style/Theme.DeviceDefault.DayNight">
    <item name="backgroundRadius">@android:dimen/system_app_widget_background_radius</item>
  </style>
</resources>

<shape xmlns:android="http://schemas.android.com/apk/res/android"
  android:shape="rectangle">
  <corners android:radius="?attr/backgroundRadius" />
  ...
</shape>

<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
  ...
  android:background="@drawable/my_widget_background" />