Flutter 修复 no_screenshot 鸿蒙窗口隐私模式切换:让一次性恢复口令页离开后恢复正常截屏
📦 no_screenshot 可以开关窗口防截屏保护,并监听截屏动作。我在鸿蒙端做恢复口令页时,发现退回公开页后仍无法截屏,显式恢复的返回值也不对。这篇记录状态切换的修复,以及监听取消和页面进退时需要处理的异步问题。
完整代码已开源在 oh-flutter/no_screenshot(上游主包为 no_screenshot),欢迎提交 Issue 或前往 鸿蒙系统Flutter开源库社区 交流。
前言
我做了一个账号安全验证页,公开资料可以截屏,点开恢复口令卡片后开启保护,收起卡片再恢复截屏。口令是固定的离线演示文本,没有连接真实账号。接上 no_screenshot 的鸿蒙实现后,第一次切换正常,第二次却没能解除保护;改用显式恢复接口,窗口已经恢复,返回值又是 false。
我顺着方法通道查到原生实现,发现切换分支始终写入 true,返回值又把“是否受保护”和“操作是否成功”混在了一起。同时在等待窗口返回期间取消监听、页面提前退出这两类异步交错也需要处理。逐一修正后,模拟器与畅享 100 Pro Max 真机里的公开页都能在收起卡片后恢复正常截屏与投屏。
一、使用场景与原版问题
1.1 同一个窗口里的两种页面
验证页保留了普通设置和说明文字,用户可以截屏留存。恢复口令卡片只在主动查看时显示,收起后回到公开资料页。两种内容都在同一个 Flutter 窗口里,所以页面切换的同时,应用还要改变这个窗口的隐私属性。否则卡片虽然不见了,公开页仍可能沿用刚才的保护状态。
我先用切换接口重现问题。它承诺翻转截屏状态,连续调用两次,窗口就应该回到起点。实际接入业务时,我更倾向于显式开启和恢复:先等保护成功,再显示敏感页;退出时先移除敏感内容,再恢复截屏。图 1 画的是这个顺序,第五章有对应的接入函数。

图1 页面保护顺序
这件事需要系统、插件和页面配合。鸿蒙窗口模块负责隐私属性和截屏事件;no_screenshot 把 Dart 方法转成窗口调用,把结果传回来;页面决定哪些内容需要保护,以及失败时该怎样提示。Example 中禁用按钮、展开卡片和切换路由的代码都放在应用侧,插件只处理窗口能力。
排查时,我没有只盯着页面徽标。screenshotStream 里的值是收到事件时的快照,窗口后来可能已经改变;wasScreenshotTaken 则只表示发生过截屏事件。为了看清调用结果,我另外查询了窗口属性,再与设备端截屏记录对照。
1.2 选择社区 2.0.1 适配分支
我检查了 pub.dev 上游发布页,以及 oh-Flutter、CPF-Flutter 两个社区组织的相关实现。现有包已经提供开启、恢复和切换接口,鸿蒙实现也已接入窗口能力,因此我沿用原库修复,没有另起一个包。

图2 上游包页面
图 2 是 no_screenshot 2.0.1 的发布页。这个包由 flutterplaza.com 发布,采用 BSD-3-Clause 许可,提供截屏开关、状态流,以及 SecureWidget、SecureNavigatorObserver 等组件和路由接口。页面标注 Android、iOS、Linux、macOS、Web 与 Windows,上游主仓没有 ohos 目录。
鸿蒙实现来自 oh-flutter 维护的 no_screenshot 社区仓库。图 3 能看到该仓库的 ohos 目录;查调用细节时,我看的就是这里的原生代码。上游发布页用来核对公开接口,社区源码用来核对这些接口在鸿蒙上怎样执行。

