gearbox开发入门.doc

首先，我写这个文档时也才接触gearbox开发两个月时间，对gearbox开发可以说才刚入门，下面就写一下自己对学习gearbox开发的一点看法。gearbox开发与大家以前熟悉的Java或者c/c+开发有很大的不同，这是在一种全新的平台上做开发，使用的事公司自己的一套规范Gearbox手机应用开发使用XML语言和Lua脚本语言，但是并不要求我们对这两门语言有多么的精通熟悉，只需要有一点点了解就可以进行应用开发了，当然对这两面语言越了解也就越能快速的开发gearbox应用。gearbox应用文件结构非常简单，很容易学习，只要看几遍代码例子就可以掌握。Gearbox 应用文件的整体结构由 等组成。一个文件可以包含一个或者多个，内部可以有0-N个，一个内部可以有一个或者多个或者。一个可以看成按时间顺序进行动画，里面的每个即为定义动画每个帧上的显示效果。1. 一个简单例子一个gearbox应用由包围，就正如与它们之间的代码就是一张网页一样。一个就是一个gearbox应用文档。一个元素可以有多个元素，元素关闭符号为,其他元素的关闭符号也是类似的在开始符号前添加反斜杠。每个元素表示一段动画，每个元素是动画的一帧。应用的执行入口是第一个元素，其他的只能由第一个调用才会执行。一个简单的gearbox应用文档如下：例1：例1中，只有一个元素，该动画只有一帧，把图片“bar.png”放到画面上。2. 如何显示图片图片的使用必须先定义才能将图片放置到图层中。定义语句为：define-image id=numbersource=URL width=number height=number 将图片放置到图层我称之为“图片的实例化”有两种方法，一种是使用XML标签另一种方法是使用Lua脚本函数placeObject()，具体用法参考文档GearBox _file_format v2.doc。需要明白的是应用中所有的（就我目前所知）元素都必须通过定义，或者声明元素的引用给它们一个唯一的id才能通过这个id来placeobject即我所谓的“实例化”。下面给出一个显示图片的完整例子例2:定义时必须保证id唯一，在同一个中placeobject时每个图层只能放一个object即depth必须唯一，如果不唯一会出现无法预料的问题。depth高的图层可能会遮住低层UI元素，如果图层中的元素位置叠在一起。不同的depth互不影响。例子中定义了6张图片，然后把他们“实例化”显示到屏幕上。图片的id属性可以任意取值但必须保证唯一。定义可以在应用的任何位置，只要保证在placeobject时相应的id已经定义。frameRate属性是帧率，表示每秒钟播放多少帧。Loop属性表示是否循环播放，此例子为none只播放一遍。3. 如何在第一个中调用其他的gearbox应用文档由gearbox引擎解释执行，执行的入口是第一个,第一个执行结束后不会接着执行后面的，而是等待用户的操作，响应用户事件。其它的只能在第一个中调用。一个中可以包含多个UI元素，可以说是一个UI元素的集合，但它也是一个UI元素。调用的顺序是，首先要定义一个元素，这通过标签对就可以完成。在调用一个前必须先给它一个唯一的id标识它： 这就是声明的引用，url属性对应相应的的name属性。请看例子：例3： 例3中第一个只有一帧，先在图层1的（0,0）坐标处放置了一张图片ani_bg.jpg，接着声明了第二关的引用，然后调用即“实例化”了该。第二个是一个实现书翻页的动画，通过6帧的循环播放不停的翻页。frameRate控制各帧，即元素切换的速率。第一到第六帧分别放置id为1到6的不同的六张图片，前面说过在同一个里，每一个图层只能place一个object，这里六张图片都放置在图层1中，是因为isMove属性为1时会将图层中已经存在的object移除掉在放置新的object。这里可以参考GearBox _file_format v2.doc中placeObject（）一节。4. 关于id定义图片、即的引用、标签等UI元素时必须给出id属性。这个id在整个应用文档中必须保证唯一，这个id就好像一个类名以后就可以通过这个id号place任意数量的UI元素于画面中。如果id不唯一就会报（目前gearbox引擎不够完善，可能会有预料不到的问题出现）id冲突的错误。5. Gearbox中的时间控制问题gearbox应用中可能会同时“实例化”多个framelist,gearbox引擎自动执行第一个framelist,placeObject我所谓的“实例化”其实就是执行其中的代码。当place了多个framelist时，如果它们都没有执行结束那么各个就会并行执行。当它们会修改全局变量时就可能出问题，所以帧率的设置要注意。6. 循环执行的问题很多地方都要用到循环执行的。循环执行时，每循环一遍就会删除掉所有place的object，也就是说该framelist所有图层上的UI元素都被删除掉了所有的图层又可以重新placeobject。每循环一遍可能会改变变量的值。每循环一遍就会执行里面所有的代码一遍，就相当于一个循环语句。最常用的循环执行的例子可能就是计时问题了。例4：计时例子例4中第一个f