iOS 向钱包添加 .pkpass，附带测试代码 - 这是 iOS 钱包开发的最新老方法，可节省大量签名工作。

最编程 2024-04-29 14:45:14

...

在手机内的 ** Wallet ** app 能够收集各种卡券，在开始创建pkpass文件之前可以先看一下:

苹果的官方文档：Wallet Developer Guide 里面介绍了怎样使用Wallet，而且还有一些模版文件
Raywenderlich: Passbook Tutorial 教程，里面一步一步的介绍了怎样生成一个pkpass 文件

** pkpass 的文件内主要包含：**

pass.json,  
manifest.json, 
signature  
还有各种png 图片

** 卡券分为五种：**

•Coupon
•Boarding pass
•Store card
•Event ticket
•Generic

1. 准备

下载 wallet 内的 Example Passes and Sample Code 里面有一个 ** SamplePasses ** 文件夹，里面有目前所需的各种文件包括 pass.json 和 icon.png, logo.png 等比如在 ** Coupon.pass ** 文件夹内就包含：

icon.png
icon@2x.png
logo.png
logo@2x.png
pass.json

点击 ** Coupon.pkpass ** 可看到一张这样的卡券

创建 ** Pass Type ID ** , 苹果文档里有介绍，一步步按照文档来，最终会创建一个类似于如图的 ** Pass Type ID ** ，

把该 ** Pass Type ID ** 下载，然后双击，它会导入到 keychain 里

2. 创建pass.json （这里以苹果的下载资源为例）

新建一个文件夹，命名为 pastest.pass (也可以随便)，把它放在你好找的地方。在Xcode 创建一个空白的empty 文件，

命名为 pass.json

记得把pass.json文件移动到创建的pastest.pass文件夹内。在刚刚创建的 pass.json 内直接把苹果的 coupon 内的pass.json 的内容拷贝替换进来

{
  "formatVersion" : 1,
  "passTypeIdentifier" : "pass.com.apple.devpubs.example",
  "serialNumber" : "E5982H-I2",
  "teamIdentifier" : "A93A5CM278",
  "webServiceURL" : "https://example.com/passes/",
  "authenticationToken" : "vxwxd7J8AlNNFPS8k0a0FfUFtq0ewzFdc",
  "barcode" : {
    "message" : "123456789",
    "format" : "PKBarcodeFormatPDF417",
    "messageEncoding" : "iso-8859-1"
  },
  "locations" : [
    {
      "longitude" : -122.3748889,
      "latitude" : 37.6189722
    },
    {
      "longitude" : -122.03118,
      "latitude" : 37.33182
    }
  ],
  "organizationName" : "Paw Planet",
  "description" : "Paw Planet Coupon",
  "logoText" : "Paw Planet",
  "foregroundColor" : "rgb(255, 255, 255)",
  "backgroundColor" : "rgb(206, 140, 53)",
  "coupon" : {
    "primaryFields" : [
      {
        "key" : "offer",
        "label" : "Any premium dog food",
        "value" : "20% off"
      }
    ],
    "auxiliaryFields" : [
      {
        "key" : "expires",
        "label" : "EXPIRES",
        "value" : "2013-04-24T10:00-05:00",
        "isRelative" : true,
        "dateStyle" : "PKDateStyleShort"
      }
    ]
  }
}

里面的内容就是一大串的 key: value 了，在例子中，目前只需要替换 passTypeIdentifier 和 teamIdentifier，比如我刚刚生成的 passTypeIdentifier 为 ** pass.come.deng.wulala ** 替换成这样

  "passTypeIdentifier" : "pass.come.deng.wulala",

就好了
** teamIdentifier ** 同理，到自己开发者账号内拷贝过来替换就好了，比如：

  "teamIdentifier" : "X5NZ3Y8346",

到此 pass.json 文件就算OK了

3. 创建 manifest.json

同样的，用Xcode 创建一个empty 文件，命名为 manifest.json ，由于例子是一个 coupon 的 pkpass 文件，所以只需要

icon.png
icon@2x.png
logo.png
logo@2x.png
pass.json

