# @evennit/notifee-expo-plugin 中文文档

规范地址：https://npmcn.com/package/%40evennit/notifee-expo-plugin/

版本：3\.8\.0
npm 元数据更新时间：2026-02-17T21:54:39.579Z
中文译文更新时间：2026-11-14T01:03:09.452Z
软件包许可：MIT

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

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

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

- 包体积（解压后）：68.3 kB，28 个文件
- 模块格式：CommonJS
- TypeScript 类型：未声明
- 运行依赖：1 个
- 首次发布：2024-07-05T07:31:24.394Z
- 最新版本发布：2026-02-17T21:54:39.453Z
- 近 30 天下载量：11787（2026-10-14 至 2026-11-12，npm 官方下载统计）
- 已发布版本数：9（近 12 个月 1 个）

## 中文简介

此插件将允许您使用带有通知服务扩展的 Notifee , 而无需退出 Expo 管理的工作流程 .

## 安装

```sh
npm install @evennit/notifee-expo-plugin
```

也可以使用：`pnpm add @evennit/notifee-expo-plugin`、`yarn add @evennit/notifee-expo-plugin`、`bun add @evennit/notifee-expo-plugin`

## README

# \### Notifee-Expo-Plugin # ######################################################################################################################################################

对 **你们** 寻找一个可以神奇地为您做这些事情的插件, 而不需要弹出您的 Expo 应用程序

-   在 Notifee 服务中添加通知服务扩展 _(由于iOS上的低功率模式使得BackgroundEvent上的 Notifee 无法使用)_
-   用您提供的 Apple dev 团队 ID 自动签名您的主要应用程序和通知服务扩展目标
-   在您的应用程序中添加 iOS 通信通知功能
-   启用您喜欢的 iOS 背景模式
-   用您的通知图标插入您的 Android 应用程序文件夹

你来对地方了!

## \* 安装 \* \* \*

确定你已经有了 `@notifee/react-native` 安装,然后:

```sh
# npm
npm install @evennit/notifee-expo-plugin

#or

# yarn
yarn add @evennit/notifee-expo-plugin
```

## 翻译:

将插件添加到您的 Expo 配置的插件阵列中 :

应用配置.js

```js
{
  plugins: [
    [
      "@evennit/notifee-expo-plugin",
      {
        iosDeploymentTarget: "13.4", //<-- Must be the same as your main app target's iOS deployment target
        apsEnvMode: "development",
      },
    ],
  ];
}
```

应用. config.json

```json
{
  "expo": {
    "plugins": [
      [
        "@evennit/notifee-expo-plugin",
        {
          "iosDeploymentTarget": "13.4", //<-- Must be the same as your main app target's iOS deployment target
          "apsEnvMode": "development"
        }
      ]
    ]
  }
}
```

## 重建你的应用程序

在安装并添加插件到您的工程的 Expo 配置插件阵列后, 您需要重建您的 iOS 和 Android 应用程序 :

```sh
npx expo prebuild
```

现在你该走了!

## 道具

| 财产 | 说明 |
| --- | --- |
| `apsEnvMode: string` (必须) | 设置 APS 环境权限 。 确定是使用开发还是生产Apple Push通知服务(APN).  
数值 : `"development"` 或者说 `"production"` |
| `iosDeploymentTarget: string` (必须) | 为iOS设定通知服务扩展的部署目标. 这应该符合主应用程序的部署目标.  
实例: `"13.4"` |
| `androidIcons?: NotifeeAndroidIcon[]` | 指定将添加到适当的资源文件夹中的Android图标,以备通知。 每个图标应使用名称、路径和类型(大小)来定义.  
实例: `[{ name: "ic_small_logo", path: "./assets/logo.png", type: "small" }]` |
| `enableCommunicationNotifications?: boolean` | 启用通信通知, 这将添加通信通知的必要配置 [https://github.com/invertase/notifee/pull/526 (英语)](https://github.com/invertase/notifee/pull/526)。 。 。 . |
| `appleDevTeamId?: string` | 用提供的苹果开发团队ID自动在app和通知服务扩展目标上签名. |
| `customNotificationServiceFilePath?: string` | 指定自定义通知服务文件的路径,其中应该已经包括 Notifee 的必要配置以及任何额外的定制。 您可以基于此软件包的默认通知Service.m文件.  
实例: `"./assets/notifee/NotificationService.m"`。 。 。 . |
| `backgroundModes?: string[]` | 指定应用程序的背景模式。 如果不提供,默认值将是: `["remote-notification"]`另一方面,一个空阵列 `[]` 将会向插件发出信号以跳过背景 Modes 步骤 。 仅iOS.  
在此参见可能值 : [https://developer.apple.com/documentation/bundleresources/information property list/uibackgroundmodes 页面存档备份,存于互联网档案馆](https://developer.apple.com/documentation/bundleresources/information_property_list/uibackgroundmodes) |
| `verbose?: boolean` | 在插件配置过程中启用动词日志输出. 设定为 `true`,插件将记录每个步骤的详细信息。 默认为 `false`。 。 。 . |

## STARS队

如果这对你有什么用,就给它一个:

## 感谢并想支持我

你可以支持我 通过 [科非语](https://ko-fi.com/kevpug)。 。 。 .

## 执照

这套软件包可在 [麻省理工学院许可证](https://github.com/evennit/notifee-expo-plugin/blob/main/LICENSE)。 。 。 .

快乐的编码 :)

## 常见问题

### @evennit/notifee-expo-plugin 是什么？

此插件将允许您使用带有通知服务扩展的 Notifee , 而无需退出 Expo 管理的工作流程 \.

### 如何安装 @evennit/notifee-expo-plugin？

在项目目录运行 npm install @evennit/notifee-expo-plugin，或使用 pnpm add / yarn add / bun add。

### @evennit/notifee-expo-plugin 支持 TypeScript 吗？

该包的 package\.json 没有声明类型入口。需要类型提示时，可以在 npm 上查找社区维护的 @types/evennit\_\_notifee-expo-plugin 是否存在。

### @evennit/notifee-expo-plugin 支持 ESM 还是 CommonJS？

以 CommonJS 形式发布，可以直接 require\(\)；在 ES Module 项目中也可以用 import 引入（Node\.js 会把 module\.exports 作为默认导出）。

### @evennit/notifee-expo-plugin 可以商用吗？

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

### @evennit/notifee-expo-plugin 的下载量有多少？

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

### @evennit/notifee-expo-plugin 还在维护吗？

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