Transcript iOS6 PassBook 透明de面具 PassBook 是啥 PassBook是收集一堆

iOS6 PassBook
透明de面具
PassBook 是啥
•
PassBook是收集一堆
Pass用的容器(废话一
句)
那Pass又是啥
•
Pass是对于可以装入
PassBook的一些类似
会员卡, 票证等等的泛
称(至少我这样理解...)
Pass的导入
• 如何把pass加入到passbook
• 三种途径
• email
• web
• apps
•
Pass的导入
email
•
•
邮件客户端: 直接将pkpass文件作为附件发送
以代码发送邮件, 需要设置MIME的部分, 以python为
例
•
from email.mime.base import MIMEBase
from email.mime.multipart import MIMEMultipart
msg = MIMEMultipart() #set msg[‘from’] msg[‘to’] and etc...
attachment = 'passes/event.pkpass'
pkpass = MIMEBase("application", "vnd.apple.pkpass")
fp = open(attachment, 'rb')
pkpass.set_payload(fp.read())
fp.close()
encoders.encode_base64(pkpass)
pkpass.add_header('Content-Disposition', 'attachment',
filename=attachment)
msg.attach(pkpass)
Pass的导入
Pass的导入
•
web
•
需要设置一些pkpass文件相关的响应头. 以Apache
为例, 需要开启mod_headers.
•
cat .htaccess
<FilesMatch "\.(?i:pkpass)$">
ForceType application/vnd.apple.pkpass
SetEnvIf Request_URI "^.*/([^/]*)$" FILENAME=$1
Header set Content-Disposition "attachment;
filename=%{FILENAME}e"
UnsetEnv FILENAME
Header set Pragma no-cache
Header set Cache-Control "no-store, no-cache, must-revalidate, postcheck=0, pre-check=0"
</FilesMatch>
Pass的导入
• apps
1. 根据pass文件创建出PKPass实例(这
步会校验pass.json是否合法, 包括json
语法是否规范以及相关字段是否符合
要求)
•
NSData *data = [NSData dataWithContentsOfFile:passFilePath];
NSError *error = nil;
PKPass *pass = [[PKPass alloc] initWithData:data error:&error];
NSLog(@”%@”, error.debugDescription);
Pass的导入
• apps
2. 检查PKPassLibrary内是否已经有同样
的pass, 有的话, 进行更新, 没有就要进
行增加.
•
PKPassLibrary *passLibrary = [[PKPassLibrary alloc] init];
if([passLibrary containsPass:pass]) {
BOOL replaceResult = [passLibrary replacePassWithPass:pass];
} else {
PKAddPassesViewController *addPassesViewController = [[PKAddPassesViewController alloc]
initWithPass:pass];
addPassesViewController.delegate = self;
[self.navigationController presentViewController:addPassesViewController animated:YES
completion:NULL];
[addPassesViewController release];
}
Pass的导入
Pass的文件结构
• .pkpass文件其实就是一个zip文件
• pkpass内的文件组织结构
•
•
•
•
•
•
•
•
pass.json
manifest.json
signature
icon.png & [email protected]
logo.png & [email protected]
thumbnail.png
background.png
other multi-language files
Pass的文件结构
• pkpass内的文件组织结构
•
pass.json
•
•
•
pass内最基础的文件之一
json格式
内涵pass需要的全部字段, 后续详述
Pass的文件结构
• pkpass内的文件组织结构
•
manifest.json
•
•
•
json格式
用以校验pass内其他文件是否正确
会记录除mainfest.json以及signature之外其他文件的sha1sum
Pass的文件结构
• pkpass内的文件组织结构
•
signature
•
•
•
•
对manifest.json进行签名后生成的数字签名
用以验证manifest.json的合法性
签名用的证书是从IDP内获取
导入passbook后, 系统内部会进行合法性校验
Pass的文件结构
• pkpass内的文件组织结构
•
icon.png & [email protected]
•
•
显示在email导入时左侧的icon, 系统会负责添加圆角和高光
PKPass类会有一个icon的属性, 也是指向该图片
Pass的文件结构
• pkpass内的文件组织结构
•
logo.png & [email protected]
•
•
在passbook内, 每个pass左上角的icon
需要是透明底色
Pass的文件结构
• pkpass内的文件组织结构
•
thumbnail.png
•
•
•
部分类型的pass内有效
对于Generic类型的而言, 是右侧的头像
Event也是右侧图像
Pass的文件结构
• pkpass内的文件组织结构
•
background.png
•
•
•
至少对部分类型的Pass起作用(没有详细测试), 但至少表现不同
StoreCard内是上方横向的贯通图
EventTicket内则是虚化背景用
pass.json
•
基本字段
•
•
•
•
•
•
formatVersion
•
文件格式标识, 目前只有 1 一个取值
passTypeIdentifier
•
在idp内建立的pass标识, 与签名用的证书相关联
organizationName
•
组织名称, 会在email的附件部分以及在PKPass的一个属性中体现
teamIdentifier
•
组织唯一标识, 目前没找到来源, 我这边用appid前系统添加那个串来替代了.
serialNumber
•
唯一标识一个pass的码, 两个码一样且组织标识一样的将被认为是同一个pass
description
•
iOS6 B2开始要求的新字段, 内容随便写
pass.json
•
其他可选字段
•
•
•
•
•
•
•
•
locations
relevantDate
foregroundColor
backgroundColor
logoText
webServiceURL
authenticationToken
barCode
pass.json
• 其他可选字段
• locations
• 到达此位置范围或者附近时会给出提
示
• 一组或多组经纬度组合, 也可以包括
海拔高度.
• 应该是根据经纬度的精度不同来设定
范围的大小(并未详细测试)
pass.json
• 其他可选字段
• relevantDate
• 触发时间
• 到该时间时会给出提示
pass.json
• 其他可选字段
• foregroundColor & backgroundColor
• 类似 rgb(22, 55, 111) 这样的颜色值
• 分别是背景和前景(字)的颜色
pass.json
• 其他可选字段
• webServiceURL &
authenticationToken
• pass可以和一个webService进行交
互, 以获取更新等状态
• 需要以authenticationToken进行认证
pass.json
•
其他可选字段
•
barCode
•
生成二维码或者条码等
•
•
•
•
format: 必要字段, 标明要生成哪种码, 有如下可选
PKBarcodeFormatQR, //二维码
PKBarcodeFormatPDF417, //条码
PKBarcodeFormatAztec,
PKBarcodeFormatText
message: 必要字段, barcode的原文
messageEncoding: 原文的编码, 一般来讲是iso-8859-1, 但如果确定
扫描的设备可以识别, 其他的也可以, 比如中文等等.
altText: 可选字段, 会显示在barcode附近的一行文字, 一般建议是
barcode对应的信息等等, 以便在扫描无能的情况下也能使用.
pass.json
• pass核心部分
• boardingPass
• coupon
• eventTicket
• generic
• storeCard
Pass打包
• 生成全部文件的sha1写入manifest.json
• 用openssl对manifest.json签名, 生成
signature
• 将全部文件打包成zip文件, 并命名为
pkpass后缀
Pass打包
• manifest.json以及zip内最好不要含有
.DS_Store这个文件
• zip内应该直接是pass.json等, 而不是再
有一层目录.
官方信息
• https://developer.apple.com/library/prer
elease/ios/#documentation/UserExperie
nce/Conceptual/PassKit_PG/Introductio
n.html#//apple_ref/doc/uid/TP40012195
-CH1-SW1
• WWDC 2012 sample codes