@giulio987/expo-wallet

中文文档
1.0.0发布于 2026/10/24MITTypeScriptESM + CJS零依赖构建来源已验证近 30 天下载 1.2万

添加、读取和管理苹果钱包和Google钱包, 由 Nitro 模块创建 React Industrial / Expo 通过

中文使用文档
文档目录7 节
  1. 安装
  2. 配置插件( iOS)
  3. 使用量
  4. 示例
  5. 发展
  6. 捐款
  7. 许可证

@giulio987/expo-wallet(英语:

Google Wallet Apple Wallet

添加通行证到 苹果钱包 财务报告和审定财务报表 谷歌钱包 从React Industrial / Expo,并读取已经用苹果钱包的通行证. 建造在 硝基模块 (JSI,无桥.

v1 是一个重写: 该模块不再是 Expo 模块 (expo-modules-core)但是一个硝基模组. 它需要一个开发建设, 博览会Go不支持.

安装

npx expo install @giulio987/expo-wallet react-native-nitro-modules
npx expo prebuild

需要新架构(自世博会SDK 53起的默认)和世博会SDK 53+ / React Introduct 0.78+.

配置插件( iOS)

getPasses, (中文(简体) ), containsPass 财务报告和审定财务报表 removePass 只看到通过 通过类型标识符 在应用程序中列出 com.apple.developer.pass-type-identifiers 权利。 插件为您添加 :

{
  "expo": {
    "plugins": [
      ["@giulio987/expo-wallet", { "passTypeIdentifiers": ["pass.com.example.mypass"] }]
    ]
  }
}

无 passTypeIdentifiers 插件无所事事(必须在您的 App ID 上启用该权限,所以它被选入); 保存已有的标识符。 匹配的 Pass 类型 ID 必须存在于您的 Apple 开发者账户和应用程序的提供配置中 。 不利用博览会? 自己在 Xcode 中加入权利 .

使用量

import ExpoWallet, { AddToWalletButton } from "@giulio987/expo-wallet";

if (await ExpoWallet.isAvailable()) {
  // iOS: base64 encoded .pkpass   Android: signed Google Wallet JWT
  const added = await ExpoWallet.addPass(Platform.OS === "ios" ? pkpassBase64 : jwt);
  // true = added, false = user cancelled
}

const passes = await ExpoWallet.getPasses(); // iOS only

<AddToWalletButton buttonStyle="black" onPress={() => ExpoWallet.addPass(payload)} />;

命名出口( E)import { addPass } from ...) 也可以使用.

API 密码iOS系统机器人
isAvailable()可用密码KitGoogle 钱包 API 可用
canAddPasses()对永远 false (使用时 isAvailable(中文(简体) )
addPass(data)基础64 .pkpass谷歌钱包 JWT
addPasses(data[])对拒绝 UNSUPPORTED
getPasses()是(您的通行证类型)拒绝 UNSUPPORTED
containsPass(typeId, serial)对拒绝 UNSUPPORTED
removePass(typeId, serial)对拒绝 UNSUPPORTED
<AddToWalletButton />PKAddPassButton简单本地按钮*

Google 钱包没有客户端 API 来列出或删除保存的通行证,只有服务器侧的 REST API,因此 UNSUPPORTED 拒绝.

*Android按钮是一个纯黑色的按钮. 用于生产 谷歌钱包品牌指南 并使用"添加到谷歌钱包"的官方资产.

错误是 WalletErrors 与一个 code 从 WALLET_ERRORS,比如说. if (e instanceof WalletError && e.code === WALLET_ERRORS.UNSUPPORTED)。 。 。 .

addPass 决定 true 如果通行证是添加的(在iOS上,如果它已经在钱包里)和 false 如果用户取消. addPasses 决定 true 只要每个传球都落到钱包里.

示例

cd example
npm install
npx expo prebuild
npm run ios   # or: npm run android

发展

npm install
npm run specs   # regenerates nitrogen/generated after editing src/specs/*.nitro.ts
npm run build

捐款

欢迎提出问题和拉动请求.

许可证

麻省理工学院

版本与发布记录

@giulio987/expo-wallet 共发布 7 个版本,首次发布于 2023/09/20;过去 12 个月发布了 1 个版本。最新版本附带 npm provenance 构建来源证明,可追溯到公开的 CI 构建记录。

版本发布日期距今
1.0.0latest2026/10/2423 天前
0.1.52025/06/231.4 年前
0.1.42024/02/202 年前
0.1.32023/10/043 年前
0.1.22023/10/043 年前
0.1.12023/09/203 年前

关于 @giulio987/expo-wallet 的常见问题

@giulio987/expo-wallet 是什么?

添加、读取和管理苹果钱包和Google钱包, 由 Nitro 模块创建 React Industrial / Expo 通过

如何安装 @giulio987/expo-wallet?

在项目目录运行 npm install @giulio987/expo-wallet,或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖:react(*)、react-native(*)、react-native-nitro-modules(>=0.37.0)。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖,Yarn 需要手动安装。

@giulio987/expo-wallet 支持 TypeScript 吗?

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

@giulio987/expo-wallet 支持 ESM 还是 CommonJS?

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

@giulio987/expo-wallet 可以商用吗?

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

@giulio987/expo-wallet 的下载量有多少?

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

@giulio987/expo-wallet 还在维护吗?

最新版本 1.0.0 发布于 2026/10/24(23 天前);至今共发布 7 个版本,其中过去 12 个月发布了 1 个;首次发布于 2023/09/20。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。