확장 프로그램 버전 가져오기 설명서
이 문서는 특정 확장 프로그램의 버전을 가져오는 함수인 extension_get_version에 대해 설명합니다. 이 함수는 주어진 이름의 확장 자산의 버전을 "주요.부.수정" 형식의 문자열로 반환합니다.
함수 문법
extension_get_version(ext_name);
인수 설명
| 인수 이름 | 유형 | 설명 |
|---|---|---|
| ext_name | String | 확장 프로그램의 이름 |
반환 값
- String: 확장 프로그램의 버전 문자열 ("주요.부.수정" 형식)
예제 코드
아래의 예제는 "MyExtension"이라는 이름의 확장 프로그램의 버전을 가져오는 방법을 보여줍니다.
var _version_string = extension_get_version("MyExtension");
var _values = string_split(_version_string, ".");
var _major = _values[0], _minor = _values[1], _revision = _values[2];
show_debug_message($"Version: {_version_string}\nMajor: {_major}\nMinor: {_minor}\nRevision: {_revision}");
if (_major < 1) {
show_debug_message("At least version 1 of the extension is required.");
game_end();
}
이 코드는 다음과 같이 작동합니다:
extension_get_version함수를 호출하여 "MyExtension"의 버전 번호를 포함하는 문자열을 가져옵니다.- 반환된 값을
_version_string변수에 저장합니다. string_split함수를 사용하여_version_string을 "."로 나누어 주요 버전, 부 버전 및 수정 번호를 얻습니다.- 각 버전 번호는
_major,_minor,_revision변수에 할당됩니다. - 디버그 메시지를 통해 이 정보를 출력합니다.
- 주요 버전 번호를 확인하여 1보다 작으면 게임을 종료합니다.
활용 및 응용 예제
- 버전 확인 후 추가 기능 활성화
var _version_string = extension_get_version("MyExtension");
var _values = string_split(_version_string, ".");
var _major = _values[0];
if (_major >= 2) {
// 버전 2 이상의 기능 활성화
enable_new_feature();
} else {
show_debug_message("이 기능은 버전 2 이상에서만 사용할 수 있습니다.");
}
- 업데이트 확인
var _version_string = extension_get_version("MyExtension");
if (_version_string != "2.0.0") {
show_debug_message("업데이트가 필요합니다. 현재 버전: " + _version_string);
}
- 조건부 메시지 출력
var _version_string = extension_get_version("MyExtension");
var _values = string_split(_version_string, ".");
var _minor = _values[1];
if (_minor < 1) {
show_debug_message("이 확장 프로그램의 부 버전이 오래되었습니다.");
}
결론
이 문서에서는 extension_get_version 함수를 사용하여 확장 프로그램의 버전을 가져오는 방법 및 그 활용 예제를 다루었습니다. 이 기능을 통해 확장 프로그램의 유효성을 체크하고, 필요한 경우 기능을 활성화하거나 업데이트 알림을 제공할 수 있습니다.