{"_id":"@cordova-ohos/cordova-plugin-jcore","_rev":"3-3144b8339cdabdb9ceac127b872d1443","name":"@cordova-ohos/cordova-plugin-jcore","dist-tags":{"latest":"5.2.1"},"versions":{"5.2.0":{"name":"@cordova-ohos/cordova-plugin-jcore","version":"5.2.0","keywords":["cordova","jcore","ecosystem:cordova","cordova-openharmony"],"author":{"name":"Huawei Device, Inc. Ltd. and","email":"马弓手"},"license":"Apache-2.0","_id":"@cordova-ohos/cordova-plugin-jcore@5.2.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-jcore/issues"},"dist":{"shasum":"b9f45e0a0f495e637ff3f3426c8701c1f6c55761","tarball":"https://registry.npmjs.org/@cordova-ohos/cordova-plugin-jcore/-/cordova-plugin-jcore-5.2.0.tgz","fileCount":8,"integrity":"sha512-czUWXNeTw2wbzeAf0kF02DopwTJ64hP4U6dPU18fIC94RVcM06EENcKu3p6ztkU28oQZ69Fk7ejFnLsvtGDEEA==","signatures":[{"sig":"MEUCIQDezXG44P8BjccEuM9+XnMfxGHuA5jkhjcPhiyONDBLVgIgIEsrLiNrmq9iK96wRygVyCIzmAcd9tVFpaYSo0njXMg=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":26213},"cordova":{"id":"cordova-plugin-jcore","platforms":["ohos"]},"engines":{"cordovaDependencies":{"5.2.0":{"hcordova":">=1.0.0","@cordova-ohos/ohos":">=2.0.0"}}},"gitHead":"b841af71e3b546ebfd2ca304471bc4fd5ae116c6","_npmUser":{"name":"wanpengsz","email":"wanpengsz@163.com"},"repository":{"url":"gitcode:OpenHarmony-Cordova/cordova-plugin-jcore","type":"git"},"_npmVersion":"9.6.2","description":"Cordova File Path Plugin","directories":{},"_nodeVersion":"20.16.0","_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/cordova-plugin-jcore_5.2.0_1773996829990_0.5103546277938207","host":"s3://npm-registry-packages-npm-production"}},"5.2.1":{"name":"@cordova-ohos/cordova-plugin-jcore","version":"5.2.1","description":"Cordova Jcore Plugin","cordova":{"id":"cordova-plugin-jcore","platforms":["ohos"]},"repository":{"type":"git","url":"gitcode:CPF-Cordova/cordova-plugin-jcore"},"bugs":{"url":"https://gitcode.com/CPF-Cordova/cordova-plugin-jcore/issues"},"keywords":["cordova","jcore","ecosystem:cordova","cordova-openharmony"],"engines":{"cordovaDependencies":{"5.2.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-jcore@5.2.1","gitHead":"de24b6a1974ad8cba6590511109da0d6f0efbc47","_nodeVersion":"22.0.0","_npmVersion":"10.5.1","dist":{"integrity":"sha512-jLIWIIW4GZSSiiE2xbYHlRGbLFzJTqUhDnRw+4tQRB6Ccf+fJDOSu5GB+0XtsACjs6sCDzvradbhBwWcGYBOuQ==","shasum":"d88937a19949f1841d8e4c246d1cd27778cf31fc","tarball":"https://registry.npmjs.org/@cordova-ohos/cordova-plugin-jcore/-/cordova-plugin-jcore-5.2.1.tgz","fileCount":9,"unpackedSize":40408,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEYCIQCXD85gr3OEMeEs7JKZ3wXY2uo61HCA5fm1xj0GY52USQIhALhkT6eYtcDj3ReqV5oeJ/advuvwQHAqYvZun1vShX8D"}]},"_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-jcore_5.2.1_1785149835374_0.6644739239788633"},"_hasShrinkwrap":false}},"time":{"created":"2026-03-20T08:53:49.892Z","modified":"2026-07-27T10:57:15.723Z","5.2.0":"2026-03-20T08:53:50.139Z","5.2.1":"2026-07-27T10:57:15.505Z"},"bugs":{"url":"https://gitcode.com/CPF-Cordova/cordova-plugin-jcore/issues"},"author":{"name":"Huawei Device, Inc. Ltd. and","email":"马弓手"},"license":"Apache-2.0","keywords":["cordova","jcore","ecosystem:cordova","cordova-openharmony"],"repository":{"type":"git","url":"gitcode:CPF-Cordova/cordova-plugin-jcore"},"description":"Cordova Jcore 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-jcore</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-jcore@5.2.0](https://www.npmjs.com/package/cordova-plugin-jcore/v/5.2.0) 开发，本文档重点阐述其在 OpenHarmony（OHOS）系统中的具体应用。\r\n\r\n- [cordova-plugin-jcore](#cordova-plugin-jcore)\r\n  - [简介](#简介)\r\n  - [支持平台](#支持平台)\r\n  - [下载安装](#下载安装)\r\n    - [从 npm 安装（推荐）](#从-npm-安装推荐)\r\n    - [指定平台安装 ohos](#指定平台安装-ohos)\r\n    - [从 GitCode 仓库安装](#从-gitcode-仓库安装)\r\n    - [离线安装（本地包）](#离线安装本地包)\r\n    - [安装后验证](#安装后验证)\r\n    - [卸载](#卸载)\r\n  - [约束与限制](#约束与限制)\r\n    - [兼容性](#兼容性)\r\n  - [使用示例](#使用示例)\r\n  - [使用说明](#使用说明)\r\n    - [OHOS 配置](#ohos-配置)\r\n      - [修改项目 oh-package.json5 文件](#修改项目-oh-packagejson5-文件)\r\n      - [配置工程级 build-profile.json5 文件](#配置工程级-build-profilejson5-文件)\r\n  - [目录结构](#目录结构)\r\n  - [贡献代码](#贡献代码)\r\n  - [许可证](#许可证)\r\n  - [官方资源](#官方资源)\r\n\r\n\r\n## 简介\r\n\r\n`cordova-plugin-jcore` 是 Harmony Cordova 生态系统中一款核心基础插件，在 Android 平台中作为极光推送的基础插件，OHOS 平台的极光推送则直接依赖极光推送的 har 包作为基础能力提供者。该插件为极光推送相关功能提供底层支撑，简化混合应用中极光推送能力的集成流程，适配多平台推送需求。\r\n\r\n- Android 平台：作为极光推送的基础插件，为极光推送功能提供底层支持\r\n\r\n- OHOS 平台：依赖极光推送 har 包，作为极光推送能力的基础提供者\r\n\r\n- 支持指定版本安装，适配不同项目的版本需求\r\n\r\n- 提供清晰的平台配置指引，确保插件正常运行\r\n\r\n**重要提示：** 该插件在 Android 是作为极光推送的基础的插件，如果您是从 Android 移植到 OHOS，需要配置极光推送 har 包。\r\n\r\n## 支持平台\r\n\r\n- **Android**：API 19 及以上（Android 4.4+）\r\n\r\n- **iOS**：10.0 及以上\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\r\n# 安装 hcordova 命令化工具\r\nnpm install -g hcordova\r\n\r\n# 全平台安装插件\r\nhcordova plugin add cordova-plugin-jcore\r\n\r\n# 如需指定版本，可添加 @version 后缀（示例：1.0.0 版本）\r\nhcordova plugin add cordova-plugin-jcore@1.0.0 --platform ohos\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-jcore --platform ohos\r\n\r\n# 安装指定版本（示例：1.0.0 版本）\r\nhcordova plugin add cordova-plugin-jcore@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-jcore.git --platform ohos\r\n\r\n# 指定标签/分支安装\r\nhcordova plugin add https://gitcode.com/CPF-Cordova/cordova-plugin-jcore.git@develop --platform ohos\r\n```\r\n\r\n### 离线安装（本地包）\r\n\r\n适用于无网络环境，先下载插件包到本地，再执行离线安装：\r\n\r\n```bash\r\n# 下载插件包到本地（示例路径：~/Downloads/cordova-plugin-jcore）\r\n# 执行离线安装\r\nhcordova plugin add ~/Downloads/cordova-plugin-jcore --platform ohos\r\n```\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```bash\r\n# Cordova CLI 全平台卸载\r\nhcordova plugin remove cordova-plugin-jcore \r\n\r\n# 指定平台卸载\r\nhcordova plugin remove cordova-plugin-jcore --platform ohos\r\n```\r\n\r\n## 约束与限制\r\n\r\n* 依赖插件：无强制依赖，OHOS 平台需配置极光推送 har 包才能正常提供极光推送基础能力；Android 平台作为极光推送基础插件，需配合极光推送相关插件使用。\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\n1. 安装插件：通过 hcordova CLI 命令安装 cordova-plugin-jcore 插件，可根据需求指定版本和平台；\r\n\r\n2. 配置 OHOS 平台：按照下方 OHOS 配置指引，修改项目配置文件，添加极光推送 har 包依赖及工程级配置；\r\n\r\n3. 集成极光推送：OHOS 平台依赖极光推送 har 包，Android 平台配合极光推送相关插件，即可实现极光推送基础能力调用。\r\n\r\n## 使用说明\r\n\r\n### OHOS 配置\r\n\r\n#### 修改项目 oh-package.json5 文件\r\n\r\n在项目中的 oh-package.json5 文件，dependencies 中加入极光 jg/push 的依赖项：\r\n\r\n```json\r\n{\r\n  \"name\": \"entry\",\r\n  \"version\": \"1.0.0\",\r\n  \"description\": \"Please describe the basic information.\",\r\n  \"main\": \"\",\r\n  \"author\": \"\",\r\n  \"license\": \"\",\r\n  \"dependencies\": {\r\n    \"@jg/push\": \"^1.3.1\"\r\n  }\r\n}\r\n```\r\n\r\n#### 配置工程级 build-profile.json5 文件\r\n\r\n在工程级（最外层）build-profile.json5 中，配置 \"useNormalizedOHMUrl\": true：\r\n\r\n```json\r\n\"products\": [\r\n    {\r\n    \"name\": \"default\",\r\n    \"signingConfig\": \"default\",\r\n    \"compatibleSdkVersion\": \"5.0.0(12)\",\r\n    \"buildOption\": {\r\n        \"strictMode\": {\r\n        \"caseSensitiveCheck\": true,\r\n        \"useNormalizedOHMUrl\": true\r\n        }\r\n    }\r\n    }\r\n]\r\n```\r\n\r\n## 目录结构\r\n\r\n```\r\ncordova-plugin-jcore/\r\n├── src/                          # 源代码目录\r\n│   └── main/                     # 主要源代码\r\n│       └── cpp/                  # C++ 原生代码\r\n│           └── JPush/            # JPush 模块\r\n│               ├── JCorePlugin.cpp  # JCore 核心功能的 C++ 实现\r\n│               └── JCorePlugin.h    # JCore 核心功能的头文件\r\n├── www/                          # Web 资源目录\r\n│   └── jcore.js                  # JavaScript JCore 接口（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-jcore/issues) ，当然也非常欢迎发 [PR](https://gitcode.com/CPF-Cordova/cordova-plugin-jcore/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-jcore 官方指南](https://www.npmjs.com/package/cordova-plugin-jcore)\r\n\r\n- GitCode 仓库：[CPF-Cordova/cordova-plugin-jcore](https://gitcode.com/CPF-Cordova/cordova-plugin-jcore)\r\n","readmeFilename":"README.md"}