百宝云TLL模块说明文档

Abin

百宝云TLL模块使用说明文档

TLL是百宝云新推出的一个模块文件，作者可以把自己写的功能通过TLL文件的方式分享给别人使用，从而不担心源码泄露的问题，使用者只能在百宝云开发工具里，导入TLL文件，才能看到作者对外导出的接口。
下面我们来看看如何创建TLL模块文件，以及如何使用TLL模块里导出的接口。

创建TLL模块项目

打开百宝云开发工具，点击新建按钮，创建一个TLL项目。如图：

在创建项目的对话框里，我们一定要选择TLL模块，之后输入项目名称：测试TLL，最后记得，一定要选择项目存放的位置！！！！

如下图：

点击确定按钮之后，我们就创建了一个TLL模块项目了，让我们来这个创建的项目吧！

编写TLL模块对外导出的接口

对外导出接口的格式是：
中文：  导出功能 功能名(参数)......结束
英文：  tllexport 功能名(参数)......end

例如我们自动生成的代码：


我们在为导出接口取名时，建议增加个性化的前缀，以避免与其他的TLL模块导出的接口同名，从而导致项目出现语法错误。
个性化前缀：比如我叫Abin，那么我就可以在导出的接口前面加上 Abin_。这样就即可以让自己或者使用者一目了然的知道当前用的是谁的TLL模块，也便于TLL模块开发者调试自己的代码。

好了，这里我就写几个简单的示例代码：

1. // 其他的字符，自己添加
   
2. 
   
3. var 字符数组 =array("A","B","C","D","E","F","G","H","I","J","K","L","M","N","O","P","Q","R","S","T","U","V","W","X","Y","Z")
   
4. 
   
5. 导出功能 Abin_得到随机字符串(长度)
   
6.     return 随机字符串(长度)
   
7. 结束
   
8. 
   
9. 功能 随机字符串(长度)
   
10.     var result = ""
    
11.     if(长度 <= 0)
    
12.         return result
    
13.     end
    
14.     for(var i = 0; i < 长度; i++)
    
15.         result = result & 字符数组[rnd(0,25)]
    
16.     end
    
17.    
    
18.     return result
    
19. 结束
    
20. 
    
21. 
    
22. tllexport Abin_介绍英文名(名称)
    
23.     return "大家好，我是Abin，我的英文名是：" & 名称
    
24. end

复制代码

为TLL模块导出的接口编写说明信息

百宝云工具还为大家提供了一个编辑TLL接口说明的工具，在这个工具里，作者可以对导出的接口编写：接口的作用、参数的作用、返回值说明、以及接口调用的举例。

如下图：

在上面的对话框里，我们就可以对导出的接口编写说明了。

功能说明如果为空的话，工具会自动生成”功能描述内容”字样。

例如我们现在对导出接口做如下的说明：

我们还可以对TLL模块文件添加说明信息，只要点击界面上的TLL文件说明按钮即可，如下图：

注意：

无论是在编写接口说明、TLL文件说明，写完了之后，必须点击保存或者确定按钮，这个才会保存当前编辑过的内容；如果直接关闭窗口，那么不会保存当前编辑过的内容！

这些都完成之后，那么就点击生成按钮，生成我们的TLL模块文件吧！

如果代码有语法错误的话，那么会生成失败。这时就需要自己修改代码了；生成成功的话，那么在项目的生成目录下就会存在TLL文件了，我们去看看吧！

这个就是我们刚刚生成的TLL模块文件，是不是很简单？？？（其实真的很简单）

题外话
说一个题外话，在生成之前，我们可以设置TLL模块文件的生成目录，这个功能是同TLL模块一起添加的，所以在不支持TLL的开发工具里，是没有这个功能哟！！！
使用见下图：

操作流程： 点击【选项】 --> 点击【生成文件目录设置】 --> 点击【浏览】 --> 在弹出的对话框里【选择/新建一个文件夹】 --> 点击【确定】。

在百宝云项目里引用TLL模块

打开百宝云开发工具，新建一个云应用项目。如下图：

创建成功之后，我们就可以把刚刚生成的TLL模块导入到项目里了。

导入TLL模块的方法

导入TLL模块的方法有三种：

①：在TLL项目里，设置生成文件的目录为需要导入TLL模块的百宝云项目源码目录，之后生成TLL模块，那么TLL模块文件就生成到目标百宝云项目里了，这样就可以使用TLL模块的导出接口了。

②：在项目管理的TLL模块节点上右键，会弹出下面的菜单，如下图：

选择导入模块选项，之后会弹出一个文件浏览框出来，如下图：

最后找到需要导入的TLL模块，选择模块文件，点击打开即可。这样TLL模块就导入到项目了，我们也就可以正常使用TLL模块里的导出接口了。

③：在TLL模块项目里，打开生成目录，复制TLL模块文件，之后打开云应用项目的源码目录，把刚刚复制的TLL模块文件，粘贴到此源码目录即可，这样我们也可以正确的使用TLL模块里导出的接口了。

TLL模块信息查看

①：查看TLL模块文件的说明信息：在模块文件上右键，会弹出一个菜单，选择【查看模块说明】选项，如下图：

点击了【查看模块说明】选项之后，会弹出一个说明的对话框，如下图：

这个对话框里的内容就是我们前面为TLL模块文件写的TLL文件说明。

②：TLL模块导出接口说明信息：在TLL模块名下，选择一个导出的接口，如果写了接口的说明，那么在【功能描述】窗口里，就会显示对应的说明内容；如果没有编辑接口说明，那么就不会显示当前接口的说明。如下图：

TLL导出接口的使用方法

使用TLL模块导出的接口就和使用自定义功能、百宝云库的API一样，方便简单，也可以参考说明里的举例。那么下面我们就一起来调用前面写的TLL模块接口吧！

1. 功能 _initial()
   
2.     //    发送文本消息("初始化接口")
   
3.     var 名称 = Abin_得到随机字符串(8)
   
4.     var 说话内容 = Abin_介绍英文名(名称)
   
5.     文件写日志(说话内容)
   
6. 结束

复制代码

我们在代码直接写在_initial()这个方法里，以便云应用启动了就执行我们的代码。代码里是把说明内容变量的数据写到默认的日志文件里了。

现在我们就直接生成云应用，以及上传安装包吧！

生成云应用的图：

上传安装包以及上传成功的图：

云应用启动成功了，那么我们刚刚写的代码已经执行了，现在我们去看看日志文件里到底写了什么内容呢？？？一起看看吧！！！

从上面的图就可以看出，我们前面写的TLL模块正常的运行了。

至此，我们的教程也要结束了，通过这个教程，相信大家都能做自己的TLL模块了，也可以把自己的模块分享给亲朋好友来使用了。同时，大家也可以在百宝云论坛里下载与使用别人分享的TLL模块了。

最后，感谢大家对百宝云的支持！

下载文章中配套的源码：


此贴Word版本下载：



附加：
百宝云虚拟桌面：http://user.91shenfan.com
百宝云官方网址：http://www.91shenfan.com/
百宝云官方论坛网址：http://bbs.91shenfan.com/

百宝云创始交流群： 309604797

友情链接：
【POST必备】红船HTTP库+源码 cURL原生接口封装：http://bbs.91shenfan.com/thread-8-1-1.html

adminwal

6666

42006654

TC 6 什么时候 加入TLL功能呀  ！！1

红船

~~~