# @aparajita/capacitor-ios-silent-notifications 中文文档

规范地址：https://npmcn.com/package/%40aparajita/capacitor-ios-silent-notifications/

版本：3\.0\.0
npm 元数据更新时间：2025-10-31T15:30:22.220Z
中文译文更新时间：2026-11-06T09:00:59.660Z
软件包许可：MIT

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

原始 npm 页面：https://www.npmjs.com/package/%40aparajita/capacitor-ios-silent-notifications
原文对照：https://npmcn.com/package/%40aparajita/capacitor-ios-silent-notifications/?lang=original
项目主页：https://github.com/aparajita/capacitor-ios-silent-notifications#readme
源码仓库：https://github.com/aparajita/capacitor-ios-silent-notifications

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

- 包体积（解压后）：13.8 kB，15 个文件
- 模块格式：ESM + CJS
- TypeScript 类型：包内自带
- Node.js 要求：\>=20\.0\.0
- 运行依赖：4 个
- 首次发布：2024-03-08T01:58:54.307Z
- 最新版本发布：2025-10-31T15:30:21.994Z
- 近 30 天下载量：4538（2026-10-06 至 2026-11-04，npm 官方下载统计）
- 已发布版本数：5（近 12 个月 0 个）

## 中文简介

为 iOS 提供无声通知支持的 Capacitor 7+ 插件

## 安装

```sh
npm install @aparajita/capacitor-ios-silent-notifications
```

也可以使用：`pnpm add @aparajita/capacitor-ios-silent-notifications`、`yarn add @aparajita/capacitor-ios-silent-notifications`、`bun add @aparajita/capacitor-ios-silent-notifications`

## README

# 电容器- ios- silent- 通知

此插件用于 [电容器 7+](https://capacitorjs.com/) 为iOS上无声(只提供数据)通知提供支持.

## 安装

```sh
pnpm add @aparajita/capacitor-ios-silent-notifications # npm install, yarn add
```

没有使用 [小时](https://pnpm.js.org/)你欠它自己 一个尝试。 更快速、更适合单簧管 _就是这样,就是这样_ 磁盘空间比其它选项少.

> 此插件假设您已经 [配置您用于按下通知的应用程序](https://capacitorjs.com/docs/apis/push-notifications)。 。 。 .

## 使用量

使用此插件有两个小步骤:

### 1\. 在您的应用程序中添加一个听众

在您的应用程序初始化过程中添加以下代码 :

```typescript
import { IosSilentNotifications } from '@aparajita/capacitor-ios-silent-notifications'

// `const { remove }` is optional. If you are never going to remove the listener,
// you can omit it.
const { remove } = await IosSilentNotifications.addListener(
  'onSilentNotification',
  (notification: Notification) => {
    // Do something with the notification
  },
)
```

请注意,在Android上,这个插件没有任何作用,因为同一功能已经由 `@capacitor/push-notifications` 插件 。 如果你愿意,你可以跳过呼叫 `addListener` 在Android上显示:

```typescript
if (Capacitor.getPlatform() === 'ios') {
  await IosSilentNotifications.addListener(
    'onSilentNotification',
    (notification: Notification) => {
      // Do something with the notification
    },
  )
}
```

#### 2\. 将通知转发给插件

在您的应用中 `AppDelegate.swift` 文件,将以下代码添加到 `AppDelegate` 类 :

```swift
  func application(_ application: UIApplication,
                   didReceiveRemoteNotification userInfo: [AnyHashable: Any],
                   fetchCompletionHandler completionHandler: @escaping (UIBackgroundFetchResult) -> Void) {
    NotificationCenter.default.post(name:Notification.Name("silentNotification"), object: userInfo);
    completionHandler(UIBackgroundFetchResult.newData)
  }
```

## 常见问题

### @aparajita/capacitor-ios-silent-notifications 是什么？

为 iOS 提供无声通知支持的 Capacitor 7\+ 插件

### 如何安装 @aparajita/capacitor-ios-silent-notifications？

在项目目录运行 npm install @aparajita/capacitor-ios-silent-notifications，或使用 pnpm add / yarn add / bun add。

### @aparajita/capacitor-ios-silent-notifications 支持 TypeScript 吗？

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

### @aparajita/capacitor-ios-silent-notifications 支持 ESM 还是 CommonJS？

同时提供 ES Module 与 CommonJS 入口，import 和 require\(\) 都可以使用，打包工具会自动选择合适的版本。

### @aparajita/capacitor-ios-silent-notifications 需要什么版本的 Node\.js？

package\.json 的 engines 字段要求 Node\.js \>=20\.0\.0。版本不符时 npm 默认只给出警告，开启 engine-strict 后会拒绝安装。

### @aparajita/capacitor-ios-silent-notifications 可以商用吗？

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

### @aparajita/capacitor-ios-silent-notifications 的下载量有多少？

根据 npm 官方下载统计，@aparajita/capacitor-ios-silent-notifications 在 2026/10/06 – 2026/11/04 这 30 天内被下载 4,538 次，日均约 151 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。

### @aparajita/capacitor-ios-silent-notifications 还在维护吗？

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