Metadados
Um pacote de scripts XPP precisa de um script chamado Info.lua, que retorna uma constante de tabela Lua usada para descrever os metadados do pacote de scripts atual. Em geral, ele não deve conter código Lua além dos valores constantes.
Este é um exemplo típico de 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";
};
};
A tabela retornada por Info.lua normalmente contém os seguintes pares de chave e valor; consulte as subseções para obter uma explicação detalhada de cada um:
| Chave | Obrigatório | Recomendado | Descrição |
|---|---|---|---|
| BundleIdentifier | * | * | Identificador único |
| BundleVersion | * | * | Número da versão |
| BundleName | * | * | Nome |
| Executable | * | Nome do arquivo de script executável de entrada ( .lua, .xxt ) | |
| BundleDisplayName | * | Nome de exibição | |
| BundleIconFile | * | Ícone do aplicativo | |
| MainInterfaceFile | * | Nome do arquivo de configuração de entrada XUI ( .xui, .xuic ) | |
| MinimumSystemVersion | Requisito de versão mínima do sistema | ||
| MaximumSystemVersion | Requisito de versão máxima do sistema | ||
| MinimumXXTVersion | Requisito de versão mínima do XXTouch | ||
| SupportedResolutions | Array de resoluções compatíveis do dispositivo | ||
| PackageControl | Informações adicionais |
Recomenda-se preencher essas informações tanto quanto possível. Um nome de exibição, ícone do aplicativo e interface de configuração completos ajudam a melhorar a aparência geral e a aceitação do script.
Em um script, as informações constantes de Info.lua podem ser obtidas pelo módulo de pacotes de scripts XPP.
Quais scripts são compatíveis com um pacote XPP?
Os formatos de script executável compatíveis com um pacote XPP são .lua e .xxt. Os scripts obtêm recursos e configurações do pacote, sem diferença significativa em relação à execução independente. Para especificar o script de entrada, consulte o campo Executable de Info.lua.
Como especificar a interface de configuração do XPP?
Para especificar o arquivo da interface de configuração do pacote XPP, consulte o campo MainInterfaceFile de Info.lua. Para escrever um arquivo de interface XUI, consulte o manual da biblioteca de interface XUI.
Como lidar com recursos no XPP?
- Scripts, recursos, módulos e dados do pacote XPP devem ser colocados no diretório XPP e acessados por caminhos relativos.
- Não armazene no pacote XPP os arquivos e dados temporários gerados durante sua execução; armazene-os no diretório de cache do XXTouch, em um diretório temporário ou em outro local apropriado.
Em um script, os caminhos dos recursos do pacote XPP podem ser obtidos pelo módulo de pacotes de scripts XPP.