灵码知识库 · 用法与命令大全

灵码 App 使用说明

从安装到打包，完整操作流程。

1. 安装灵码›

好后打开「灵码」。

2. 创建工程›

3. 设计界面›

编辑器上方是画布（手机屏幕比例），下方是操作区：

· 选中组件：在画布上点组件，出现蓝框即为选中

· 修改属性：选中组件后点「属性」，改文本/颜色/宽高/字号等

· 调整层级：选中组件后点「上移/下移」改变叠放顺序

· 删除组件：选中后点「删除」

4. 写脚本›

示例（按钮单击）：提示("你好")

5. 多界面与导航栏›

点「界面」可新建多个界面（页面）。每个界面有独立组件和事件。

加底部导航栏：添加「导航栏」组件，属性「选项」填逗号分隔的页面名（如：首页,消息,我的），顺序对应界面顺序，预览时点导航可切换页面。

6. 运行测试›

编辑器点「运行」可预览当前工程（调试模式）。调试模式有输出区，可看到打印/提示的调试信息。

7. 打包安装›

在 Download 目录，文件名「工程名.apk」。

8. 导出与分享›

9. 外部脚本›

10. 导入导出工程›

布局

线性布局layout›

用途：把子组件按垂直或水平方向依次排列，是排版的基础容器。

属性：方向（垂直/水平）、背景色、圆角、宽高

事件：单击、长按

示例：

垂直布局里放三个按钮，它们会竖排成一列

滚动布局scroll›

用途：内容超出屏幕时可上下（或左右）滚动，适合内容多的页面。

属性：方向（垂直/水平）、背景色

事件：单击、长按

示例：

聊天记录页套滚动布局，消息多了可以往下滑

帧布局frame›

用途：子组件可重叠放置，适合做悬浮按钮、顶部栏、吸底栏。

属性：背景色、圆角

事件：单击、长按

示例：

网格布局grid›

用途：按行列网格排列子组件，适合做宫格菜单。

属性：背景色

事件：单击、长按

示例：

九宫格功能菜单

导航栏tabbar›

用途：底部导航条，点击切换界面。

属性：选项（逗号分隔，顺序对应界面顺序）

事件：无（自动切页）

示例：

选项填：首页,消息,我的 → 底部出现三个导航，分别切到第 1/2/3 个界面

基础

按钮button›

用途：可点击的按钮，点击执行事件脚本。

属性：文本、字号、文字颜色、背景色、圆角、宽高

事件：单击、长按、触摸按下、触摸抬起

示例：

事件-单击：提示("你点了按钮")

文本text›

用途：显示一段文字。

属性：文本、字号、文字颜色

事件：单击、长按

示例：

容") 动态改文字

图片image›

用途：显示图片，支持网络地址或本地文件。

属性：src（图片地址）、缩放模式（裁剪居中/平铺/拉伸）、背景

事件：单击、长按

示例：

src 填 https://图片地址，或 SD卡目录()+"/a.png"

圆形图片roundimg›

用途：圆形头像/图片。

属性：src、背景

事件：单击、长按

示例：

QQ 头像那种圆形图

输入

输入框input›

用途：文本输入框，可获取用户输入。

属性：提示文字、字号、多行（真/假）

事件：单击、内容改变

示例：

开关switch›

用途：开关按钮（开/关）。

属性：选中（真/假）

事件：改变

示例：

勾选checkbox›

用途：复选框。

属性：选中（真/假）

事件：改变

示例：

勾选后获取值(勾选1) 为真

单选radio›

用途：单选按钮。

属性：选中（真/假）

事件：改变

示例：

同一组单选互斥

下拉选择spinner›

用途：下拉菜单。

属性：选项（逗号分隔）、选中序号

事件：改变

示例：

选项填：苹果,香蕉,橘子；选中后获取值(下拉1) 返回序号

日期date›

用途：日期选择。

属性：文本

事件：改变

示例：

选择日期后文本显示日期

时间time›

用途：时间选择。

属性：文本

事件：改变

示例：

选择时间后文本显示时间

媒体

网页视图webview›

用途：内嵌网页浏览器。

属性：src（网址）

事件：单击、长按

示例：

src 填 https://lm.mzf.ink

