跳到主要内容

元信息

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。脚本从脚本包中获取资源与配置,与单独运行并无显著区别。如需指定入口脚本,参见 Info.lua 的 Executable 字段。

如何指定 XPP 的配置界面?

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

如何处理 XPP 中的资源?

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

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