Bolt界面引擎QuickStart： SDK，教程和开发环境
Bolt界面引擎QuickStart： SDK，教程和开发环境
作者：Tsukasa
Bolt QuickStart
一． 安装 Bolt SDK
这里我们会先介绍如何安装Bolt界面引擎的SDK，然后 按照业界悠久的传统，本文将通过跑起一个 Hello,Bolt 的例子，来验证安装是否成功。并希望在这个过程里让您能在最短的时间内对 Bolt 界面引擎有个初步的认识。
准备工作：
0. 了解 xml, 了解 lua
1. 顺手的文本编辑器
2. 确定能解压 .zip 包
3. 保持网络畅通
从bolt.xunlei.com首页下载我们的最新版SDK，解压。
解压后的目录结构如下：
bin 目录中包含 Bolt 的发布版二进制文件； dev 目录包含开发版的 Bolt （ dev 目录），相较于发布版（ pr ），使用时会增加各种出错提示，包括 lua 脚本错误， xml 格式错误等等，用于开发时的除错； include 目录中包含 Bolt 的头文件， lib 包含 Bolt 各模块的链接文件； samples 目录包含若干 Bolt 的示例工程； tools 目录中包含 Bolt 提供的各种开发工具。
在使用Bolt SDK开始开发之前，先执行setup.js配置环境变量和VS编译器。
因为Simples中的实例大部分是从WTL框架创建，要正常使用它们需要先安装并配置WTL8.0（下载地址http://sourceforge.net/projects/wtl/files/）
第二步 : 开始 Hello,Bolt 教程。 Bolt SDK 目录下 samples/HelloBolt 目录中的 HelloBolt1 至 7 示范从头开始用 Bolt 搭建一个界面的所有要点。您可以试着把第一篇文章里最简单的HelloBolt跑起来，验证SDK已经正确安装。
开始HelloBolt教程。
二．
搭建Bolt的开发环境
一、 使用Notepad++实现基本的代码编写环境
由于使用引擎开发应用最主要的工作就是编写各种.xml和.lua文件，而Notepad++提供对这两种文件良好的手工编写支持，均有语法高亮和自动的格式调整，所以推荐大家使用Notepad++作为界面引擎主要的编码工具。
下面我的Notepad++开发环境的搭建步骤：
1. 先去Notepad++的官方网站下载最新版本的Notepad++。
2. 安装完成后运行,这个时候我会立刻下一些比较好用的插件，点击菜单 插件->Plugin Manager->Show Plugin Manager
3. Notepad++真的有很多插件，这里我先安装NppExec(支持在Notepad++里调用其它.exe)和Explorer(能在Notepad++里直接操作资源管理器)
4. 下载安装完成后重启Notepad++
5. 在工具栏上点 
，就能打开Explorer插件了。下面是效果
，就能打开Explorer插件了。下面是效果 
是不是很有IDE的感觉了，注意框起来的这几个按钮，都是一些非常好用的功能
6. 下面接着配置NppExec,能让我们在Notepad++里使用外部工具编译或运行lua，检查xml.这里以编译引擎的xml为例子，介绍一下。引擎提供了一个叫xluecl.exe的工具(包含在SDK\tools目录中)，可以做很多事情，其中之一就是检查一个引擎的xml是否有可检查的问题，并检查这个xml的后端lua文件的语法正确性。相关工具都在tools目录下，有3个exe.
7. 先把tools目录复制到本地，比如说放到D:\Dev\Tools\，然后我们通过命令行
D:\Dev\Tools\xluecl.exe -xml Progress.xml 这样的调用就可以检查一个xml的编写了。
D:\Dev\Tools\xluecl.exe -xml Progress.xml 这样的调用就可以检查一个xml的编写了。
8. 在Notepad++的菜单 插件->Nppexec->Execute… (注意你在第3步一定要装好了这个插件)
然后输入：
$(FULL_CURRENT_PATH) 是Notepad++的一个宏，代表当前编辑的文件的完整路径。点save… 按钮，给这个命令行取一个名字叫 xluecl xml. 然后按OK就可以试运行了,我故意写错一个xml,下面是运行结果：
非常方便的就找到错误所在了。
9. 下次要用这个命令行还是要不停的点这么多菜单，未免有点烦。这个时候可以通过Notepad++的命令宏功能把刚刚的命令行放到菜单里，并绑定快捷键。点击菜单 插件->Nppexec->Advanced Option…
在Associated script里选择刚刚保存的命令行，然后点Add/Modify按钮。然后勾上Place to the Macros submenu.点OK关闭窗口。按提示重启Notepad++.现在可以在菜单里看到：
你可以快速的使用该操作去编译.xml了。
10. 绑定快捷键只需要点菜单 设置->管理快捷键
这里就不详细说明了，相信聪明的你已经知道该怎么办了。
11. 搞定了一个操作之后，后面就如法炮制了。这是我的外部调用列表：
| luac | D:\Dev\Tools\luac.exe "$(FULL_CURRENT_PATH)" |
| Run lua | D:\Dev\Tools\lua.exe "$(FULL_CURRENT_PATH)" |
| xluecl xar | D:\Dev\Tools\xluecl.exe -xar "$(CURRENT_DIRECTORY)" |
| xluecl xml | D:\Dev\Tools\xluecl.exe -xml "$(FULL_CURRENT_PATH)" |
二、 使用Decoda 调试Lua代码 （由于安全原因我们对Lua环VM做了一些调整，现在的Decoda调试暂被关闭，过几个版本会打开 ）
这个工具比较简单，一切顺利的话会得到和vs相近的调试体验。
Copy Decoda目录到本地，运行Decoda.exe.点菜单 Debug->Start Debuging,然后在弹出的对话框的Command里选择你要调试的应用程序的路径（这里我以迅雷7为例子）。点OK后就以调试lua脚本的方式启动了迅雷。这个时候，调试器里会显示已经加载的lua文件的列表：
打开一个文件，然后按F9下断点…这个就不介绍了。
Decoda这个软件本身对lua的编辑支持的也不错，有自动完成功能。迅雷7项目组有不少哥们就很喜欢用这个工具来编辑.lua而不是notepad++.
用Decoda调试有一些需要注意的地方：
1） 文件列表里只会显示已经加载的文件，由于引擎使用了大量的按需加载机制，所以很多时候你会发现左侧没有你想下断点的文件。想办法让你的脚本执行一次，左侧就有了。
2） 调试非日志版，由于lua文件被编译了，所以看不到代码。
3） 注意调试时发现了bug,请不要在Decoda里修改保存,因为Decoda并不知道文件的绝对路径。
4） 这个调试器的大部分快捷键和功能都和vs很像，相信大家一定能很快上手的。
原文地址：
http://xldoc.xl7.xunlei.com/0000000018/00000000180001000032.html