OpenWrt开发之界面

OpenWrt开发之界面

本站内容版权属于本人。转载须告知本人,写明出处,并在文首提供指向本站对应文章的链接。
本文链接:OpenWrt开发之界面

OpenWrt的界面是名为Luci的一个包。说实在的,对路由器来说,网页界面并不是必需的,只要能ssh上路由器设备,理论上说就可以做任何事情了。不过对于普通用户来说,还是有界面会友好一些。和OpenWrt本身一样,Luci也可以扩展,也就是说你可以向Luci里面加自己的页面,在官方的opkg源里面,也可以找到许多以luci-app-开头的包,它们就是Luci的扩展。

Luci目前是用Lua作为引擎写成的,为了进一步提升性能,社区有计划推出不使用Lua的界面Luci2,然而5年过去了,Luci2仍然不见影子,而家用路由器的性能也明显增强了不少。我个人感觉至少近期不会有Luci2了,学习用Luci也完全不会是49年入国军的行为。

本文接续《如何在OpenWrt上开发》。

导入Luci包

为了制作Luci扩展,我们需要在开发时导入Luci。在openwrt目录下运行以下命令:

创建界面扩展包

之前我们创建过包mypackage。这里我们就假设要为它的配置做个界面,按照Luci的命名规则,这个包应该叫做luci-app-mypackage。我们在myfeed目录下建这个包名的目录,在其中创建Makefile文件,写入以下内容。

这样包就创建好了,虽然里面还没有任何内容。

和普通包不一样的是,Luci的编译规则已经定义了安装方式,不需要自己定义,但相对的,包目录的结构也被固定下来了,如以下列表所示:

  • luci-app-mypackage – 包根目录
    • Makefile – 编译规则。
    • htdocs – 网站目录,会按照其内部目录结构放在网站根目录。
    • root – 系统目录,会按照其内部目录结构放在路由器的根目录。
    • src – C语言代码目录,需要Makefile来定义编译方式。
    • luasrc – Lua语言代码目录,会被编译安装到Luci的安装目录下。
    • lua – Lua语言代码目录,会被安装到Lua文档的目录下。
    • ipkg – 包管理脚本目录,可以放”preinst”, ”postinst”, ”prerm”, ”postrm”. ”conffiles”等脚本。

一个简单的Luci扩展包一般只需要htdocsroot目录。

创建界面入口

创建以下目录和文件:/luci-app-mypackage/root/usr/share/luci/menu.d/luci-app-mypackage.json,写入以下内容。这个文件的作用是在Luci界面的菜单里面加一项。title是显示在界面上的名称,order是决定顺序用的,action是链接到的页面,depends.acl是页面所有的权限定义。

还需要创建权限定义文件luci-app-mypackage/root/usr/share/rpcd/acl.d/luci-app-mypackage.json。其中read是读权限,write是写权限,file是文件,uci是配置文件(参见《OpenWrt开发之配置文件》),ubus是远程调用Lua代码。

编译安装包试试,就可以在界面上看到菜单项My Package了。

创建设置界面

在界面入口中的action里面,定义了界面的类型为view,路径是mypackage/overview,相对应的,我们创建文件/luci-app-mypackage/htdocs/luci-static/resources/view/mypackage/overview.js

现在点击菜单项,就有设置界面的内容了。

如果想要制作更加复杂的功能,则需要参考Github上luci的源码,其中包含了很多luci-app,也需要参考Lua API和JS API。篇幅所限,这里先不详述,会在下一篇中以我的一个例子来说明。

参考文档

发表评论

您的电子邮箱地址不会被公开。 必填项已用*标注

*

此站点使用Akismet来减少垃圾评论。了解我们如何处理您的评论数据