[转载]亿联星空.百宝箱产品合作规范

亿联星空.百宝箱产品合作规范

G（V1.0） 2005-08-25

 

1.概述

《亿联星空百宝箱产品合作规范GV1.0》根据中国移动颁布的《百宝箱业务应用程序开发规范_JAVA分册2.0.0》以及《百宝箱业务SP应用开发终端适配要求V1.0》制定并修订。目的是为简化移植流程，缩短移植、测试、上线周期。 希望各合作伙伴能够认真遵循本规范的要求，以便保证产品能够尽快上线取得收益。

2.应用开发终端适配要求（重要！）

根据移动2004年8月颁布的《百宝箱业务SP应用开发终端适配要求V1.0》、《中国移动百宝箱支持终端说明V1.0（2005-8-8更新）》及其相关规定，从2005年9月开始，所有应用（新提交产品，或已上线产品）均需符合如下要求：

2.1新增业务

1) 每款业务参加业务评估及随后的业务测试适要求适配5款以上（含5款,包括Nokia S40,不包括S60）“订制终端”，适配标准以通过测试为准。“订制终端列表”见Excel附件。亿联星空针对“订制终端“各机型做了仔细分析，总结出“亿联星空推荐适配终端列表”见表1。请合作伙伴在开发新应用时，优先考虑适配至少4款表1中推荐的终端。

 

2) 考虑到市场需求，新应用适用机型除Nokia S40/S60外，亿联星空还特别推荐适配Moto V600系列，即适用于Moto V300/V303/V500/V600。

 

3) 根据中国移动规范，附件列表将定期进行更新，请合作伙伴注意。

2.2已上线业务

1)考虑到市场需求，亿联星空特别推荐已上线业务尽快适配Moto V600系列机型，即适用于Moto V300/V303/V500/V600。

2) 根据中国移动规范，附件列表将定期进行更新，请合作伙伴注意。

2.3亿联星空推荐适配终端型号及其资料

1) 针对以上要求，亿联星空对新提交的产品要求适配表1中至少5款终端，即新业务提交时，需已经可以在下列表中至少5款机器上成功运行。见表1

表1 亿联星空推荐适配终端列表
终端类	包含手机	JAR文件 大小限制	备注
Nokia S40	Nokia 7210 etc.	59K
V600系列	V300、V303、V500、V501、V600	150K
E398系列	Moto、E398、Moto、V80、V600i	150K	与Moto V300有细微差别
V3系列	V3、E375	150K	与Moto V300有细微差别
N7610	N7610	150K
新S60系列	N6681、N3230、N6260、N6670、N6600   etc.	150K
C650系列	C650、V220、V180	150K
K700C	SonyEricsson K700、K700c	150K
A760系列	A760、A768、A760i、A768i、A728	150K

 

2) 对于已上线业务，我们强烈建议合作伙伴在3个月内优先完成表1中所列终端的品开发工作。

2.4 JAD & JAR文件命名要求（重要！）

为更好管理和测试同一应用对应的多个终端上的JAD和JAR文件，JAD和JAR文件命名需遵循如下标准，此标准将从2005年8月开始实行：

 

每款游戏放置在一个单独文件夹，然后再按终端类对各适配机型命名文件夹，每个文件夹中放两个文件，即Jar和Jad文件。（具体放置方法和终端类见《百宝箱支持终端说明.doc》，请留意该文件中图片中说明的排列顺序！）

 

Jar和Jad文件命名问题：

 

游戏名称_适用机型.jar

游戏名称_适用机型.jad

 

例如：  Fight1944_S40.jar

Fight1944_S40.jad

 “游戏名称”可以为拼音、拼音缩写、英文单词、英文缩写，但请注意所起名称简单，意义清晰明了。

要求：如果一个JAR&JAD文件适用多个型号的终端，请在JAR&JAD文件名中列出所有适用机型，中间用“_”分隔。

为方便识别，此处对机型缩写做统一规定，请产品技术人员打JAR包时对适用机型使用统一缩写：

