Metadaten
Ein XPP-Skriptpaket benötigt ein Skript namens Info.lua, das eine Lua-Tabellenkonstante mit den Metadaten des aktuellen Skript-App-Pakets zurückgibt. Es sollte normalerweise außer Konstanten keine weiteren Lua-Anweisungen enthalten.
Beispiel für eine typische 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";
};
};
Die von Info.lua zurückgegebene Tabelle enthält normalerweise die folgenden Schlüssel-Wert-Paare. Einzelheiten zu jedem Paar finden Sie in den jeweiligen Unterkapiteln:
| Schlüssel | Erforderlich | Empfohlen | Beschreibung |
|---|---|---|---|
| BundleIdentifier | * | * | Eindeutiger Bezeichner |
| BundleVersion | * | * | Versionsnummer |
| BundleName | * | * | Name |
| Executable | * | Name der ausführbaren Einstiegsskriptdatei ( .lua, .xxt ) | |
| BundleDisplayName | * | Anzeigename | |
| BundleIconFile | * | App-Symbol | |
| MainInterfaceFile | * | Name der XUI-Einstiegskonfigurationsdatei ( .xui, .xuic ) | |
| MinimumSystemVersion | Anforderung an die minimale Systemversion | ||
| MaximumSystemVersion | Anforderung an die maximale Systemversion | ||
| MinimumXXTVersion | Anforderung an die minimale XXTouch-Version | ||
| SupportedResolutions | Array unterstützter Geräteauflösungen | ||
| PackageControl | Zusatzinformationen |
Es wird empfohlen, diese Informationen möglichst vollständig anzugeben. Ein vollständiger Anzeigename, ein App-Symbol und eine Konfigurationsoberfläche verbessern den Gesamteindruck und die Akzeptanz des Skripts.
Die Konstanten aus Info.lua können im Skript über das XPP-Skriptpaketmodul abgerufen werden.
Welche Skripte unterstützt ein XPP-Skriptpaket?
Die unterstützten ausführbaren Skriptformate sind .lua und .xxt. Skripte beziehen Ressourcen und Konfigurationen aus dem Skriptpaket und unterscheiden sich beim Ausführen nicht wesentlich von einzeln ausgeführten Skripten. Um ein Einstiegsskript festzulegen, siehe das Feld Executable in Info.lua.
Wie wird die Konfigurationsoberfläche eines XPP festgelegt?
Um die Konfigurationsoberflächendatei eines XPP-Skriptpakets festzulegen, siehe das Feld MainInterfaceFile in Info.lua. Zum Erstellen einer XUI-Konfigurationsdatei siehe das XUI-Handbuch.
Wie werden Ressourcen in XPP behandelt?
- Skripte, Ressourcen, Module und Daten eines XPP-Skriptpakets müssen im XPP-Verzeichnis abgelegt und über relative Pfade aufgerufen werden.
- Temporäre Dateien und Daten, die während der Ausführung des XPP-Skriptpakets entstehen, dürfen nicht im XPP-Skriptpaket gespeichert werden. Legen Sie sie stattdessen im XXTouch-Cacheverzeichnis, im temporären Verzeichnis oder an einem ähnlichen Ort ab.
Der Pfad zu Ressourcen im XPP-Skriptpaket kann im Skript über das XPP-Skriptpaketmodul abgerufen werden.