视频video›

用途：视频播放器，支持网络视频。

属性：src（视频地址）

事件：单击、长按

示例：

src 填 mp4 视频直链

进度条progress›

用途：显示进度。

属性：max（最大值）、value（当前值）

事件：无

示例：

脚本里设置值(进度1,80) 更新进度

滑动条seekbar›

用途：可拖动的进度条。

属性：max、value

事件：改变

示例：

拖动改变音量：设置值(滑动条1,50)

容器

卡片card›

用途：圆角卡片容器，可放子组件。

属性：背景、圆角、宽高

事件：单击、长按

示例：

卡片里放图片+文本做图文卡片

列表list›

用途：数据列表，逐条显示。

属性：src（json 数组）

事件：单击、长按

示例：

src 填 [{"文本":"A"},{"文本":"B"}]

网格列表gridlist›

用途：网格数据列表。

属性：src（json 数组）

事件：单击、长按

示例：

图片九宫格

滑动窗体viewpager›

用途：左右滑动切换的窗体。

属性：src

事件：单击、长按

示例：

轮播图

全中文脚本命令，共 85 个。用法中「组件名」用双引号引起来。

提示与界面

提示›

弹出提示气泡。

示例：

提示("你好")

打印›

调试输出（调试模式显示在输出区）。

示例：

打印("变量=" + 变量)

设置文本›

设置组件的文字。

示例：

容")

设置颜色›

设置组件文字颜色。

示例：

设置颜色(文本1,红)

设置背景›

设置组件背景色。

示例：

设置背景(按钮1,"#23725d")

隐藏›

隐藏组件。

示例：

隐藏(按钮1)

显示›

显示组件。

示例：

显示(按钮1)

获取文本›

取组件的文字。

示例：

容 = 获取文本(文本1)

设置值›

设置组件的数值（进度条等）。

示例：

设置值(进度1,80)

获取值›

取组件的值（开关/下拉/进度等）。

示例：

设置属性›

按属性名设置组件属性。

示例：

设置属性(图片1,"src","https://...")

获取属性›

按属性名读取组件属性。

示例：

地址 = 获取属性(图片1,"src")

跳转›

用浏览器打开网址。

示例：

跳转("https://lm.mzf.ink")

跳转界面›

切换到指定界面。

示例：

跳转界面(设置页面)

退出应用›

退出程序。

示例：

退出应用

返回上一页›

返回上一个界面。

示例：

返回上一页

输入›

弹出输入框让用户输入，返回内容。

示例：

振动›

手机振动指定毫秒。

示例：

振动(200)

复制›

复制文字到剪贴板。

示例：

复制("要复制的文字")

获取剪贴板›

读取剪贴板内容。

示例：

容 = 获取剪贴板()

逻辑控制

如果/否则›

条件判断。

示例：

如果(变量 == "1") {提示("是")

} 否则 {

提示("否")

}

重复›

循环指定次数。

示例：

重复(10) {打印("第" + 循环次数 + "次")

}

当›

条件为真时循环。

示例：

当(变量 < 10) {变量 = 变量 + 1

}

跳出›

跳出当前循环。

示例：

重复(10) {如果(变量 == 5) { 跳出 }

}

继续›

跳过本次循环。

示例：

重复(10) {继续

}

并且/或者/不是›

逻辑运算。

示例：

如果(变量 > 1 并且变量 < 10) {}

注释›

注释文字，不执行。

示例：

// 这是一行注释

运行源码›

执行外部脚本文件（.z）。

示例：

运行源码("脚本.z")

等待›

暂停指定毫秒。

示例：

(1000) // 等 1 秒

定时器›

每隔指定毫秒重复执行（可传回调代码）。

示例：

定时器(1000) {打印("每秒一次")

}

停止定时器›

停止定时器。

示例：

停止定时器()

文本处理

字符长度›

取文字长度。

示例：

长度 = 字符长度("你好") // 2

截取字符›

从起始位置取 N 个字符。

示例：

子串 = 截取字符("你好世界",1,2) // 好世

查找字符›

找文字出现位置，找不到返回 -1。

示例：

位置 = 查找字符("abc","b") // 2

替换字符›

替换文字。

示例：

