# @havesource/cordova-plugin-push 中文文档

规范地址：https://npmcn.com/package/%40havesource/cordova-plugin-push/

版本：7\.0\.0
npm 元数据更新时间：2025-09-09T07:27:13.059Z
中文译文更新时间：2026-11-17T11:52:49.905Z
软件包许可：MIT

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40havesource/cordova-plugin-push
原文对照：https://npmcn.com/package/%40havesource/cordova-plugin-push/?lang=original
项目主页：https://github.com/havesource/cordova-plugin-push#readme
源码仓库：https://github.com/havesource/cordova-plugin-push

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：239 kB，29 个文件
- TypeScript 类型：包内自带
- 运行依赖：0 个
- 首次发布：2020-11-08T11:08:37.245Z
- 最新版本发布：2025-09-09T07:27:12.810Z
- 近 30 天下载量：15316（2026-10-18 至 2026-11-16，npm 官方下载统计）
- 已发布版本数：22（近 12 个月 0 个）

## 中文简介

登记并收到推车通知.

## 安装

```sh
npm install @havesource/cordova-plugin-push
```

也可以使用：`pnpm add @havesource/cordova-plugin-push`、`yarn add @havesource/cordova-plugin-push`、`bun add @havesource/cordova-plugin-push`

## README

# 科尔多瓦插件推