图3 社区适配仓库
各候选实现的核查结果见表 1:
| 仓库来源 | 分支或标签 | 对应版本 | 鸿蒙实现现状与核查结论 |
|---|---|---|---|
| pub.dev/packages/no_screenshot | 正式发布版 | 2.0.1 | 含双声明防截屏模型与 overlayOff,无 ohos 实现 |
| CPF-Flutter/fluttertpc_no_screenshot | development | v1.1.0 | 仓库内无 ohos 目录,停留在上游早期版本 |
| CPF-Flutter/fluttertpc_no_screenshot | br_3.35_dev | 1.1.0 | 基于旧版接口,通过媒体库相册查询检测截屏,缺 2.0.1 能力 |
| oh-flutter/no_screenshot | feat/ohos_no_screenshot_2.0.1 | 2.0.1-ohos.1 | 已对齐上游 2.0.1 Dart API 并接入 @ohos.window,存在切换与回执缺陷 |
表1 社区版本核查
CPF-Flutter 的 br_3.35_dev 分支基于上游 1.1.0,缺少 overlayOff、SecureNavigatorObserver 等 2.0.x 接口,截屏检测使用的是媒体库相册变更监听。oh-flutter 的 feat/ohos_no_screenshot_2.0.1 分支已经包含 2.0.1 Dart API,并使用窗口隐私属性和窗口截屏事件。我选择它作为修复起点,便于直接对照现有接口的行为。
这个分支与标签 2.0.1-ohos.1 的原生实现一致,但两者不是同一个提交,完整映射放在工程说明中。首版补丁使用 fix/ohos-privacy-mode-state-sync 分支,保留 no_screenshot 包名和 BSD-3-Clause 许可;原版标签仍指向原版代码。
1.3 两个错误和一项状态同步扩展
用社区 2.0.1 适配分支,在同一个前台窗口连续调用两次 toggleScreenshot(),就能遇到第一处问题:第一次进入保护态,第二次仍在保护态,两个返回值却都是 true。预期的“再切一次就恢复”没有发生。这个复现只需要普通页和口令卡片,不依赖额外的业务限制。
接着我查看了显式恢复接口。上游 screenshotOn() 的注释写明,成功恢复截屏,或者本来就允许截屏,都应返回 true。鸿蒙原版在关闭保护后却返回 false。对业务代码来说,这会被当成失败,可能弹出错误提示,或重复执行已经完成的恢复操作。
原版还有一个使用上的不便:只有系统截屏时才发送快照,刚订阅或刚改变开关时,页面收不到更新。我补充了初始快照和变更快照,让观测面板能跟上操作。这是事件行为的扩展,原来的接口并未承诺初始回放,所以我把它与前面两处 Bug 分开说明。接入后收到的事件会变多,是否提示“发生截屏”,仍要看事件里的截屏标志。
二、修复前后的实测对比
2.1 对照版本与运行环境
本文先后在本地手机模拟器与 华为畅享 100 Pro Max 实体真机(公开型号 YEW-AL80)完成了双环境对照验证。其中图 4—图 8 和表 2 来自首版状态修复在模拟器上的无签名双包记录(com.example.pgc26base 与 com.example.pgc26fix);第 2.4 节补充了当前含生命周期修复的完整版本在畅享 100 Pro Max 真机上的运行画面与通道日志。诊断页面、权限声明保持一致,只替换被测的原生插件实现。
- Flutter 3.41.9+ohos-1.0.2,Dart 3.11.5,debug 构建。
- DevEco Studio 26.0.0,HarmonyOS SDK API 26。
- 本地模拟器:Mate 90 Pro 手机模拟器,模板镜像标识 7.0.0.107,屏幕 1280 × 2832;本地设备参数回报 OpenHarmony-7.0.0.105。
- 实体真机:华为畅享 100 Pro Max(YEW-AL80,固件版本 7.0.0.100(SP9C00E100R9P4),系统回报 OpenHarmony-7.0.0.105,分辨率 1128 × 2444,arm64-v8a)。
- 每组执行相同的四步操作序列,结合 HiLog、WindowManagerService 窗口转储、模拟器端
snapshot_display以及真机 USBScreen Mirroring独立投屏通路交叉核对;没有多轮稳定性或性能统计。
安全路由独立入口(safe_main.dart)另外通过了单元测试、静态检查及 HAP 构建;系统录屏与无线投屏未单独实测。
2.2 同样四步操作下的结果
两组都从桌面打开诊断页,依次查看初始状态、切换进入口令页、切换返回公开页,最后单独调用显式恢复。进入口令页和返回公开页时各触发一次系统截屏。诊断页保留切换按钮,正是为了检查第二次调用能否把窗口恢复。