新 = 替换字符("a-b","-","") // ab

转大写›

字母转大写。

示例：

转大写("abc") // ABC

转小写›

字母转小写。

示例：

转小写("ABC") // abc

去除空格›

去掉首尾空格。

示例：

去除空格(" hi ") // hi

正则匹配›

正则匹配，返回是否匹配。

示例：

正则替换›

正则替换。

示例：

正则替换("a1b2","\\d","#")

转编码›

中文转 URL 编码。

示例：

转编码("你") // %E4%BD%A0

转中文›

URL 编码转中文。

示例：

转中文("%E4%BD%A0") // 你

转换数字›

文字转数字。

示例：

数 = 转换数字("12.5")

数值与数组

随机数›

取区间随机整数。

示例：

随机数(1,100)

取整›

取整数部分。

示例：

取整(3.7) // 3

四舍五入›

四舍五入。

示例：

取绝对值›

取绝对值。

示例：

取绝对值(-5) // 5

当前时间›

当前时间字符串。

示例：

时间 = 当前时间()

创建数组›

创建数组。

示例：

数组 = 创建数组(1,2,3)

取数组›

按下标取数组元素（从 1 开始）。

示例：

取数组(数组,1) // 1

改数组›

修改数组元素。

示例：

改数组(数组,2,"新")

数组长度›

数组元素个数。

示例：

数组长度(数组) // 3

取json值›

取 JSON 里的值。

示例：

取json值("{\"a\":1}","a") // 1

文件与存储

创建目录›

创建文件夹（自动建上级目录）。

示例：

创建目录(SD卡目录()+"/我的文件夹")

SD卡目录›

手机存储根目录。

示例：

SD卡目录() // /storage/emulated/0/Download

读取文件›

读取文件内容。

示例：

容 = 读取文件(SD卡目录()+"/a.txt")

写入文件›

写内容到文件。

示例：

容")

删除文件›

删除文件。

示例：

删除文件(路径)

文件存在›

判断文件是否存在。

示例：

如果(文件存在(路径)) {}

文件大小›

文件大小（字节）。

示例：

大小 = 文件大小(路径)

文件列表›

列目录下文件（数组）。

示例：

列表 = 文件列表(SD卡目录()+"/灵码脚本")

复制文件›

复制文件。

示例：

复制文件(源路径,目标路径)

移动文件›

移动文件。

示例：

移动文件(源路径,目标路径)

打开文件›

调系统打开文件。

示例：

打开文件(路径)

下载文件›

下载网络文件到本地。

示例：

下载文件("https://...",SD卡目录()+"/x.apk")

网络

获取网页›

GET 网页内容。

示例：

网页 = 获取网页("https://...")

网络请求›

HTTP 请求（支持 GET/POST、请求头）。

示例：

网络请求("GET","https://...","成功代码","失败代码")

ws连接›

连接 WebSocket，回调收消息。

示例：

ws连接("ws://地址","成功代码","收到消息代码","断开代码")

ws发送›

发送 WebSocket 消息。

示例：

ws发送("{\"op\":1}")

ws关闭›

关闭 WebSocket。

示例：

系统与设备

打电话›

拨打电话。

示例：

打电话("10086")

发短信›

发送短信。

示例：

容")

播放音乐›

播放音频（网络或本地）。

示例：

播放音乐("https://.../a.mp3")

停止音乐›

停止播放。

示例：

停止音乐

通知›

发系统通知。

示例：

容")

朗读›

语音朗读文字。

示例：

朗读("你好")

屏幕宽/屏幕高›

屏幕尺寸（dp）。

示例：

宽 = 屏幕宽()

设备型号/设备系统›

设备信息。

示例：

型号 = 设备型号()

横屏/竖屏›

切换屏幕方向。

示例：

横屏

状态栏颜色›

设置状态栏颜色。

示例：

状态栏颜色("#23725d")

隐藏状态栏/显示状态栏›

隐藏/显示状态栏。

示例：

隐藏状态栏

隐藏键盘›

收起输入法。

示例：

打开应用›

打开其他应用。

示例：

打开应用("com.tencent.mm")

卸载应用›

卸载应用。

示例：

名)

打开设置›

打开系统设置。

示例：

打开设置