Ionic Capacitor Angular 自定义插件实现仅指定页面禁用截图方法

• 线程权限异常来源：Capacitor的@PluginMethod标注的原生方法，默认运行在插件独立工作线程，而非Android应用的UI主线程。Window属性修改属于UI操作范畴，强制要求在UI主线程执行，跨线程操作就会直接抛出「仅创建视图的线程可修改视图」的异常。
• 手动创建Activity的错误逻辑：Android的Activity实例由系统通过生命周期栈统一管理，手动执行new MainActivity()创建的对象只是普通Java类实例，没有绑定系统Window、应用上下文，既无法正常调用getWindow()方法，也会触发编译错误、空指针等各类运行时问题，本身就不符合Android开发规范。
• 全范围禁截图的问题来源：在MainActivity的onCreate方法中设置的FLAG_SECURE是全局主Window级别的标记，只要应用主Window存在，标记就会一直生效，不会随前端页面路由切换自动清除，因此会出现全应用禁截图的不符合预期的效果。

1. 修复自定义Capacitor插件的原生逻辑 #

核心调整是将Window标记的修改操作切换到UI主线程执行，同时移除全应用默认禁截图的逻辑，修改后的Screenshot.java代码如下：

@NativePlugin
public class Screenshot extends Plugin {

    @PluginMethod
    public void enableScreenshot(PluginCall call) {
        Activity activity;
        try {
            // 直接通过Plugin基类封装的方法获取系统有效Activity实例
            activity = getActivity();
            // 将Window属性修改操作投递到UI主线程执行
            activity.runOnUiThread(() -> {
                activity.getWindow().clearFlags(WindowManager.LayoutParams.FLAG_SECURE);
            });
        } catch (Exception e) {
            Log.e("ScreenshotPlugin", "enableScreenshot execute failed", e);
            call.reject("恢复截图能力失败", e);
            return;
        }
        JSObject ret = new JSObject();
        ret.put("status", true);
        call.success(ret);
    }

    @PluginMethod
    public void disableScreenshot(PluginCall call) {
        Activity activity;
        try {
            activity = getActivity();
            activity.runOnUiThread(() -> {
                activity.getWindow().setFlags(
                    WindowManager.LayoutParams.FLAG_SECURE,
                    WindowManager.LayoutParams.FLAG_SECURE
                );
            });
        } catch (Exception e) {
            Log.e("ScreenshotPlugin", "disableScreenshot execute failed", e);
            call.reject("禁用截图能力失败", e);
            return;
        }
        JSObject ret = new JSObject();
        ret.put("status", true);
        call.success(ret);
    }
}

同步修改MainActivity的onCreate方法，删除全局设置FLAG_SECURE的代码，保留插件注册逻辑：

public class MainActivity extends BridgeActivity {

  @Override
  public void onCreate(Bundle savedInstanceState) {
    super.onCreate(savedInstanceState);
    // 删除原全局设置FLAG_SECURE的代码行

    // Initializes the Bridge
    this.init(savedInstanceState, new ArrayList<Class<? extends Plugin>>() {{
      add(Contacts.class);
      add(Screenshot.class);
    }});
  }
}

这部分调整直接解决两个核心报错：

• 通过runOnUiThread切换执行线程，从根源解决跨线程修改Window属性的权限异常
• 移除手动new Activity的错误思路，通过Plugin基类提供的getActivity()方法获取系统管理的有效Activity实例，解决编译错误、符号无法解析的问题

2. 前端页面级控制逻辑 #

Ionic应用的主Window是全局共享的，只需要在进入敏感页时打上禁截图标记，离开敏感页时清除标记，就可以实现仅指定页面禁截图的效果，不需要为每个页面单独创建Window。
首先完成插件的前端TypeScript封装：

import { registerPlugin } from '@capacitor/core';

export interface ScreenshotPluginDefinitions {
  enableScreenshot(): Promise<{ status: boolean }>;
  disableScreenshot(): Promise<{ status: boolean }>;
}

const Screenshot = registerPlugin<ScreenshotPluginDefinitions>('Screenshot');

export { Screenshot };

在需要禁用截图的敏感页面中，结合Ionic/Angular的路由生命周期调用插件方法，示例代码如下：

import { Component, OnInit } from '@angular/core';
import { Screenshot } from '../../plugins/screenshot-plugin';

@Component({
  selector: 'app-sensitive-page',
  templateUrl: './sensitive-page.page.html',
  styleUrls: ['./sensitive-page.page.scss'],
})
export class SensitivePage implements OnInit {

  async ngOnInit() {
    // 进入敏感页面时，禁用截图能力
    await Screenshot.disableScreenshot();
  }

  async ionViewDidLeave() {
    // 离开敏感页面时，恢复正常截图能力
    await Screenshot.enableScreenshot();
  }

  async ngOnDestroy() {
    // 兜底调用，避免页面异常销毁时漏清标记
    await Screenshot.enableScreenshot();
  }
}

3. 注意事项 #

• 所有获取Activity实例的场景，一律通过Capacitor Plugin基类提供的getActivity()方法获取，绝对不要手动实例化Activity类
• 页面切换时必须做好标记清除的兜底逻辑，避免用户通过系统手势、返回键退出敏感页时，漏调enableScreenshot导致其他页面也被误禁截图
• 插件注册的类名需要和MainActivity中init方法注册的插件类保持一致，避免前端调用时找不到对应原生方法

内容的提问来源于stack exchange，提问作者Yaseen