在 Android 开发中，窗口属性决定了 Activity、Dialog、Service Window 等 UI 的外观与行为。它们从 styles.xml 传递到程序内核，再最终交由 WindowManagerService 处理。

常见开发者痛点汇总

• statusBarColor 似乎没生效：大多数人只改了颜色，却忽略了 windowTranslucentStatus/DRAWS_SYSTEM_BAR_BACKGROUNDS/主题继承等细节。老实说，
• windowsIsTranslucent/半透明 Activity 结果是黑屏：忘记同时设置 wndBackground=transparent 或 wndDisablePreview=true
• 弹窗/悬浮窗点击外部却不关闭：没有正确配置 wndCloseOnTouchOutside + FLAG_NOT_TOUCH_MODAL + WATCH_OUTSIDE_TOUCH
• AOD 或锁屏界面被截屏：未开启 wndSecure=true
• 键盘适配失效: 无论是聊天页面还是登录页。都因布局层级或输入法类型导致键盘覆盖输入框。
• <强>"全屏模式下状态栏依旧可见": 没有清楚地切换到沉浸式模式。
• <强>"启动页面闪烁白屏": 未关闭默认预览或未设置透明背景。
• <强>"共享元素动画出现白色闪烁": 背景淡出时长和过渡动画冲突。
• <强>"Edge-to-Edge 默认开启导致布局被拉伸": 未 opt-out 或未适配 WindowInsets。
• <强>"FLAG_LAYOUT_IN_SCREEN 与 FLAG_LAYOUT_NO_LIMITS 误用导致绘制错误".

*上述问题均可通过正确配置 Theme 属性与代码组合解决；以下章节将逐条拆解实现方法与常用方法。

1 架构概览：Theme → PhoneWindow 的数据流

AndroidManifest.xml 中指定的 Theme / setTheme │ Resources.Theme │ context.obtainStyledAttributes ▼ TypedArray │ ├──▶ PhoneWindow 构造函数 ──▶ 读取约 个属性 │ ├──▶ mIsFloating │ ├──▶ 部分 flags │ └──▶ 初始 LayoutParams 设置 │ └──▶ PhoneWindow.generateLayout  ──▶ 读取约 + 个属性 | ... | ...

说到关键类说明。

Window : 抽象基类，定义 flags、type、softInputMode、features 等抽象方法 App进程 PhoneWindow : 程序内部唯一实现 WindowManager.LayoutParams: 描述 Window 的布局参数 WindowManagerService : 程序服务，管理所有窗口 Z-order、尺寸、输入事件等 SurfaceFlinger : GPU 合成层

关键认知：    Theme 属性 → PhoneWindow → LayoutParams → WMS   这条链路中真正使用者是 WMS。

1.1 属性定义：R.styleable.Window

所有 Window 相关的 me 属性定义在 AOSP 的 frameworks/base/core/res/res/values/attrs.xml 中…，截至 Android API，该 styleable 包含约 + 个属性。

...

这些属性被程序预置 Theme设置默认值；应用层通过自定义 Theme 覆写。

1.1.1 默认值来源链举例

Theme.Material3.DayNight.NoActionBar
└─ parent: Theme.Material3.DayNight
└─ parent: Theme.Material3.Light
...
└─ parent: Platform

. 在你的 Theme 中设置的属性，会逐级向上覆盖父主题同名属性。

2 PhoneWindow 读取属性两个入口

• …
• …

. 构造函数一次读取 Window Styleable

public PhoneWindow(Context context。Window preserved,ActivityConfigCallback callback){
super;按理说，mLayoutInflater = LayoutInflater.from;// ★ 第一次读取 Window Styleable
TypedArray a = context.obtainStyledAttributes(
null。R.styleable.Window,/* defStyleAttr = */0,R.style.PhoneWindow);// defStyleRes
}

. 第一次消费的大约+个字段主要涉及 flags、type 等基本特性；后续生成布局时再补充细节。

至于关键参数解析，set=null / defStyleAttr / defStyleRes

• a.getBoolean;若设为 true 则立即添加 NOT_TOUCHABLE|NOT_FOCUSABLE flag 并禁用 InputChannel。这正是 “窗口完全不可交互” 的根本原因！
  • a.getBoolean;添加 FLAG_SPLIT_TOUCH；让多指触摸可以分别命中不同窗口——非常关键在分屏或游戏双摇杆场景下才会用到。...

. 示例代码：windowNoDisplay -> FLAG_NOT_TOUCHABLE | NOT_FOCUSABLE & InputFeature.NO_INPUT_CHANNEL java if){ setFlags(FLAG_NOT_TOUCHABLE|FLAG_NOT_FOCUSABLE,FLAG_NOT_TOUCHABLE|FLAG_NOT_FOCUSABLE);final LayoutParams params = getAttributes;params.inputFeatures |= INPUT_FEATURE_NO_INPUT_CHANNEL;}

