Apple Wallet 凭证 API
让用户将 .pkpass 凭证(门票、优惠券、会员卡)从您的 Web 应用添加到 Apple Wallet。
Apple Wallet 凭证 API 让您的 Web 应用可以向用户提供 .pkpass 文件(活动门票、登机牌、优惠券、会员卡等),以便用户将其添加到 Apple Wallet。
使用方法:
链接到您的 .pkpass 文件,但将文件 URL 的 https:// 前缀替换为 addpkpass://:
<a href="addpkpass://example.com/passes/ticket.pkpass">将门票添加到 Apple Wallet</a>
工作原理:
- 应用将
addpkpass://链接转换回https://URL。 - 凭证 URL 在应用内浏览器标签页中打开,该标签页会识别
.pkpass内容并显示原生的添加到 Apple Wallet 预览。 - 用户确认后,凭证将存储在 Wallet 应用中。
注意:凭证必须通过 HTTPS 提供,使用正确的 MIME 类型 application/vnd.apple.pkpass,并使用有效的 Apple Pass Type ID 证书签名(关于如何生成凭证,请参阅 Apple Wallet Passes 文档)。
SDK 风格的实现说明
将此功能视为向 Web 层公开的原生能力:将生产网站或 PWA 作为唯一可信来源,然后使用文档中的 WebViewGold 配置标志、URL 命令和 JavaScript 桥接调用,仅在能够带来价值的地方启用原生 iOS 行为。这种方式让代码库易于维护,因为同一个 Web 应用只需极少的条件逻辑即可同时服务于浏览器、WebViewGold for iOS 以及其他 WebViewGold 平台。
为获得可靠的结果,建议优先使用 HTTPS 端点、稳定的路由名称、在界面中明确的成功/错误状态,以及封装原生调用的小型 JavaScript 辅助函数。例如,使用 jQuery Mobile、Lovable、Base44、Bolt、WordPress、Bubble、自定义 React/Vue/Angular 技术栈或静态 HTML 构建的 Web 应用,可以提供单个按钮或事件处理程序来触发原生 WebViewGold API,同时仍为浏览器提供优雅的回退方案。
- 推荐的集成模式:检测应用上下文,调用 WebViewGold API,然后在原生回调或路由变更后更新 Web 界面。
- 测试清单:在真机或打包构建上验证该功能,检查权限和商店审核文案,并确认仅使用浏览器的用户仍能获得有用的回退方案。
- SEO 优势:让功能页面、路由标题和结构化内容在您的网站上保持可被索引,同时由 WebViewGold 为 iOS 用户提供原生应用外壳。