20110510 Brew工程师培训笔记——第二十三章 BREW 应用开发规范

第二十三章 BREW 应用开发规范 

一、主要内容

（1）、BREW业务开发的指导原则 

（2）、BREW应用UI设计要求 

（3）、BREW在线应用的开发要求 

（4）、BREW预装应用的开发要求 

二、BREW业务开发的指导原则

（1）、BREW业务开发的指导原则

（a）、业务可用性

（b）、BREW应用的命名原则

（c）、业务可移植性

（d）、对BREW程序的运行要求

（e）、BREW应用软件的版权要求

（f）、应用的安全性要求 

（2）、业务可用性

开发商在开发BREW应用业务时应遵循如下可用性原则：

（a）、业务可用性强并且操作简单。

（b）、业务使用具有灵活性和高效率。

（c）、便于用户选择和设置个性化的服务。

（d）、应用界面的显见性和审美的考虑。

（e）、提供通俗易懂的使用帮助。

（f）、提供关于页面包含开发名称及联系方式。

（3）、BREW应用的命名原则

联通对BREW应用的命名有如下原则：

（a）、应用中文名称不得只使用应用的中文类别或专有中文名词来命名。

（b）、应用程序英文名称不得只使用英文类别或专有英文单词来命名。

（c）、新应用中英文名称不允许和联通商用系统中已有的应用名称相同。

（d）、应用程序下载到终端上后，建议采用中文名称显示（英文专有名词除外）。

（e）、联通商用系统中的应用程序中文名称与下载到手机上的应用程序名称一致。

（f）、同一Part Number的各版本，应用名称应保持一致。若需要改名，建议采用新的Part Number。

（4）、业务可移植性

（a）、可移植性是指该BREW业务可以很容易地从一款手机移植到另一款手机上。开发商在UI设计与程序设计过程中应考虑到可移植性问题。充分利用BREW平台所提供的功能。

（b）、BREW平台能够提供屏幕的尺寸的大小，如有可能，应尽量使UI能够自适应屏幕尺寸的大小。

（c）、对于不能自适应屏幕尺寸的情况，要求全部UI应包含在手机屏幕尺寸范围内。应用的UI须在手机屏幕的长和宽方向上居中对齐。

（d）、由于不同手机的内存和堆栈大小很不一样，开发商的应用应尽量节省内存和堆栈的使用。

（5）、对BREW程序的运行要求

开发商所开发的BREW程序在终端上运行时，必须保证与终端运行环境的良好兼容性，并且保证不影响终端及终端上其它业务的正常运行

（6）、BREW应用软件的版权要求

（a）、开发商提交的BREW应用软件，应具有合法的版权。

（b）、若开发商在开发BREW应用程序中使用了其它公司以商标权或版权注册的内容，必须与该公司签订使用许可协议，在开发BREW的应用程序中根据相关的许可协议妥善使用。

（c）、开发商所开发的BREW应用程序在使用过程中，由于与第三方的版权和商标权所引起的纠纷，由开发商自行处理。

（d）、使用属于中国联通的商标、品牌，需取得中国联通书面授权的允许。

（7）、应用的安全性要求

开发商应确保BREW应用的安全性，确保提交的BREW应用没有病毒、黑客程序等不安全因素 

三、BREW应用UI设计要求 

（1）、BREW应用UI设计要求 

开发商在进行BREW应用UI设计时应遵循如下方面的设计要求。

（a）、应用程序的主菜单页面

（b）、屏幕布局

（c）、运行过程的等待处理

（d）、屏幕刷新

（e）、图标

（f）、文本输入 

（2）、应用程序的主菜单页面

（a）、应用程序的主菜单页面是指应用程序某一包含主要管理功能的页面

1、建议通常在闪屏之后出现应用程序的主菜单页面，但不作强制要求。

2、程序启动后若不自动进入主菜单页面，应给予用户明显的操作提示以进入主菜单页面。

3、主菜单页面可按照不同方式进行设计。

（b）、主菜单应包括如下项目：

1、开始：（一个或多个）使用开始或其他名字用于启动和执行程序主体功能。

