本文链接：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目录下运行以下命令：
|
1 2 |
./scripts/feeds update luci ./scripts/feeds install luci |
创建界面扩展包
之前我们创建过包mypackage。这里我们就假设要为它的配置做个界面，按照Luci的命名规则，这个包应该叫做luci-app-mypackage。我们在myfeed目录下建这个包名的目录，在其中创建Makefile文件，写入以下内容。
|
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 |
include $(TOPDIR)/rules.mk PKG_VERSION:=1.0 PKG_RELEASE:=1 PKG_MAINTAINER:=Chaofan <herbix@163.com> PKG_LICENSE:=Private # 包的描述和依赖 LUCI_TITLE:=Luci interface to configure mypackage LUCI_DEPENDS:=+mypackage # 固定写法，导入Luci的编译规则 include $(TOPDIR)/feeds/luci/luci.mk # 下面这句注释不能省略，因为OpenWrt会找含有“call BuildPackage”文本的Makefile文件当作包的定义 # call BuildPackage - OpenWrt buildroot signature |
这样包就创建好了，虽然里面还没有任何内容。
和普通包不一样的是，Luci的编译规则已经定义了安装方式，不需要自己定义，但相对的，包目录的结构也被固定下来了，如以下列表所示：
- luci-app-mypackage – 包根目录
- Makefile – 编译规则。
- htdocs – 网站目录，会按照其内部目录结构放在网站根目录。
- root – 系统目录，会按照其内部目录结构放在路由器的根目录。
- src – C语言代码目录，需要Makefile来定义编译方式。
- luasrc – Lua语言代码目录，会被编译安装到Luci的安装目录下。
- lua – Lua语言代码目录，会被安装到Lua文档的目录下。
- ipkg – 包管理脚本目录，可以放”preinst”, ”postinst”, ”prerm”, ”postrm”. ”conffiles”等脚本。
一个简单的Luci扩展包一般只需要htdocs和root目录。
创建界面入口
创建以下目录和文件：/luci-app-mypackage/root/usr/share/luci/menu.d/luci-app-mypackage.json，写入以下内容。这个文件的作用是在Luci界面的菜单里面加一项。title是显示在界面上的名称，order是决定顺序用的，action是链接到的页面，depends.acl是页面所有的权限定义。
|
1 2 3 4 5 6 7 8 9 10 11 12 13 |
{ "admin/services/mypackage": { "title": "My Package", "order": 100, "action": { "type": "view", "path": "mypackage/overview" }, "depends": { "acl": [ "luci-app-mypackage" ] } } } |
还需要创建权限定义文件luci-app-mypackage/root/usr/share/rpcd/acl.d/luci-app-mypackage.json。其中read是读权限，write是写权限，file是文件，uci是配置文件（参见《OpenWrt开发之配置文件》），ubus是远程调用Lua代码。
|
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 |
{ "luci-app-mypackage": { "description": "Grant access to mypackage procedures", "read": { "file": { "/etc/config/mypackage-extra": [ "read" ] }, "ubus": { "luci.mypackage": [ "get_status" ] }, "uci": [ "mypackage" ] }, "write": { "file": { "/etc/config/mypackage-extra": [ "write" ] }, "uci": [ "mypackage" ] } } } |
编译安装包试试，就可以在界面上看到菜单项My Package了。
创建设置界面
在界面入口中的action里面，定义了界面的类型为view，路径是mypackage/overview，相对应的，我们创建文件/luci-app-mypackage/htdocs/luci-static/resources/view/mypackage/overview.js。
|
1 2 3 4 5 6 7 8 9 |
'use strict'; 'require view'; return view.extend({ render: function() { return E('p', {}, _('My package configurations')); } }); |
现在点击菜单项，就有设置界面的内容了。
如果想要制作更加复杂的功能，则需要参考Github上luci的源码，其中包含了很多luci-app，也需要参考Lua API和JS API。篇幅所限，这里先不详述，会在下一篇中以我的一个例子来说明。
您好，请问在openwrt中master分支用了js生成界面 而21.x分支用lua生成的界面，请问前者和luci2的区别时什么？另外js生成界面和lua生成界面哪个性能好一些？为什么会有这两种方式？
luci2我记得说是用js生成界面的，所以可能是一回事。js的性能会好一些。为何会用lua应该是个历史问题，最初的开发者选择了它，而后面也没有太强的动力去更新它。