Metainformación
El paquete de scripts XPP necesita un script llamado Info.lua, que devuelve una constante de tipo tabla Lua para describir la metainformación del paquete actual. Normalmente no debe contener código Lua aparte de los valores constantes.
Este es un ejemplo 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";
};
};
La tabla devuelta por Info.lua suele contener los siguientes pares clave-valor. Consulta las subsecciones correspondientes para obtener una explicación detallada de cada uno:
| Clave | Obligatoria | Recomendada | Descripción |
|---|---|---|---|
| BundleIdentifier | * | * | Identificador único |
| BundleVersion | * | * | Número de versión |
| BundleName | * | * | Nombre |
| Executable | * | Nombre del archivo de script ejecutable de entrada ( .lua, .xxt ) | |
| BundleDisplayName | * | Nombre mostrado | |
| BundleIconFile | * | Icono de la aplicación | |
| MainInterfaceFile | * | Nombre del archivo de configuración de entrada XUI ( .xui, .xuic ) | |
| MinimumSystemVersion | Requisito de versión mínima del sistema | ||
| MaximumSystemVersion | Requisito de versión máxima del sistema | ||
| MinimumXXTVersion | Requisito de versión mínima de XXTouch | ||
| SupportedResolutions | Matriz de resoluciones compatibles del dispositivo | ||
| PackageControl | Información adicional |
Se recomienda completar esta información tanto como sea posible. Un nombre mostrado, un icono y una interfaz de configuración completos ayudan a mejorar la apariencia general y la aceptación del script.
Para obtener en un script la información constante de Info.lua, puedes usar el módulo del paquete de scripts XPP.
¿Qué scripts admite el paquete de scripts XPP?
El paquete de scripts XPP admite los formatos ejecutables .lua y .xxt. Los scripts obtienen los recursos y la configuración del paquete, por lo que no hay una diferencia significativa respecto a ejecutarlos por separado. Para especificar el script de entrada, consulta el campo Executable de Info.lua.
¿Cómo se especifica la interfaz de configuración de XPP?
Para especificar el archivo de interfaz al configurar un paquete de scripts XPP, consulta el campo MainInterfaceFile de Info.lua. Para escribir un archivo de interfaz XUI, consulta el manual de la biblioteca de interfaces XUI.
¿Cómo se gestionan los recursos de XPP?
- Los scripts, recursos, módulos y datos del paquete de scripts XPP deben colocarse en el directorio XPP y se accede a ellos mediante rutas relativas.
- Los archivos o datos temporales generados durante la ejecución del paquete XPP no deben guardarse en el paquete; deben guardarse en la caché de XXTouch, el directorio temporal u otra ubicación adecuada.
Para obtener en un script la ruta de un recurso del paquete XPP, puedes usar el módulo del paquete de scripts XPP.