神烦论坛

 找回密码
 立即注册
查看: 1454|回复: 3

百宝云TLL模块说明文档

[复制链接]

96

主题

220

帖子

1383

积分

管理员

Rank: 9Rank: 9Rank: 9

积分
1383
发表于 2016-6-2 19:57:41 | 显示全部楼层 |阅读模式
百宝云TLL模块使用说明文档


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

创建TLL模块项目
打开百宝云开发工具,点击新建按钮,创建一个TLL项目。如图:


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

如下图:


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



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

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

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


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

好了,这里我就写几个简单的示例代码:
  1. // 其他的字符,自己添加

  2. 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")

  3. 导出功能 Abin_得到随机字符串(长度)
  4.     return 随机字符串(长度)
  5. 结束

  6. 功能 随机字符串(长度)
  7.     var result = ""
  8.     if(长度 <= 0)
  9.         return result
  10.     end
  11.     for(var i = 0; i < 长度; i++)
  12.         result = result & 字符数组[rnd(0,25)]
  13.     end
  14.    
  15.     return result
  16. 结束


  17. tllexport Abin_介绍英文名(名称)
  18.     return "大家好,我是Abin,我的英文名是:" & 名称
  19. 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




本帖子中包含更多资源

您需要 登录 才可以下载或查看,没有帐号?立即注册

x
回复

使用道具 举报

86

主题

195

帖子

2026

积分

管理员

Rank: 9Rank: 9Rank: 9

积分
2026
发表于 2016-6-2 20:37:51 | 显示全部楼层
6666
回复 支持 反对

使用道具 举报

0

主题

64

帖子

209

积分

钢铁侠

Rank: 3Rank: 3

积分
209
发表于 2016-6-2 23:28:02 | 显示全部楼层
TC 6 什么时候 加入TLL功能呀  !!1
回复 支持 反对

使用道具 举报

49

主题

151

帖子

875

积分

版主

Rank: 7Rank: 7Rank: 7

积分
875
发表于 2016-6-3 13:54:52 | 显示全部楼层
~~~
回复 支持 反对

使用道具 举报

您需要登录后才可以回帖 登录 | 立即注册

本版积分规则

技术支持
关闭
售后
在线客服
QQ群:309604797
在线客服

小黑屋|神烦论坛 ( 苏ICP备18043773号 )

GMT+8, 2021-10-20 20:48

Powered by bby! X3.4

© 2015-2021 baibaoyun

快速回复 返回顶部 返回列表