2、帮助：提供应用介绍、操作指南。应用也可采用其他操作提示方式（如提示页面）为用户提供帮助。 

3、关于：应给出公司名称、应用程序的版本号、公司客服电话

（3）、屏幕布局

（a）、由于BREW应用程序会应用于多款手机，具有不同屏幕尺寸和比例，应用程序应对适用的每款终端的屏幕和有关参数进行适配。如果根据屏幕尺寸和比例，对用户界面作了重大修改，要确信应用程序保持原有的可用性，这样用户在更换手机时继续使用应用程序不会遇到困难。

（b）、应用程序可选择如下两种方式适配：

1、应用程序自适应屏幕尺寸来调整UI满屏显示。

2、对于不能自适应屏幕尺寸的情况，如与手机的屏幕实际尺寸不符，要求全部UI应包含在手机屏幕尺寸范围内。应用的UI须在手机屏幕的长和宽方向上大致居中对齐。

（4）、运行过程的等待处理

（a）、很多情况下，应用程序无法做出瞬间反应。如果用户必须等待应用程序完成一个进程，应向用户提供一个可视的反馈，并应提示用户如何取消进程。一般来说二秒钟内等待不需要提供专门反馈。

（b）、当用户在等待长时间的进程（2秒以上）时，应使用动画进程(如，进度条)来显示运行的进度状态，建议给出提示信息（如，需等待的时间）。

（c）、对网络连接等待状态，至少应提供一种方式退出连接等待状态。如使用清除键、特定功能键或结束键。

（d）、对非网络连接等待状态，至少保证30秒后可使用清除键、特定功能键或结束键退出等待状态。

（5）、屏幕刷新

（a）、每个屏幕（例如splash、帮助、弹出对话框、文本输入）可以正确的刷新且内容正确。

（b）、将覆盖在另一屏幕上的某一屏幕取消后可以正确的刷新。

（c）、在过渡期间屏幕不会是空屏。

（6）、图标

（a）、MIF 应用程序图标（必选）：

1、Thumbnail:为16x16像素

2、Icon: 26x26像素。支持部分或全部透明

3、Image: 65x42像素。如果数据设备支持，允许满屏显示或者按标准显示尺寸进行显示（>65x42）

（b）、程序菜单图标（可选）：

1、标准菜单前的图标为12x12像素。可支持部分或全部透明。

2、图标显示菜单的图标为26 x 26像素。支持部分或全部透明。

3、在同一菜单中使用的图标风格应基本保持一致，这样不会造成一个图标明显突出（除非有意制造这种效果）

（c）、图标格式 （可选）：

1、PNG   (透明化处理背景颜色RGB值=0,0,0)

2、BMP  (透明化处理背景颜色RGB值=255,0,255)

3、其他的图像格式，如JPEG，BCI，由终端功能决定

（7）、文本输入（必选）

（a）、用户使用文本框输入注册（Register）密码，如果输入字符以密码*显示，则程序应提示用户再次输入确认。

（b）、如果应用程序支持密码保存并显示，用户在下一次使用时，应以*显示密码。

（c）、文本输入框的输入内容有最大限制。文本输入框的最大限制符合自然法则

（d）、在文本输入(AEECLSID_TEXTCTL)的状态下，须提供用户返回当前某一屏幕的方法。可有两种不同办法：

1、在文本输入中但无字符输入的状态下，允许“CLR”键起到“后退”或者“返回”当前某一屏幕的功能

2、使用特定功能键或软键菜单。在文本输入的软键菜单中加入一个菜单项，其功能类似于菜单中的“后退”或者“取消”功能。例如下图所示，这种方法可避免在用户重复按“CLR”键时，错误回到上一屏幕。

（8）、文本输入（可选）

（a）、若需要特定输入格式，都必须表明输入格式。 若输入超过一行，文本框应支持多行输入

（b）、尽量减少用户的文本输入

（c）、为每一个输入项作直观的提示与描述，不多于8个汉字

（d）、支持输入数据的自动记忆功能，如用户名和密码的保存。

