এজ-টু-এজ সেট-আপ করা

এজ-টু-এজ ডিসপ্লে আপনার অ্যাপকে সিস্টেম বারের পিছনে UI ড্র করার অনুমতি দেয়— স্ট্যাটাস বার, ক্যাপশন বার এবং নেভিগেশন বার—যাতে আরও নিমজ্জিত ব্যবহারকারীর অভিজ্ঞতা অর্জন করা যায়। আপনি Android 15 (API লেভেল 35) বা তার পরবর্তী যেকোনও ভার্সন রান করা ডিভাইস টার্গেট করলে, ডিফল্ট হিসেবে এজ-টু-এজ এনফোর্স করা হয়।

সব Android ভার্সনে এজ-টু-এজ কন্টেন্ট সঠিকভাবে দেখাতে, এই সেট-আপের ধাপগুলি অনুসরণ করুন। এইসব ধাপ অনুসরণ না করলে, আপনার অ্যাপ সিস্টেম বারের পিছনে সলিড কালার দেখাতে পারে অথবা স্ক্রিনের কীবোর্ড (IME) ট্রানজিশনের সাথে সিঙ্ক করে কন্টেন্ট অ্যানিমেট করতে পারে না।

১. এজ-টু-এজ ডিসপ্লে চালু করুন

Android-এর আগের ভার্সনে এজ-টু-এজ চালু করতে, আপনার Activity.onCreate() পদ্ধতিতে enableEdgeToEdge() কল করুন:

override fun onCreate(savedInstanceState: Bundle?) {
    super.onCreate(savedInstanceState)
    enableEdgeToEdge()
    // ...
}

ডিফল্ট হিসেবে, enableEdgeToEdge() সিস্টেম বারকে স্বচ্ছ করে তোলে, তবে ৩-বোতাম নেভিগেশন মোডে এটি প্রযোজ্য নয়, যেখানে এটি আরও ভালো কন্ট্রাস্টের জন্য নেভিগেশন বারে একটি ট্রান্সলুসেন্ট স্ক্রিম প্রয়োগ করে। সিস্টেম আইকন ও স্ক্রিমের রঙ সিস্টেমের লাইট বা ডার্ক থিমের সাথে মানানসই হয়।

২. windowSoftInputMode কনফিগার করুন

আপনার অ্যাক্টিভিটির AndroidManifest.xml এন্ট্রিতে android:windowSoftInputMode="adjustResize" সেট করুন। এই সেটিং আপনার অ্যাপকে 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">
  ...
</activity>

৩. ইনসেট ব্যবহার করে ওভারল্যাপ ম্যানেজ করা

এজ-টু-এজ চালু হয়ে গেলে, আপনার অ্যাপের কিছু কন্টেন্ট ও UI এলিমেন্ট সিস্টেম বারের পিছনে ড্র হতে পারে। সিস্টেম বার বা ওভারল্যাপ করা সিস্টেম জেসচারের মাধ্যমে গুরুত্বপূর্ণ বা ইন্টার‍্যাক্টিভ এলিমেন্ট যাতে অস্পষ্ট না হয়ে যায়, তার জন্য আপনাকে ইনসেট ম্যানেজ করতে হবে।

ইনসেট স্ক্রিনের সেইসব অংশ বর্ণনা করে যা সিস্টেম UI বা সিস্টেম জেসচারের সাথে ইন্টারসেক্ট করে। এজ-টু-এজ ডিসপ্লের জন্য বিবেচনা করার মতো প্রধান ধরনের ইনসেটগুলি হল:

  • সিস্টেম বার ইনসেট: সিস্টেম বার দেখানো হয় এমন জায়গা দেখায়। সিস্টেম বারের মাধ্যমে UI যাতে অস্পষ্ট না হয়ে যায় তার জন্য এগুলি ব্যবহার করুন।
  • ডিসপ্লে কাট-আউট ইনসেট: ডিভাইসের স্ক্রিনে ফিজিক্যাল কাট-আউট (যেমন, ক্যামেরা নচ) যেখানে আছে সেই জায়গা দেখায়।

Compose-এ, আপনি রুলার, প্যাডিং মডিফায়ার বা ইনসেট সাইজ মডিফায়ার ব্যবহার করে ইনসেট ম্যানেজ করতে পারেন। বিস্তারিত নির্দেশিকার জন্য উইন্ডো ইনসেট সম্পর্কে দেখুন।

উন্নত বিষয়

আরও উন্নত এজ-টু-এজ ব্যবহারের ক্ষেত্রে নিম্নলিখিত বিষয়গুলি বিবেচনা করুন।

ইমারসিভ মোড

ভিডিও বা ম্যাপের মতো কিছু কন্টেন্ট, সম্পূর্ণ ইমারসিভ অভিজ্ঞতা থেকে উপকৃত হয় যেখানে সিস্টেম বার লুকানো থাকে। WindowInsetsControllerCompat ব্যবহার করে আপনি সিস্টেম বার লুকাতে পারবেন:

val windowInsetsController = WindowCompat.getInsetsController(window, window.decorView)

// Hide the system bars.
windowInsetsController.hide(WindowInsetsCompat.Type.systemBars())

// Show the system bars.
windowInsetsController.show(WindowInsetsCompat.Type.systemBars())

সিস্টেম বারের রঙ ও আইকন

এজ-টু-এজ মোডে, আপনার অ্যাপের ব্যাকগ্রাউন্ড সিস্টেম বারের পিছনে দেখা যেতে পারে, তাই আরও ভালো কন্ট্রাস্টের জন্য আপনাকে সিস্টেম বার আইকনের রঙ অ্যাডজাস্ট করতে হতে পারে।

স্ট্যাটাস বার আইকন লাইট বা ডার্ক করতে, WindowInsetsControllerCompat ব্যবহার করুন:

// Set status bar icons to dark.
WindowCompat.getInsetsController(window, window.decorView)
    .isAppearanceLightStatusBars = true

// Set status bar icons to light.
WindowCompat.getInsetsController(window, window.decorView)
    .isAppearanceLightStatusBars = false

সিস্টেম বার সুরক্ষা

enableEdgeToEdge() ডিফল্ট স্বচ্ছ বা আংশিক স্বচ্ছ সিস্টেম বার প্রদান করলেও, আপনাকে এটি কাস্টমাইজ করতে হতে পারে। কখন ট্রান্সপারেন্ট বনাম ট্রান্সলুসেন্ট বার ব্যবহার করতে হবে তা সিদ্ধান্ত নিতে Android সিস্টেম বার ডিজাইন নির্দেশিকা এবং এজ-টু-এজ ডিজাইন নির্দেশিকা দেখুন।

৩টি-বোতাম দিয়ে করা নেভিগেশন বারকে ট্রান্সলুসেন্টের পরিবর্তে সম্পূর্ণ ট্রান্সপারেন্ট করতে, আপনি কন্ট্রাস্ট এনফোর্সমেন্ট বন্ধ করতে পারেন:

window.isNavigationBarContrastEnforced = false

আরও তথ্যের জন্য, সিস্টেম বার সুরক্ষা সম্পর্কে দেখুন।