تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
تتيح التطبيقات المصغّرة للمستخدم إمكانية عرض محتوى رئيسي سريع وسريع
من التطبيق على شاشاته الرئيسية والمساحات المشابهة. يؤدي تحسين قابلية اكتشاف الأداة إلى ضمان إلمام المستخدمين بهذه الإضافات القوية لتطبيقك.
يكتشف المستخدمون أداتك ويضيفونها من خلال منتقي الأدوات، كما هو موضح من قائمة التطبيقات المصغَّرة التي تظهر عند الضغط مع الاستمرار على الشاشة الرئيسية أو على رمز التطبيق. على بعض الأجهزة، تعرض أداة اختيار التطبيقات المصغّرة قسمًا للاقتراحات
الذي يعرض جودة التطبيقات المصغّرة بالإضافة إلى ذلك، يمكنك الترويج لتطبيقك المصغّر في الأوقات المناسبة عندما تكون وظيفة الأداة أكثر صلة باهتماماتك. يصف هذا الدليل كيفية الترويج لتطبيقاتك المصغّرة بفعالية.
مقاسات الشعار
تخيَّل أداة اختيار التطبيقات المصغّرة كنافذة تسوّق. يكون الحجم الافتراضي للأداة هو عرضها الأولي، مما يترك انطباعًا أوليًا يمكن أن يؤثر بشكل كبير في عملية الاختيار. استخدِم حجمًا يعرض وظائف الأداة
بشكل فعّال بدون إرباك العرض.
لمزيد من المعلومات حول اختيار حجم تلقائي مناسب للأداة، راجِع المقاس.
عند التصميم بالحجم الافتراضي، ضع في اعتبارك عوامل شكل مختلفة مثل
الهواتف والأجهزة اللوحية والأجهزة القابلة للطي.
cancel
الإجراءات غير المُوصى بها
يمكنك ضبط الأحجام التلقائية نفسها على مستوى جميع أحجام الأجهزة، والتأكد من ضبط أحجام محدّدة وفقًا لكل أحجام شبكة لكل شكل من أشكال الأجهزة.
تجنَّب نشر إصدارات متعددة من حجم التطبيق المصغّر نفسه لعرض ألوان أو أشكال مختلفة فقط. بدلاً من ذلك، يمكنك دمج نشاط إعداد داخل التطبيق المصغّر للسماح للمستخدمين بتخصيص الألوان وتعزيز المرونة وتبسيط أداة اختيار التطبيقات المصغّرة.
cancel
الإجراءات غير المُوصى بها
يمكنك توفير العديد من التطبيقات المصغّرة للغرض نفسه، أو استخدام نشاط إعداد لتخصيص الأشكال.
معاينة المحتوى
يمكنك زيادة معدّل استخدام التطبيق المصغّر من خلال تقديم معاينة دقيقة وغنية بالمعلومات للمحتوى. من خلال النسخ المطابق للتخطيط والوظيفة الفعلية للأداة في المعاينة،
يمكنك تزويد المستخدمين بفهم واضح لما يمكن توقعه
بمجرد إضافته إلى شاشتهم الرئيسية.
cancel
الإجراءات غير المُوصى بها
اترك معاينة، حيث سيؤدي ذلك إلى أن تعرض معاينة الأداة رمز صورة التطبيق فقط.
check_circle
الإجراءات التي يُنصح بها
توفير معاينات عالية الجودة دقيقة لحجم التطبيق المصغّر
cancel
الإجراءات غير المُوصى بها
توفير معاينة غير دقيقة لحجم الأداة.
cancel
الإجراءات غير المُوصى بها
يمكنك تغيير شكل التطبيق المصغّر أو حجمه عندما يضعه المستخدم في البداية على الشاشة الرئيسية.
إذا كان التطبيق المصغّر متوافقًا مع الألوان الديناميكية، عليك تصميم المعاينات بحيث يتم عرضها أيضًا بتلك الألوان. قم بصياغة وصف واضح وموجز للتطبيق المصغّر
يقدم عرض قيمة واضح للمستخدم.
اكتشاف أداتك داخل التطبيق
يمكنك عرض خيار تثبيت التطبيقات المصغّرة ذات الصلة بشكل استباقي في اللحظات المناسبة للسياق في تطبيقك. وعند إجراء ذلك، يُرجى مراعاة العوامل التالية:
يمكنك عرض خيار تثبيت التطبيق المصغّر إذا كان ذلك مناسبًا أكثر استنادًا إلى إجراءات المستخدم داخل التطبيق. على سبيل المثال، بعد أن يكمل المستخدم إحدى المهام بنجاح من خلال تطبيق مصغّر مطابق، أو عندما يصل المستخدم بشكل متكرر إلى
ميزة يمكن تبسيطها باستخدام تطبيق مصغّر.
استخدِم تلميحات مرئية بسيطة مثل رمز أو صورة متحركة موجزة للفت الانتباه إلى خيار تثبيت تطبيق مصغّر.
يجب ألا يؤدي اقتراح تثبيت التطبيق المصغّر إلى حظر أو عرقلة إجراءات المستخدم الأساسية داخل تطبيقك.
يخضع كل من المحتوى وعيّنات التعليمات البرمجية في هذه الصفحة للتراخيص الموضحّة في ترخيص استخدام المحتوى. إنّ Java وOpenJDK هما علامتان تجاريتان مسجَّلتان لشركة Oracle و/أو الشركات التابعة لها.
تاريخ التعديل الأخير: 2025-07-27 (حسب التوقيت العالمي المتفَّق عليه)
[[["يسهُل فهم المحتوى.","easyToUnderstand","thumb-up"],["ساعَدني المحتوى في حلّ مشكلتي.","solvedMyProblem","thumb-up"],["غير ذلك","otherUp","thumb-up"]],[["لا يحتوي على المعلومات التي أحتاج إليها.","missingTheInformationINeed","thumb-down"],["الخطوات معقدة للغاية / كثيرة جدًا.","tooComplicatedTooManySteps","thumb-down"],["المحتوى قديم.","outOfDate","thumb-down"],["ثمة مشكلة في الترجمة.","translationIssue","thumb-down"],["مشكلة في العيّنات / التعليمات البرمجية","samplesCodeIssue","thumb-down"],["غير ذلك","otherDown","thumb-down"]],["تاريخ التعديل الأخير: 2025-07-27 (حسب التوقيت العالمي المتفَّق عليه)"],[],[],null,["# Discovery and promotion\n\nApp widgets allow your user to deliver key glanceable content and quick actions\nfrom your app on their home screens and similar surfaces. Improving your\nwidget's discoverability ensures users are aware of these powerful extensions of\nyour app.\n\nUsers discover and add your widget through the widget picker, as shown from\nthe **Widgets** menu that appears when they long-press on the home screen or on\nyour app icon. On some devices, the widget picker displays a suggestions section\nthat shows quality widgets. Additionally, you can promote your widget from\nwithin your app at relevant moments when the widget's functionality is most\nrelevant. This guide describes how to to effectively promote your widgets.\n\nSizing\n------\n\nImagine the widget picker as a shopping window. Your widget's default size is\nits initial display, making a first impression that can greatly influence\nselection. Use a size that effectively showcases your widget's functionality\nwithout cluttering the view.\n\nFor more information on choosing an appropriate default size for your widget,\nsee [Sizing](/design/ui/mobile/guides/widgets/sizing).\n| **Tip:** Specify the `targetCellWidth` and `targetCellHeight` to one of the sizes discussed in the sizing guidance. Ensure that the minimum sizes specified meets the target cell size across most devices in portrait and landscape orientation.\n\nWhen designing for the default size, consider different form factors such as\nphones, tablets and foldables. \ncancel\n\n### Don't\n\nSet the same default sizes across all device sizes, make sure to set specific sizes based of each form factors grid sizes.\n\nAvoid publishing multiple versions of the same widget size solely to offer\ndifferent colors or shapes. Instead, incorporate a configuration activity within\nthe widget to allow users to customize colors, enhancing flexibility and\nstreamline the widget picker. \ncancel\n\n### Don't\n\nProvide multiple widgets with the same purpose, instead use a configuration activity to customize shapes.\n\nContent preview\n---------------\n\nDrive user adoption of your widget by providing an accurate and informative\ncontent preview. By mirroring the actual layout and functionality of the widget\nin the preview, you provide users with a clear understanding of what they can\nexpect once they add it to their home screen. \ncancel\n\n### Don't\n\nLeave out a preview, as this will cause the widget preview to show only an image app icon. \ncheck_circle\n\n### Do\n\nProvide quality previews that are accurate to the widget size. \ncancel\n\n### Don't\n\nProvide a preview that isn't accurate to the widget size.\n**Tip:** You can specify a layout xml resource for your previews using `android:previewLayout`. For more information, see [Improve widget picker experience](/develop/ui/views/appwidgets/enhance#improve-widget-picker-experience). \ncancel\n\n### Don't\n\nChange the widget's shape or size when the user initially drops it onto the home screen.\n\nIf your widget supports dynamic colors, design your previews to also display in\nthose colors. Craft a clear and concise description for your widget that\nprovides a clear value proposition for the user.\n\nIn-app discovery of your widget\n-------------------------------\n\nYou can proactively surface the option to pin relevant widgets at contextually\nappropriate moments in your app. When doing so keep the following factors in\nmind:\n\n- Present the pin widget option when it makes the most sense based on the user's actions within the app. For example, after a user successfully completes a task that has a corresponding widget or When a user repeatedly accesses a feature that could be streamlined with a widget.\n- Use subtle visual hints such as an icon or a brief animation to draw attention to the option to pin a widget.\n- The widget pinning suggestion should never block or hinder the user's primary actions within your app.\n\nFor more information, see [Let users pin a widget](/develop/ui/views/appwidgets/discoverability#pin) to configure widget\npinning from within your app."]]