1、对需要用户名和密码登陆的应用，要充分考虑如何让新用户非常方便、简单地完成注册

2、对用户注册后再次使用时，对于不涉及移动支付等安全性要求非常高的应用，建议用户名和密码默认填好，用户选“登录”键即可。

（e）、对用户输入应自动切换到恰当的输入模式。

（f）、对确定的内容进行预置。

（g）、对用户输入的内容进行检测，确保输入的内容正确。

（h）、在文本输入中但无字符输入的状态下，若使用“CLR”键后退或者返回前一屏幕，应避免重复按键。

四、BREW在线应用的开发要求 

（1）、BREW在线应用的开发要求

（a）、UNI-WISE平台接入方式 

（b）、域名及IP地址分配 

（c）、私网域名分配规则 

（d）、在线应用的网络编程要求 

（2）、UNI-WISE平台接入方式

（a）、CP/SP的BREW在线应用服务器需要接入联通的UNI-WISE综合数据业务平台，有三种接入方式：

1、专线接入 ：CP/SP将服务器置于自身的局域网，采用公网IP地址，申请DDN专线接入到UNI-WISE平台 

2、联通IDC托管：CP/SP将服务器交联通公司IDC机房托管，采用私网IP地址，并租借IDC的MPLS VPN 

3、其他特殊接入方式：是指CP/SP将服务器放到外部IDC机房托管，并提供公网IP地址。联通为CP/SP服务器分配私网域名与域名解析服务，通过统一的地址映射网关完成内网IP到公网IP地址的映射 

（b）、CP/SP申请应用服务器的UNI-WISE平台接入时，应填写联通无限SP业务测试申请表并向联通增值业务部提交申请

（3）、域名及IP地址分配

（a）、联通UNI-WISE平台为不同接入方式的CP/SP统一分配私网域名。

（b）、终端用户通过CDMA 1X网络访问CP/SP提供的在线业务时，UNI-WISE平台提供域名解析功能。

（c）、通过域名解析出在线服务器的IP地址，建立终端用户和CP/SP的BREW在线服务器的连接 

（4）、私网域名分配规则

（a）、SP域名的格式统一为：主机名.二级域名.uniwise

（b）、所有SP的域名都归属在uniwise的一级域名之下。

（c）、SP可以自行确定二级域名和主机名

（d）、联通保留以下二级域名，SP不能选取：WAP  WAP20  WAP12  BREW  JAVA  IMAP  LBS  CDMA  GSM SMS 

（5）、在线应用的网络编程要求

由于在线服务器可能存在位置变动及IP地址变更，故要求各CP/SP的在线应用在客户端编程时使用私网域名访问在线服务器，以便BREW应用服务器的位置或IP地址变更后，用户无需修改程序能继续访问在线服务器 

五、BREW预装应用的开发要求 

（1）、预装应用的开发要求

（a）、预装应用的定义 

（b）、动态预装应用的定价 

（c）、预装应用包参数配置 

（d）、动态预装应用的UBT测试以及运营商计费测试 

（e）、多卡方式预安装包的行为 

（f）、预安装应用上线 

（2）、预装应用的定义

（a）、Brew 应用的手机预装从技术上可分为两类：

1、动态预装

2、静态预装

（b）、BREW应用的手机预装从商务上也可分为两类：

1、手机厂家预安装

2、销售渠道预安装

（c）、中国联通只允许SP和终端厂商采用动态预安装。

（d）、采用动态预装解决方案， 应用被用户激活后可通过BREW的BDS系统产生用户计费信息。动态预装可以进行空中升级及使用权（License）的购买。

（3）、动态预装应用的定价

（a）、目前动态预装可支持如下几种计费模式，计费价格为0：

1、按固定使用天数

2、按固定使用日期

3、按实际使用时间

4、按固定使用次数（需程序支持）

（b）、当应用使用到期后，BREW的AEE将提示用户是否续购新的使用权，用户许可后将启动MobileShop连接到下载服务器中该应用的正常下载计费页面。开发商可在此为用户提供各种计费模式与计费价格。

