/apnsagent

A simple apns agent server and client lib in python

Primary LanguagePython

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/<who> <who>为应用的app_key,可以查看该应用的无效token