跳到主要内容

元信息

XPP 脚本包中需要一个名为 Info.lua 的脚本,返回一个用于描述当前脚本应用包元信息的 Lua 表常量。它通常不应该包含常量值以外的 Lua 代码。

以下是一个典型的 Info.lua 示例:

return {
BundleIdentifier = "com.yourcompany.yourscript";
BundleVersion = "0.0.1";
BundleName = "Your Name";
BundleDisplayName = "\U4f60\U7684\U540d\U5b57";
BundleIconFile = "appicon.png";
Executable = "xui-script.lua";
MainInterfaceFile = "xui-demo.xui";
MinimumSystemVersion = "10.0";
MaximumSystemVersion = "10.2";
MinimumXXTVersion = "1.1.2";
SupportedResolutions = {
{
width = 640;
height = 1136;
};
};
PackageControl = {
AuthorName = "i_82";
AuthorEmail = "[email protected]";
Description = "";
Homepage = "https://82flex.com";
};
};

Info.lua 返回的表通常包含以下键值对,各键值对的详细解释参见各子章节:

必选建议描述
BundleIdentifier**唯一标识符
BundleVersion**版本号
BundleName**名称
Executable*可执行入口脚本文件名 ( .lua, .xxt )
BundleDisplayName*显示名称
BundleIconFile*应用图标
MainInterfaceFile*XUI 入口配置文件名 ( .xui, .xuic )
MinimumSystemVersion最低系统版本要求
MaximumSystemVersion最高系统版本要求
MinimumXXTVersion最低 XXTouch 版本要求
SupportedResolutions设备分辨率支持数组
PackageControl附加信息

你应当尽可能完善这些信息,完善的显示名称、应用图标、配置界面有助于你的脚本观感更好,获得更高的认可度。

在脚本中,获取 Info.lua 中的常量信息,可通过 XPP 脚本包模块 获取。

XPP 脚本包支持哪些脚本?

XPP 脚本包中支持的可执行服务脚本格式有: .lua.xxt. 脚本从脚本包中获取资源与配置, 与单独运行并无太大区别. 如需指定 XPP 脚本包的入口脚本, 参见 Info.lua 的 Executable 字段.

如何指定 XPP 的配置界面?

如需指定 XPP 脚本包配置时的配置界面文件, 参见 Info.lua 的 MainInterfaceFile 字段. 如需编写配置界面 XUI 文件, 参见 XUI 界面库使用手册.

如何处理 XPP 中的资源?

  • XPP 脚本包中的脚本/资源/模块/数据需放置于 XPP 目录中, 通过相对路径访问.
  • XPP 脚本包运行时所产生的临时文件/数据, 请勿存放在 XPP 脚本包中, 应存放于 XXTouch 缓存目录、临时目录等位置.

在脚本中,XPP 脚本包中的资源路径,可通过 XPP 脚本包模块 获取。