apnsagent

apnsagent copied to clipboard

project: apnsagent license: BSD auth : jeffkit

apnsagent为多个iOS 应用提供集中式的推送服务，她有以下特点：

• 接入简单，可以同时服务于多个App
• 无缝支持开发和生产模式的推送
• 重用TCP连接，同时使用队列的异步发送，API调用效率高
• 自动忽略失效的Token

apnsagent的程序包括：

• 服务程序，它部署在你的Server上，仅运行一个实例，同时服务于多个应用
• WebServer监控服务器，用一个http后台查看系统运行状态
• 客户端API，应用的后端程序用来请求服务程序发送推送消息

服务程序配置及运行：

• 安装并运行redis，使用常规安装可快速开始。

• 首先，你需要有一个目录用于保存推送的证书和密钥(如何获取app的推送证书与密钥请参考apple的文档)，目录结构如下：

  • apps
    • com.toraysoft.yiqi # 某个应用文件夹，以id命名
      • production # 生产环境证书
        • cer.pem # 证书
        • key.pem # 密钥，要求去掉passparse的
      • develop # 开发环境证书，下同
        • cer.pem
        • key.pem

• 安装apnsagent: cd $apnsagent-home python setup.py install (或使用pip安装)

• 运行服务 apnsagent-server.py config [options]

  • config 服务器配置文件，下面是一个Sample，看一下就明白 [app] app_dir = /Users/jeff/local/apps/

  [redis] host = 127.0.0.1 port = 6379 db = 0 password = '' 使用apnsagent-server.py -h 获得更多帮助。

客户端API使用示例： from apnsagent.client import PushClient client = PushClient(app_key) # 初始化一个推送客户端。 client.register_token(token,develop=True) # 可选，注册一个Token，不注册默认发到生产队列当中。 client.push(token,alert,badge,sound,custom) # 发送一条推送消息。

工程依赖

• PyAPNs 使用此版本:https://github.com/jeffkit/apnsagent
• redis-py
• simplejson
• flask (for 嵌入式监控web)

监控服务： 系统运行后，可以打开本地的5555端口，查看系统的运行状态：

• /login 登录界面，输入用户名和密码登录，用户名和密码在constants.py中配置，默认为用户名apns，密码12345
• /list 查看各个应用的运行情况
• /detail/ 为应用的app_key，可以查看该应用的无效token