[按键手机插件开发]06. 优化按键TracePrint实现打印输出任何数据类型 _ 按键精灵脚本教程

查看: 4607\|回复: 7	[紫猫] [按键手机插件开发]06. 优化按键TracePrint实现打印输出任何数据... [复制链接]

紫猫

[紫猫学院创始人]

组别按键认证导师
UID513852
帖子3624
精华47
鲜花4633 朵
铜币28052 个
银币6157 个
在线时间190000
注册时间2010-10-09

1^#

字体大小: t T

发表于 2022-03-06 17:03 | |只看楼主

本系列教程目的是让大家掌握Lua基本语法与按键精灵手机版的插件开发制作，丰富按键精灵生态环境，让按键精灵变得更加强大！
本教程中部分知识点参考《Lua程序设计》书籍，有兴趣可以自行购买→传送门←
按键精灵手机版插件的开发标准草案请阅读帖子：http://bbs.anjian.com/showtopic-697779-1.aspx
紫猫学院也有提供Lua插件开发的VIP教学服务，有兴趣请咨询紫猫老师QQ345911220或微信zimaoxy

前言
在前面课程中，我们已经详细介绍了Lua的一些语法规则、数据类型和函数用法，本节课我们将开发第一个按键精灵手机班插件函数。按键精灵自带的 TracePrint 在输出查看数组的时候会直接显示unknown，在输出查看文本内容的时候，空格等不可见字符无法被立即察觉到，这些都对我们调试脚本造成不便，所以本节课将通过插件函数来解决这个问题，对应紫猫插件中的zm.TracePrint与zm.VarInfo函数。

插件框架
在开发插件之前，建议大家熟读《按键精灵手机版插件的开发标准草案与简易教程》，本节课将在该插件框架上进行进一步的开发，以下是纯框架例子。

在按键精灵中打印输出插件内部数据
在按键精灵中我们使用TracePrint可以打印输出查看信息，在Lua中我们使用print可以打印输出信息，但是print无法在按键精灵上打印输出，而直接写TracePrint会报错，因为这个TracePrint是按键精灵的命令，并非Lua的命令。所以这里我们要调用按键精灵的LuaAuxLib库里的TracePrint函数实现插件在按键精灵上打印输出数据。但是这个函数有一个局限性，第一个参数是由按键编辑器传入的代码行数，而我们没有办法自动获取代码行号，导致只能输出查看信息，而无法得知这是第几行代码的输出。
为了方便调试脚本，我们先封装一个内部使用的traceprint命令，同时让这个命令在Lua调试环境下使用print函数输出，而在按键精灵调试环境下使用LuaAuxLib.TracePrint打印到按键控制台上。

获取变量详细信息
我们通过自定义的VarInfo函数返回变量的详细信息内容, 方便打印输出, 函数要求支持可变长参数, 并对每一个参数的数据类型, 长度, 内容都进行输出, 如果遇到table数组数据, 则转换json后打印.

在按键精灵中打印输出变量详细信息
上面已经得到了详细的信息数据了，现在我们只要通过LuaAuxLib.TracePrint传入上面函数返回值即可实现打印输出。

整合代码
通过上面介绍，我们已经将功能全部实现，整合入插件框架中，我们将插件保存为zimaoxy.lua，并放到按键精灵手机助手的Plugin目录下，这里注意不要保存成zimao.lua！

