Android 通知欄顏色客製化：SystemBarTint 庫實戰與版本限制詳解

想讓 App 的主色調延伸至系統通知欄（Status Bar），打造沉浸式視覺體驗？Android 4.4 (API 19) 起提供透明狀態欄 API，但原生實作繁瑣。開源庫 SystemBarTint 以極簡 API 解決此痛點，是開發者首選方案。

快速整合步驟

1. GitHub 專案：jgilfelt/SystemBarTint
2. Gradle 依賴（JitPack）：

   repositories { maven { url 'https://jitpack.io' } }
   dependencies { implementation 'com.github.jgilfelt:SystemBarTint:v1.0.3' }

3. Activity onCreate 中啟用：

   if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.KITKAT) {
       setTranslucentStatus(true);
       SystemBarTintManager tintManager = new SystemBarTintManager(this);
       tintManager.setStatusBarTintEnabled(true);
       tintManager.setStatusBarTintResource(R.color.colorPrimary); // 你的主色調
   }

版本限制與相容性

進階技巧

• 搭配 fitsSystemWindows="true" 於根佈局，避免內容被狀態欄遮蓋
• 動態換膚時呼叫 tintManager.setStatusBarTintColor(newColor) 即時更新
• 導航欄同步著色：tintManager.setNavigationBarTintEnabled(true)

注意：API 19 僅支援「透明狀態欄＋著色」，真正的 Material Design 沉浸式體驗建議以 API 21+ 為基準開發，低版本優雅降級即可。