图4 原版操作记录
原版进入口令页后开启了保护,返回公开页后仍未解除。最后点击显式恢复,窗口属性已经变成 false,但方法也返回 false,徽标还停留在上一次截屏时的 true。看到这里很容易误以为窗口仍受保护,实际留下来的是旧快照;这一帧反映的是回执和显示的问题。

图5 修复操作记录
修复组刚订阅就收到了初始快照。进入口令页时属性为 true,返回公开页后变成 false,显式恢复也返回 true。我还把当前诊断页的面板标题改成了“最后一次状态快照”,截屏提示只描述事件发生时读到的属性,免得旧值一直挂在界面上让人误判。
2.3 运行画面与窗口属性交叉核对
图 6 取自原版实录中第二次切换之后、显式恢复之前。此时页面已回到公开资料,窗口仍在保护态,正好对应切换接口没有恢复的那一步。图 7、图 8 则分别是首版修复组的口令页和恢复后的公开页。

图6 原版返回公开页

图7 口令页保护态

图8 修复后公开页
图 7 还能看见口令,是因为这些带设备轮廓的图片截自宿主机上的模拟器窗口。鸿蒙的隐私模式控制设备内部的截屏,管不到宿主机对模拟器窗口的捕获。因此,窗口外观用来记录页面操作,保护是否生效还要结合设备内的窗口属性和截屏结果看。
为便于对应日志,这组记录保留了进程号和窗口编号:基线是进程 13843、窗口 64,修复组是进程 14712、窗口 66。重新运行时,这些编号可能改变,查询时应使用当次应用的标识。
| 操作节点 | 原版隐私属性 | 首版修复隐私属性 | 方法回执(原版/修复) |
|---|---|---|---|
| 初始公开页 | false | false | 未调用 |
| 第一次切换进入口令页 | true | true | true/true |
| 第二次切换返回公开页 | true | false | true/true |
| 显式恢复截屏 | false | false | false/true |
表2 窗口属性对照
文字记录中,保护态截屏为 58,099 B,修复组返回公开页后为 201,899 B,分别注明黑图和可读的公开页面。不过,这批模拟器端 JPEG 原文件没有归档,现在只能复核保留的运行画面、HiLog 和窗口属性,无法重新计算图片哈希或检查像素。字节数本身也不足以判断图片内容。
2.4 华为畅享 100 Pro Max 真机投屏与回执复测
我还在华为畅享 100 Pro Max(YEW-AL80)上运行了当前修订版,并通过 DevEco Studio 的 Screen Mirroring 查看 USB 投屏画面。窗口进入隐私模式后,投屏画面变成黑屏;截图顶栏的设备序列号已脱敏。

图9 真机原版黑屏

