苹果终于上线了官方卡券设计工具 Pass Designer 测试版。对常年跟 Apple Wallet 打交道的开发者来说,这件要求 macOS 27 或更高版本的工具,终结了十多年来靠手写 pass.json、找第三方网页瞎猜渲染效果的笨办法。不过只要深入看一眼它的产出物就会发现,苹果这次并不是在做一个面向运营人员的免代码发券玩具,而是在给这几年激进演进却愈发混乱的卡券生态打一剂工程补丁。

渲染终于不用盲猜,但它只造模板不发卡

过去在 Apple Wallet 里做一张卡券,体验极其原始。要么在本地手敲配置字段然后反复推流打包,要么依赖第三方商用平台提供的预览界面,但第三方预览常常与真机显示存在色差和排版偏差。Pass Designer 最大的实际价值,是直接调用了与 iOS 和 watchOS 完全一致的真机渲染引擎。不管是背景、前景与标签颜色的搭配,还是标准字段的文本折行,屏幕所见即是用户在设备上看到的效果,甚至能即时校验必填字段缺失或非法定义。

但很多非技术团队会产生误解,以为装了这个工具就能直接导出卡券发给用户。事实恰恰相反,Pass Designer 导出的只是一个后缀为 .pkpasstemplate 的模板包,而不是终端设备可以直接导入的 .pkpass 文件。

在 WWDC26 第 209 场专题会议中,苹果官方把卡券工具的讲解切成了两段:5 分 46 秒开始介绍前端设计工具 Pass Designer,而到了 10 分 40 秒,才引出真正负责生产的 Pass Builder。一套能在工业环境跑通的发券流水线,必须将前端模板交给后端注入真实数据并完成安全签名。

WWDC26 确立的卡券官方生产管线 Pass Designer macOS 27+ 界面配置 实时真机排版校验 产出: .pkpasstemplate Pass Builder 支持 Mac 与 Linux 环境 Swift API / buildpass CLI 个性化注入 + 私钥签名 最终可用卡券 构建 manifest 清单 PKCS #7 分离签名 标准 .pkpass

如果选择手动签名,开发者必须自行构建清单文件,使用卡券私钥执行 PKCS #7 分离签名并压缩归档。显然,苹果官方推出这套工具,瞄准的是规范流水线前端,而不是替企业打通后端的发券服务器。

语义野心背后,旧设备的空白陷阱

苹果急于在这个时间点交出 Pass Designer,核心动力在于卡券底层逻辑的激进化转型。从 WWDC24 推出面向 iOS 18 的海报活动门票,到 WWDC25 面向 iOS 26 和 watchOS 26 升级航空登机牌语义结构,再到 WWDC26 推出依赖 iOS 27 的 Poster Generic,卡券已经不再是一张贴着条码的静态图片。

系统需要卡券承载高度结构化的语义标签。航班起飞时间、登机口、场馆地址这些关键信息,直接被 Siri 建议、系统日历和地图抽取使用。可这种演进带来了一个极为棘手的副作用:老机型的解析断层。

模板看着越前卫,旧系统解析起来就越脆弱。

在 Pass Designer 中,苹果特别强化了语义标签编辑与双轨对比视图。因为根据规范约束,如果开发者在制作新式登机牌或门票时,没有在内部保留 primaryFields、secondaryFields 等旧版基础字段,老版本系统的设备打开卡券时可能会直接呈现为空白;更糟糕的是,如果为了兼容而胡乱定义旧版字段,会导致卡券在所有设备上都导入失败。

系统级特性与传统兼容的硬约束 新版语义 / 海报门票规范 • 语义登机牌仅限航司 (PKTransitTypeAir) • 海报门票排斥二维码与条形码显示 • iOS 27 引入全新条码渲染编码 旧版向下兼容硬约束 • 缺失 legacy 字段:旧设备呈现空白 • legacy 格式非法:所有设备导入失败 • barcodes 缺 QR 兜底:旧系统条码消失

更细节的暗礁还在条码规则里。iOS 27 引入了全新的条码格式,但如果开发人员没有在优先级配置的 barcodes 数组中留下一套被广泛支持的旧格式(比如传统的 QR 码),运行 iOS 26 或更早系统的设备在亮屏后根本无法渲染出条码。官方设计器提供的一键生成向后兼容结构,本质上是苹果不得不为自身过快的系统迭代收拾残局。


前卫海报票撞上冰冷闸机

除了兼容性陷阱,苹果前卫的设计语言与现实世界的物理设施之间,正在出现更明显的断层。

最典型的例子莫过于海报活动门票。从设计构图来看,全幅画面的票面视觉极为现代化,但苹果在官方文档中直接写明:海报门票与需要二维码或条形码入场的门票不兼容。在苹果的理想设想中,无感 NFC 刷卡或者基于超宽带的感应核验才是终局。可现实是,全球绝大多数音乐节、体育赛事和展会现场,检票闸机依然依赖光学镜头扫描二维码。当主办方满心欢喜地用新模板做了一张极具设计感的海报票,却发现入场通道的物理扫码枪根本无从下嘴时,前卫的美学就变成了尴尬的通行阻碍。

同样的局限也体现在语义化交通凭证上。目前苹果的语义登机牌要求交通类型严格限定于航司航班,火车和公路客运等常规交通场景无法套用这套深层联动模型。

  • 提醒.开发团队切换到 Poster Event Ticket 或新条码格式前,必须确认线下闸机支持非条码验证,且务必在 barcodes 数组中保留 QR 码作为降级兜底。

这场变动同样在重构卡券服务商的生存空间。过去像 PassKit、Passcreator 这类商业第三方平台,靠着提供友好的 Web 排版工具和格式转换向企业收取订阅费。如今苹果官方免费提供了真机一致的视觉工具,第三方平台的排版壁垒几乎被削平。

但官方工具并没有宣判第三方平台的死刑。Pass Designer 挑起的是模板规范和数据校验的担子,而批量用户下发的动态 API、用户卡券生命周期内的锁屏通知推送,以及基于非 macOS 服务器环境的大规模分发流水线,依然是外部系统的阵地。工具归工具,管道归管道。如何在老设备的空白风险与新系统的数据红利之间找到平衡,才是摆在每一个卡券技术负责人面前的现实问题。