---

. generateLayout 二次读取

java protected ViewGroup generateLayout{ TypedArray a = getWindowStyle;// 获取 attributes // …话说回来，≈+ 个属性消费 …}

• *为什么两次？* 因为在 `generateLayout` 前可能已经执行了 `requestFeature` / `addFlags` / `setSoftInputMode` 等 API——我们要保证这些显式调用不会被后续主题覆盖。
  .
  实现思路这方面。**标记位模式** —— 每个可覆写字段都有一个 `mHasXxx` 标记，如果已在代码里设定就不再受主题影响。

  • `mHasSoftInputMode` ← `setSoftInputMode` 调用后设为 true 并记录值；若未调用则取主题默认，...

  ---

  3 WindowManager.LayoutParams Flags

  **为什么要理解 Flags？** 因为每个 Flag 都代表一个独立行为开关，没有它们就无法解释为何某些 UI 行为失效。怎么说呢，

  . 什么是 Flags？

  text int flags : bitmask

  # Bits Set As Flag Name & Effect Category *
  布局相关 | 输入/焦点 | 程序栏 | 安全显示 | 锁屏 | …etc.

  . 布局相关 Flags

  . FLAGLAYOUTIN_SCREEN``

  作用 ：允许内容延伸至整个屏幕，包括状态栏和导航栏后面。

  WMS 效果 ： - 内容区域变为 而非。- 程序栏仍可见，只是可画到其后面。

  典型场景 ： - 状态栏背景延伸到状态栏后面。- 全屏视频播放器但保留状态栏。不过，

  . FLAGLAYOUTNO_LIMITS``

  作用 ：允许窗口超出物理边界。用于 CRT 屏幕过扫描时代。

  WMS 效果 ：仅用于老 TV 和 TV 模式；现在基本废弃，

  . FLAGLAYOUTATTACHEDINDECOR``

  网站内部标志，不应手动设置。

  ---

  . 输入与焦点 Flags

  . FLAGNOTTOUCHABLE``

  不能接收任何触摸事件；事件穿透到底层，

  . FLAGNOTFOCUSABLE``

  不能成为键盘焦点；若同时设置 NOT_TOUCHABLE 则完全不可交互。

  . FLAGWATCHOUTSIDE_TOUCH``

  监听外部触摸事件，用于 Dialog 点击外部关闭等功能。按理说，

  . FLAGNOTTOUCH_MODAL``

  让触摸事件穿透至后方窗口——悬浮球等情况必需。

  . FLAGSPLITTOUCH``

  支持多指触摸分别命中不同窗口——分屏、多窗口游戏场景必备。

  . 程序栏 Flags

  . FLAG_FULLSCREEN – 隐藏程序栏并占满全部空间

  . FLAG_TRANSLUCENT_STATUS/NIGATION – 半透明状态栏／导航栏

  关键组合

  text windowTranslucentStatus=true => FLAG_TRANSLUCENT_STATUS windowDrawsSystemBarBackgrounds=true => FLAG_DRAWS_SYSTEM_BAR_BACKGROUNDS statusBarColor=color => 实际渲染颜色 如果缺一不可，“statusBarColor” 将无效！说起来，

  ---

  . 安全与显示 Flags

  . FLAG_SECURE – 禁止截屏录制

  ⚠️ 注意此 flag 同时会阻止 ADB screencap。screenrecord,第三方录音软件，还有程序快捷键截图都显示黑色，但无法阻止物理拍照！

  ---

  . 锁屏相关 Flags

  Flag	用途
  SHOWWHENLOCKED	在锁屏上方显示
  DISMISS_KEYGUARD	自动解除滑动锁
  TURNSCREENON	打开时亮屏
  KEEPSCREENON	防止熄灯

  ---

  4 Theme 属性分类详解

  下面按功能类别逐一说明对应 Java 消费方法及典型使用场景，同时指出常见坑点与方法。

  窗口 Flags 类

  android.windowNoDisplay

  xml

  Java的观点是。

  java if){ setFlags(WindowManager.LayoutParams.FLAG_NOT_TOUCHABLE| WindowManager.LayoutParams.FLAG_NOT_FOCUSABLE,same);final LayoutParams lp=getAttributes;lp.inputFeatures |= INPUT_FEATURE_NO_INPUT_CHANNEL;}

  ✅ 使用场景后台 Service 持有 window 无 UI 时使用，以防止误弹窗干扰使用者体验。

  android.windowDisablePreview

  类似上文，仅添加 FLAG_DISABLE_PREVIEW;常用于自定义 Splash 或半透明 Activity 避免启动白色闪烁。

  android.windowEnableSplitTouch

  Adds FLAG_SPLIT_TOUCH;话说回来，必须配合多指触控需求，如分屏、游戏双摇杆。

  android.windowShowWallpaper

  Adds WINDOW_SHOW_WALLPAPER;常用于 Launcher 或半透明风格 App。

  android.windowBlurBehind

  Adds WINDOW_BLUR_BEHIND;对应 API+ GPU 模糊效果，需要配合 windowBackgroundBlurRadius 调整性能。

  android.windowSecure

  Add WINDOW_SECURE;常用于银行 APP、密码输入页等敏感页面。

  android.windowNotTouchable

  Sets WINDOW_FLAGS.NOT_TOUCHABLE;用于 Loading 覆盖层或纯展示页，无需交互。

  窗口 Type 类

  android.windowIsFloating

  Sets internal flag mIsFloating. Generates dialog‑style layout . Used for Dialog‑styled Activities or Picture‑in‑Picture windows.

  尺寸与布局类

  如：

  xml 320dp 600dp

  PhoneWindow 在 generateLayout 根据是否满足条件修改相应 width/height/minWidth/minHeight。

  背景与样式类

  Key attributes:

  Attr	Effect
  windowBackground	DecorView background drawable/color
  windowClipToOutline	Enables outline clipping
  windowElevation	Z‑axis shadow offset

  从常见坑来看，

  • 半透明 Activity 未把 background 设置为 transparent -> 黑色背景！老实说，
  • 圆角窗体需同时开启 clipToOutline 与 outline drawable。

  程序状态栏／导航栏类

  说到主要三步。

  如果缺一不可，“statusBarColor” 将不起作用！在 Android 13+ 默认 Edge‑to‑Edge 所以无需手动开启，但旧主题仍需手工配置。

  SoftKeyboard Class

  Attribute is a bitmask combining state and adjust bits:

  xml android:windowSoftInputMode= "stateVisible|adjustResize"

  Common combinations: - adjustResize: compress view when keyboard pops up—ideal for chat lists. - adjustPan: move whole view upward—good for simple forms at bottom. - stateAlwaysHidden: keyboard stays hidden until explicitly requested—useful in search pages.

  Transition Animation Class

  Enable with:

  xml android:windowActivityTransitions=true android:windowEnterTransition="@transition/explode" android:windowExitTransition="@transition/fade"

  If you see white flash during shared element transition,increase

  xml android:windowTransitionBackgroundFadeDuration=" to smooth out.

  Pixel Format & Rendering Class

  xml android:isTranslucent=true // changes Surface pixel format to TRANSLUCENT

  Effects: - SurfaceFlinger now performs per‑pixel blending → performance hit on low‑end devices. - Must pair with transparent background and optionally disable preview.

  完整映射速查表

  Flag Attribute Name	Consumer Entry Point	Target Field/Effect

  手机操作提示及常见陷阱说明...

  此处略去大量详细映射表…，请结合官方文档进一步阅读！✂️ ✂️ ✂️ 🛠️🛠️🛠️ 🧩🧩🧩 📚📚📚 🚀🚀🚀 🔑🔑🔑   💡💡💡   🏆🏆🏆 ↕↕↕   ⏳⏳⏳ ⏰⏰⏰ ⬅️➡️⬇️⬆️ ➖➕ ➖➕ ➖➕ ➖➕ ⬢⬢ ⬢⬢ ⬢⬢ ▽▽▽ ▽▽▽ ▽▽▽ ▽▽▽ ▓▓▓▒▒▒░░░▉▉▉▍▍▍▎▎▎☂☂☂ ☃☃☃ ☾☾☾ ⚡⚡⚡ 🌑🌑🌑 🌝🌝🌝 ❗❗❗ 🔴🔴🔴 ⚙⚙⚙ 📺📺📺 👓👓👓 💭💭💭 💬💬💬 👋👋👋 👨‍🍳👨‍🍳👨‍🍳 🐛🐛🐛 🎮🎮🎮 🏞️🏞️🏞️ ✈️✈️✈️ 🚲🚲🚲 🚀🚀🚀 🎥🎥🎥 🖼️🖼🖼 ✨✨✨ 🎉🎉🎉 ⚠⚠⚠ 🔒🔒🔒 🔓🔓🔓 🔐🔐🔐 ❌❌❌ ✔✔✔ ♻♻♻ ✋✋✋ 🚫🚫🚫 🌟🌟🌟 💡💡💡 🧪🧪🧪 💎💎💎 💸💸💸 🚦🚦🚦 🔴⚫◼︎◼︎▪︎▪︎●●● ◾◾◾ ◇◇◇ ••••• •••• •• • •••• •••• …说起来，​

  #️⃣

  Property Name In xml Attribute file e.g.。styles.xml or mes.xml.	Consumer entry point,i.e.,where it’s read by framework.	Target field,i.e.,which field in phonewindo….
  	onCreate

  ...

  ---

  实战场景速查

  显示全屏视频或游戏页面——隐藏程序栏且保持滑动唤醒功能→ 标准做法如下：

  xml

---