manifest.json 内的内容格式：

{
"icon.png":"ba47a8021c8d74d2146d7244c8a0566be37df43b",
"icon@2x.png":"bd5442b4b08aa4dde333ec9ef0269e7fd93140b3",
"logo.png":"780540b3a324bf66aeaee2d352283371356e9502",
"logo@2x.png":"a718ffd4e611e404dd3eb701454bcaefdabbe311",
"pass.json":"98dc0ced131d6a62311fc16a84ec29dec4fc52b6"
}

在里面 "icon.png":"ba47a8021c8d74d2146d7244c8a0566be37df43b", ** ba47a8021c8d74d2146d7244c8a0566be37df43b ** 为 icon.png 的 SHA1 生成值
生成 icon.png logo.png pass.json 的 SHA1 方式为打开命令行 cd 到你存放文件的文件夹 pastest.pass 内然后对于 icon.png 图片在当前目录的命令行内输入

openssl sha1 icon.png

把输出的值在manifest 内替换为你自己图片的值以此类推，直到把所以的图片都OK，然后pass.json 文件也一样

openssl sha1 pass.json

然后值替换，这样manifest.pass 文件也OK了. **（注意生成 pass.json 的 SHA1 后就不要更改 pass.json内的内容了，否则 pass.json 的 SHA1 需要重新生成） **

4. 签名加密

至此，两个重要的 json 文件就OK了，接下来是一大堆的签名工作了。

** 导出 Pass Type ID 证书**

首先在keychain 找到你刚刚生成的 Pass Type ID，

右键，点击 ** 导出"xxxxxxxx"，在弹出窗口输入： Certificates.p12 **

点击 ** 存储 ** 在提示输入密码的时候

直接点击 ** 好 ，不输入密码。记得把证书 ** Certificates.p12 存放在文件夹 pastest.pass 内。

** 生成 passcertificate.pem **

cd 到 pastest.pass 文件夹，然后在命令行输入：

openssl pkcs12 -inCertificates.p12 -clcerts -nokeys -outpasscertificate.pem -passin pass:

它会在文件夹 pastest.pass 内生成一个 passcertificate.pem。

** 生成 pastest.pass **

继续在文件夹 pastest.pass 命令行目录内输入：

openssl pkcs12 -inCertificates.p12 -nocerts -outpasskey.pem -passin pass: -passout pass:12345

它会在文件夹 pastest.pass 内生成一个 passkey.pem

** 导出 Apple Worldwide Developer Relations Certification Authority 证书 **

在 keychain 内找到苹果的证书 Apple Worldwide Developer Relations Certification Authority，如果找不到就到开发者账号下一个。

和生成证书 Certificates.p12 一样，** 右键 ** -> ** 导出 Apple Worldwide Developer Relations Certification Authority **
在弹出窗口中命名为：** WWDR.pem **

记得 ** 文件格式** 选为 ** 增强保密邮件(.pem)** , 点击 ** 存储 ** 把生成的 WWDR.pem 存放在文件夹 pastest.pass 内，

** 生成pkpass**

在文件夹 pastest.pass 命令行目录内输入：

openssl smime -binary -sign -certfile WWDR.pem -signer passcertificate.pem -inkey passkey.pem -inmanifest.json -outsignature -outform DER -passin pass:12345

成功以后看输入内容可知会生成一个** signature ** 文件，待会生成 pkpass 的时候会需要。继续输入：

zip -r freehugcoupon.pkpass manifest.json pass.json signature logo.pnglogo@2x.png icon.pngicon@2x.png

至此一个命名为 ** freehugcoupon.pkpass ** .pkpass文件就生成了，当然名字可以自定义

5. .pkpass 成功

在文件夹内点击刚刚生成的 ** freehugcoupon.pkpass ** 会看到结果为

哈哈大功告成

** 你可查看本文生成的. pkpass 所有文件和使用下载的苹果 passes 资源在Xcode Project 中的代码示例 **

上一篇： BTC 钱包地址申请

下一篇：区块链钱包更新下载地址