메타데이터
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 스크립트 패키지 모듈을 통해 가져올 수 있습니다.