图10 真机修复恢复
两组在真机上执行相同的“公开页 → 进入口令页 → 返回公开页 → 显式解除保护”四步操作:
- 原版基线(PID 18908):进入恢复口令页后 USB 投屏立即黑屏;随后点击“返回公开资料页(切换解除保护)”,虽然日志打印
switchView target=public toggleResult=true,但因原生层再次写入 true,投屏画面仍然是黑屏(图 9);紧接着点击底部“显式解除(screenshotOn)”,画面虽解除黑屏,通道却错误返回explicit screenshotOn result=false。 - 当前修复版(PID 20052):冷启动挂载即收到
protectionOn=false初始快照;进入口令页时原生打印toggleScreenshot: before=false target=true actual=true matched=true,USB 投屏同步黑屏保护;点击返回公开页后原生打印before=true target=false actual=false matched=true,USB 投屏当场恢复清晰画面(图 10),顶部状态栏更新为“普通窗口可截屏 (false)”;随后点击显式解除,准确返回explicit screenshotOn result=true。
这几类记录回答的问题不同:回执说明方法认为操作是否成功,窗口属性说明系统当时处于什么状态,事件快照记录截屏回调发生时的值,图片才直接显示截出了什么。比对时需要把它们放回同一个操作节点;尤其不能拿显式恢复后的属性,去解释恢复前那次截屏。
三、原理与核心代码分析
3.1 调用目标和返回值用错了
我打开社区源码中的 ohos/src/main/ets/components/plugin/NoScreenshotPlugin.ets,先看设置窗口属性的函数。方法分发器里,开启保护与切换都调用 setProtected(true),恢复截屏调用 setProtected(false):
private async setProtected(on: boolean): Promise<boolean> {
const win = await this.getWindow();
this.win = win;
await win.setWindowPrivacyMode(on);
return win.getWindowProperties().isPrivacyMode;
}
🔍 问题出在调用目标和返回值这两处。
切换方法收到请求后没有读取当前状态,而是与开启保护共用一个分支,始终写入 true。窗口原本可截屏时,这样做恰好完成了第一次切换;窗口已经受保护时,再写一次 true 就什么也没翻转。只测“进入口令页”会漏掉这个问题,必须把返回公开页的第二次调用一起检查。
返回值的问题在最后一行。它直接返回窗口当前的隐私属性,而 Dart 接口需要的是操作是否成功。开启保护时,两者恰好都是 true;解除保护时,窗口属性应该为 false,成功回执却仍应为 true。修复时,我保留回读结果来描述窗口状态,另用 actual === targetPrivacy 判断是否达成目标。这样两个布尔值各自有明确用途。
我也看了事件流的发送位置。原版订阅处理只是保存输出端,只有系统截屏回调会发送数据,因此按钮改变属性后,页面没有新的快照可显示。补充同步时,需要增加发送时机,并区分普通状态变化和真正的截屏事件。
3.2 分开处理状态变化和截屏事件
补充状态推送时,我把 was_screenshot_taken 设为 false,只在系统截屏回调中设为 true。这个字段会影响 Dart 层的业务回调,不能把两种事件混在一起。
上游 lib/no_screenshot.dart 中的 _dispatchCallbacks 正是根据它分发回调:
void _dispatchCallbacks(ScreenshotSnapshot snapshot) {
if (snapshot.wasScreenshotTaken) {
onScreenshotDetected?.call(snapshot);
}
if (!_wasRecording && snapshot.isScreenRecording) {
onScreenRecordingStarted?.call(snapshot);
}
if (_wasRecording && !snapshot.isScreenRecording) {
onScreenRecordingStopped?.call(snapshot);
}
_wasRecording = snapshot.isScreenRecording;
}
startCallbacks() 会订阅状态流,收到快照后,只有截屏标志为 true 才调用 onScreenshotDetected。如果应用用这个回调提示用户或记录截屏告警,把普通开关变化也标成 true,就会在进出页面时发出误报。接入方不需要从页面位置猜事件来源,插件应当在发送时写清楚。
方法通道返回这次操作的结果,事件通道发送状态快照;两者使用同一次回读得到的窗口属性。图 11 展示了调用顺序:

