Android SlidingMenu 庫導致狀態欄沉浸式透明失效？根因與替代方案

使用 SlidingMenu (jfeinstein10/SlidingMenu) 庫實現側滑選單，主 Activity 設定透明狀態欄 (FLAG_TRANSLUCENT_STATUS) 失效，其他 Activity 正常。經排查，**SlidingMenu 內部佈局機制強制佔用狀態欄區域**，導致沉浸式失效。

問題現象

• 主 Activity (掛載 SlidingMenu) 狀態欄不透明、內容不延伸至狀態欄下方。
• 移除 SlidingMenu 相關代碼後恢復正常。
• 未在 Manifest 設定主題，BaseActivity 統一設定透明狀態欄。

根本原因

SlidingMenu 透過 attachToActivity(this, SLIDING_WINDOW) 將選單視圖添加到 `Window` 的 `DecorView` 中，其內部 `CustomViewAbove` / `CustomViewBehind` 佈局過程中**強制設定 `fitsSystemWindows=true` 或調整 `WindowInsets`**，覆蓋了 Activity 設定的沉浸式旗標。

解決方案

1. 棄用 SlidingMenu，遷移至官方 NavigationView + DrawerLayout (推薦)：

   <androidx.drawerlayout.widget.DrawerLayout ...>
     <!-- 主內容 -->
     <FrameLayout android:id="@+id/content_container" ... />
     <!-- 側滑選單 -->
     <com.google.android.material.navigation.NavigationView ... />
   </androidx.drawerlayout.widget.DrawerLayout>
   

   在 `Activity.onCreate` 中：

   if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.KITKAT) {
       window.addFlags(WindowManager.LayoutParams.FLAG_TRANSLUCENT_STATUS);
   }
   // DrawerLayout 會正確處理 fitsSystemWindows
   

2. 若必須繼續用 SlidingMenu (維舊專案)：
   • 修改庫源碼：在 `CustomViewAbove.onMeasure` / `onLayout` 中移除對 `fitsSystemWindows` 的強制處理。
   • 或在主 Activity `onPostCreate` 中重新套用旗標：

     @Override
     protected void onPostCreate(Bundle savedInstanceState) {
         super.onPostCreate(savedInstanceState);
         if (Build.VERSION.SDK_INT >= 19) {
             getWindow().addFlags(WindowManager.LayoutParams.FLAG_TRANSLUCENT_STATUS);
             // 強制重新佈局
             getWindow().getDecorView().requestLayout();
         }
     }
     

最佳實務總結

「SlidingMenu 這樣的自定義控件，是不能設置沉浸式狀態欄的」—— 提問者最終自行總結。官方 DrawerLayout 經過大量機型測試，完美支援沉浸式、刘海屏、水劃手勢，新專案**零理由**使用已停更 8 年的 SlidingMenu。

遷移檢查清單

• [ ] 佈局改為 `DrawerLayout` + `NavigationView`
• [ ] 選單項目遷移至 `menu/nav_menu.xml`
• [ ] `ActionBarDrawerToggle` 同步 Toolbar 狀態
• [ ] 移除所有 `SlidingMenu` 依賴與代碼
• [ ] 測試 Android 4.4~14 沉浸式狀態欄、側滑手勢、鍵盤彈出佈局

遷移至官方組件，徹底解決沉浸式衝突，並獲得長期維護保障。