{"_id":"@cordova-ohos/cordova-plugin-statusbar","_rev":"5-da1e0d37bad08390215b30d26fd639fe","name":"@cordova-ohos/cordova-plugin-statusbar","dist-tags":{"latest":"4.0.1"},"versions":{"4.0.0":{"name":"@cordova-ohos/cordova-plugin-statusbar","version":"4.0.0","keywords":["cordova","statusbar","ecosystem:cordova","cordova-openharmony"],"author":{"name":"Huawei Device, Inc. Ltd. and","email":"马弓手"},"license":"Apache-2.0","_id":"@cordova-ohos/cordova-plugin-statusbar@4.0.0","maintainers":[{"name":"luqi_tan","email":"295099422@qq.com"}],"bugs":{"url":"https://gitcode.com/OpenHarmony-Cordova/cordova-plugin-statusbar/issues"},"dist":{"shasum":"ce5db7f44623c5fa4f7a899376b7e229a8c4894f","tarball":"https://registry.npmjs.org/@cordova-ohos/cordova-plugin-statusbar/-/cordova-plugin-statusbar-4.0.0.tgz","fileCount":10,"integrity":"sha512-cANujlqy2LAXUTkvh4Qss92A1++QYXBnJryyoVoBatQVtpRmUi6bSNWCs24RfZ8Kkym6rExzuPLjlNzYETBkRg==","signatures":[{"sig":"MEYCIQC5U4qfh067qqdWbM30fJaAEkQVbkOulCFOHPa+SH2HKwIhALcRd8iekBso071Eibvafal+ttqVD+o+3yaZ2OaliLGS","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":64252},"cordova":{"id":"cordova-plugin-statusbar","platforms":["ohos"]},"engines":{"cordovaDependencies":{"4.0.0":{"hcordova":">=1.0.0","@cordova-ohos/ohos":">=2.0.0"}}},"gitHead":"0803fcbf0298735f572b237a8437da9100c96f65","_npmUser":{"name":"luqi_tan","email":"295099422@qq.com"},"repository":{"url":"gitcode:OpenHarmony-Cordova/cordova-plugin-statusbar","type":"git"},"_npmVersion":"10.5.1","description":"Cordova statusbar Plugin","directories":{},"_nodeVersion":"22.0.0","_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/cordova-plugin-statusbar_4.0.0_1773924723167_0.025895320818336787","host":"s3://npm-registry-packages-npm-production"}},"4.0.1":{"name":"@cordova-ohos/cordova-plugin-statusbar","version":"4.0.1","description":"Cordova Status Bar Plugin","cordova":{"id":"cordova-plugin-statusbar","platforms":["ohos"]},"repository":{"type":"git","url":"gitcode:CPF-Cordova/cordova-plugin-statusbar"},"bugs":{"url":"https://gitcode.com/CPF-Cordova/cordova-plugin-statusbar/issues"},"keywords":["cordova","statusbar","ecosystem:cordova","cordova-openharmony"],"engines":{"cordovaDependencies":{"4.0.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-statusbar@4.0.1","gitHead":"370d6c6b5114e39a055be1d942481e8af0050bc8","_nodeVersion":"22.0.0","_npmVersion":"10.5.1","dist":{"integrity":"sha512-kIJj34Cew3njhm1yBVDbz3cRDgh2c2DvLsJlNU1lJaiafyBxfoObRZvPkxaBTGS/1FAJV7BQOost/qZOZ2el4A==","shasum":"7bffc725e240fd5ecd14f207de2292b8db67698d","tarball":"https://registry.npmjs.org/@cordova-ohos/cordova-plugin-statusbar/-/cordova-plugin-statusbar-4.0.1.tgz","fileCount":11,"unpackedSize":87413,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIAv5VmZbQXNldaPTmMpsRx5VLu2TOKeYjxXUKenU2ocRAiEA8KO6JGudUrYEg9LleG/dAHYSSlo2F/DG9gEPphXpTd0="}]},"_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-statusbar_4.0.1_1785142543168_0.427698330041979"},"_hasShrinkwrap":false}},"time":{"created":"2026-03-19T12:52:03.076Z","modified":"2026-07-27T08:55:43.521Z","4.0.0":"2026-03-19T12:52:03.312Z","4.0.1":"2026-07-27T08:55:43.318Z"},"bugs":{"url":"https://gitcode.com/CPF-Cordova/cordova-plugin-statusbar/issues"},"author":{"name":"Huawei Device, Inc. Ltd. and","email":"马弓手"},"license":"Apache-2.0","keywords":["cordova","statusbar","ecosystem:cordova","cordova-openharmony"],"repository":{"type":"git","url":"gitcode:CPF-Cordova/cordova-plugin-statusbar"},"description":"Cordova Status Bar 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-statusbar</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-statusbar@4.0.0](https://npmjs.com/package/cordova-plugin-statusbar/v/4.0.0) 开发，本文档重点阐述其在 OpenHarmony（OHOS）系统中的具体应用。\r\n\r\n- [cordova-plugin-statusbar](#cordova-plugin-statusbar)\r\n  - [简介](#简介)\r\n  - [功能特性](#功能特性)\r\n  - [支持平台](#支持平台)\r\n  - [下载安装](#下载安装)\r\n    - [前提条件](#前提条件)\r\n    - [基础版安装（推荐）](#基础版安装推荐)\r\n    - [指定平台安装 ohos](#指定平台安装-ohos)\r\n    - [从 GitCode 仓库安装](#从-gitcode-仓库安装)\r\n    - [安装指定版本](#安装指定版本)\r\n    - [离线安装（本地包）](#离线安装本地包)\r\n    - [安装后验证](#安装后验证)\r\n    - [卸载](#卸载)\r\n  - [约束与限制](#约束与限制)\r\n    - [兼容性](#兼容性)\r\n  - [核心概念](#核心概念)\r\n    - [1. 插件命名空间](#1-插件命名空间)\r\n    - [2. 核心配置方式](#2-核心配置方式)\r\n    - [3. 调用前提](#3-调用前提)\r\n  - [使用示例](#使用示例)\r\n    - [1. 完整功能示例（含模式切换、状态监控）](#1-完整功能示例含模式切换状态监控)\r\n    - [2. 单个 API 调用示例](#2-单个-api-调用示例)\r\n  - [使用说明](#使用说明)\r\n    - [核心说明](#核心说明)\r\n    - [API 及参数说明](#api-及参数说明)\r\n      - [1. 核心 API 列表](#1-核心-api-列表)\r\n      - [2. config.xml 配置说明](#2-configxml-配置说明)\r\n      - [3. 补充说明](#3-补充说明)\r\n  - [目录结构](#目录结构)\r\n  - [贡献代码](#贡献代码)\r\n  - [许可证](#许可证)\r\n  - [官方资源](#官方资源)\r\n\r\n\r\n## 简介\r\n\r\ncordova-plugin-statusbar 是 Apache Cordova 生态中用于管理移动应用状态栏的核心插件。状态栏作为移动设备屏幕顶部的系统级界面元素，包含时间、电池电量、信号强度等关键信息，该插件允许开发者在跨平台 Cordova 应用中，对状态栏的样式、可见性、行为进行全方位自定义，实现应用视觉风格与系统状态栏的统一，提升用户体验，本文档重点说明该插件在 OHOS 系统中的应用配置与使用方法。\r\n\r\n## 功能特性\r\n\r\n- **多平台适配**：深度适配 Android（API 21+）、iOS（10.0+）、Windows（10+）、Browser 主流浏览器及 OHOS（5.0+），确保跨平台状态栏控制一致性\r\n\r\n- **样式自定义**：支持动态修改状态栏背景色、文字/图标颜色，适配深色/浅色模式切换，支持沉浸式布局配置\r\n\r\n- **可见性灵活控制**：支持显示/隐藏状态栏，带动画过渡效果，适配全屏场景（如视频播放、游戏）\r\n\r\n- **布局适配优化**：可设置状态栏是否覆盖 WebView，自动适配 notch 屏、动态岛等特殊屏幕，避免内容遮挡\r\n\r\n- **状态实时监控**：可实时获取状态栏当前可见状态，便于根据状态调整应用布局\r\n\r\n- **OHOS 专属特性**：新增状态栏文字颜色、导航条样式等专属配置，适配 OHOS 系统特性，区别于 Android 和 iOS 平台\r\n\r\n## 支持平台\r\n\r\n- **Android**：API 级别 21 及以上（Android 5.0+），支持 Material Design 风格状态栏配置\r\n\r\n- **iOS**：10.0 及以上，适配 iPhone、iPad 全系列，支持动态岛、notch 屏适配\r\n\r\n- **Windows**：Windows 10 及以上，支持 UWP 通用应用场景\r\n\r\n- **Browser**：主流桌面及移动浏览器（Chrome、Firefox、Edge、Safari），模拟状态栏样式与行为\r\n\r\n- **OHOS**：5.0+，支持 OHOS 系统专属状态栏配置\r\n\r\n## 下载安装\r\n\r\n确保已创建 Cordova 项目，进入项目根目录后通过 hcordova CLI 安装插件，支持从 npm 仓库或 GitCode 仓库获取，安装后插件会自动处理各平台依赖与配置。\r\n\r\n### 前提条件\r\n\r\n- 已安装 Node.js（v14.0.0+）和 npm（v6.0.0+），可通过 `node -v`、`npm -v` 验证版本\r\n\r\n- 已全局安装 hcordova 命令工具，未安装可执行 `npm install -g hcordova`\r\n\r\n- 已创建 Cordova 项目，未创建可执行 `hcordova create MyStatusBarApp com.example.statusbarapp 状态栏示例应用`\r\n\r\n### 基础版安装（推荐）\r\n\r\n适用于大多数场景，直接从 npm 仓库安装稳定版：\r\n```bash\r\n# 使用 hcordova CLI 安装\r\n# 安装 hcordova 命令化工具\r\nnpm install -g hcordova\r\n\r\n# 全平台安装插件\r\nhcordova plugin add cordova-plugin-statusbar\r\n```\r\n\r\n### 指定平台安装 ohos\r\n\r\n仅为 OHOS 平台安装插件：\r\n\r\n```bash\r\n# 仅安装到 OHOS 平台\r\nhcordova plugin add cordova-plugin-statusbar --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-statusbar.git --platform ohos\r\n\r\n# 指定标签/分支安装\r\nhcordova plugin add https://gitcode.com/CPF-Cordova/cordova-plugin-statusbar.git@develop --platform ohos\r\n```\r\n\r\n### 安装指定版本\r\n\r\n```bash\r\n# 仅安装到 OHOS 平台指定版本\r\nhcordova plugin add cordova-plugin-statusbar@1.0.0 --platform ohos\r\n```\r\n\r\n### 离线安装（本地包）\r\n\r\n适用于无网络环境，先下载插件包到本地，再执行离线安装：\r\n\r\n```bash\r\n# 下载插件包到本地（示例路径：../Downloads/cordova-plugin-statusbar）\r\n# 执行离线安装\r\nhcordova plugin add ../Downloads/cordova-plugin-statusbar  --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```bash\r\n# 全平台卸载\r\nhcordova plugin remove cordova-plugin-statusbar\r\n\r\n# 指定 OHOS 平台卸载\r\nhcordova plugin remove cordova-plugin-statusbar --platform ohos\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### 1. 插件命名空间\r\n\r\n插件通过全局对象 `StatusBar` 暴露所有 API 方法，无需额外引入，所有操作均通过该对象调用。\r\n\r\n### 2. 核心配置方式\r\n\r\n状态栏基础样式和默认行为通过项目根目录的 `config.xml` 文件配置，配置项在应用启动时生效，覆盖系统默认设置；运行时动态修改需通过 API 调用实现。\r\n\r\n### 3. 调用前提\r\n\r\n所有 API 需在 Cordova 的 `deviceready` 事件触发后调用，确保原生接口已初始化，避免因环境未就绪导致调用失败。\r\n\r\n## 使用示例\r\n\r\n插件通过全局对象 `StatusBar` 调用所有方法，以下为各核心功能的纯代码使用示例，可直接复制到项目中使用（API 及参数详情见「使用说明」章节）。\r\n\r\n### 1. 完整功能示例（含模式切换、状态监控）\r\n\r\n```javascript\r\n// 等待 Cordova 环境就绪\r\ndocument.addEventListener('deviceready', function() {\r\n  // 1. 显示状态栏（带动画）\r\n  document.getElementById('showStatusBar').addEventListener('click', function() {\r\n      if (StatusBar) {\r\n          StatusBar.show();\r\n          console.log('状态栏已显示');\r\n          updateStatusText();\r\n      } else {\r\n          console.error('StatusBar API 未加载，插件可能未安装');\r\n      }\r\n  });\r\n\r\n  // 2. 隐藏状态栏（带动画）\r\n  document.getElementById('hideStatusBar').addEventListener('click', function() {\r\n      if (StatusBar) {\r\n          StatusBar.hide(true); // true 启用动画\r\n          console.log('状态栏已隐藏');\r\n          updateStatusText();\r\n      }\r\n  });\r\n\r\n  // 3. 切换深色/浅色模式（修改状态栏背景色和文字颜色）\r\n  document.getElementById('toggleMode').addEventListener('click', function() {\r\n      if (StatusBar) {\r\n          const isDarkMode = document.body.classList.contains('dark-mode');\r\n          if (isDarkMode) {\r\n              // 切换浅色模式\r\n              StatusBar.backgroundColorByHexString('#FFFFFF');\r\n              StatusBar.styleLightContent(false);\r\n              document.body.classList.remove('dark-mode');\r\n              console.log('已切换为浅色模式');\r\n          } else {\r\n              // 切换深色模式\r\n              StatusBar.backgroundColorByHexString('#212121');\r\n              StatusBar.styleLightContent(true);\r\n              document.body.classList.add('dark-mode');\r\n              console.log('已切换为深色模式');\r\n          }\r\n          updateStatusText();\r\n      }\r\n  });\r\n\r\n  // 4. 切换状态栏是否覆盖 WebView\r\n  document.getElementById('toggleOverlay').addEventListener('click', function() {\r\n      if (StatusBar) {\r\n          const currentOverlay = StatusBar.isVisible ? StatusBar.overlaysWebView(false) : StatusBar.overlaysWebView(true);\r\n          console.log(`状态栏覆盖 WebView：${!currentOverlay}`);\r\n          updateStatusText();\r\n      }\r\n  });\r\n\r\n  // 5. 实时更新状态栏状态提示\r\n  function updateStatusText() {\r\n      if (StatusBar) {\r\n          const status = StatusBar.isVisible ? '显示中' : '隐藏中';\r\n          const overlayStatus = StatusBar.overlaysWebView() ? '已覆盖' : '未覆盖';\r\n          const textColor = StatusBar.styleLightContent() ? '浅色' : '深色';\r\n          document.getElementById('statusInfo').textContent = `状态栏：${status}，覆盖 WebView：${overlayStatus}，文字颜色：${textColor}`;\r\n      }\r\n  }\r\n}, false);\r\n```\r\n\r\n### 2. 单个 API 调用示例\r\n\r\n```javascript\r\n// 等待环境就绪\r\ndocument.addEventListener('deviceready', function() {\r\n  // 1. 显示状态栏\r\n  StatusBar.show();\r\n\r\n  // 2. 隐藏状态栏（带动画）\r\n  StatusBar.hide(true);\r\n\r\n  // 3. 设置状态栏背景色（十六进制，带透明度）\r\n  StatusBar.backgroundColorByHexString('#2196F380');\r\n\r\n  // 4. 设置状态栏文字/图标颜色（浅色/深色）\r\n  StatusBar.styleLightContent(true); // 浅色文字，适配深色背景\r\n\r\n  // 5. 设置状态栏是否覆盖 WebView\r\n  StatusBar.overlaysWebView(true);\r\n\r\n  // 6. 检查状态栏可见状态\r\n  const isShow = StatusBar.isVisible;\r\n  console.log(`状态栏当前状态：${isShow ? '显示' : '隐藏'}`);\r\n}, false);\r\n```\r\n\r\n## 使用说明\r\n\r\n### 核心说明\r\n1. 插件调用：所有 API 均通过全局对象 `StatusBar` 调用，无需额外引入，需在 `deviceready` 事件触发后使用。\r\n2. 配置优先级：运行时通过 API 动态修改的配置，优先级高于 `config.xml` 中的静态配置，修改后立即生效。\r\n3. OHOS 专属：OHOS 系统新增 `StatusBarTextColor`、`NavigationBar` 相关配置，仅在 OHOS 平台生效，Android 和 iOS 平台不支持。\r\n4. 异常处理：若 API 调用失败，需检查插件是否正确安装、权限是否配置，以及 `deviceready` 事件是否触发。\r\n5. 全屏适配：隐藏状态栏后，建议同步调整 WebView 布局，避免内容留白或遮挡。\r\n\r\n### API 及参数说明\r\n\r\n#### 1. 核心 API 列表\r\n\r\n| API 方法 | 方法说明 | 参数说明 | 适用平台 |\r\n|---|---|---|---|\r\n| StatusBar.show() | 显示状态栏，支持带动画过渡 | 无参数，调用后立即显示状态栏 | 全平台 |\r\n| StatusBar.hide(animate) | 隐藏状态栏，animate 为布尔值（是否启用动画） | animate：可选，默认 false，true 启用过渡动画 | 全平台 |\r\n| StatusBar.backgroundColorByHexString(hexString) | 设置状态栏背景色，支持带透明度格式 | hexString：必选，十六进制颜色字符串（#RRGGBB 或 #RRGGBBAA） | 全平台 |\r\n| StatusBar.styleLightContent(isLight) | 设置状态栏文字/图标颜色（浅色/深色） | isLight：必选，布尔值，true=浅色，false=深色 | 全平台 |\r\n| StatusBar.overlaysWebView(overlay) | 设置状态栏是否覆盖 WebView 界面 | overlay：必选，布尔值，true=覆盖，false=不覆盖 | 全平台 |\r\n| StatusBar.isVisible | 获取状态栏当前可见状态 | 无参数，返回布尔值（true=显示，false=隐藏） | 全平台 |\r\n#### 2. config.xml 配置说明\r\n\r\n状态栏基础样式需在项目根目录 `config.xml` 中配置，启动时生效，以下为完整配置示例及说明：\r\n\r\n```xml\r\n<!-- 配置是否沉浸式布局（状态栏是否覆盖 WebView） -->\r\n<preference name=\"StatusBarOverlaysWebView\" value=\"true\" />\r\n<!-- 配置状态栏背景色 -->\r\n<preference name=\"StatusBarBackgroundColor\" value=\"#000000\" />\r\n<!-- OHOS 专属：配置状态栏文字颜色 -->\r\n<preference name=\"StatusBarTextColor\" value=\"#ffffff\" />\r\n<!-- 配置状态栏文字样式（仅 Android/iOS 生效） -->\r\n<preference name=\"StatusBarStyle\" value=\"lightcontent\" />\r\n<!-- 配置系统导航条背景色 -->\r\n<preference name=\"NavigationBarBackgroundColor\" value=\"#F90707\" />\r\n<!-- 配置系统导航条文字颜色 -->\r\n<preference name=\"NavigationBarFontColor\" value=\"#ffffff\" />\r\n<!-- 配置系统导航条 title 对齐方式 -->\r\n<preference name=\"NavigationBarFontAlign\" value=\"center\" />\r\n<!-- OHOS 专属：导航条高亮显示 -->\r\n<preference name=\"NavigationBarLight\" value=\"true\" />\r\n```\r\n\r\n配置说明：\r\n\r\n- StatusBarOverlaysWebView：是否沉浸式布局，true=覆盖 WebView，false=不覆盖\r\n\r\n- StatusBarBackgroundColor：状态栏背景色，十六进制格式，支持透明度\r\n\r\n- StatusBarTextColor：OHOS 专属配置，状态栏文字颜色，Android/iOS 不支持\r\n\r\n- StatusBarStyle：仅 Android/iOS 生效，控制文字样式，lightcontent=浅色文字\r\n\r\n- NavigationBar 相关配置：仅 OHOS 平台生效，控制系统导航条样式\r\n\r\n#### 3. 补充说明\r\n\r\n- OHOS 专属：新增的导航条（NavigationBar）相关配置，仅在 OHOS 系统中生效，Android 和 iOS 平台会自动忽略\r\n\r\n- 权限说明：使用状态栏无需额外申请权限，若涉及导航条操作，确保应用拥有相关系统权限\r\n\r\n- 动画效果：show/hide 方法的动画参数，仅在 Android、iOS、OHOS 平台支持，Browser 平台不支持\r\n\r\n- 兼容性提示：低版本系统（如 Android 4.4 及以下、iOS 9 及以下）不支持部分 API，需做好降级处理\r\n\r\n## 目录结构\r\n\r\n```\r\ncordova-plugin-statusbar             # [根目录] 状态栏控制插件项目根目录\r\n├── src                              # [源码目录] 存放原生平台代码\r\n│   └── main                         # [主目录] 主代码目录\r\n│       ├── cpp                      # [C++ 目录] C++ 原生代码目录\r\n│       │   └── StatusBar            # [C++ 模块] 状态栏 C++ 模块文件夹\r\n│       │       ├── StatusBar.cpp    # [C++ 实现] C++ 源文件，实现状态栏控制的底层逻辑\r\n│       │       └── StatusBar.h      # [C++ 声明] C++ 头文件，定义状态栏接口\r\n│       └── ets                      # [ArkTS 目录] ArkTS/ETS 代码目录\r\n│           └── components           # [组件目录] 存放 UI 或逻辑组件\r\n│               ├── NavigationBar    # [TS 模块] 导航栏（底部）相关逻辑文件夹\r\n│               │   └── NavigationBar.ets # [ETS 文件] 导航栏的 UI 组件或控制逻辑\r\n│               └── StatusBar        # [TS 模块] 状态栏（顶部）相关逻辑文件夹\r\n│                   └── StatusBarAction.ets # [ETS 文件] 处理状态栏具体动作（如变色、隐藏）的 ArkTS 实现\r\n├── www                              # [前端目录] 存放供 Web 端调用的 JS 接口文件\r\n│   └── statusbar.js                 # [JS 文件] 暴露给 Web 端的 JS 接口\r\n├── .gitignore                       # [配置] Git 版本控制忽略文件配置\r\n├── LICENSE                          # [文本] 开源许可证文件\r\n├── OAT.xml                          # [配置] 门禁配置文件\r\n├── package.json                     # [配置] 项目依赖与元信息配置\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-statusbar/issues) ，当然也非常欢迎发 [PR](https://gitcode.com/CPF-Cordova/cordova-plugin-statusbar/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-statusbar 官方指南](https://github.com/apache/cordova-plugin-statusbar)\r\n\r\n- **OHOS 专属参考**：[CPF-Cordova 仓库](https://gitcode.com/CPF-Cordova/cordova-plugin-statusbar)\r\n","readmeFilename":"README.md"}