BOLT.NET 学习笔记(一) 开篇 用.net winform 快速开发 炫酷的界面

时间:2022-04-28 13:59:43

BOLT.NET 学习笔记(一) 开篇 用.net winform 快速开发 炫酷的界面

bolt 基本介绍

Bolt界面引擎是迅雷公司从2009年开始开发的第四代界面库。迅雷7是首个采用该引擎成功开发的产品,目前迅雷旗下大部分客户端产品都基于该引擎开发,并稳定运行于超过3.5亿台PC上。

BOLT.NET开源项目

介绍

从2012年11月开始,千寻动漫(http://manhuahe.net)团队开始开发千寻漫画盒2.0版本,我们选择了迅雷的BOLT界面引擎开发新版界面。由于我们项目一开始主要使用.NET平台上的C#语言开发,所以直接选择了在.NET平台上使用BOLT引擎开发新版界面。迅雷BOLT SDK里有一个简单版本的dotNetBoltDemo,我们从这个简单的例子出发,在开发过程中按需封装和改进,逐渐形成了比较稳定的一个封装类库。考虑到很多开发者同样需要使用.NET平台开发BOLT界面,本着分享和避免重复发明*的精神,我们将BOLT.NET类库项目开源出来,希望大家一起改进它,以提供一个在.NET平台上使用简单、稳定高效、接口优雅的BOLT封装,为在.NET上通过BOLT开发产品界面提供有品质的保证。

源码

BOLT.NET 项目源代码托管在http://boltdotnet.codeplex.com/上,使用Git做版本管理。
Git clone地址:https://git01.codeplex.com/boltdotnet
源码项目工程使用visual studio 2010构建
项目使用BSD开源协议

主要技术

使用.NET平台调用技术(P/Invoke)调用XLUE.dll导出的API注册类和对象给BOLT的Lua环境。
使用Attribute简化类和对象的注册。
使用扩展方法简化Lua 栈元素的读取。
使用泛型类以及扩展方法将Lua的function转成C#的Action和Func,简化代码。
简化UI线程的消息循环,并提供跨线程Invoke方法,让跨线程调用BOLT界面更加方便和友好。
在P/Invoke BOLT的API时,通过UTF8Marshal属性自动对BOLT环境的UTF8字符与.NET环境的UCS编码做转换。

使用说明

下载并安装Git for Windows (http://msysgit.github.io/)
打开Git Bash 命令行界面
使用git命令将源码克隆到本地: git clone https://git01.codeplex.com/boltdotnet
打开HelloBolt.NET.sln解决方案,编译并运行项目。

共有两个工程:
ComicDown.UI.Core,是BOLT的.NET封装的核心类库。
HelloBolt.NET,使用BOLT SDK的HelloBolt7的XAR做的DEMO,通过代码可以看到在.NET里通过ComicDown.UI.Core封装的API使用BOLT更加简单方便。

工程的输出路径:
boltdotnet\HelloBolt.NET\Bin\Debug
boltdotnet\HelloBolt.NET\Bin\Release
界面的BOLT代码:
boltdotnet\HelloBolt.NET\Bin\View

工程使用的是BOLT的dev和pr版Union版本XLUE.dll,分别位于Debug和Release目录下。请自行从迅雷BOLT官方论坛引擎发布版(http://bolt.xunlei.com/bbs/forum.php?mod=forumdisplay&fid=42)下载最新版本XLUE.dll

DEMO介绍

HelloBolt.NET项目,在Program.cs里通过XLBolt单例启动迅雷环境。Classes目录下的Application和MyClass是待注册给BOLT环境的C#类。RegisterClasses目录下的LuaApplication和LuaMyClass分别注册了Application单例对象给BOLT环境,MyClass工厂类给BOLT环境。
具体的代码和使用说明都已经在代码里面有详细注释,请直接通过上一步获取源码并阅读。