图11 跨端状态时序
把方法名、目标状态和回执放在一起,对照起来更方便。需要注意,协议字段 is_screenshot_on 在这里承载的是隐私保护状态,Dart 侧将它解析为 isScreenshotProtectionOn,不要仅凭字段中的 on 推断“允许截屏”。
| 通道方法名 | 目标 isPrivacyMode | 方法回执返回 true 条件 | 推送状态流快照字段 |
|---|---|---|---|
screenshotOff | true(开启保护) | 窗口回读 isPrivacyMode === true | is_screenshot_on: true, was_screenshot_taken: false |
screenshotOn | false(解除保护) | 窗口回读 isPrivacyMode === false | is_screenshot_on: false, was_screenshot_taken: false |
toggleScreenshot | !before(取反) | 窗口回读 isPrivacyMode === !before | is_screenshot_on: actual, was_screenshot_taken: false |
系统 screenshot 回调 | 保持不变 | 无(原生主动推送事件) | is_screenshot_on: current, was_screenshot_taken: true |
表3 方法回执契约
3.3 先修正状态与回执,再处理异步生命周期
我把原生改动分为三步:
- 为切换接口单独读取并翻转窗口属性,显式开关继续使用明确目标值。
- 写入完成后回读属性,以实际值是否等于目标值计算成功回执,再发出非截屏的状态快照。
- 串行执行窗口操作,并在等待窗口、停止监听和宿主脱离之间检查请求是否仍有效。
状态翻转与写入校验都放在 NoScreenshotPlugin 类中。下面两个函数负责读取当前值、计算目标和检查写入结果;显式开关也会通过 setProtected 调用同一个写入函数。三种操作都由 enqueue 排队,快照按表 3 的字段发送,异常通过 MethodResult 返回并保留系统错误码。
private async toggleProtected(): Promise<boolean> {
const win = await this.getWindow();
const before = win.getWindowProperties().isPrivacyMode;
return this.applyPrivacyMode(win, before, !before, 'toggleScreenshot');
}
private async applyPrivacyMode(
win: window.Window,
before: boolean,
targetPrivacy: boolean,
action: string,
): Promise<boolean> {
const generation = this.lifecycleGeneration;
await win.setWindowPrivacyMode(targetPrivacy);
if (generation !== this.lifecycleGeneration) {
throw new Error('The UIAbility changed during the window operation.');
}
const actual = win.getWindowProperties().isPrivacyMode;
const matched = actual === targetPrivacy;
hilog.info(
LOG_DOMAIN,
LOG_TAG,
'%{public}s: before=%{public}s target=%{public}s actual=%{public}s matched=%{public}s',
action,
String(before),
String(targetPrivacy),
String(actual),
String(matched),
);
this.emitSnapshot(actual, false);
return matched;
}
生命周期编号会在 UIAbility 或 Flutter Engine 脱离时递增。排队的操作开始时、异步获取窗口后、写入完成后,代码都会检查编号是否仍然相同。宿主已经换了,旧请求就以异常结束,避免把旧窗口的成功结果传给新宿主。
这个检查只能识别过期请求,无法撤销已经提交给系统的写入。因此页面退出时仍要等自己的开启请求结束,再做恢复;否则就算插件拒绝了迟到回执,之前的写入也可能已经生效。
FIFO 队列把一次读取、写入、回读作为一笔操作,等它结束后才执行下一笔。连续切换时,第二笔才能读到第一笔刚写入的状态。上一笔抛错后,队列仍会继续;该笔错误照常返回给调用者,后续调用不必跟着失败。
监听注册也有等待过程:startWatching 请求窗口后,结果不会马上回来。这时如果调用停止,按“尚未注册就直接返回”的做法,等待中的请求仍在;窗口一旦返回,它又会把监听挂上。我给监听单独保存了一个代次,停止时就递增,只有与当前代次一致的请求才能继续注册。
private startWatching(): Promise<void> {
if (this.watchedWindow != null) {
return Promise.resolve();
}
if (this.watchStart != null) {
return this.watchStart;
}
const generation = this.watchGeneration;
const pending = this.getWindow()
.then((win: window.Window) => {
// stop 或宿主脱离后,迟到的窗口不能重新注册监听。
if (generation !== this.watchGeneration) {
throw new Error('Screenshot listening was cancelled.');
}
win.on('screenshot', this.onScreenshot);
this.watchedWindow = win;
hilog.info(LOG_DOMAIN, LOG_TAG, 'window screenshot listener attached');
});
this.watchStart = pending;
const clearPending = (): void => {
if (this.watchStart === pending) {
this.watchStart = null;
}
};
pending.then(clearPending, clearPending);
return pending;
}
private stopWatching(): void {
// 即使尚未注册,也必须使正在等待窗口的请求失效。
this.watchGeneration++;
this.watchStart = null;
const watchedWindow = this.watchedWindow;
this.watchedWindow = null;
if (watchedWindow == null) {
return;
}
try {
watchedWindow.off('screenshot', this.onScreenshot);
hilog.info(LOG_DOMAIN, LOG_TAG, 'window screenshot listener detached');
} catch (error) {
this.logFailure('detach screenshot listener', error as BusinessError);
}
}
正在注册的 Promise 和已经注册过的窗口分别保存。连续两次启动可以共用同一个请求,方法通道会等注册完成后才返回成功。停止时则在原来注册的窗口上解绑,即使其他属性操作拿到了另一个窗口,也不会找错对象。
解绑失败会记录动作、错误码和错误消息。初始快照的异步读取同样要检查订阅是否还在:旧订阅已经取消,就丢弃它的迟到结果,不能把这条数据发给后来建立的订阅。
四、安全编码契约与踩坑边界
4.1 在宿主中声明窗口权限
窗口调用还依赖宿主权限。我检查了本地 DevEco SDK 的 PermissionDefinitions.json,再与 Example 的 module.json5 对照,确认需要声明 ohos.permission.PRIVACY_WINDOW。图 12 是定义与配置的对应内容:

