Métadonnées
Un paquet de scripts XPP doit contenir un script nommé Info.lua, qui renvoie une constante de table Lua décrivant les métadonnées du paquet d’application de scripts actuel. Il ne doit généralement pas contenir de code Lua en dehors des valeurs constantes.
Voici un exemple typique 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 table renvoyée par Info.lua contient généralement les paires clé-valeur suivantes ; leur explication détaillée figure dans les sous-sections correspondantes :
| Clé | Obligatoire | Recommandé | Description |
|---|---|---|---|
| BundleIdentifier | * | * | Identifiant unique |
| BundleVersion | * | * | Numéro de version |
| BundleName | * | * | Nom |
| Executable | * | Nom du fichier de script d’entrée exécutable ( .lua, .xxt ) | |
| BundleDisplayName | * | Nom d’affichage | |
| BundleIconFile | * | Icône de l’application | |
| MainInterfaceFile | * | Nom du fichier de configuration d’entrée XUI ( .xui, .xuic ) | |
| MinimumSystemVersion | Version minimale du système requise | ||
| MaximumSystemVersion | Version maximale du système requise | ||
| MinimumXXTVersion | Version minimale de XXTouch requise | ||
| SupportedResolutions | Tableau des résolutions d’appareil prises en charge | ||
| PackageControl | Informations supplémentaires |
Il est recommandé de fournir autant d’informations que possible. Un nom d’affichage, une icône d’application et une interface de configuration complets améliorent l’aspect général et la reconnaissance du script.
Dans un script, les constantes de Info.lua peuvent être obtenues via le module de paquet de scripts XPP.
Quels scripts un paquet XPP prend-il en charge ?
Les formats de scripts exécutables pris en charge par un paquet XPP sont .lua et .xxt. Le script obtient ses ressources et sa configuration depuis le paquet, sans différence notable avec une exécution autonome. Pour indiquer le script d’entrée, consultez le champ Executable de Info.lua.
Comment définir l’interface de configuration de XPP ?
Pour définir le fichier d’interface de configuration du paquet XPP, consultez le champ MainInterfaceFile de Info.lua. Pour écrire un fichier d’interface XUI, consultez le manuel de la bibliothèque d’interface XUI.
Comment gérer les ressources dans XPP ?
- Les scripts, ressources, modules et données du paquet XPP doivent être placés dans le répertoire XPP et accessibles par des chemins relatifs.
- Les fichiers et données temporaires produits lors de l’exécution du paquet XPP ne doivent pas être placés dans le paquet ; stockez-les dans le cache XXTouch, le répertoire temporaire ou un emplacement similaire.
Dans un script, les chemins des ressources du paquet XPP peuvent être obtenus via le module de paquet de scripts XPP.