local _zimao = {} --这是内部私有table函数
local zimao = {} --这是对外公开table函数
QMPlugin = zimao --通过这行代码, 实现将zimao表中所有函数对外公开
_zimao.version = "20220306" --插件版本号, 方便自己记忆
local function try(block) -- 保护执行函数
local tablejoin = function (...)
local result = {}
for _, t in ipairs({...}) do
if type(t) == "table" then
for k, v in pairs(t) do
if type(k) == "number" then table.insert(result, v)
else result[k] = v end
end
else
table.insert(result, t)
end
end
return result
end
-- get the try function
local try = block[1]
assert(try)
-- get catch and finally functions
local funcs = tablejoin(block[2] or {}, block[3] or {})
-- try to call it
local result_error = {}
local results = {pcall(try)}
if not results[1] then
-- run the catch function
if funcs and funcs.catch then
result_error = {funcs.catch(results[2])}
end
end
-- run the finally function
if funcs and funcs.finally then
local result_fin = {funcs.finally(table.unpack(results))}
if #result_fin > 0 then
return table.unpack(result_fin)
end
end
-- ok?
if results[1] and #results > 1 then
return table.unpack(results, 2, #results)
else
if #result_error > 0 then
return table.unpack(result_error)
else
return nil
end
end
end
local function catch(block) --异常捕获函数
return {catch = block[1]}
end
local function finally(block) --最终必定执行函数
return {finally = block[1]}
end
-- 常用的内部函数, 不加入私有table中, 直接定义使用
local function traceprint(...) --调用按键精灵的调试输出命令
if QMPlugin then -- 在Lua调试环境下, QMPlugin变量的值是我们插件公开table函数值, 而在按键精灵调试运行环境下, 该变量值被替换为nil
print(...)
else
-- 获取可变长参数的第一个参数值
local line = select(1, ...)
-- 如果第一个参数是字符串, 并且符合格式 _数字 , 则判定为行号意思
if type(line) == "string" and line:match("^%_%d+$") then
-- 第一个参数按照格式 _数字: 传入TracePrint中可实现打印行号功能
LuaAuxLib.TracePrint(line .. ":", table.concat({...}, " ", 2, select("#", ...)))
elseif line == ":" and #{...} > 1 then
-- 第一个参数是冒号 : 时, 表示直接打印输出数据
LuaAuxLib.TracePrint(":", table.concat({...}, " ", 2, select("#", ...)))
else
-- 其他的情况下则加上前缀后, 进行正常输出
LuaAuxLib.TracePrint(":","紫猫学院测试插件：", ...)
end
end
end
-- 实现获取变量信息的插件函数, 需对外公开, 所以使用zimao前缀
function zimao.VarInfo(...)
-- 防止无法获取nil参数
local paramCount = select("#", ...)
local varType, printStr, t = "", "", {}
for i = 1, paramCount do
local v = select(i, ...)
try {
function()
varType = type(v)
if varType == "table" then
printStr = "【" .. varType .." " .. tostring(#v) .. "】" .. LuaAuxLib.Encode_GetJsonLib():encode(v)
elseif varType == "number" or varType == "string" then
printStr = "【" .. varType .." " .. tostring(#tostring(v)) .. "】" .. tostring(v)
elseif varType == "boolean" or varType == "null" then
printStr = "【" .. varType .."】" .. tostring(v)
else
printStr = "【" .. varType .."】未知数据，无法查看！"
end
table.insert( t, #t + 1, printStr )
end,
catch {
function (errors)
-- 下面这个traceprint是我们上面定义过的内部输出命令，注意大小写
traceprint("发生运行时错误！错误代码：VarInfo()，错误信息：", errors)
end
}
}
end
printStr = table.concat( t, ", " )
return printStr
end
-- 实现打印输出变量详细信息数据, 需对外公开
function zimao.TracePrint(...)
-- 通过VarInfo函数获取参数的详细数据信息
local info = zimao.VarInfo(...)
try {
function()
-- 在保护模式下打印输出这个数据内容
traceprint(info)
end,
catch {
function (errors)
traceprint("发生运行时错误！错误代码：TracePrint()，错误信息：", errors)
end
}
}
end

复制代码

按键精灵测试
插件完成后，记得要先自己调试运行测试一遍，检查是否有错误，本次代码测试效果如下图：

【紫猫编程学园】火热招生中

教学涉及按键精灵电脑版、按键精灵手机版、易语言、Lua编程。

包含网页、端游、手游、办公、模拟器、插件等。

报名咨询QQ:345911220 或 97682686 或 97682687;

报名咨询微信:zimaoxy; 点我在线交谈

紫猫学园免费教程

加入交流QQ群: 7333555

回顶部

发送短消息 UID 3328028 帖子 1497 精华 0 鲜花 199 朵铜币 3957 个银币 204 个性别在线时间 26840 注册时间 2015-06-28 最后登录 2024-03-09 查看公共资料搜索主题搜索帖子 zjcyjj zjcyjj 组别大学三年级 UID3328028 帖子1497 精华0 鲜花199 朵铜币3957 个银币204 个在线时间26840 注册时间2015-06-28 小红帽对论坛提出良好建议（可向管理员申请）	2^# 字体大小: t T 发表于 2022-03-19 01:39 \| \|只看该用户实现数据可视化


	回顶部

发送短消息 UID 8932624 帖子 25 精华 0 鲜花 16 朵铜币 23 个银币 23 个性别在线时间 0 注册时间 2022-12-25 最后登录 2024-09-12 查看公共资料搜索主题搜索帖子蓝色的土土组别小学一年级 UID8932624 帖子25 精华0 鲜花16 朵铜币23 个银币23 个在线时间0 注册时间2022-12-25	3^# 字体大小: t T 发表于 2023-01-29 06:14 \| \|只看该用户 321321


	回顶部

发送短消息 UID 8134593 帖子 10 精华 0 鲜花 9 朵铜币 18 个银币 9 个性别在线时间 0 注册时间 2021-01-28 最后登录 2023-03-09 查看公共资料搜索主题搜索帖子 7586400 7586400 组别小学一年级 UID8134593 帖子10 精华0 鲜花9 朵铜币18 个银币9 个在线时间0 注册时间2021-01-28	4^# 字体大小: t T 发表于 2023-02-20 18:59 \| \|只看该用户学习学习


	回顶部

发送短消息 UID 8768351 帖子 40 精华 0 鲜花 26 朵铜币 39 个银币 39 个性别在线时间 0 注册时间 2022-06-12 最后登录 2024-05-06 348236378 查看公共资料搜索主题搜索帖子 tiki祈 tiki祈组别小学二年级 UID8768351 帖子40 精华0 鲜花26 朵铜币39 个银币39 个在线时间0 注册时间2022-06-12	5^# 字体大小: t T 发表于 2023-04-04 09:50 \| \|只看该用户马克一下，回来学习


	回顶部

发送短消息 UID 9030272 帖子 1 精华 0 鲜花 2 朵铜币 2 个银币 2 个性别在线时间 0 注册时间 2023-05-01 最后登录 2023-05-01 查看公共资料搜索主题搜索帖子 beane 组别幼儿园 UID9030272 帖子1 精华0 鲜花2 朵铜币2 个银币2 个在线时间0 注册时间2023-05-01	6^# 字体大小: t T 发表于 2023-05-01 11:04 \| \|只看该用户好强


	回顶部

发送短消息 UID 3874640 帖子 1637 精华 0 鲜花 159 朵铜币 7282 个银币 177 个性别在线时间 66120 注册时间 2016-04-19 最后登录 2024-11-30 查看公共资料搜索主题搜索帖子 romanticaqq Yeah 组别大学三年级 UID3874640 帖子1637 精华0 鲜花159 朵铜币7282 个银币177 个在线时间66120 注册时间2016-04-19 过大年勋章俩小福娃给大家拜年啦！图灵勋章参与按键精灵验证码识别大赛奖励	7^# 字体大小: t T 发表于 2023-05-11 13:00 \| \|只看该用户好东西！！！！！
	Yeah分享

	回顶部

发送短消息 UID 9080015 帖子 2 精华 0 鲜花 2 朵铜币 3 个银币 3 个性别在线时间 0 注册时间 2023-07-15 最后登录 2023-07-15 查看公共资料搜索主题搜索帖子走南闯bei 组别幼儿园 UID9080015 帖子2 精华0 鲜花2 朵铜币3 个银币3 个在线时间0 注册时间2023-07-15	8^# 字体大小: t T 发表于 2023-07-15 05:59 \| \|只看该用户


	回顶部

上一主题| 下一主题

[紫猫] [按键手机插件开发]06. 优化按键TracePrint实现打印输出任何数据... [复制链接]