إعداد ميزة "العرض حتى حافة الشاشة"

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

1. استهداف الإصدار 15 من نظام التشغيل Android (المستوى 35 لواجهة برمجة التطبيقات) أو الإصدارات الأحدث لتفعيل وضع "من الحافة إلى الحافة" على الإصدار 15 من نظام التشغيل Android والإصدارات الأحدث يظهر تطبيقك خلف واجهة مستخدم النظام. يمكنك تعديل واجهة المستخدم لتطبيقك من خلال التعامل مع المساحات المتروكة.
2. يمكنك اختياريًا استدعاء enableEdgeToEdge() في Activity.onCreate()، ما يتيح لتطبيقك العرض حتى حافة الشاشة على إصدارات Android القديمة.

3. اضبط android:windowSoftInputMode="adjustResize" في إدخال AndroidManifest.xml في "النشاط". يسمح هذا الإعداد لتطبيقك بتلقّي حجم أداة IME البرمجية كإضافات، ما يساعدك في تطبيق التنسيق والحشو المناسبَين عند ظهور أداة IME واختفائها في تطبيقك.

   <!-- In your AndroidManifest.xml file: -->
   <activity
     android:name=".ui.MainActivity"
     android:label="@string/app_name"
     android:windowSoftInputMode="adjustResize"
     android:theme="@style/Theme.MyApplication"
     android:exported="true">
   

4. التعامل مع مواضع الإدخال لكي لا تتداخل واجهة المستخدم المهمة مع أشرطة النظام أو موضع القطع على الشاشة يمكنك التعامل مع عمليات الإدراج باستخدام المساطر أو عناصر تعديل المساحة المتروكة أو عناصر تعديل حجم الإدراج. تتعامل بعض مكوّنات التصميم المتعدد الأبعاد تلقائيًا مع المساحات المتروكة الداخلية أو تتضمّن مَعلمات لتسهيل التعامل مع المساحات المتروكة الداخلية، مثل المَعلمة PaddingValues في Scaffold. اختَر إحدى طرق التعامل مع الحواف الداخلية. على سبيل المثال، استخدِم Scaffold أو Modifier.safeDrawingPadding() أو Modifier.fitInside(WindowInsetsRulers.SafeDrawing.current)، لأنّ هذه الأساليب غالبًا ما تكون قابلة للتبديل.