Siêu dữ liệu

Gói XPP phải chứa một kịch bản tên là Info.lua, trả về một hằng bảng Lua mô tả siêu dữ liệu của gói. Tệp này không nên chứa logic thực thi ngoài các hằng số.

Ví dụ Info.lua điển hình:

return {
    BundleIdentifier = "com.yourcompany.yourscript";
    BundleVersion = "0.0.1";
    BundleName = "Tên của bạn";
    BundleDisplayName = "Tên hiển thị của bạn";
    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";
    };
};

Bảng được trả về thường chứa các khóa sau. Xem các trang con để biết chi tiết:

Khóa	Bắt buộc	Khuyến nghị	Mô tả
BundleIdentifier	*	*	Mã định danh duy nhất
BundleVersion	*	*	Phiên bản
BundleName	*	*	Tên
Executable		*	Tên tệp kịch bản điểm vào (.lua, .xxt)
BundleDisplayName		*	Tên hiển thị
BundleIconFile		*	Biểu tượng ứng dụng
MainInterfaceFile		*	Cấu hình điểm vào XUI (.xui, .xuic)
MinimumSystemVersion			Phiên bản iOS tối thiểu
MaximumSystemVersion			Phiên bản iOS tối đa
MinimumXXTVersion			Phiên bản XXTouch tối thiểu
SupportedResolutions			Độ phân giải thiết bị được hỗ trợ
PackageControl			Thông tin bổ sung

Nên điền các mục này đầy đủ nhất có thể. Tên hiển thị, biểu tượng và giao diện cấu hình phù hợp sẽ cải thiện giao diện, trải nghiệm và mức độ chấp nhận kịch bản.

Trong kịch bản, có thể đọc các hằng từ Info.lua thông qua mô-đun gói XPP.

XPP hỗ trợ những định dạng kịch bản nào?

Các định dạng kịch bản thực thi được hỗ trợ trong gói XPP là .lua và .xxt. Kịch bản truy cập tài nguyên và cấu hình trong gói bằng đường dẫn tương đối. Để chỉ định kịch bản điểm vào, xem Executable.

Cách chỉ định giao diện cấu hình XPP

Để chỉ định trang cấu hình được mở từ XXTouch, hãy đặt MainInterfaceFile. Để viết giao diện cấu hình, xem Hướng dẫn XUI.

Cách quản lý tài nguyên trong XPP

• Đặt kịch bản, tài nguyên, mô-đun và dữ liệu trong thư mục XPP, rồi truy cập chúng bằng đường dẫn tương đối.
• Không ghi tệp hoặc dữ liệu tạm thời vào gói XPP khi chạy; thay vào đó, hãy dùng các thư mục bộ nhớ đệm hoặc thư mục tạm của XXTouch.

Trong kịch bản, có thể lấy đường dẫn tài nguyên từ mô-đun gói XPP.