中国电信通用Widget开放系统技术规范 总册 6.3
Widget应用配置文件要求
YD/T2187.1—2009
配置文件要求遵循w3c Widget 1.0标准。标准规定使用config.xml作为有效的Widget配置文件名称，该文件可以被放置在Widget安装目录中。
如下是一个典型的Widget配置文件的内容举例：
identifier=\ version=\ height=\ width=\
A sample widget to demonstrate some of the possibilities. email=\ 6.3.1 配置文件框架 6.3.1.1 格式与Schema 1) 要求使用通用数据交换格式的配置文件语言。 2) 要求为为这种语言规定正式的schema，定义配置缺省项。 3) 推荐配置文件采用UTF-8编码。可以规定配置文件语言采用替换标准的数据交换格 式（如JSON）和Schema。 6.3.1.2 Widget元数据 要求配置文件包括Widget应用相关元数据的XML元素的结构和语义，具体包括名称、版本号、唯一识别码、以及Widget应用用途的描述。 6.3.1.3 著作权元数据 要求包括Widget应用著作权相关的结构和语义数据，包括作者名、e-mail、组织。 14 中国电信通用Widget开放系统技术规范 总册 6.3.1.4 版权声明和许可元数据 YD/T2187.1—2009 要求包括规定结构和语义，明确涉及或包括软件许可或声明。提供一种方法声明Widget的版权所有者，同时提供模型指示Widget引擎如何处理数据。 6.3.1.5 视觉表现尺寸 要求包括Widget应用的初始视觉尺寸，并且是设备无关的。例如通过CSS像素。 6.3.1.6 声明的自启动机制 要求包括自启动机制，运行时定位开始文件，不能定位到Widget应用包之外的范围，但可以定位到internet上可支持的媒体资源。 6.3.1.7 缺省的自启动机制 要求可以在缺少声明的自启动机制的情况下应定义一种自动模式来寻找Widget配置文件。 6.3.1.8 图标展现 要求包括Widget图标展现的定义方式，用以替换或反馈其内容。不应限制图标展示必须为静态图片。在需要的时候可以提供文字展示。 6.3.1.9 缩略图 要求定义Widget运行状态下的一个或多个图像，即Widget在Widget管理器展现时的缩略图，正确使用这些缩略图以显示Widget的实际运行状态。 6.3.1.10 配置参数 要求声明通常值和配置参数的预定义，用作Widget初始化。对特定的参数应定义缺省值，以适应参数丢失或作者提供的值无效的情况。在必要的情况下Widget引擎可以无视作者定的参数。 6.3.1.11 定义启动值 要求定义初始值，在Widget首次运行时生效。比如天气Widget可以预先写入初始城市。允许定义哪些值是只读的，这些值在运行时不可更改。 6.3.1.12 功能接入声明 要求规定或推荐一种方式，可以定义Widget接入特定设备或功能的正式标准，如接入设备上摄像头的API。可以有首选和备选、可选的和强制的。 6.3.1.13 配置文件独立性 要求规定配置文件格式，能够独立于包含它的Widget。可提供如何独立于Widget包使用配置文件的指导。 6.3.1.14 优先展现模式 要求确定Widget的最优表现模式，对所有Widget引擎提供一致的缺省表现模式。 6.3.1.15 资源访问能力声明 要求提供一种方式来声明Widget的资源访问能力，以控制Widget对于通过HTTP/HTTPS 15 中国电信通用Widget开放系统技术规范 总册 YD/T2187.1—2009 访问网络资源、访问终端文件系统，或加载外部脚本等相关资源访问能力的权限请求。 6.3.1.16 更新信息源声明 要求提供一种方式来定义允许从哪些在线资源点上获取Widget的相关更新信息。同时，建议对发起更新信息轮询的时间间隔进行相关声明。 6.3.1.17 广告声明 要求提供一种方式来定义在Widget中相关广告内容的呈现方式，例如以静态或是动态广告区方式呈现、产品标识的程序方式等。 6.3.1.18 计费声明 要求提供一种方式来声明Widget是否需要通过相关计费认证才允许在本地使用。 6.3.2 数字签名要求 支持W3C Widgets Digital Signature。 6.3.3 安全要求 1) 支持W3C的文件加密方式。 2) 支持OMA DRM要求的文件包加密方式。 6.4 Widget应用API要求 Widget应用按照能力划分为以下类别： 1) Widget管理 2) 本地应用管理 3) 网络通信 4) 数据管理 5) 用户交互设置 6) 设备状态 7) Widget应用设置 8) 策略管理 9) PIM个人信息管理 10) 短信，彩信 11) 呼叫 12) 媒体库 13) 媒体录制 14) 电信业务能力 16 中国电信通用Widget开放系统技术规范 总册 6.5 引擎能力要求 YD/T2187.1—2009 6.5.1 应用逻辑能力 1) Widget引擎的应用逻辑要求主要由脚本语言来完成。符合Widget引擎的应用脚本引 擎应该符合以下几个原则： a) 可以对Widget的参数及属性进行操作。 b) 可以获得Widget专有的事件。 c) 可以安全的访问移动设备上的其他服务、资源和应用程序。 2) Widget引擎要求对Widget应用相关的属性、方法和事件进行封装，形成数据对象或 者相应的数据结构。同时必须能够通过现有标准的脚本语言对其进行调用（如ECMAScript）。 3) Widget引擎要求让Widget在运行时调用手机系统的信息，如当前语言、时间、网络 状态、电池电量等等。 4) Widget引擎要求让Widget设定默认的启动参数。可以让Widget保存运行时产生的配 置信息。可以记录Widget前次启动的位置。 6.5.2 应用程序调用能力 要求可以调用终端以下应用程序： 1) 媒体播放程序 2) 浏览器 3) 缺省邮箱 6.5.3 本地资源能力 为支持Widget引擎运行，引擎可以调用终端以下本地资源能力。 分类 地址簿 子分类 联系人或电话簿 功能要求描述 可以增删改查outlook联系人（windows、WM系统），电话簿（其他系统） 终端基本信息 通信 电话 短信 安全 证书 SSL GUI 图形 电话拨打与拦截 短信发送与拦截 证书的读取与放置 绘图 如手机终端的IMEI号，型号，软件版本等 17 中国电信通用Widget开放系统技术规范 总册 PNG 、SVG（可选） 其他 字体 OS 互斥、信号量 IO Thread IPC 内存 获取与设置字体 创建、删除，挂起，恢复 分配和释放 多芯片内存的分配与释放 mutex 文件 I/O 字符集 来电 电话结束 新短信到来 新彩信到来 外部事件 摄像头 GPS 网络状态 触屏信息 YD/T2187.1—2009 其他 时间 系统事件 获取摄像头状态，并可以控制摄像头 获取GPS状态及信息，并可以打开、关闭GPS 网络连接方式及状态变化 6.5.3.1 网络能力 1) Widget引擎要求支持异步的HTTP访问（如XMLHttpRequest）。 2) Widget引擎要求应该能够在Widget访问网络时予以用户必要提示。 3) 在Widget没有得到授权使用网络的情况下，向Widget系统提供安全通知消息，并禁 止Widget使用网络资源。 6.5.3.2 媒体能力 媒体 文字 支持内容 备注 支持点阵、矢量字体、Truetype字体，并支持中手机终端可选支持Truetype字英文混排 体 18