无线立通
Push 服务终端方案说明文档
[键入文档副标题]
基础平台中心
2011-4-6
[在此处键入文档的摘要。摘要通常是对文档内容的简短总结。在此处键入文档的摘要。摘
要通常是对文档内容的简短总结。]
2
3
4
Push 服务终端方案说明文档
Push 终端的功能分为 2 部分,分别由 2 个应用来承载:Push Agent(PA)和 Push Manager
(PM)。PA 来实现 Push 服务的基本功能,很少涉及 UI。PM 主要负责 Push 服务 UI 的展现,
和 Push 服务的设置功能。PA 和 PM 统称为推送基座(Push Base)。本文档规定 Push 客户端
为实现 Push 功能所涉及的文件存储的目录结果、消息格式、消息处理流程和 http 协议格式。
1 Push 终端涉及的文件
1.1 目录结构
基座涉及的文件全部组织存放在一起,并优先存放在外存储卡上,比如 SD 卡,TF 卡
等,以隐藏属性存放。目录结构如下所示,有两个应用文件的配置及数据文件的组织结构,
[]表示文件夹:
\[%SdRoot%]\[leadtone]\[push] \ setting.dat
\push.log
\smsnofication\%timestamp%.dat
\%timestamp%.dat
\[%appID%]\app.config
\push.log
\icon.dat
\ sound.dat
\setting.dat
\[pushdata]\%timestamp%.dat
\%timestamp%.dat
\[%appID%]\app.config
\push.log
\icon.dat
\sound.dat
\setting.dat
\[pushdata]\%timestamp%.dat
\%timestamp%.dat
\[apk]\weibo.apk
\qq.apk
名称
属性
父目录
读写
访问
描述
Commented [U1]: 没有 SD 卡的情况,有待处理。
5
%SdRoot%
目录
根目录
RW
外存储卡的根目录,在不同平台
上 , 名 称 不 同 , 比 如 Storage
Card、E:\等。
leadtone_push
目录
%SdRoot%
RW
所有 push 应用配置文件的根目录
setting.dat
文件
leadtone_push
RW
以键值对形式保存本地终端的一
些参数,如设备的 Token(PIN 码)
值,IMEI 值,配置文件同步时间
戳等。
push.log
文件
pushinfo
WO
保存 push 平台的 log 信息文件
smsnofication
目录
pushinfo
WO
保存还没有被处理的推送通知文
件
%timestamp%.
dat
文件
smsnotification
RW
存放还没有被处理的推送通知文
件(以 2 进制形式存放短信内
容),文件名以收到该通知的时间,
按照 YYYYMMDDHHMMSS 的形成
文件名,例如 20101207122036.dat
%appID%
目录
pushinfo
RW
以 appID 的值命名,表示 appID 应
用的配置文件和所有与其关联的
数据文件
app.config
文件
%appID%
RO
appID 应用的配置文件,格式见下
一节
push.log
文件
%appID%
WO
和 appID 应用相关的 log 信息文件
icon.dat
文件
%appID%
RO
appID 应用的图标文件。
sound.dat
文件
%appID%
RO
appID 应用的提示音文件。
setting.dat
文件
%appID%
RW
和 push 应用相关的管理设置参数
文件,比如参数开关选项等。
pushdata
目录
%appID%
RW
保存一定数目的 push 通知参数文
件
%timestamp%.
dat
文件
pushdata
RW
存放 push 通知转给 appID 应用的
参数文件,文件名以收到该通知
的时间,按照 YYYYMMDDHHMMSS
的 形 成 文 件 名 , 例 如
20101207122036.dat
apk
目录
push
RW
保存升级用的 apk 文件
weibo.apk
文件
apk
RW
升级用的 apk 文件
1.2 应用程序版本
由于应用程序安装时来源不定,有的有版本信息,有的没版本信息,再者即使有版本信
息,各个应用程序版本的表示方式也不一样,因此定义了一个版本管理机制来统一各个应用
的版本信息。每个应用程序均有一个提供商指定的版本信息判断方法,是根据应用文件的某
些特征值来判断,比如可以定义文件大小为 78652 字节的对应版本号为 1.0.0。常用的特征
值如下表所示:
Commented [U2]: 目前 Android 实现的是用时间到 70 年
的秒数为时间戳,如果有需要再改动。这么做的原因是可
以省去字符串解析的过程。数据文件的时间戳也是这么处
理的。这个时间戳只有 Agent 内部使用,所以应该影响不
大。
评论0