（c）、除进行预安装外，预安装应用均要求放置在下载目录中可供正常下载

（4）、预装应用包参数配置

（a）、联通在为开发商生成预安装包时，将固定选择如下的参数配置：

1、应用确认选择开机确认方式（Pending）：应用在手机开机后或第一次进入BREW应用管理器后应用将被自动激活。同时产生应用确认并上传计费信息到BDS系统。

2、RUIM卡方式选择为支持多卡方式（Any SID）。即可使用不同的RUIM卡运行该预安装应用。

3、应用保护模式选择为非保护方式（Unprotected）。即允许用户可从手机上删除该应用

（5）、动态预装应用的UBT测试以及运营商计费测试

（a）、为确保程序的安全和质量，所有动态预装应用都必须经过严格的UBT测试。

（b）、当预安装包生成后，联通还需进行预安装计费测试。这之后才正式发行预安装包 

（6）、多卡方式预安装包的行为

（a）、有预装程序的手机在第一次插卡开机后或第一次进入BREW的AppMgr，应用程序将被激活。同时产生应用确认并上传0计费信息到BDS系统。如果注册失败，程序将在每次用户使用BREW时不断尝试注册，直到注册成功。在注册时用户看不到注册的价格的提示。

（b）、在程序被使用，消费直到失效后，用户再次启动应用时，应用将向用户提示“应用已过期，是否购买” ，如果 用户选择“是” ， 手机将自动引导用户进入BREW应用下载服务器，并自动显示对应的程序购买页面，用户在选择购买后将可继续使用程序。相关续买费用将和当时机内的RUIM卡关联。

（c）、如果用户使用A卡在A机续购时选择包月，A机上应用包月费将同A卡相关联。当用户在A机上使用B卡后，A机上应用的包月续费仍同原来的A卡相关联。A机用户仍可取消包月。

（d）、如果用户再在B机上使用A卡续购时选择包月，B机上应用包月费仍将同A卡相关联。这样A卡在A机和B机上都会被收取包月费。A机和B机用户仍可取消包月。

（7）、预安装应用上线

（a）、联通要求预安装包应支持多卡方式。但预安装应用对应于下载目录中的应用包要求仅支持单卡方式。所以对于预安装应用包的上载方式如下：

1、将预装应用包以多卡方式进行上载，版本定义为 Vx.y.z_anysid。其中Vx.y.z为预装应用原版本。该包将被用来生成预安装应用发布包。

2、基于版本Vx.y.z_anysid，将预装应用包以单卡方式进行升级上载，版本定义为 Vx.y.z_anysid_singlesid。该包将被放入下载目录供空中下载使用。

（b）、当应用上载完成后，联通将根据与开发商确定的报价计划生成多卡方式的预安装应用发布包，同时将单卡方式的应用包加入下载目录中。

六、本章关键点

（1）、本章对联通BREW应用开发规范进行了具体介绍。BREW应用开发应遵循联通的应用可用性原则，命名原则，可移植性原则，兼容性原则，安全性原则。应用软件及内容的版权应合法。

（2）、应用的开发应注意主页面的帮助，关于项。屏幕布局需符合要求。注意对运行过程的等待处理及屏幕刷新等。应用程序图标有标准要求，文本输入也有标准要求。

（3）、BREW在线应用有三种接入方式。要求使用私网域名。

（4）、联通对BREW预装程序有标准的上线管理办法及流程 

七、问题回顾

（1）、联通要求开发商开发应用应遵循哪些可用性原则？

（2）、如何开发程序以加强应用的可移植性？

（3）、应用的主菜单页面应包括哪些主要项目？

（4）、当程序运行时有长时间等待，应如何处理？

（5）、如何正确处理屏幕刷新？

（6）、MIF文件中三种图标尺寸如何？透明色如何处理？

（7）、文本框控件中，CLR键如何正确处理？

（8）、在线服务器接入都有哪几种方式？

（9）、私网域名的定义格式是怎么样的？

（10）、预安装支持哪几种计费方式？

（11）、为什么预装时要采用单卡和多卡两种方式呢？