终端型号	缩写	JAR&JAD 命名举例
Nokia
Nokia40系列	S40	Fight1944_S40.jar
Nokia60系列	S60	Fight1944_S60.jar
如果此应用只适用于7650或3650，请在命名时分开书写 ___ Fight1944_N3650.jar
Motorola
A760	A760	Fight1944_A760.jar
V600系列：	V300/V303/V500/V600	Fight1944_V600.jar
NEC
N800	N800	Fight1944_N800.jar
N810	N810	Fight1944_N810.jar
N820	N820	Fight1944_N820.jar
Samsung
E系列：E108/E708	E108/E708	Fight1944_E108_E708.jar
D系列：D108/D418	D108/D418	Fight1944_D418.jar
S系列：S208	S208	Fight1944_S208.jar
X系列：X608/X108	X108 /X608	Fight1944_X108_X608.jar
SonyEricsson
T618	T618	Fight1944_T618.jar
T628	T628	Fight1944_T628.jar
K700	K700	Fight1944_K700.jar

3.规范细则

3.1 JAD文件

手机型号	可否支持中文应用名（MidletName）	说明
Nokia 7650	不可以（不能安装）	新版本7650已经解决了中文应用名的问题，但为了兼容老版本的7650，要求SP使用英文应用名
Nokia 3650	不可以（不能安装）	新版本3650已经解决了中文应用名的问题，但为了兼容老版本的3650，要求SP使用英文应用名
Motorola V60i	不可以（不能安装）
Siemens 3118/2128/S57/M55	不可以（显示为乱码）
Samsung E108/X108//S208/X608/E708	不可以（不能安装）
科健K358/K368/K618	不可以（不能安装）

3.1.2.不支持中文JAD的手机列表及JAD包含项目说明：

名称	格 式	限 制
MIDlet-Name	全英文表示,如：MIDlet-Name: Fight1944	24字符内
MIDlet-Version	如：MIDlet-Version: 1.0	5位字符内
MIDlet-Vendor	统一表述为: Eline Tech 如:MIDlet-Vendor: Eline Tech
MIDlet-Jar-URL	如：MIDlet-Jar-URL: xxxx.jar	128字符内，遵循RFC2396
MIDlet-Jar-Size	如：MIDlet-Jar-Size: xxxxx	不多于6位字符。同实际JAR文件一致，最大限制依赖于手机实现
MicroEdition-Configuration	统一表述为：CLDC-1.0
MicroEdition-Profile	统一表述为：MIDP-1.0
注：JAD文件中不能出现任何中文或全角字符,“-”为半角符号减号 3

3.1.3. Nokia S40等JAD支持中文手机

名称	格 式	限 制
MIDlet-Name	如：MIDlet—Name: 决战1944	12个汉字内
MIDlet-Version	如：MIDlet-Version: 1.0	5位字符内
MIDlet-Vendor	统一表述为“亿联星空” 如：MIDlet-Vendor: 亿联星空
MIDlet-Jar-URL	如：MIDlet-Jar-URL: xxxx.jar	128字符内，遵循RFC2396
MIDlet-Jar-Size	如：MIDlet-Jar-Size: xxxxx	不多于6位字符。同实际JAR文件一致，最大限制依赖于手机实现
MicroEdition-Configuration	统一表述为：CLDC-1.0
MicroEdition-Profile	统一表述为：MIDP-1.0
注：“-”为半角符号减号 3

3.1.4. NEC系列手机（不推荐）：

名称	格 式	限 制
MIDlet-1	如：MIDlet-1: 进入游戏, , Fight1944Midlet	第一个参数不超过11个字符
MIDlet-Name	如：MIDlet-Name: 决战1944	不超过11个字符
MIDlet-Description	表述为：xxx 如：MIDlet-Description: 决战1944, NEC NXXX	不多于512字节，使用UTF-8编码
MIDlet-Version	如：MIDlet-Version: 1.0	5位字符内 4
MIDlet-Vendor	统一表述为“亿联星空” 如：MIDlet-Vendor: 亿联星空
MIDlet-Jar-URL	如：MIDlet-Jar-URL: xxxx.jar	128字符内，遵循RFC2396
MIDlet-Jar-Size	如：MIDlet-Jar-Size: 93426	不多于6位字符。同实际JAR文件一致，最大限制依赖于手机实现
MIDlet-Data-Size	MIDlet Suite运行时占用的RMS大小。 此项中的数值需要与JAR中，MANIFEST.MF中相同。不能设置为“0”，建议设置为2000。 如：MIDlet-Data-Size: xxxxx（不能为零）	不多于6位字节，使用UTF-8编码，数值为0至20480，但不得为“0”。
Media-price	应用价格。 如：Media-price: 5	不多于32字节，使用UTF-8编码
MicroEdition-Configuration	统一表述为：CLDC-1.0 如： MicroEdition-Configuration: CLDC-1.0	8位字节，使用UTF-8编码
MicroEdition-Profile	统一表述为：MIDP-1.0 如：MicroEdition-Profile: MIDP-1.0	8位字节，使用UTF-8编码
MIDlet-UseNetwork	MIDlet Suite是否需要使用联网功能。 表述为：MIDlet-UseNetwork: YES/NO 如：MIDlet-UseNetwork: YES	4位字节，使用UTF-8编码，且区分大小写
注：“-”为半角符号减号

