PassBook服务

Passbook是苹果推出的一个管理登机牌、会员卡、电影票、优惠券等信息的 工具。Passbook就像一个卡包，用于存放你的购物卡、积分卡、电影票、礼品卡等，而这些票据就是一个“Pass”。和物理票据不同的是你可以动态更 新Pass的信息，提醒用户优惠券即将过期；甚至如果你的Pass中包含地理位置信息的话当你到达某个商店还可以动态提示用户最近商店有何种优惠活动；当 用户将一张团购券添加到Passbook之后，用户到了商店之后Passbook可以自动弹出团购券，店员扫描之后进行消费、积分等等都是 Passbook的应用场景。Passbook可以管理多类票据，苹果将其划分为五类：

1. 登机牌（Boarding pass）

2. 优惠券（Coupon）

3. 活动票据、入场券（Event ticket）

4. 购物卡、积分卡（Store Cards）

5. 普通票据(自定义票据)（Generic pass）

苹果的划分一方面出于不同票据功能及展示信息不同，另一方面也是为了统一票据的设计，下面是苹果官方关于五种票据的布局设计布局：

既然一个票据就是一个Pass，那么什么是Pass呢？在iOS中一个Pass其实就是一个.pkpass文件，事实上它是一个Zip压缩包，只是这个压缩包要按照一定的目录结构来设计，下面是一个Pass包的目录结构（注意不同的票据类型会适当删减）：

Pass Package

├── icon.png

├── icon@2x.png

├── logo.png

├── logo@2x.png

├── thumbnail.png

├── thumbnail@2x.png

├── background.png

├── background@2x.png

├── strip.png

├── strip@2x.png

├── manifest.json

├── fr.lproj

│ └── pass.strings

├── de.lproj

│ └── pass.strings

├── pass.json

└── signature

也就是说在Passbook应用中显示的内容其实就是一个按照上面文件列表来组织的一个压缩包。在.pkpass文件中除了图标icon、缩略图thumbnail和logo外最重要的就是pass.json、manifest.json和signature。

• 1.pass.json

这个文件描述了Pass的布局、颜色设置、文本描述信息等，也就是说具体Pass包如何展示其实就是通过这个JSON文件来配置的，关于pass.json的具体配置项在此不再一一介绍，大家可以查看苹果官方帮助文档“Pass Design and Creation”。这里主要说一下其中关键的几个配置项：

passTypeIdentifier:pass唯一标识，这个值类似于App ID，需要从开发者中心创建，并且这个标识必须以“pass”开头（例如下面的示例中取名为“pass.com.cmjstudio.mypassbook”）。

teamIdentifier：团队标识，申请苹果开发者账号时会分配一个唯一的团队标识（可以在苹果开发者中心--查看账户信息中查看”Team ID“）。

barcode:二维码信息配置，主要指定二维码内容、类型、编码格式。

locations:地理位置信息，可以配置相关位置的文本信息。

• 2.manifest.json

manifest.json 从名称可以看出这个文件主要用来描述当前Pass包中的文件目录组织结构。这个文件记录了除“manifest.json”、“signature”外的 文件和对应的sha1哈希值（注意：哈希值可以通过”openssl sha1 [ 文件路径]“命令获得）。

• 3.signature

signature是一个签名文件。虽然manifest.json存储了哈希值，但是大家都知道hash算法是公开的，如何保证一个pass包是合法的，未经修改的呢？那就是使用一个签名文件来验证。

了 解了以上内容后基本上对于如何定义一个pass包有了简单的概念。有了pass包之后对于添加pass到passbook应用是比较简单的。但事实上通常 大家看到的passbook应用中添加的pass包并不是手动组织的，而是通过程序来完成pass包制作的。举例来说：如果你在美团上购买一张电影票之 后，会告诉你一个优惠码，这个优惠码会显示到pass中。由于这个优惠码是动态生成的，所以直接手动制作出一个pass包是不现实的。通常情况下pass 包的生成都是通过后台服务器动态生成，然后返回给iOS客户端来读取和添加的，手动制作pass包的情况是比较少的，除非你的票据信息是一成不变的。当然 为了演示Passbook应用，这里还是会以手动方式演示一个pass包的生成过程，了解了这个过程之后相信在服务器端通过一些后台程序生成一个pass 包也不在话下（下面的生成过程均可通过服务器端编程来实现）。

同其他Apple服务开发类似，做Passbook开发同样需要一些准备工作：

在 苹果开发者中心新建Pass Type ID（例如这里新建一个“pass.com.cmjstudio.mypassbook”），并且基于这个Pass Type ID创建一个Passbook证书（在mac上找到钥匙串，选择”从证书颁发机构请求证书“，生成一个证书请求文件；将此文件上传到对应的Pass Type ID下生成证书文件）如下图：Pa

下载证书后，将此证书导入Mac中（此处配置的Pass Type ID对应pass.json中的”passTypeIdentitifier“，此证书用于生成签名文件signature。）。

在 Xcode中-Targets-Capabilities启用Pasbook服务，这里需要注意的是”Allow all team pass types“选项，如果勾选了这一项，那么pass.json中的passTypeIdentifier和teamIdentifier就可以是任何团队 创建的任何Pass项目了，这里使用前面创建的项目，所以选择”Allow subset of pass types“。

有了上面的准备工作，下面看一下如何制作一个Pass：

• 根据所选择的Passbook类型准备图片素材，由于这里以一个Store Card举例，所以需要准备icon、logo和strip三类图片。

• 配 置pass.json，这里还是强调一下passTypeIdentifier和teamIdentifier，前者就是上面在开发者中心创建的Pass Type ID（”pass.com.cmjstudio.mypassbook“）,后者是对应的团队标识，其他信息根据实际情况配置。

 1 {
 2     "formatVersion":1,  3 "passTypeIdentifier":"pass.com.cmjstudio.mypassbook",  4 "serialNumber":"54afe978584e3",  5 "teamIdentifier":"JB74M3J7RY",  6 "authenticationToken":"bc83dde3304d766d5b1aea631827f84c",  7 "barcode":{"message":"userName KenshinCui","altText":"会员详情见背面","format":"PKBarcodeFormatQR","messageEncoding":"iso-8859-1"},  8 "locations":[  9 {"longitude":-122.3748889,"latitude":37.6189722},{"longitude":-122.03118,"latitude":37.33182}], 10 "organizationName":"CMJ Coffee", 11 "logoText":"CMJ Coffee", 12 "description":"", 13 "foregroundColor":"rgb(2,2,4)", 14 "backgroundColor":"rgb(244,244,254)", 15 "storeCard":{ 16 "headerFields":[{"key":"date","label":"余额","value":"￥8888.50"}], 17 "secondaryFields":[{"key":"more","label":"VIP会员","value":"Kenshin Cui"}], 18 "backFields":[ 19 {"key":"records","label":"消费记录(最近10次)","value":" 9/23 ￥107.00 无糖冰美式\n 9/21 ￥58.00 黑魔卡\n 8/25 ￥44.00 魔卡\n 8/23 ￥107.00 无糖冰美式\n 8/18 ￥107.00 无糖冰美式\n 7/29 ￥58.00 黑魔卡\n 7/26 ￥44.00 魔卡\n 7/13 ￥58.00 黑魔卡\n 7/11 ￥44.00 魔卡\n 6/20 ￥44.00 魔卡\n"}, 20 {"key":"phone","label":"联系方式","value":"4008-888-88"}, 21 {"key":"terms","label":"会员规则","value":