中智盟widget开发手册..doc

中智盟 Widget开发手册 中国智能多媒体终端技术联盟 2011-8-10目录 1 中智盟Widget简介 4 2 开发工具安装使用 4 3 Widget组成 5 4 创建一个Widget 6 5 控件属性及使用 7 5.1 View 7 5.2 Event 8 5.3 BasicElement 9 5.4 Div 10 5.5 Img 10 5.6 Listbox 10 5.7 Combobox 11 5.8 Edit 12 5.9 CheckBox 13 5.10 Radio 14 5.11 Scrollbar 14 5.12 其它控件 14 6 联网获取数据 14 7 DOM使用 15 8 Debug类 17 9 framework 17 9.1 framework.audio 17 10 audioClip类 18 11 中智盟Widget开发需注意事项 19 11.1 Main.xml文件 19 11.2 Options.xml 19 11.3 Options类 19 11.4 Date类 20 11.5 文件编码格式 20 版本历史 版本 日期 作者 描述 备注 2010-8-4 段宝山、徐杰、杨正伟 初始版本 1.0.1 2010-09-06 陈逢 详细描述创建一个Widget的过程 1.0.2 2010-09-14 段宝山 增加framework类的描述 中智盟Widget简介 Widget是一种小型的工具集合，用户可自由开发上传到网络供其它用户下载使用，其功能涵盖了娱乐、工作、学习等多个方面。目前PC上流行的Widget有GoogleWidget、YahooWidget等。 中智盟Widget与GoogleWidget兼容，其使用的API函数和控件是GoogleWidget的一个子集。中智盟Widget去掉了两个GoogleWidget的控件，一个是Link控件（由于目前电视无法实现点击连接上网的功能），一个是Content控件。另外中智盟Widget对一些控件的属性也做了一些简化。由于GoogleWidget是针对PC开发的，所以有许多功能是PC上才有的，比如访问注册表，比如运行Shell命令，这些功能在电视上无法运行，因此中智盟Widget不支持所有与PC功能相关的功能。 开发工具安装使用 中智盟 Widget开发工具使用GoogleWidgetSDK，最新工具的下载链接为“/downloadsdksubmit?hl=zh-CN”。该SDK工具需要GoogleDesktop软件，下载地址为：“/zh/CN/”。先安装GoogleDesktop，安装之后解压GoogleWidgetSDK压缩包，在解压后的目录中tools目录有designer_en.exe可执行文件，运行该文件后即打开GoogleWidgetSDK工具。 打开SDK工具后，在HomePage这个选项卡有许多有用的链接，其中“Using Gadget Designer”是关于如何使用SDK工具的帮助。“Gadget API Reference”链接是GoogleWidget各控件属性、方法和事件的详细描述。如下图1所示： 图1 SDK HomePage Widget组成 一个Widget即是一个目录，该目录中有以下几类文件和目录： main.xml文件：以XML言语描述一个Widget运行起来后界面元素的属性、布局以及不同的动作触发的函数操作。一个Widget只能有一个main.xml文件，且文件名只能是main.xml。 若干js文件：这些js文件由JavaScript语言编写，用以完成Widget的各种功能和动作。一个Widget可以有许多js文件。 图片资源文件或目录：Widget界面所用到的各种图片文件可以放在当前目录中，也可以放在一个单独的目录中。这些图片资源的路径可以在main.xml文件中使用。 多国语言目录：目录名为“en”、“zh_cn”之类，这些目录中的strings.xml记录了Widget界面上文字信息所对应各国语言的翻译内容。这些目录的命名必须符合“RFC1766 language codes”中规定的命名方式。中智盟Widget要求必须要有两个目录，一个是en目录，一个是zh_cn目录，其它国家语言的目录用户可以自行添加。 gadget.gmanifest文件：该文件记录了Widget各种描述信息，比如Widget描述，Widget版本，Widget作者等。 当用GoogleWidgetSDK工具新建一个Widget后，在该Widget的目录中会自动生成main.xml，main.js，gadget.gmanifest，en目录，stock