3.1.5.其他要求

JAD文件大小在4K以内，采用UTF-8N编码方式（没有字节序检测码BOM的UTF-8）。

3.2 JAR文件

3.2.1. 文件打包时注意事项（为了解决移动平台的API问题和兼容性问题）

1） 如果使用JBuilder进行开发并打包，请打包时在菜单上选择 Project->Project Properties，选择Build下的Java，Target VM项设为All Java SDKs 。

2） 如果不使用JBuilder打包，对打包工具的要求： 请使用JDK1.3.1版本（国际版）； 打包工具使用SUN公司提供的J2ME Wireless Toolkit (midp1.0版本，1.0.3或1.0.4)；由于SUN公司的WTK只支持标准的midp1.0，不支持各手机扩展的API，需要SP对所使用的WTK进行扩充才可以支持手机扩展的API，方法是：将扩展API加到D:/WTK104/lib/midpapi.zip（假设WTK安装在D:/WTK104目录下）中即可。

3） 不做扰码或使用RetroGuard进行扰码，不要使用别的扰码工具。

3.2.2. 对占用内存的要求（重要）

JAVA应用程序运行占用内存的上限为终端可提供最大运行内存减去10K （由于应用程序在中国移动平台被下载时会根据需要插入程序代码，这段代码在手机上执行时要占用10K左右的堆内存，因此要求提交的应用程序在运行时要预留至少10K的堆内存）。

3.2.3. 对JAR文件字节数的要求：

部分支持JAVA终端应用程序最大容量列表：

终端厂商	手机型号	限制JAR文件的最大容量
Nokia	S40	59K
	7650/3650	95K
	7610	95K
	6600	95K
Motorola	T720	95K
	388/388c	95K
	E680	95K
	A760/A768	95K
	V300	95K
	V878	95K
	V872	95K
	C650	95K
Siemens	3118/2128/S57/M55	95K
NEC	N800	55K
	NEC N810/N820/N830	95K
SonyEriccson	T168/T628	95K
	K700	95K
Samsung	E108/E708	95K
	D108/D418	95K
	S208	95K
	X108/X458/X608	95K

 

3.2.4. 其他要求

1) JAR文件Manifest部分属性与JAD文件相同，相同属性描述应当一致。NEC系列手机的Manifest部分属性不得填写为“0”。

 

2) JAVA应用必须提交相应ICON（现包括：Nokia S40 为16x16；Nokia S60 为32x32；Moto A760 为40x40；Lenove 为 G900/901 16x16; Moto V300系列为 15x15）

3.3. 程序启动界面

1) 对Nokia S40、NEC N800终端的要求： Nokia S40、NEC N800 手机由于容量原因，第一屏请使用移动梦网logo，第二屏请使用百宝箱、SP两个图标在一起的Logo图片，显示时间为3秒

第三屏可以是CP的公司Logo，显示时间为2秒（可选） 之后自动进入应用首页

 

2) 对其他终端的要求：

第一屏必须显示移动梦网Logo，显示时间为1秒

第二屏必须是亿联星空的Logo，显示是时间为2秒

第三屏可以是CP的公司Logo，显示时间为2秒（可选）

之后直接进入应用首页

3.4. 主菜单、应用中菜单、应用界面及操作要求

3.4.1. 对各菜单操作界面、应用中画面的总体要求