{"_id":"@cordova-ohos/cordova-plugin-privacyscreen","_rev":"3-c23ee638dad76953ace10e35fe483397","name":"@cordova-ohos/cordova-plugin-privacyscreen","dist-tags":{"latest":"0.4.1"},"versions":{"0.4.0":{"name":"@cordova-ohos/cordova-plugin-privacyscreen","version":"0.4.0","keywords":["cordova","privacyscreen","ecosystem:cordova","cordova-openharmony"],"author":{"name":"Huawei Device, Inc. Ltd. and","email":"马弓手"},"license":"Apache-2.0","_id":"@cordova-ohos/cordova-plugin-privacyscreen@0.4.0","maintainers":[{"name":"luqi_tan","email":"295099422@qq.com"},{"name":"wanpengsz","email":"wanpengsz@163.com"},{"name":"xkh111","email":"xukaihui11@163.com"}],"bugs":{"url":"https://gitcode.com/OpenHarmony-Cordova/cordova-plugin-privacyscreen/issues"},"dist":{"shasum":"3021b42e4b50c3bc09925d90c562cff65ffd2941","tarball":"https://registry.npmjs.org/@cordova-ohos/cordova-plugin-privacyscreen/-/cordova-plugin-privacyscreen-0.4.0.tgz","fileCount":8,"integrity":"sha512-iS6z5JSjVTut1ntCFgBeNqRKSYEWQ51Z9DQ5w4YMicT6lB6R6C4uE/ClFLrHZFOjJPfBzi/HQquHgu2GL/AFhg==","signatures":[{"sig":"MEQCIGsHXrJoGAexuMD8miczPTszRZPPC2s2wZ8VZ+yQAHD6AiBqEg7TK1AaZ6RJA5/TFiZfPoC75oc85LtAhV0jM1v6Ag==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":27137},"cordova":{"id":"cordova-plugin-privacyscreen","platforms":["ohos"]},"engines":{"cordovaDependencies":{"0.4.0":{"hcordova":">=1.0.0","@cordova-ohos/ohos":">=2.0.0"}}},"gitHead":"6f9c31078338b932e1e6c4c66ad36c5339216ea4","_npmUser":{"name":"wanpengsz","email":"wanpengsz@163.com"},"repository":{"url":"gitcode:OpenHarmony-Cordova/cordova-plugin-privacyscreen","type":"git"},"_npmVersion":"9.6.2","description":"Cordova privacyscreen Plugin","directories":{},"_nodeVersion":"20.16.0","_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/cordova-plugin-privacyscreen_0.4.0_1773997529887_0.1473272574462432","host":"s3://npm-registry-packages-npm-production"}},"0.4.1":{"name":"@cordova-ohos/cordova-plugin-privacyscreen","version":"0.4.1","description":"Cordova Privacy Screen Plugin","cordova":{"id":"cordova-plugin-privacyscreen","platforms":["ohos"]},"repository":{"type":"git","url":"gitcode:CPF-Cordova/cordova-plugin-privacyscreen"},"bugs":{"url":"https://gitcode.com/CPF-Cordova/cordova-plugin-privacyscreen/issues"},"keywords":["cordova","privacyscreen","ecosystem:cordova","cordova-openharmony"],"engines":{"cordovaDependencies":{"0.4.1":{"@cordova-ohos/ohos":">=2.0.0","hcordova":">=1.0.0"}}},"author":{"name":"Huawei Device, Inc. Ltd. and","email":"马弓手"},"license":"Apache-2.0","_id":"@cordova-ohos/cordova-plugin-privacyscreen@0.4.1","gitHead":"a230803292317277aa6230b1b6f88880bb4ff273","_nodeVersion":"22.0.0","_npmVersion":"10.5.1","dist":{"integrity":"sha512-8nlAKXFRTA4+bTZOMbJSpKrK+IO+3mdemaGkIEvKIS1wI+cGiTQ9emdHrJbKVmIgPI+totUlH5Ha9mD5LHB9ww==","shasum":"e933100ca5108d267bb650b38e476228c6932e11","tarball":"https://registry.npmjs.org/@cordova-ohos/cordova-plugin-privacyscreen/-/cordova-plugin-privacyscreen-0.4.1.tgz","fileCount":9,"unpackedSize":48028,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEQCIHChTmgjrPcPxjieCuG/+9aWhVmg9H3wBfs/MwJ+9e8qAiANDfSj93SuuDKkHrSi5rT/zgTfDNWWOikxJQbdZd7qlw=="}]},"_npmUser":{"name":"luqi_tan","email":"295099422@qq.com"},"directories":{},"maintainers":[{"name":"luqi_tan","email":"295099422@qq.com"},{"name":"wanpengsz","email":"wanpengsz@163.com"},{"name":"xkh111","email":"xukaihui11@163.com"},{"name":"hcordova","email":"chenlihuiabc@163.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/cordova-plugin-privacyscreen_0.4.1_1785155298972_0.24796765067927518"},"_hasShrinkwrap":false}},"time":{"created":"2026-03-20T09:05:29.821Z","modified":"2026-07-27T12:28:19.383Z","0.4.0":"2026-03-20T09:05:30.042Z","0.4.1":"2026-07-27T12:28:19.142Z"},"bugs":{"url":"https://gitcode.com/CPF-Cordova/cordova-plugin-privacyscreen/issues"},"author":{"name":"Huawei Device, Inc. Ltd. and","email":"马弓手"},"license":"Apache-2.0","keywords":["cordova","privacyscreen","ecosystem:cordova","cordova-openharmony"],"repository":{"type":"git","url":"gitcode:CPF-Cordova/cordova-plugin-privacyscreen"},"description":"Cordova Privacy Screen Plugin","maintainers":[{"name":"luqi_tan","email":"295099422@qq.com"},{"name":"wanpengsz","email":"wanpengsz@163.com"},{"name":"xkh111","email":"xukaihui11@163.com"},{"name":"hcordova","email":"chenlihuiabc@163.com"}],"readme":"# <center>cordova-plugin-privacyscreen</center>\r\n\r\n[![zh-CN](https://img.shields.io/badge/lang-中文-blue.svg)](README.md)\r\n[![en](https://img.shields.io/badge/lang-English-blue.svg)](README.en.md)\r\n\r\n本项目基于 [cordova-plugin-privacyscreen@0.4.0](https://www.npmjs.com/package/cordova-plugin-privacyscreen/v/0.4.0) 开发，本文档重点阐述其在 OpenHarmony（OHOS）系统中的具体应用。\r\n\r\n- [cordova-plugin-privacyscreen](#cordova-plugin-privacyscreen)\r\n  - [简介](#简介)\r\n  - [功能特性](#功能特性)\r\n  - [支持平台](#支持平台)\r\n  - [下载安装](#下载安装)\r\n    - [前提条件](#前提条件)\r\n    - [从 npm 安装（推荐）](#从-npm-安装推荐)\r\n    - [从 GitCode 仓库安装](#从-gitcode-仓库安装)\r\n    - [离线安装（本地包）](#离线安装本地包)\r\n    - [安装后验证](#安装后验证)\r\n    - [卸载](#卸载)\r\n  - [约束与限制](#约束与限制)\r\n    - [兼容性](#兼容性)\r\n  - [使用示例](#使用示例)\r\n    - [1. 基础使用示例（无需编码）](#1-基础使用示例无需编码)\r\n    - [2. 安装验证示例](#2-安装验证示例)\r\n  - [使用说明](#使用说明)\r\n    - [1. 基础使用说明](#1-基础使用说明)\r\n    - [2. 注意事项](#2-注意事项)\r\n  - [目录结构](#目录结构)\r\n  - [贡献代码](#贡献代码)\r\n  - [许可证](#许可证)\r\n  - [官方资源](#官方资源)\r\n\r\n\r\n## 简介\r\n\r\n`cordova-plugin-privacyscreen` 是一款专为 Cordova 混合移动应用打造的隐私屏幕保护插件，旨在防止应用在后台或屏幕锁定时敏感信息被泄露。通过自动显示遮罩层、模糊界面或自定义保护视图等方式，为金融、医疗、社交等涉及敏感数据的应用提供全方位的隐私防护。\r\n\r\n## 功能特性\r\n\r\n- **自动隐私防护**：应用切换到后台或屏幕锁定时，自动触发隐私保护，防止敏感信息泄露\r\n\r\n- **多防护方式支持**：支持遮罩层显示、界面模糊、自定义保护视图等多种防护形式\r\n\r\n- **无需额外编码**：插件安装后自动开启屏幕保护，禁止截屏、录屏操作，无需编写额外代码\r\n\r\n- **跨平台适配**：兼容 Android、iOS、OHOS 等多平台，遵循 Cordova 插件规范，适配性强\r\n\r\n- **轻量无侵入**：插件体积小，不占用过多设备资源，不影响应用原有运行性能\r\n\r\n## 支持平台\r\n\r\n- **Android**（API 级别 22 及以上）\r\n\r\n- **iOS**（iOS 11.0 及以上）\r\n\r\n- **OHOS**（5.0 及以上）\r\n\r\n## 下载安装\r\n\r\n通过 hcordova CLI 即可快速安装插件，支持从 npm 仓库或 GitCode 仓库获取，安装前请确保已创建 Cordova 项目（若未创建，执行 `cordova create privacyApp com.example.privacyapp PrivacyApp` 创建）。\r\n\r\n### 前提条件\r\n\r\n在安装插件前，请确保开发环境已满足以下条件：\r\n\r\n- 已安装 Node.js（v14.0.0 及以上）和 npm（v6.0.0 及以上）\r\n\r\n- 已安装 HCordova CLI（10.0.0 及以上），可通过以下命令安装：\r\n\r\n```bash\r\nnpm install -g hcordova\r\n```\r\n\r\n- 已创建 Cordova 项目（若未创建，可通过 `cordova create privacyApp com.example.privacyapp PrivacyApp` 命令创建）\r\n\r\n### 从 npm 安装（推荐）\r\n\r\n```bash\r\n# 安装最新稳定版插件\r\nhcordova plugin add cordova-plugin-privacyscreen\r\n\r\n# 安装指定版本（示例：1.0.0 版本）\r\nhcordova plugin add cordova-plugin-privacyscreen@1.0.0 --platform ohos\r\n```\r\n\r\n### 从 GitCode 仓库安装\r\n\r\n适用于需要体验最新功能的开发者，仅为 OHOS 平台安装开发版插件：\r\n\r\n```bash\r\n# 仅支持 OHOS 平台\r\nhcordova plugin add https://gitcode.com/CPF-Cordova/cordova-plugin-privacyscreen.git --platform ohos\r\n\r\n# 指定标签/分支安装\r\nhcordova plugin add https://gitcode.com/CPF-Cordova/cordova-plugin-privacyscreen.git@develop --platform ohos\r\n```\r\n\r\n### 离线安装（本地包）\r\n\r\n适用于无网络环境，先下载插件包到本地，再执行离线安装：\r\n\r\n```bash\r\n# 下载插件包到本地（示例路径：~/Downloads/cordova-plugin-privacyscreen）\r\n# 执行离线安装\r\nhcordova plugin add ~/Downloads/cordova-plugin-privacyscreen --platform ohos\r\n```\r\n\r\n### 安装后验证\r\n\r\n安装完成后，可通过以下命令验证插件是否成功添加到项目中：\r\n\r\n```bash\r\n# 查看已安装的插件列表，若包含本插件 ID 则表示插件已成功安装\r\nhcordova plugin list\r\n```\r\n\r\n\r\n### 卸载\r\n\r\n进入项目根目录，执行以下命令卸载插件，卸载后建议重新构建项目以清理残留文件：\r\n\r\n```bash\r\n# Cordova CLI 全平台卸载\r\nhcordova plugin remove cordova-plugin-privacyscreen \r\n\r\n# 指定平台卸载\r\nhcordova plugin remove cordova-plugin-privacyscreen --platform ohos\r\n```\r\n\r\n## 约束与限制\r\n\r\n- 依赖插件：无强制依赖，可直接集成到 Cordova 项目中使用\r\n\r\n- 防护范围：主要针对应用后台切换、屏幕锁定场景，以及截屏、录屏操作，无法防护设备 root 后的恶意获取行为\r\n\r\n- 自定义限制：基础防护功能无需编码，若需自定义保护视图，需额外编写适配多平台的原生代码\r\n\r\n### 兼容性\r\n\r\n支持：\r\n\r\n| 项目 | 版本/信息 |\r\n|-----|--------|\r\n| SDK | API12+ |\r\n| IDE | DevEco Studio: 5.0+ |\r\n| ROM | 5.1+ |\r\n| Emulator | OpenHarmony 6.0+ |\r\n\r\n在以下版本中已测试通过：\r\n\r\n| 项目 | 版本/信息 |\r\n|-----|--------|\r\n| @cordova-ohos/ohos | 14.0.1-ohos-14.0.1 |\r\n| SDK | 5.0.0(12) |\r\n| IDE | DevEco Studio: 6.0.13.200 |\r\n| ROM | 5.1.0.120 SP3 |\r\n| Emulator | OpenHarmony 6.0.1(21) |\r\n\r\n## 使用示例\r\n\r\n本插件安装后无需编写任何代码，自动开启隐私防护功能，以下为核心功能的使用说明及简单验证示例：\r\n\r\n### 1. 基础使用示例（无需编码）\r\n\r\n插件安装完成后，重新构建并运行项目，即可自动触发以下防护效果：\r\n\r\n- 应用切换到后台（如按 home 键、切换三方应用）时，自动显示遮罩层或模糊界面，隐藏敏感信息\r\n\r\n- 屏幕锁定时，应用界面自动被保护，解锁后恢复正常显示\r\n\r\n- 禁止设备对应用界面进行截屏、录屏操作，防止敏感信息被留存\r\n\r\n### 2. 安装验证示例\r\n\r\n安装完成后，可通过以下步骤验证插件是否正常工作：\r\n\r\n```javascript\r\n// Cordova 加载完成后，验证插件是否加载成功\r\ndocument.addEventListener('deviceready', function() {\r\n    console.log('Cordova 已加载完成');\r\n    // 验证插件是否存在\r\n    if (cordova.plugins.privacyscreen) {\r\n        console.log('隐私屏幕插件加载成功，已自动开启防护');\r\n    } else {\r\n        console.log('隐私屏幕插件加载失败，请检查安装是否正确');\r\n    }\r\n}, false);\r\n```\r\n\r\n## 使用说明\r\n\r\n以下为插件使用的核心说明，包括基础使用、注意事项等，帮助开发者快速上手并避免异常。\r\n\r\n### 1. 基础使用说明\r\n\r\n本插件为“安装即生效”模式，无需编写任何额外代码，安装完成并重新构建项目后，自动开启所有基础隐私防护功能：\r\n\r\n- 防护触发场景：应用切换到后台、屏幕锁定、尝试截屏/录屏时，自动触发防护\r\n\r\n- 默认防护方式：采用系统默认遮罩层（黑色或半透明），隐藏应用界面敏感信息\r\n\r\n- 无需手动初始化：插件会在 Cordova 加载完成后自动初始化，无需调用任何 API\r\n\r\n### 2. 注意事项\r\n\r\n- 构建要求：插件安装后，需重新构建项目（如 `hcordova build ohos`），否则防护功能可能无法正常生效\r\n\r\n- 权限说明：部分平台（如 Android 10+、OHOS）需要授予应用“后台显示”“禁止截屏”相关权限，插件会自动申请，若用户拒绝，防护功能可能失效\r\n\r\n- 自定义防护：若需自定义保护视图（如添加应用 logo、提示文字），需参考插件官方指南，编写多平台原生适配代码\r\n\r\n- 卸载残留：卸载插件后，建议重新构建项目，清理残留的原生配置文件，避免影响应用后续运行\r\n\r\n- 兼容性提示：部分老旧设备或自定义 ROM 可能存在防护效果异常，建议在目标设备上进行测试验证\r\n\r\n## 目录结构\r\n\r\n```\r\ncordova-plugin-privacyscreen       # [根目录] 隐私屏幕插件项目根目录\r\n├── src                            # [源码目录] 存放原生平台代码\r\n│   └── main                       # [主目录] 主代码目录\r\n│       ├── cpp                    # [C++ 目录] C++ 原生代码目录\r\n│       │   └── FullScreen         # [C++ 模块] 全屏/隐私屏幕 C++ 模块文件夹\r\n│       │       ├── PrivacyScreenPlugin.cpp # [C++ 实现] C++ 源文件，实现隐私屏幕底层逻辑\r\n│       │       └── PrivacyScreenPlugin.h   # [C++ 声明] C++ 头文件，定义插件接口\r\n│       └── ets                    # [ArkTS 目录] ArkTS/ETS 代码目录\r\n│           └── components         # [组件目录] 存放逻辑组件\r\n│               └── PluginAction   # [TS 模块] 插件动作逻辑文件夹\r\n│                   └── SetWindowPrivacyMode.ets # [ETS 文件] 设置窗口隐私模式的 ArkTS 实现\r\n├── .gitignore                     # [Git 配置] 指定 Git 版本控制中需要忽略的文件和目录\r\n├── LICENSE                        # [许可证] 项目的开源协议或版权声明\r\n├── OAT.xml                        # [配置文件] 门禁配置文件\r\n├── package.json                   # [配置文件] Node.js 项目的依赖和脚本配置\r\n├── plugin.xml                     # [配置文件] Cordova 插件的核心配置文件\r\n└── README.md                      # [文档] 项目说明文档，通常包含安装和使用指南\r\n```\r\n\r\n## 贡献代码\r\n\r\n使用过程中发现任何问题都可以提 [Issue](https://gitcode.com/CPF-Cordova/cordova-plugin-privacyscreen/issues) ，当然也非常欢迎发 [PR](https://gitcode.com/CPF-Cordova/cordova-plugin-privacyscreen/pulls) 共建。\r\n\r\n## 许可证\r\n\r\n本插件基于 **Apache License 2.0** 开源，详见 [LICENSE](LICENSE) 文件。\r\n\r\n## 官方资源\r\n\r\n- Android 和 iOS：[cordova-plugin-privacyscreen 官方指南](https://www.npmjs.com/package/cordova-plugin-privacyscreen)\r\n\r\n- GitCode 仓库：[CPF-Cordova/cordova-plugin-privacyscreen](https://gitcode.com/CPF-Cordova/cordova-plugin-privacyscreen)\r\n","readmeFilename":"README.md"}