luavm 0.1.1 luavm: ^0.1.1 copied to clipboard
Provide simple Lua VMs to Flutter (now supports vanilla Lua 5.3.5)
Flutter Lua VM Plugin #
A Flutter plugin provides Lua virtual machine
This plugin is inspired by flutter_lua, a Go based Lua implementation for Flutter.
Getting Started #
Features
- Supports the latest stable vanilla Lua 5.3.5
- Support multiple Lua instances (don't be too much. <=100 instances)
- Lua script runs in platform thread
- Use Java/ObjC to avoid the annoying Swift version compatibility problem
Limitations
- Lua library "os" is NOT supported yet, due to unsupported functions in iOS: system and tmpnam
- All returned values will be converted to string
Usage #
Open a new VM
VM instances are named to distinguish each other.
import 'package:luavm/luavm.dart';
...
await Luavm.open("vm-name");
Run Lua Code
When VM is opened, run Lua code with 'eval' function:
- To load a Lua function:
await Luavm.eval("name","function luafn(a,b) return a+b end" );
- To simply run Lua code:
final res = await Luavm.eval("name","return _VERSION")
res should be returned as:
["Lua 5.3"]
- To call a Lua function:
final res = await Luavm.eval("name","return luafn(1,2)");
Luavm.eval returns a list of String, contains each value returned from Lua function.
final res = await Luavm.eval("name","return 1,2,'hello'");
should return a Dart list:
["1","2","hello"]
Close Lua VM
await Luavm.close("name");
Error Handling
Errors will be thrown as LuaError which contains error message as a string.