自定義 View、彈窗定位、圖片縮放等場景頻繁需要螢幕尺寸。本文提供生產級 ScreenUtils 工具類,封裝 DisplayMetrics、WindowManager,支援多窗口模式、刘海屏安全區域、可用高度(扣除狀態欄/導航欄) 等進階需求。
public class ScreenUtils {
private ScreenUtils() {}
/** 螢幕寬度 (px) */
public static int getScreenWidth(Context context) {
return getDisplayMetrics(context).widthPixels;
}
/** 螢幕高度 (px) */
public static int getScreenHeight(Context context) {
return getDisplayMetrics(context).heightPixels;
}
/** 密度 */
public static float getDensity(Context context) {
return getDisplayMetrics(context).density;
}
/** dp 轉 px */
public static int dp2px(Context context, float dp) {
return (int) (dp * getDensity(context) + 0.5f);
}
/** px 轉 dp */
public static int px2dp(Context context, float px) {
return (int) (px / getDensity(context) + 0.5f);
}
private static DisplayMetrics getDisplayMetrics(Context context) {
WindowManager wm = (WindowManager) context.getSystemService(Context.WINDOW_SERVICE);
DisplayMetrics metrics = new DisplayMetrics();
wm.getDefaultDisplay().getRealMetrics(metrics); // 獲取真實物理尺寸(含刘海)
return metrics;
}
}
/** 獲取應用可用高度 (扣除狀態欄、導航欄、系統欄) */
public static int getUsableHeight(Context context) {
WindowManager wm = (WindowManager) context.getSystemService(Context.WINDOW_SERVICE);
DisplayMetrics metrics = new DisplayMetrics();
wm.getDefaultDisplay().getMetrics(metrics); // 可用尺寸
return metrics.heightPixels;
}
/** 獲取狀態欄高度 */
public static int getStatusBarHeight(Context context) {
int resId = context.getResources().getIdentifier("status_bar_height", "dimen", "android");
return resId > 0 ? context.getResources().getDimensionPixelSize(resId) : 0;
}
/** 獲取導航欄高度 */
public static int getNavigationBarHeight(Context context) {
Resources res = context.getResources();
int resId = res.getIdentifier("navigation_bar_height", "dimen", "android");
return resId > 0 ? res.getDimensionPixelSize(resId) : 0;
}
// Activity 內直接獲取當前窗口尺寸
@Override
public void onConfigurationChanged(Configuration newConfig) {
super.onConfigurationChanged(newConfig);
int width = getResources().getConfiguration().screenWidthDp * getDensity(this);
int height = getResources().getConfiguration().screenHeightDp * getDensity(this);
// 此尺寸為當前窗口大小,非全螢幕物理尺寸
}
// 在 View 中獲取安全區域插入邊距
ViewCompat.setOnApplyWindowInsetsListener(rootView, (v, insets) -> {
Insets sysBars = insets.getInsets(WindowInsetsCompat.Type.systemBars());
Insets ime = insets.getInsets(WindowInsetsCompat.Type.ime());
// sysBars.top = 狀態欄高度(含刘海)
// sysBars.bottom = 導航欄高度
v.setPadding(sysBars.left, sysBars.top, sysBars.right, sysBars.bottom);
return insets;
});
// 自定義 View 中
int screenW = ScreenUtils.getScreenWidth(context);
int itemW = (screenW - ScreenUtils.dp2px(context, 32)) / 3; // 3列,邊距16dp*2
// Dialog 全屏寬度
dialog.getWindow().setLayout(ScreenUtils.getScreenWidth(context), WindowManager.LayoutParams.WRAP_CONTENT);
將工具類納入基礎庫模組,統一全專案螢幕尺寸獲取口徑,避免重複造輪子與邏輯不一致。