图12 权限契约配置
SDK 中,这项权限的级别是 normal,授权方式是 system_grant,从 API 9 起提供,不需要特殊 Profile 白名单或 ACL 证书。宿主声明后,在安装阶段由系统授予,应用不必再弹出动态权限申请。
自动授予仍以宿主声明为前提。若 requestPermissions 中漏写,窗口调用会因权限校验失败返回错误码 201,插件再把它传成 Dart 的 PlatformException。页面要捕获这个异常,保持口令不显示。组件测试模拟了权限失败时的页面行为;缺权限安装包没有单独上设备测试。
检查原版 Example 时,我顺手清理了几处配置:移除这个离线页面用不到的 INTERNET 权限,补齐多语言的 privacy_reason 词条,并清空构建文件里的签名配置。原仓库中保留过本地绝对签名路径和口令字段,这类配置应当留在开发者本机,不随示例分发。
4.2 顺序执行之外的页面保护归属

图13 通道运行日志
图 13 的日志与第二章操作对应。原版返回公开页后仍记录保护态 true,显式恢复回执为 false;修复组第二次切换的目标和实际值都是 false,匹配结果为 true。把这几行与表 2 对上,就能分清是窗口没变,还是回执与显示出了问题。
代码测试中,插件原有的 136 项 Dart 测试通过。我另加了 9 项直接执行 ETS 实现的生命周期测试,覆盖等待中停止、宿主脱离、并发启动、旧请求晚到、按注册窗口解绑,以及注册失败后重试。窗口接口在这里由测试替身提供,方便控制请求何时完成。
Example 的 8 项测试检查诊断页和安全入口,包括保护失败不显示口令、等待中宿主页被移除、退场结束前不解除、恢复失败提示和重复点击。这些测试能检查程序顺序及错误处理,这些用例中的等待和取消竞态尚未在设备上单独注入验证。
⚠️ 排好顺序,还不等于知道该由谁解除保护。假如安全页 B 的开启请求先到,旧安全页 A 的解除请求后到,队列照顺序执行,最后仍会把 B 所在窗口的保护关掉。因此多个安全页需要由应用统一管理;各页都在销毁时无条件恢复整个窗口,会互相影响。
上游 SecureWidget 在初始化时异步请求保护,包裹住内容并不意味着敏感首帧出现前请求已经完成。SecureNavigatorObserver 也不会自动解决多个页面之间的保护归属。我在第五章的普通账号页中采用单一调用入口,先等开启结果再跳转,限定一个窗口、一个保护所有者。
工程最低环境调整为 Dart 3.11.0、Flutter 3.41.0,以适配这里使用的鸿蒙工具链。实际运行分析和测试的是 Dart 3.11.5,插件与示例均通过。Android、iOS 等平台源码保留原样,没有做运行回归。
4.3 窗口与系统能力的实际边界
| 能力 | 本文可确认的范围 |
|---|---|
| 窗口保护开启与恢复 | 已在 Mate 90 Pro 模拟器与华为畅享 100 Pro Max 真机完成顺序调用及对照 |
| 截屏事件及状态快照 | 事件与状态变更分开标记;事件不等于拦截结果 |
| 截屏文件路径 | 窗口事件未提供路径,插件返回空字符串 |
| 录屏开始、结束检测 | 实现没有独立检测,字段固定为 false,不能解读成“当前没有录屏” |
| 图片、模糊、纯色遮罩 | 此鸿蒙实现返回 false;失败不能按开启保护处理 |
| 录屏与投屏保护 | 真机 USB Screen Mirroring 投屏已实测黑屏遮蔽与恢复;无线投屏与系统录屏未单独实测 |
表4 能力与验证范围
窗口获取沿用社区的 getLastWindow(context)。它可能返回顶部子窗口,并不总是主窗口。单独保存监听窗口解决的是解绑找错对象的问题,多窗口之间怎样分配保护仍需应用处理。本例没有创建 ArkUI 子窗口,浮窗、多窗并列和焦点变化都不在已测范围内。
窗口隐私模式也不是局部打码。它作用于整个窗口,无法让上半部分允许截屏、下半部分隐藏。普通 Flutter 路由共享宿主窗口时,系统并不知道哪一个 Widget 是口令卡片,开启和解除的时间要由页面控制。
鸿蒙截屏与隐私模式指南说明了系统能力及不同设备的表现。本例使用设备端截屏工具,其他快捷键、录屏和投屏入口的结果不能由它代替。外部相机也仍能拍到屏幕;真实业务中的内容显示时间和访问权限,需要另外安排。
五、结论与可直接复用的建议
5.1 适合直接复用的部分
修复后的显式恢复接口能按目标是否达成返回结果,切换接口也能在进入和离开口令页时来回改变窗口状态。如果你的页面也只是短暂显示敏感内容,可以沿用 no_screenshot 的显式开关:开启成功后显示,完全退场后恢复,false 和异常都走失败处理。单纯保护内容不需要启动截屏监听。
下面的固定提交已完整包含状态双向翻转、目标回执校验、EventChannel 状态流同步以及第三章的监听代次与宿主脱离收尾。如果你的页面还需要订阅截屏事件,记得在页面销毁时调用 stopScreenshotListening() 并取消流订阅。
5.2 在自己的项目中使用
💡 在应用的 pubspec.yaml 中添加固定提交依赖。pub.dev 发布包没有鸿蒙实现,社区原分支也不含这些状态修复,仅写包版本号无法取得这里使用的代码:
dependencies:
no_screenshot:
git:
url: https://atomgit.com/abaoge/no_screenshot.git
ref: 422f58223e9e57563bdbcb47c49e2111004dbe8c
再检查宿主 ohos/entry/src/main/module.json5:deviceTypes 包含目标设备,例如 phone 或 tablet;requestPermissions 中声明窗口隐私权限,并在 base、zh_CN、en_US 的 string.json 中补齐 privacy_reason 用途词条。
"requestPermissions": [
{
"name": "ohos.permission.PRIVACY_WINDOW",
"reason": "$string:privacy_reason",
"usedScene": {
"abilities": ["EntryAbility"],
"when": "inuse"
}
}
]
原生配置改完后,需要重新编译安装应用。在普通页导入 package:no_screenshot/no_screenshot.dart,State 保存插件实例 _plugin 和初始为 false 的 _opening,等待期间禁用按钮。RecoveryCodePage 负责显示离线演示口令,外层 MaterialApp 提供 Navigator 与 ScaffoldMessenger。打开页面的完整函数如下:
Future<void> _openRecoveryPage() async {
if (_opening) return;
setState(() => _opening = true);
try {
// 先确认保护成功,再构建敏感页面;失败时不展示口令。
final protected = await _plugin.screenshotOff();
if (!protected) throw StateError('窗口保护未达成目标状态');
if (!mounted) return;
final route = MaterialPageRoute<void>(
builder: (_) => const RecoveryCodePage(),
);
await Navigator.of(context).push(route);
// push 的 Future 在出栈时完成;completed 才表示退场动画和覆盖层已移除。
await route.completed;
} catch (error, stack) {
debugPrint('打开受保护页面失败:$error\n$stack');
if (mounted) {
ScaffoldMessenger.of(
context,
).showSnackBar(const SnackBar(content: Text('无法确认窗口保护,未展示恢复口令')));
}
} finally {
// 即使等待期间宿主页被移除,也在开启请求结束后执行收尾。
try {
if (!await _plugin.screenshotOn()) {
throw StateError('恢复截屏未达成目标状态');
}
} catch (error, stack) {
debugPrint('恢复窗口截屏失败:$error\n$stack');
if (mounted) {
ScaffoldMessenger.of(
context,
).showSnackBar(const SnackBar(content: Text('恢复截屏失败,请重新进入应用检查')));
}
}
if (mounted) setState(() => _opening = false);
}
}
5.3 两个容易忽略的接入条件
这里特意多等了一步:Navigator.push 的 Future 在路由出栈时就完成,退场动画可能还在播放;route.completed 完成时,路由覆盖层才已移除。如果只等前者就恢复截屏,口令仍可见的那段退场过程就可能失去保护。
另一种情况是开启请求还没结束,普通页先被移除了。函数会在请求完成后检查 mounted,不再创建敏感路由,但仍进入 finally 恢复窗口。这样收尾发生在开启之后,不会被迟到的开启操作重新覆盖。
这个入口只适合单一保护所有者。另一个安全弹窗或路由若也需要保护,应交给同一个应用控制器处理,等所有敏感内容退出后再恢复窗口。当前鸿蒙实现不支持图片、模糊或纯色遮罩;选用默认安全模式时,也仍要处理页面首帧和退出时机。
同款验证 Example保留了第二章的诊断面板与第五章的安全路由入口,工程 README说明了构建方法。诊断入口用于观察接口行为;业务页接入上面的函数时,不要再让诊断按钮同时改变同一个窗口。
小结
口令卡片收起后,公开页应该重新允许截屏。修正翻转逻辑、布尔回执和异步监听收尾后,离开恢复口令页即可恢复正常截屏与投屏 🎉,模拟器与畅享 100 Pro Max 真机对照都验证了这一结果。我也因此更留意界面上那些看似明确的状态提示:一个 true 可能表示调用成功,也可能是上一次截屏时留下的保护状态。把它们与当时的窗口属性对上,再安排页面的进入和退出,才能看清保护在哪一步生效、在哪一步解除。
参考资料
AtomGit 是由开放原子开源基金会联合 CSDN 等生态伙伴共同推出的新一代开源与人工智能协作平台。平台坚持“开放、中立、公益”的理念,把代码托管、模型共享、数据集托管、智能体开发体验和算力服务整合在一起,为开发者提供从开发、训练到部署的一站式体验。
更多推荐

所有评论(0)