《jil-widget规范中文版》由会员分享，可在线阅读，更多相关《jil-widget规范中文版（27页珍藏版）》请在金锄头文库上搜索。
1、JIL Widget规范中文版（格式与打包） (2010-08-5,13:52:43)前言：中国移动BAE团队是JIL Widget规范制定的主要参与者之一。考虑到起草规范的时间紧迫、面向的读者覆盖全球，JIL Widget规范统一采用英文编写。许多开发者通过jil.org,中国移动开发者社区、BAE友好开发者等多种途径反映：希望能提供JIL Widget规范中文版本，以便于阅读。因此，中国移动BAE团队陆续将JIL Widget规范翻译成中文，供广大开发者参考。JIL Widget系统高级技术规范格式和打包规范(Format and Packaging Specification)状态：完成
2、版本：1.21.前言1.1关于此文档1.2文档所针对的对象1.3读者评论1.4相关文档2.设计目标3.打包和配置3.1命名空间校验规则3.2config.xml示例3.3元素3.3.1 id属性3.3.2 version属性3.3.3 viewmodes属性3.4 元素3.5 元素3.6 元素3.7 元素3.8 元素3.9 元素3.10 元素3.11 元素(JIL扩展)3.12 元素(JIL扩展)3.13 元素(JIL扩展)3.14 元素(JIL扩展)4.W3C规范附加要求4.1 HTML 4.014.2 XHTML Basic 1.14.3 CSS 2.14.4数字签名4.5 Media Q
3、ueries4.6 SVG Tiny 1.25.元素总览6.缩略词7参考7.1. Widgets 1.0: Packaging and Configuration7.2. Widgets 1.0: Digital Signatures7.3. Media Queries7.4. Widgets 1.0: Access Requests Policy7.5. Widgets 1.0: APIs and Events7.6. Widgets 1.0: Window Modes and Media Query Extensions7.7. Widgets 1.0: Updates7.8. Widge
4、ts 1.0: URI Scheme7.9. HTML 4.01 Specification7.10. XHTML Basic 1.17.11. Cascading Style Sheets Level 2 Revision 1 (CSS 2.1) Specification7.12. Scalable Vector Graphics (SVG) Tiny 1.2 Specification8.附录8.1 JIL Feature Values8.2更新描述文档(UDD)详细说明8.3 JIL 1.2 XSD8.4具体变更历史1.前言1.1关于此文档此文档提供JIL Widget打包的高级别技术
5、设计规范。此版本包含了JIL高级别技术规范Widget Formats 1.0.2的升级，以使其兼容于最新的W3C打包规范需求。1.2文档所针对的对象此文档的预定读者是负责实现文档功能或验证其实现的工程师，开发者，QA测试者，和设计者。1.3读者评论这种文档永远不是十全十美的。我们不指望现存版本完全清晰；所以，您的评论对于把此文档修正为对方案的清晰描述是至关重要的。您的反馈是重要的并将被考虑在此文档的新版本中加入。请您通过www.jil.org上“联系我们”发送您的回馈。1.4相关文档文档题目和版本文件名及所在位置JIL Widget System High Level Technical S
6、pecification: WidgetFormats v1.0.x请通过www.jil.org上“联系我们”发送文档请求JIL Widget System API Specification:Handset APIs v1.1.5请通过www.jil.org上“联系我们”发送文档请求JIL Widget System High Level Technical Specification: Security v1.2请通过www.jil.org上“联系我们”发送文档请求Widgets 1.0: Packaging and Configuration. 2.设计目标JIL Widget最初最重要
7、目标是商业化。尽管与标准兼容重要，但这是第二位的。因此，只要在W3C范围内JIL能够充分发展并且采用W3C的标准不会阻碍其商业化方面的努力，JIL将会采用W3C标准。JIL 1.0.x格式和打包规范是从2008年12月的W3C格式草案衍生出来的。JIL 1.2格式和打包规范完全包含和扩展了包含并扩展了下述W3C候选发布文档： Widgets 1.0: Packaging and Configuration（BONDI组织声明的）Widgets Digital SignaturesMedia Queries前查看此文档的“参考”部分查阅相关W3C标准。那些处于不同状态的草案过程的附加规范，W3C
8、也在这些附加规范上做工作。然而JIL规范不特定包含这些规范，尽管其中一些通过JIL Widget命名空间加入到了JIL特殊能力。值得注意的是，没有明确被JIL 1.2采用的W3C草案规范有：Widgets 1.0: Access Requests PolicyWidgets 1.0: APIs and EventsWidgets 1.0 Window Modes and Media Query ExtensionsWidgets 1.0: UpdatesWidgets 1.0: URI Scheme3.打包和配置JIL 1.2规范包含了W3C Widgets 1.0打包和配置规范，同时通过它自
9、己的JIL命名空间提供了专有扩展。因此可期待JIL Widget运行时环境可以运行符合W3C包装要求的任意Widget，当然，这是在假定此Widget没有运用非JIL手机API的前提下。根据W3C包装规格，一个JIL Widget的首要命名空间必须是“http:/www.w3.org/ns/widgets”。JIL专有扩展与命名空间“http:/www.jil.org/ns/widgets1.2”相对应。注意，JIL1.0.x的命名空间仍然是“http:/www.jil.org/ns/widgets”。此文档不打算重复讲述W3C Widget格式规范。W3C规范的所有方面都必须被采用。JIL同
10、时需要除W3C之外的附加支持。下面讲述了JIL 1.2规范值得注意的方面，它们与JIL 1.0.x和W3C CR（候选发布文档）规范相关。3.1命名空间校验规则为了支持向前兼容，同时使得一个Widget支持JIL 1.0.x和JIL 1.2包装规范，Widget运行时环境必须遵循下述命名空间校验规则：在根目录下查找名为“config.xml”的文件。n如果存在并且包含http:/www.jil.org/ns/widgets命名空间，则作为JIL 1.0.x的Widget安装（目前我们用的是 JIL1.0.X版本的命名空间方式）n如果文件存在并且包含http:/www.w3.org/ns/wid
11、gets命名空间，则作为W3C Widget安装；如果同时包含http:/www.jil.org/ns/widgets1.2命名空间，那么同时处理JIL1.2的扩展。n如果文件存在，但不包含JIL 1.0.x也不包含W3C命名空间，那么终止安装。n如果config.xml不存在，终止安装。3.2config.xml示例示例中同时使用W3C和JIL 1.2命名空间，所有JIL 1.2的扩展元素必须按照“Widget”元素声明使用jil前缀。Widget ExampleAn example widgetczhengCreative Commons Attribution License3.3元素3.3.1 id属性根据W3C规范，Widget标签的“id”属性是可选的。然而，JIL要求在它参与的所有Widget中这个属性存在。因此，“id”属性应该被视为必不可少的。它的值一般是由JIK SDK签署的。id是一个URI，它包含了用户昵称的SHA256加密，同时包含了URL编码的Widget名称。作为一个例子，如果开发者的用户昵称为“JoeSmith”，Widget名称为“Weather Widget”，那个Widget ID与下述类似：http:/org.jil/wid/b4c3addd8a1004ee5c651ca52bdc
