{"_id":"@cordova-ohos/cordova-plugin-deeplink","_rev":"5-3e0d173d5cb9fdb437bfdff3df828e26","name":"@cordova-ohos/cordova-plugin-deeplink","dist-tags":{"latest":"3.2.2"},"versions":{"3.2.1":{"name":"@cordova-ohos/cordova-plugin-deeplink","version":"3.2.1","keywords":["cordova","deeplink","ecosystem:cordova","cordova-openharmony"],"author":{"name":"Huawei Device, Inc. Ltd. and","email":"马弓手"},"license":"Apache-2.0","_id":"@cordova-ohos/cordova-plugin-deeplink@3.2.1","maintainers":[{"name":"luqi_tan","email":"295099422@qq.com"}],"bugs":{"url":"https://gitcode.com/OpenHarmony-Cordova/cordova-plugin-deeplink/issues"},"dist":{"shasum":"372629ce0d41acd95636a5110261170d9b1b7522","tarball":"https://registry.npmjs.org/@cordova-ohos/cordova-plugin-deeplink/-/cordova-plugin-deeplink-3.2.1.tgz","fileCount":8,"integrity":"sha512-dyJ+lrRlMA6CS3pG/+IiVgiVzIWuD5VHXSELecb8IC40Qs/jiCXbobPFpjNrM5EVx0DhoZKcO7XAybKOo33WUA==","signatures":[{"sig":"MEYCIQC7jCmwPAD21k3pBxd/bwUapcGb0GDoYywRGqbCCmMxKQIhAOONLv4gtfkI5x6B6rL7kyJwb3jFhrbVS1iCYN/5uJ5T","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":27106},"cordova":{"id":"cordova-plugin-deeplink","platforms":["ohos"]},"engines":{"cordovaDependencies":{"3.2.1":{"hcordova":">=1.0.0","@cordova-ohos/ohos":">=2.0.0"}}},"gitHead":"4fba6d3bc7f8889f3a3c29d931125a4fff15f940","_npmUser":{"name":"luqi_tan","email":"295099422@qq.com"},"repository":{"url":"gitcode:OpenHarmony-Cordova/cordova-plugin-deeplink","type":"git"},"_npmVersion":"10.5.1","description":"Cordova deeplink Plugin","directories":{},"_nodeVersion":"22.0.0","_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/cordova-plugin-deeplink_3.2.1_1773968973459_0.5113472161006021","host":"s3://npm-registry-packages-npm-production"}},"3.2.2":{"name":"@cordova-ohos/cordova-plugin-deeplink","version":"3.2.2","description":"Cordova deeplink Plugin","cordova":{"id":"cordova-plugin-deeplink","platforms":["ohos"]},"repository":{"type":"git","url":"gitcode:CPF-Cordova/cordova-plugin-deeplink"},"bugs":{"url":"https://gitcode.com/CPF-Cordova/cordova-plugin-deeplink/issues"},"keywords":["cordova","deeplink","ecosystem:cordova","cordova-openharmony"],"engines":{"cordovaDependencies":{"3.2.2":{"@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-deeplink@3.2.2","gitHead":"08aa0ce788bc9152588252dbcd47356e8e1a335a","_nodeVersion":"22.0.0","_npmVersion":"10.5.1","dist":{"integrity":"sha512-9mlIRqO8JAeNWAa8GDBwK72FYqkMoAza9ftOF4YVIEK0lszdLv8ore+QwY+5mfQcLaP12mSmg7srGHzTxFhcGw==","shasum":"11f1e695d5903adc76cd1e0f9fe8d587d7423f26","tarball":"https://registry.npmjs.org/@cordova-ohos/cordova-plugin-deeplink/-/cordova-plugin-deeplink-3.2.2.tgz","fileCount":9,"unpackedSize":43140,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIEjXOoTbludJdN5AlIWyCzZR+vgsLiHZjO6SLSQ1ftaMAiEA+RQE2wpvPorRl0DpocSLHF1Km+RFQ9igNJKNv6ZrcBU="}]},"_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-deeplink_3.2.2_1785151653090_0.25803708120933755"},"_hasShrinkwrap":false}},"time":{"created":"2026-03-20T01:09:33.375Z","modified":"2026-07-27T11:27:34.098Z","3.2.1":"2026-03-20T01:09:33.604Z","3.2.2":"2026-07-27T11:27:33.261Z"},"bugs":{"url":"https://gitcode.com/CPF-Cordova/cordova-plugin-deeplink/issues"},"author":{"name":"Huawei Device, Inc. Ltd. and","email":"马弓手"},"license":"Apache-2.0","keywords":["cordova","deeplink","ecosystem:cordova","cordova-openharmony"],"repository":{"type":"git","url":"gitcode:CPF-Cordova/cordova-plugin-deeplink"},"description":"Cordova deeplink 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-deeplink</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-deeplink@3.2.1](https://www.npmjs.com/package/cordova-plugin-deeplink/v/3.2.1) 开发，本文档重点阐述其在 OpenHarmony（OHOS）系统中的具体应用。\r\n\r\n- [cordova-plugin-deeplink](#cordova-plugin-deeplink)\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  - [使用说明](#使用说明)\r\n    - [辅助 API 说明](#辅助-api-说明)\r\n      - [1. 分享功能 API](#1-分享功能-api)\r\n        - [参数说明](#参数说明)\r\n        - [使用示例](#使用示例-1)\r\n  - [目录结构](#目录结构)\r\n  - [贡献代码](#贡献代码)\r\n  - [许可证](#许可证)\r\n  - [官方资源](#官方资源)\r\n\r\n\r\n## 简介\r\n\r\n`cordova-plugin-deeplink` 是 Harmony Cordova 生态系统中一款核心插件，插件主要基于源 Android 上游社区功能定位研发，主要功能是统一 Android、iOS 和 OHOS 平台的分享功能，为 Cordova 混合移动应用提供跨平台、统一的分享能力，无需区分不同平台的原生分享逻辑，通过简洁 API 即可实现内容分享，适配各类分享场景。\r\n\r\n- 跨平台统一：统一 Android、iOS、OHOS 三大平台分享功能，提供一致的 API 接口\r\n\r\n- 便捷分享：支持分享标题、文本、链接等多种内容形式，满足多样化分享需求\r\n\r\n- 回调反馈：分享成功、失败或取消时均有对应回调，便于开发者处理后续逻辑\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 仓库、GitCode 仓库获取，可指定平台安装，安装前确保已创建 Cordova 项目并进入项目根目录。\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-deeplink\r\n\r\n# 指定 OHOS 平台安装\r\nhcordova plugin add cordova-plugin-deeplink --platform ohos\r\n\r\n# 指定版本安装\r\nhcordova plugin add cordova-plugin-deeplink@1.0.0 --platform ohos\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-deeplink.git --platform ohos\r\n\r\n# 指定标签/分支安装\r\nhcordova plugin add https://gitcode.com/CPF-Cordova/cordova-plugin-deeplink.git@develop --platform ohos\r\n```\r\n\r\n### 离线安装（本地包）\r\n\r\n适用于无网络环境，先下载插件包到本地，再执行离线安装：\r\n\r\n```bash\r\n# 下载插件包到本地（示例路径：~/Downloads/cordova-plugin-deeplink）\r\n# 执行离线安装\r\nhcordova plugin add ~/Downloads/cordova-plugin-deeplink --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-deeplink \r\n\r\n# 指定平台卸载（OpenHarmony/OHOS）\r\nhcordova plugin remove cordova-plugin-deeplink --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|-----|--------|\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\ncordova.plugins.WebShare.share({\r\n    title: \"Share topic\",\r\n    text: \"Share message\",\r\n    url: \"https://www.example.com\"\r\n},function(packageNames){\r\n    if (packageNames.length > 0) {\r\n        console.log(\"Shared successfully\", packageNames[0]);\r\n    } else {\r\n        console.log(\"Share was aborted\");\r\n    }\r\n},function(err){\r\n    console.error(\"Share failed:\", err.message);\r\n});\r\n\r\n```\r\n\r\n## 使用说明\r\n\r\n### 辅助 API 说明\r\n\r\n插件核心分享功能挂载在 `cordova.plugins.WebShare` 对象上，核心 API 为 share 方法，用于触发设备原生分享功能，支持分享标题、文本、链接等内容，并提供回调反馈。\r\n\r\n#### 1. 分享功能 API\r\n\r\n用于触发设备原生分享，可传入分享内容（标题、文本、链接），并设置成功、失败回调。\r\n\r\nAPI 格式：cordova.plugins.WebShare.share(shareData, successCallback, errorCallback);\r\n\r\n##### 参数说明\r\n\r\n- shareData：分享数据对象，包含 title（分享标题）、text（分享文本）、url（分享链接）三个可选属性\r\n\r\n- successCallback：分享成功或取消的回调函数，接收 packageNames 数组（成功分享的应用包名列表，取消时为空数组）\r\n\r\n- errorCallback：分享失败的回调函数，接收错误对象，包含错误信息\r\n\r\n##### 使用示例\r\n\r\n```js\r\ncordova.plugins.WebShare.share({\r\n    title: \"Share topic\",\r\n    text: \"Share message\",\r\n    url: \"https://www.example.com\"\r\n},function(packageNames){\r\n    if (packageNames.length > 0) {\r\n        console.log(\"Shared successfully\", packageNames[0]);\r\n    } else {\r\n        console.log(\"Share was aborted\");\r\n    }\r\n},function(err){\r\n    console.error(\"Share failed:\", err.message);\r\n});\r\n\r\n```\r\n\r\n## 目录结构\r\n\r\n```\r\ncordova-plugin-deeplink/\r\n├── src/                          # 源代码目录\r\n│   └── main/                     # 主要源代码\r\n│       └── cpp/                  # C++ 原生代码\r\n│           └── SocialSharing/    # 社交分享模块\r\n│               ├── WebSharePlugin.cpp  # Web 分享功能的 C++ 实现\r\n│               └── WebSharePlugin.h    # Web 分享功能的头文件\r\n├── www/                          # Web 资源目录\r\n│   └── WebShare.js               # JavaScript Web 分享接口（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-deeplink/issues) ，当然也非常欢迎发 [PR](https://gitcode.com/CPF-Cordova/cordova-plugin-deeplink/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-deeplink 官方指南](https://www.npmjs.com/package/cordova-plugin-deeplink)\r\n\r\n- GitCode 仓库：[CPF-Cordova/cordova-plugin-deeplink](https://gitcode.com/CPF-Cordova/cordova-plugin-deeplink)\r\n","readmeFilename":"README.md"}