{"_id":"@cordova-ohos/cordova-plugin-buildinfo","_rev":"5-a97b148455d4d67eb48232bfab11f15e","name":"@cordova-ohos/cordova-plugin-buildinfo","dist-tags":{"latest":"4.0.1"},"versions":{"4.0.0":{"name":"@cordova-ohos/cordova-plugin-buildinfo","version":"4.0.0","keywords":["cordova","buildinfo","ecosystem:cordova","cordova-openharmony"],"author":{"name":"Huawei Device, Inc. Ltd. and","email":"马弓手"},"license":"Apache-2.0","_id":"@cordova-ohos/cordova-plugin-buildinfo@4.0.0","maintainers":[{"name":"luqi_tan","email":"295099422@qq.com"}],"bugs":{"url":"https://gitcode.com/OpenHarmony-Cordova/cordova-plugin-buildinfo/issues"},"dist":{"shasum":"3d42b2ecd28a4700ab1bce309a3a7dd165fe738f","tarball":"https://registry.npmjs.org/@cordova-ohos/cordova-plugin-buildinfo/-/cordova-plugin-buildinfo-4.0.0.tgz","fileCount":9,"integrity":"sha512-Vu8gg0dIh6jJ+qykLHjOELupDLuZQ6qvRCzD6hEqgfz2vb3jNX4SJQogNiVloW2kIb+TFkREHTzi1q/rihc5wg==","signatures":[{"sig":"MEQCIDtvoohUCImv6PoPOn3OOgyFCGe/KYSb7G55LSAw7AP0AiAJpjV0rIl9X8JB+Fy6b+cESP8OoGIW/VENQAIihmF9Xw==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":34013},"cordova":{"id":"cordova-plugin-buildinfo","platforms":["ohos"]},"engines":{"cordovaDependencies":{"4.0.0":{"hcordova":">=1.0.0","@cordova-ohos/ohos":">=2.0.0"}}},"gitHead":"1cb28ac1902bd88b6552ee115c461e3a0ddb24a9","_npmUser":{"name":"luqi_tan","email":"295099422@qq.com"},"repository":{"url":"gitcode:OpenHarmony-Cordova/cordova-plugin-buildinfo","type":"git"},"_npmVersion":"10.5.1","description":"Cordova buildinfo Plugin","directories":{},"_nodeVersion":"22.0.0","_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/cordova-plugin-buildinfo_4.0.0_1773928483768_0.7607090230974001","host":"s3://npm-registry-packages-npm-production"}},"4.0.1":{"name":"@cordova-ohos/cordova-plugin-buildinfo","version":"4.0.1","description":"Cordova buildinfo Plugin","cordova":{"id":"cordova-plugin-buildinfo","platforms":["ohos"]},"repository":{"type":"git","url":"gitcode:CPF-Cordova/cordova-plugin-buildinfo"},"bugs":{"url":"https://gitcode.com/CPF-Cordova/cordova-plugin-buildinfo/issues"},"keywords":["cordova","buildinfo","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-buildinfo@4.0.1","gitHead":"766da6e79b2da7766e326c462e0e01b7670d75d1","_nodeVersion":"22.0.0","_npmVersion":"10.5.1","dist":{"integrity":"sha512-2xO5BytmdUHD0rFnAFCdi8/cq8JZzcI+RKWqouS6Y7dUK8ScSOdcyoqiu1iK4buyiktHRPullgy5ARbBIk8YeA==","shasum":"bbcee2202b14fe4da0d69626d9ee925253ffeceb","tarball":"https://registry.npmjs.org/@cordova-ohos/cordova-plugin-buildinfo/-/cordova-plugin-buildinfo-4.0.1.tgz","fileCount":10,"unpackedSize":48052,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIQDaceC46+H7ZcUjiw7yUPY3fGGCmcfaq+ylkLjlZfUSYwIgFEVgfTriTXm/nLUqnZkRbiTeaCrCctryhATyKZErWVo="}]},"_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-buildinfo_4.0.1_1785146800577_0.9211331991996106"},"_hasShrinkwrap":false}},"time":{"created":"2026-03-19T13:54:43.628Z","modified":"2026-07-27T10:06:40.977Z","4.0.0":"2026-03-19T13:54:43.926Z","4.0.1":"2026-07-27T10:06:40.705Z"},"bugs":{"url":"https://gitcode.com/CPF-Cordova/cordova-plugin-buildinfo/issues"},"author":{"name":"Huawei Device, Inc. Ltd. and","email":"马弓手"},"license":"Apache-2.0","keywords":["cordova","buildinfo","ecosystem:cordova","cordova-openharmony"],"repository":{"type":"git","url":"gitcode:CPF-Cordova/cordova-plugin-buildinfo"},"description":"Cordova buildinfo 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-buildinfo</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-buildinfo@4.0.0](https://www.npmjs.com/package/cordova-plugin-buildinfo/v/4.0.0) 开发，本文档重点阐述其在 OpenHarmony（OHOS）系统中的具体应用。\r\n\r\n- [cordova-plugin-buildinfo](#cordova-plugin-buildinfo)\r\n  - [简介](#简介)\r\n  - [支持平台](#支持平台)\r\n  - [下载安装](#下载安装)\r\n    - [从 npm 安装（推荐）](#从-npm-安装推荐)\r\n    - [指定平台安装 ohos](#指定平台安装-ohos)\r\n    - [安装特定版本](#安装特定版本)\r\n    - [从 GitCode 安装（开发版本）](#从-gitcode-安装开发版本)\r\n    - [离线安装（本地包）](#离线安装本地包)\r\n    - [安装后验证](#安装后验证)\r\n    - [卸载](#卸载)\r\n  - [约束与限制](#约束与限制)\r\n    - [兼容性](#兼容性)\r\n  - [使用示例](#使用示例)\r\n  - [使用说明](#使用说明)\r\n    - [OHOS 支持的属性](#ohos-支持的属性)\r\n  - [目录结构](#目录结构)\r\n  - [贡献代码](#贡献代码)\r\n  - [许可证](#许可证)\r\n  - [官方资源](#官方资源)\r\n\r\n\r\n## 简介\r\n\r\n`cordova-plugin-buildinfo` 是 Harmony Cordova 生态系统中一款核心插件，用于在多个平台（iOS、Android、浏览器等）上获取 Cordova 应用的构建信息和环境信息，为开发者提供应用基础信息查询、环境状态判断的便捷能力。\r\n\r\n- 获取基础应用信息：名称、版本号、构建号、包名/.Bundle ID\r\n\r\n- 访问构建环境变量（需配置）\r\n\r\n## 支持平台\r\n\r\n- **Android**：API 级别 21+\r\n\r\n- **iOS**：11.0+\r\n\r\n- **Browser**：主流桌面及移动浏览器\r\n\r\n- **OHOS**：5.0+\r\n\r\n## 下载安装\r\n\r\n通过 hcordova CLI 即可快速安装插件，支持从 npm 仓库获取，可指定平台和版本安装。\r\n\r\n### 从 npm 安装（推荐）\r\n\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-buildinfo\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-buildinfo --platform ohos\r\n\r\n```\r\n\r\n### 安装特定版本\r\n\r\n如需安装指定版本插件，执行以下命令：\r\n\r\n```bash\r\nhcordova plugin add cordova-plugin-buildinfo@1.0.0 --platform ohos\r\n\r\n```\r\n\r\n### 从 GitCode 安装（开发版本）\r\n\r\n如需测试最新功能或问题修复，可从 GitCode 仓库安装开发分支（仅 OHOS 平台）：\r\n\r\n```bash\r\n# 仅支持 OHOS 平台\r\nhcordova plugin add https://gitcode.com/CPF-Cordova/cordova-plugin-buildinfo.git --platform ohos\r\n\r\n# 指定标签/分支安装\r\nhcordova plugin add https://gitcode.com/CPF-Cordova/cordova-plugin-buildinfo.git@develop --platform ohos\r\n```\r\n\r\n### 离线安装（本地包）\r\n\r\n适用于无网络环境，先下载插件包到本地，再执行离线安装：\r\n\r\n```bash\r\n# 下载插件包到本地（示例路径：../Downloads/cordova-plugin-buildinfo）\r\n# 执行离线安装\r\nhcordova plugin add ../Downloads/cordova-plugin-buildinfo  --platform ohos\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```bash\r\n# Cordova CLI 全平台卸载\r\nhcordova plugin remove cordova-plugin-buildinfo \r\n\r\n# 指定 OHOS 平台卸载\r\nhcordova plugin remove cordova-plugin-buildinfo --platform ohos\r\n\r\n```\r\n\r\n## 约束与限制\r\n\r\n* 依赖插件：无强制依赖，插件集成后可直接使用，无需额外配置\r\n\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```js\r\nfunction getBuildInfo() {\r\n    var buildInfo = \"\";\r\n    buildInfo += ('BuildInfo.baseUrl        =' + BuildInfo.baseUrl+\"<br />\");\r\n    buildInfo += ('BuildInfo.packageName    =' + BuildInfo.packageName+\"<br />\");\r\n    buildInfo += ('BuildInfo.basePackageName=' + BuildInfo.basePackageName+\"<br />\");\r\n    buildInfo += ('BuildInfo.displayName    =' + BuildInfo.displayName+\"<br />\");\r\n    buildInfo += ('BuildInfo.name           =' + BuildInfo.name+\"<br />\");\r\n    buildInfo += ('BuildInfo.version        =' + BuildInfo.version+\"<br />\");\r\n    buildInfo += ('BuildInfo.versionCode    =' + BuildInfo.versionCode+\"<br />\");\r\n    buildInfo += ('BuildInfo.debug          =' + BuildInfo.debug+\"<br />\");\r\n    buildInfo += ('BuildInfo.buildType      =' + BuildInfo.buildType+\"<br />\");\r\n    buildInfo += ('BuildInfo.flavor         =' + BuildInfo.flavor+\"<br />\");\r\n    buildInfo += ('BuildInfo.buildDate      =' + BuildInfo.buildDate+\"<br />\");\r\n    buildInfo += ('BuildInfo.installDate    =' + BuildInfo.installDate+\"<br />\");\r\n    document.getElementById(\"buildInfo\").innerHTML = buildInfo;\r\n}\r\n\r\n```\r\n\r\n## 使用说明\r\n\r\n插件暴露全局对象 `BuildInfo`，开发者可直接通过该对象获取应用构建信息和环境信息，无需额外初始化操作。\r\n\r\n### OHOS 支持的属性\r\n\r\n| **属性** | **说明** |\r\n|---|---|\r\n| BuildInfo.packageName | 包名称对应 bundleName |\r\n| BuildInfo.basePackageName | 包名称对应 bundleName |\r\n| BuildInfo.displayName | 应用名称 |\r\n| BuildInfo.name | 应用名称 |\r\n| BuildInfo.version | 应用版本号 |\r\n| BuildInfo.versionCode | 应用版本 code |\r\n| BuildInfo.debug | 是否 debug |\r\n| BuildInfo.buildType | 编译类例如 debug/release |\r\n\r\n## 目录结构\r\n\r\n```\r\ncordova-plugin-buildinfo/\r\n├── src/                          # 源代码目录\r\n│   └── main/                     # 主要源代码\r\n│       ├── cpp/                  # C++ 原生代码\r\n│       │   └── AppVersion/       # 应用版本模块\r\n│       │       ├── BuildInfo.cpp # 构建信息功能的 C++ 实现\r\n│       │       └── BuildInfo.h   # 构建信息功能的头文件\r\n│       └── ets/                  # ArkTS 代码（OpenHarmony API）\r\n│           └── components/       # 组件目录\r\n│               └── PluginAction/ # 插件动作组件\r\n│                   └── GetAppInfo.ets  # 获取应用信息的实现\r\n├── www/                          # Web 资源目录\r\n│   └── buildinfo.js           # JavaScript 构建信息接口（Cordova 桥接层）\r\n├── .gitignore                    # Git 忽略文件配置\r\n├── LICENSE                       # 项目开源许可证\r\n├── OAT.xml                       # OpenHarmony 审核配置文件\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-buildinfo/issues) ，当然也非常欢迎发 [PR](https://gitcode.com/CPF-Cordova/cordova-plugin-buildinfo/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-buildinfo 官方指南](https://www.npmjs.com/package/cordova-plugin-buildinfo)\r\n\r\n- GitCode 仓库：[CPF-Cordova/cordova-plugin-buildinfo](https://gitcode.com/CPF-Cordova/cordova-plugin-buildinfo)\r\n","readmeFilename":"README.md"}