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

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

  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)، لأنّ هذه الأساليب غالبًا ما تكون قابلة للتبديل.