本文重点关注的是APNS推送后台的搭建,不涉及推送证书Certificate 、Profiles 文件,iOS客户端推送代码的介绍。
需求背景
iOS开发,在接收到APNS推送消息后打开App,然后跳转到App内任意模块、或者打开webView页面、或者执行升级操作、或者跳转打开第三方应用;对于这样的需求,开发测试的时候需要频繁发送APNS推送,如果每次都让后台服务器的兄弟来配合测试,那肯定是心好累,最好的方案就是自己搭建服务,想怎么推就怎么推!!
写在开头
网上关于APNS推送的文章有很多,但对于推送后台介绍的文章却不多(有很多都是介绍java后台的,本人曾经参照教程用java实现过,那是在Android Studio上运行的,为了推送消息这个小小的功能,却要安装Android Studio那么大一个IDE,同时还要新建工程来运行项目,想想都头大😓)
在探寻的过程中发现了Node.js + apn是一个不错方案,只是网上关于这方面的介绍不多,有的也是同一篇文章在相互转载。
文章最后对于后台的介绍只一句带过最后,安装apn,把key.pem和cert.pem拷贝到项目目录。执行以下代码可以推送通知到指定设备
,这对于我这个js门外汉来说完全就是懵逼。。。
无奈只能实践出真理,并将摸索过程中的一些经验做了总结。
干货
最新更新
拿到p12文件后可以跳过第一步(1. 生成 pem文件)
,直接进入第二步使用
1. 生成 pem文件
请先确保已安装对应的Apple Push Services证书,如果没有请网上搜索Apple Push Notification service SSL关键字
打开钥匙串访问
- 找到对应的推送证书,分别导出apns-dev-cert.p12
以及apns-dev-key.p12
文件,这里我导出的是development环境下的p12,这个可以在Xcode连真机build的时候收到推送。
导出的时候会提示设置密码,这里我设置的是:123456,后面生成pem和js文件中会用到。
然后通过终端命令将两个文件转换为PEM格式:
openssl pkcs12 -clcerts -nokeys -out apns-dev-cert.pem -in apns-dev-cert.p12
openssl pkcs12 -nocerts -out apns-dev-key.pem -in apns-dev-key.p12
上述转PEM文件语句可能转换不成功(终端中其实是不会提示你的,你可以对比下转换前后的p12 与pem文件,如果两者的文件大小相差太多,那就可能是失败了。当然如果转换失败,那最终在执行推送的时候肯定是不会成功的,那时也能发现到错误)
如果转换失败,可以试下以下转换语句
openssl pkcs12 -in apns-dev-key.p12 -out apns-dev-key.pem -nodes
2. 编辑js文件(APNS.js)
"use strict";
const apn = require("apn");
// token 数组
let tokens = ["45c0bc9952a930e96cd50df871dfc0f6a8382bb0ded0821c1111495507f8f5c3", "4a633149803b1721590802eac88003ed024be210a3053ad51fa7a657d3b2a531"];
let service = new apn.Provider({
//cert: "/你电脑上的绝对路径/apns-dev-cert.pem",////使用第一步生成的.pem
//key: "/你电脑上的绝对路径/apns-dev-key.pem",
pfx: "/你电脑上的绝对路径/apns-dev.p12", // 直接使用.p12证书
gateway: "gateway.sandbox.push.apple.com",
// gateway: "gateway.push.apple.com"; //线上地址
// port: 443, //端口
passphrase: "123456" //pem证书密码
});
let note = new apn.Notification({
alert: "Breaking News: I just sent my first Push Notification",
});
// 主题 一般取应用标识符(bundle identifier)
note.topic = "com.xxx.xxx"
console.log(`Sending: ${note.compile()} to ${tokens}`);
service.send(note, tokens).then( result => {
console.log("sent:", result.sent.length);
console.log("failed:", result.failed.length);
console.log(result.failed);
});
service.shutdown();
3. 配置
安装Node.js地址 https://nodejs.org
安装apn,终端执行:
$ sudo npm install apn
如果安装报错:
npm WARN saveError ENOENT: no such file or directory, open '/Users/CK/Desktop/qtapns/package.json'
可以输入npm init -f
命令后再安装。
解释说明:
npm init -f 命令行的作用:一个模块不管是否安装过, npm 都要强制重新安装,可以使用 -f 或 --force 参数。
配置node_modules环境变量 ,终端执行:
// 进入当前用户目录,创建.bash_profile文件(如果没有会新建)
$ touch ~/.bash_profile
打开.bash_profile文件,添加以下内容并保存
export NODE_PATH=/usr/local/lib/node_modules/
完成后在终端运行:
$ node APNS.js
不出意外,等待若干秒后可以收到推送消息,如果有问题可以根据终端提示修改。
更多关于apn的介绍看这里:https://github.com/node-apn/node-apn
APNS.js下载