Метаданные
В пакете скриптов 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. Скрипт получает ресурсы и конфигурацию из пакета; существенных отличий от отдельного запуска нет. Чтобы указать входной скрипт, см. поле Executable файла Info.lua.
Как указать интерфейс конфигурации XPP?
Чтобы указать файл интерфейса при настройке пакета скриптов XPP, см. поле MainInterfaceFile файла Info.lua. Инструкции по созданию файла интерфейса конфигурации XUI см. в руководстве по библиотеке интерфейса XUI.
Как работать с ресурсами в XPP?
- Скрипты, ресурсы, модули и данные пакета скриптов XPP должны находиться в каталоге XPP и открываться по относительным путям.
- Не сохраняйте временные файлы и данные, создаваемые во время работы пакета скриптов XPP, в самом пакете. Используйте каталог кэша XXTouch, временный каталог и другие подобные места.
Путь к ресурсу пакета скриптов XPP в скрипте можно получить с помощью модуля пакета скриптов XPP.