当前位置: BOLT界面引擎 > 知识库文章 > HelloBolt系列教程 > HelloBolt1:引入Bolt,第一个XAR

HelloBolt1:引入Bolt,第一个XAR

作者:Tsukasa

 

       在HelloBolt1中,我们要建立一个windows应用程序,在其中引入Bolt引擎,加载一个最简单的Bolt引擎的XAR包,执行其中的代码,效果如下:
                         
1.        建立VC 工程:
在所有工作开始之前,首先要执行Bolt SDK中的setup.js在编译器中配置Bolt SDK的引用目录。用VS03virtual C++中的win32工程模板建立空白项目作为HelloBolt的主程序,然后执行Bolt SDK中的Setup.js脚本。在链接器中链接Bolt各个模块的链接文件。
                   
 
 
2.        Bolt引擎的初始化反初始化
HelloBolt.cpp中包含Bolt SDK提供的头文件:

#include <XLUE.h>

#include <XLGraphic.h>
#include <XLLuaRuntime.h>
 
bool InitXLUE()方法中加入Bolt的初始化代码:调用XL_InitGraphicLib(&param)初始化图形库,    调用XLUE_InitLoader(NULL)初始化Bolt。定义lua脚本错误处理函数LuaErrorHandle,调用XLLRT_ErrorHandle将之设置到lua环境之中,这样我们可以捕获到运行过程中的脚本错误。
     完成Bolt的初始化之后,接下来指定要执行的XAR界面引擎 XML文件格式以及XAR包介绍)。 一个“XAR包”中包含界面布局XML,资源包和脚本代码,可以是文件夹, 也可以是使用Bolt SDK中提供的XLUEPack工具打包出来的.XAR后缀文件,还可以是直接将目录打包而成的zip文件。HelloBolt1执行的XAR包是HelloBolt\XAR\中的HelloBolt1文件夹。在bool LoadMainXAR()方法中,调用XLUE_AddXARSearchPath(GetResDir()) 将HelloBolt\XAR\目录添加到Bolt加载XAR包时的搜索路径,之后调用XLUE_LoadXAR("HelloBolt1"), Bolt会在HelloBolt\XAR\中搜索名为HelloBolt1的XAR包(HelloBolt1.xar 或 HelloBolt\XAR\HelloBolt1\) 加载并执行之。
void UninitXLUE()方法中加入Bolt的反初始化代码, 注意反初始化的流程。
需要在在VC中的做的工作就这么多了,编译通过后我们开始编写第一个最简单的XAR包。
 
 
3. 定义XAR的入口脚本
如前所述, HelloBolt\XAR\HelloBolt1目录是HelloBolt1中要执行的XAR包,转入其中仔细看看,目录中的文件如下:
          package.cfg是XAR包必须包含的配置文件,确定该XAR包的结构信息,如下格式:

<xlue name = "HelloBolt1" author="Thunder Corporation" copyright="(C) Thunder Corporation.">

<loadscript path="./onload.lua" type="lua"/>
</xlue>

name属性指定XAR包的名称,也就是XLUE_LoadXAR中要传入的名称,loadscript指定XAR的入口脚本。按照这个配置,加载这个XAR包会首先执行onload.lua中的lua代码。
     在onload.lua中, 只有一行调用XLMessageBox("Hello,Bolt!"),XMessageBox函数是Bolt中提供的对windows MessageBox函数的简单封装,调用会弹出系统的MessageBox。
    

迅雷公司 版权所有 Copyright 2003-2010 Thunder Inc.All Rights Reserved. 意见反馈:xl7doc@xunlei.com