[![Node CI](https://github.com/havesource/cordova-plugin-push/actions/workflows/ci.yml/badge.svg)](https://github.com/havesource/cordova-plugin-push/actions/workflows/ci.yml) [![Codacy Badge](https://api.codacy.com/project/badge/Grade/422c67b5e70c4a0eadae7b9fc794d3c1)](https://app.codacy.com/gh/havesource/cordova-plugin-push?utm_source=github.com&utm_medium=referral&utm_content=havesource/cordova-plugin-push&utm_campaign=Badge_Grade_Settings)

> 登记和接收推车通知

# 这是什么?

此插件为接收和处理本地按键通知提供了支持 **单一统一的 API**。 。 。 .

这并不意味着您将能够发送一个单一的按键消息,并让它到达运行不同操作系统的设备上. 默认情况下,Android使用FCM,而iOS使用APNS,其有效载荷相差很大. 即使你对Android和iOS都使用FCM,插件正确工作所需的有效载荷也存在差异. 为安卓 **永远** 把你的推力有效载荷放进 `data` 驱动通知的一节。 将关于这种情况的更多信息改为: [通知与数据有效载荷](https://github.com/havesource/cordova-plugin-push/blob/master/docs/PAYLOAD.md#notification-vs-data-payloads)。对于iOS,遵循常规 [FCM 文档](https://firebase.google.com/docs/cloud-messaging/http-server-ref)。 。 。 .

此插件不提供确定您运行在哪个平台的方法 。 最好的办法是使用 `device.platform` 提供的财产 [接接接接接接接点](https://github.com/apache/cordova-plugin-device)。 。 。 .

-   [报告问题](https://npmcn.com/package/%40havesource/cordova-plugin-push/docs/ISSUES.md)
-   [安装](https://npmcn.com/package/%40havesource/cordova-plugin-push/docs/INSTALLATION.md)
-   [API 参考](https://npmcn.com/package/%40havesource/cordova-plugin-push/docs/API.md)
-   [字体支持](https://npmcn.com/package/%40havesource/cordova-plugin-push/docs/TYPESCRIPT.md)
-   [实例](https://npmcn.com/package/%40havesource/cordova-plugin-push/docs/EXAMPLES.md)
-   [平台支持](https://npmcn.com/package/%40havesource/cordova-plugin-push/docs/PLATFORM_SUPPORT.md)
-   [云构建支持( PG Building, IntelXDK)](https://npmcn.com/package/%40havesource/cordova-plugin-push/docs/PHONEGAP_BUILD.md)
-   [推动通知有效载荷细节](https://npmcn.com/package/%40havesource/cordova-plugin-push/docs/PAYLOAD.md)
-   [捐款](https://npmcn.com/package/%40havesource/cordova-plugin-push/.github/CONTRIBUTING.md)
-   [许可证(麻省理工学院)](https://npmcn.com/package/%40havesource/cordova-plugin-push/MIT-LICENSE)

# 你喜欢教书吗? 你得到辅导!

-   [(使用节点-gcm)](http://macdonst.github.io/push-workshop/)

# 感谢我们所有的贡献

[![10ko](https://avatars1.githubusercontent.com/u/2706375?v=4&s=117)](https://github.com/10ko)[![TVolly](https://avatars3.githubusercontent.com/u/20628284?v=4&s=117)](https://github.com/TVolly)[![waptaxi](https://avatars2.githubusercontent.com/u/6575569?v=4&s=117)](https://github.com/waptaxi)[![viktormuller](https://avatars1.githubusercontent.com/u/8171222?v=4&s=117)](https://github.com/viktormuller)[![devgeeks](https://avatars0.githubusercontent.com/u/554999?v=4&s=117)](https://github.com/devgeeks)[![rastafan](https://avatars3.githubusercontent.com/u/7632849?v=4&s=117)](https://github.com/rastafan)

[![mdoelker](https://avatars1.githubusercontent.com/u/2145319?v=4&s=117)](https://github.com/mdoelker)[![markeeftb](https://avatars3.githubusercontent.com/u/3172570?v=4&s=117)](https://github.com/markeeftb)[![malwatte](https://avatars2.githubusercontent.com/u/2534778?v=4&s=117)](https://github.com/malwatte)[![madebycm](https://avatars3.githubusercontent.com/u/5081823?v=4&s=117)](https://github.com/madebycm)[![kelvinhokk](https://avatars0.githubusercontent.com/u/7766953?v=4&s=117)](https://github.com/kelvinhokk)[![keab42](https://avatars0.githubusercontent.com/u/1453371?v=4&s=117)](https://github.com/keab42)

[![jomarocas](https://avatars3.githubusercontent.com/u/5194064?v=4&s=117)](https://github.com/jomarocas)[![giuseppelt](https://avatars2.githubusercontent.com/u/7147291?v=4&s=117)](https://github.com/giuseppelt)[![ericb](https://avatars3.githubusercontent.com/u/19638?v=4&s=117)](https://github.com/ericb)[![eKazim](https://avatars3.githubusercontent.com/u/21195186?v=4&s=117)](https://github.com/eKazim)[![clementcontet](https://avatars1.githubusercontent.com/u/7261426?v=4&s=117)](https://github.com/clementcontet)[![yaswanthsvist](https://avatars0.githubusercontent.com/u/3897387?v=4&s=117)](https://github.com/yaswanthsvist)

[![Vabs28](https://avatars1.githubusercontent.com/u/8149036?v=4&s=117)](https://github.com/Vabs28)[![TillaTheHun0](https://avatars0.githubusercontent.com/u/8246360?v=4&s=117)](https://github.com/TillaTheHun0)[![tomasvarg](https://avatars0.githubusercontent.com/u/16196322?v=4&s=117)](https://github.com/tomasvarg)[![tobmaster](https://avatars1.githubusercontent.com/u/203823?v=4&s=117)](https://github.com/tobmaster)[![ThiagoBueno](https://avatars1.githubusercontent.com/u/3334244?v=4&s=117)](https://github.com/ThiagoBueno)[![szh](https://avatars2.githubusercontent.com/u/546965?v=4&s=117)](https://github.com/szh)

[![SharUpOff](https://avatars3.githubusercontent.com/u/26085497?v=4&s=117)](https://github.com/SharUpOff)[![smorstabilini](https://avatars0.githubusercontent.com/u/551983?v=4&s=117)](https://github.com/smorstabilini)[![fesor](https://avatars2.githubusercontent.com/u/172247?v=4&s=117)](https://github.com/fesor)[![GreyDekart](https://avatars2.githubusercontent.com/u/1793548?v=4&s=117)](https://github.com/GreyDekart)[![sebastiansier](https://avatars1.githubusercontent.com/u/3733454?v=4&s=117)](https://github.com/sebastiansier)[![olastor](https://avatars0.githubusercontent.com/u/7479641?v=4&s=117)](https://github.com/olastor)

[![tanansatpal](https://avatars2.githubusercontent.com/u/20103208?v=4&s=117)](https://github.com/tanansatpal)[![SandroGrzicic](https://avatars1.githubusercontent.com/u/200247?v=4&s=117)](https://github.com/SandroGrzicic)[![xorxor](https://avatars1.githubusercontent.com/u/1525525?v=4&s=117)](https://github.com/xorxor)[![rubenstolk](https://avatars2.githubusercontent.com/u/692644?v=4&s=117)](https://github.com/rubenstolk)[![roel-sluper](https://avatars0.githubusercontent.com/u/1556404?v=4&s=117)](https://github.com/roel-sluper)[![pataar](https://avatars3.githubusercontent.com/u/3403851?v=4&s=117)](https://github.com/pataar)

[![peteonrails](https://avatars1.githubusercontent.com/u/9593?v=4&s=117)](https://github.com/peteonrails)[![pjalbuquerque](https://avatars3.githubusercontent.com/u/4201558?v=4&s=117)](https://github.com/pjalbuquerque)[![NitroGhost](https://avatars0.githubusercontent.com/u/3674467?v=4&s=117)](https://github.com/NitroGhost)[![matrosov-nikita](https://avatars3.githubusercontent.com/u/12752587?v=4&s=117)](https://github.com/matrosov-nikita)[![Mikejo5000](https://avatars1.githubusercontent.com/u/11948536?v=4&s=117)](https://github.com/Mikejo5000)[![michellarcari](https://avatars2.githubusercontent.com/u/6429722?v=4&s=117)](https://github.com/michellarcari)

[![adamschachne](https://avatars2.githubusercontent.com/u/13020251?v=4&s=117)](https://github.com/adamschachne)[![alharding](https://avatars1.githubusercontent.com/u/926204?v=4&s=117)](https://github.com/alharding)[![albertleao](https://avatars0.githubusercontent.com/u/1950338?v=4&s=117)](https://github.com/albertleao)[![gotev](https://avatars0.githubusercontent.com/u/16792495?v=4&s=117)](https://github.com/gotev)[![Alex-Sessler](https://avatars0.githubusercontent.com/u/5779673?v=4&s=117)](https://github.com/Alex-Sessler)[![ben-8409](https://avatars1.githubusercontent.com/u/305724?v=4&s=117)](https://github.com/ben-8409)

[![bmwertman](https://avatars3.githubusercontent.com/u/2573903?v=4&s=117)](https://github.com/bmwertman)[![bmatto](https://avatars1.githubusercontent.com/u/1044422?v=4&s=117)](https://github.com/bmatto)[![countcain](https://avatars0.githubusercontent.com/u/1751150?v=4&s=117)](https://github.com/countcain)[![CookieCookson](https://avatars3.githubusercontent.com/u/3473396?v=4&s=117)](https://github.com/CookieCookson)[![cdorner](https://avatars3.githubusercontent.com/u/917733?v=4&s=117)](https://github.com/cdorner)[![colene](https://avatars3.githubusercontent.com/u/1613781?v=4&s=117)](https://github.com/colene)

[![cfsnyder](https://avatars3.githubusercontent.com/u/3925941?v=4&s=117)](https://github.com/cfsnyder)[![cmalard](https://avatars0.githubusercontent.com/u/1692136?v=4&s=117)](https://github.com/cmalard)[![dansumption](https://avatars2.githubusercontent.com/u/174105?v=4&s=117)](https://github.com/dansumption)[![dannywillems](https://avatars2.githubusercontent.com/u/6018454?v=4&s=117)](https://github.com/dannywillems)[![DrMoriarty](https://avatars1.githubusercontent.com/u/1177068?v=4&s=117)](https://github.com/DrMoriarty)[![eladmoshe](https://avatars1.githubusercontent.com/u/1702227?v=4&s=117)](https://github.com/eladmoshe)

[![mlabarca](https://avatars2.githubusercontent.com/u/4587965?v=4&s=117)](https://github.com/mlabarca)[![bromeostasis](https://avatars3.githubusercontent.com/u/3764641?v=4&s=117)](https://github.com/bromeostasis)[![filmaj](https://avatars0.githubusercontent.com/u/52645?v=4&s=117)](https://github.com/filmaj)[![geo242](https://avatars3.githubusercontent.com/u/7529238?v=4&s=117)](https://github.com/geo242)[![gbenvenuti](https://avatars3.githubusercontent.com/u/331314?v=4&s=117)](https://github.com/gbenvenuti)[![polyn0m](https://avatars2.githubusercontent.com/u/1258130?v=4&s=117)](https://github.com/polyn0m)

[![jacquesdev](https://avatars1.githubusercontent.com/u/7842197?v=4&s=117)](https://github.com/jacquesdev)[![janpio](https://avatars0.githubusercontent.com/u/183673?v=4&s=117)](https://github.com/janpio)[![jakari](https://avatars2.githubusercontent.com/u/2283862?v=4&s=117)](https://github.com/jakari)[![purplecabbage](https://avatars3.githubusercontent.com/u/46134?v=4&s=117)](https://github.com/purplecabbage)[![theaccordance](https://avatars3.githubusercontent.com/u/1813001?v=4&s=117)](https://github.com/theaccordance)[![jonas-m-](https://avatars3.githubusercontent.com/u/1147572?v=4&s=117)](https://github.com/jonas-m-)

[![Chuckytuh](https://avatars3.githubusercontent.com/u/1127199?v=4&s=117)](https://github.com/Chuckytuh)[![leonardobazico](https://avatars1.githubusercontent.com/u/5280179?v=4&s=117)](https://github.com/leonardobazico)[![loslislo-lshift](https://avatars0.githubusercontent.com/u/17316151?v=4&s=117)](https://github.com/loslislo-lshift)[![luka5](https://avatars2.githubusercontent.com/u/1176296?v=4&s=117)](https://github.com/luka5)[![mac89](https://avatars3.githubusercontent.com/u/2988607?v=4&s=117)](https://github.com/mac89)[![markokeeffe](https://avatars2.githubusercontent.com/u/1211393?v=4&s=117)](https://github.com/markokeeffe)

[![mbektchiev](https://avatars1.githubusercontent.com/u/5744783?v=4&s=117)](https://github.com/mbektchiev)[![goya](https://avatars1.githubusercontent.com/u/208774?v=4&s=117)](https://github.com/goya)[![slorber](https://avatars0.githubusercontent.com/u/749374?v=4&s=117)](https://github.com/slorber)[![daserge](https://avatars1.githubusercontent.com/u/4272078?v=4&s=117)](https://github.com/daserge)[![smdvdsn](https://avatars2.githubusercontent.com/u/507093?v=4&s=117)](https://github.com/smdvdsn)[![ryanluker](https://avatars2.githubusercontent.com/u/1335972?v=4&s=117)](https://github.com/ryanluker)

[![russellbeattie](https://avatars1.githubusercontent.com/u/166835?v=4&s=117)](https://github.com/russellbeattie)[![rjmunro](https://avatars0.githubusercontent.com/u/108641?v=4&s=117)](https://github.com/rjmunro)[![hanicker](https://avatars3.githubusercontent.com/u/510258?v=4&s=117)](https://github.com/hanicker)[![mwbrooks](https://avatars1.githubusercontent.com/u/21328?v=4&s=117)](https://github.com/mwbrooks)[![LightZam](https://avatars3.githubusercontent.com/u/5077142?v=4&s=117)](https://github.com/LightZam)[![laagland](https://avatars3.githubusercontent.com/u/7661210?v=4&s=117)](https://github.com/laagland)

[![cuatl](https://avatars1.githubusercontent.com/u/1399392?v=4&s=117)](https://github.com/cuatl)[![gianpaj](https://avatars3.githubusercontent.com/u/899175?v=4&s=117)](https://github.com/gianpaj)[![EdMcBane](https://avatars1.githubusercontent.com/u/8511142?v=4&s=117)](https://github.com/EdMcBane)[![chriswiggins](https://avatars0.githubusercontent.com/u/2830609?v=4&s=117)](https://github.com/chriswiggins)[![barryvdh](https://avatars2.githubusercontent.com/u/973269?v=4&s=117)](https://github.com/barryvdh)[![armno](https://avatars3.githubusercontent.com/u/911894?v=4&s=117)](https://github.com/armno)

[![archananaik](https://avatars2.githubusercontent.com/u/5604248?v=4&s=117)](https://github.com/archananaik)[![jakub-g](https://avatars2.githubusercontent.com/u/1437027?v=4&s=117)](https://github.com/jakub-g)[![shazron](https://avatars0.githubusercontent.com/u/36107?v=4&s=117)](https://github.com/shazron)[![sclement41](https://avatars0.githubusercontent.com/u/443136?v=4&s=117)](https://github.com/sclement41)[![hung-doan](https://avatars1.githubusercontent.com/u/11371581?v=4&s=117)](https://github.com/hung-doan)[![BBosman](https://avatars3.githubusercontent.com/u/5115488?v=4&s=117)](https://github.com/BBosman)

[![giordanocardillo](https://avatars3.githubusercontent.com/u/3403386?v=4&s=117)](https://github.com/giordanocardillo)[![mikepsinn](https://avatars3.githubusercontent.com/u/2808553?v=4&s=117)](https://github.com/mikepsinn)[![AdriVanHoudt](https://avatars1.githubusercontent.com/u/2361826?v=4&s=117)](https://github.com/AdriVanHoudt)[![alexislg2](https://avatars1.githubusercontent.com/u/7933080?v=4&s=117)](https://github.com/alexislg2)[![jcesarmobile](https://avatars3.githubusercontent.com/u/1637892?v=4&s=117)](https://github.com/jcesarmobile)[![nadyaA](https://avatars2.githubusercontent.com/u/6064810?v=4&s=117)](https://github.com/nadyaA)

[![jdhiro](https://avatars0.githubusercontent.com/u/2919453?v=4&s=117)](https://github.com/jdhiro)[![edewit](https://avatars1.githubusercontent.com/u/51133?v=4&s=117)](https://github.com/edewit)[![wildabeast](https://avatars1.githubusercontent.com/u/118985?v=4&s=117)](https://github.com/wildabeast)[![mkuklis](https://avatars2.githubusercontent.com/u/63545?v=4&s=117)](https://github.com/mkuklis)[![ashconnell](https://avatars2.githubusercontent.com/u/760516?v=4&s=117)](https://github.com/ashconnell)[![zwacky](https://avatars1.githubusercontent.com/u/1093032?v=4&s=117)](https://github.com/zwacky)

[![rakatyal](https://avatars2.githubusercontent.com/u/12533467?v=4&s=117)](https://github.com/rakatyal)[![jtbdevelopment](https://avatars3.githubusercontent.com/u/2074134?v=4&s=117)](https://github.com/jtbdevelopment)[![EddyVerbruggen](https://avatars1.githubusercontent.com/u/1426370?v=4&s=117)](https://github.com/EddyVerbruggen)[![fredgalvao](https://avatars2.githubusercontent.com/u/616464?v=4&s=117)](https://github.com/fredgalvao)[![bobeast](https://avatars0.githubusercontent.com/u/441403?v=4&s=117)](https://github.com/bobeast)[![macdonst](https://avatars1.githubusercontent.com/u/353180?v=4&s=117)](https://github.com/macdonst)

[![larrybahr](https://avatars1.githubusercontent.com/u/8782684?v=4&s=117)](https://github.com/larrybahr)

## 常见问题

### @havesource/cordova-plugin-push 是什么？

登记并收到推车通知\.

### 如何安装 @havesource/cordova-plugin-push？

在项目目录运行 npm install @havesource/cordova-plugin-push，或使用 pnpm add / yarn add / bun add。

### @havesource/cordova-plugin-push 支持 TypeScript 吗？

支持。包内自带 TypeScript 类型声明（package\.json 声明了 types 入口），安装后即可获得类型提示，无需再安装 @types 包。

### @havesource/cordova-plugin-push 可以商用吗？

@havesource/cordova-plugin-push 使用 MIT 许可。宽松许可：允许商业使用、修改和再分发，通常只需在分发时保留原版权与许可声明。以上为概括，不构成法律意见，请以许可原文为准。

### @havesource/cordova-plugin-push 的下载量有多少？

根据 npm 官方下载统计，@havesource/cordova-plugin-push 在 2026/10/18 – 2026/11/16 这 30 天内被下载 15,316 次，日均约 511 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。

### @havesource/cordova-plugin-push 还在维护吗？

最新版本 7\.0\.0 发布于 2025/09/09（1\.2 年前）；至今共发布 22 个版本，其中过去 12 个月发布了 0 个；首次发布于 2020/11/08。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。

