メタ情報
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 です。スクリプトがスクリプトパッケージからリソースや設定を取得する点を除き、単独で実行する場合との大きな違いはありません。エントリスクリプトを指定するには、Info.lua の Executable フィールドを参照してください。
XPP の設定画面を指定するには？
XPP スクリプトパッケージを設定するときに使用する設定画面ファイルを指定するには、Info.lua の MainInterfaceFile フィールドを参照してください。設定画面用の XUI ファイルを作成する場合は、XUI インターフェースライブラリ利用マニュアルを参照してください。
XPP 内のリソースを扱うには？
- XPP スクリプトパッケージ内のスクリプト、リソース、モジュール、データは XPP ディレクトリに配置し、相対パスでアクセスしてください。
- XPP スクリプトパッケージの実行時に生成される一時ファイルやデータは、XPP スクリプトパッケージ内に保存しないでください。XXTouch のキャッシュディレクトリや一時ディレクトリなどに保存してください。
スクリプト内では、XPP スクリプトパッケージモジュールを使用して、XPP スクリプトパッケージ内のリソースパスを取得できます。