앱 업데이트 | 사용자 경험, 알림, 인터랙션 | Appbox SDK 가이드
앱 업데이트
앱스토어에 새 버전의 앱이 있다면 업데이트 팝업을 띄워 사용자가 최신 버전으로 업데이트 하도록 유도할 수 있으며, 사용자에게 선택적으로 ‘권장 업데이트’로 노출하거나, 또는 필수로 업데이트를 요청하는 ‘강제 업데이트’ 방식으로 설정할 수 있습니다.
앱을 최신 버전으로 업데이트
AppboxSDK.application.updatePrompt(...)
Javascript
1
// 앱 업데이트 팝업
2
AppboxSDK.application.updatePrompt(
3
{
4
require: false,
5
message: "마켓에 새로운 버전이 있습니다. 업데이트하시겠어요?",
6
appStore: "https://apps.apple.com/app/id1234567890",
7
googlePlay: "https://play.google.com/store/apps/details?id=com.example.app",
8
updateButton: "업데이트",
9
cancelButton: "나중에",
10
updateAlert: true
11
}, (err, data) => {
12
if (err) {
13
console.error(
"업데이트 안내(권장) 실패:",
"code:", err.code,
"message:", err.message
);
14
} else {
15
console.log(
"업데이트 안내(권장) OK:",
data.result
);
16
}
17
});
Request 항목 정의
| Request 항목 | 필수여부 | 설명 | 기본값 | |
|---|---|---|---|---|
| require | 필수 | true :강제, false : 권장 (새로운 버전을 업데이트 하지 않으면 앱 진입을 들어가지 못하도록 강제하거나, 업데이트를 권장만 하고 앱 진입은 가능하도록 할 수 있습니다.) | ||
| message | 필수 | 업데이트 메시지, 예) "마켓에 새로운 버전이 있습니다. 업데이트하여 주세요." | ||
| appStore | 필수 | 애플 앱스토어 앱 다운로드 URL 입력 - ex) https://apps.apple.com/kr/app/id{Apple ID} - Apple ID 확인 방법 : https://apps.apple.com/kr/iphone/charts (위 링크에서 해당 앱을 검색하여 URL 링크에서 Apple ID를 확인하세요.) |
||
| googlePlay | 필수 | 구글 플레이 앱 다운로드 URL 입력 - ex) https://play.google.com/store/apps/details?id={패키지명} - 패키지명 확인 방법 : https://play.google.com (위 링크에서 해당 앱을 검색하여 URL 링크에서 패키지명을 확인하세요.) |
||
| updateButton | 필수 | 업데이트 버튼의 텍스트 ex) 업데이트 하기, 앱 업데이트 | ||
| cancelButton | - | 취소 버튼의 텍스트 (require 항목의 값이 false 일때 필수) ex) 다음에, 그냥 입장 | ||
| updateAlert | - | 업데이트가 필요할때 메시지얼럿을 어디서 띄울지 선택 (true : AppBox에서 띄움, false : 웹에서 띄움). 웹에서 업데이트 화면을 직접 그릴 때만 false 로 하세요. | true | |
Response 항목 정의
| Response 결과값 | |
|---|---|
| data.result | 성공 여부 (true | false) |
| err.code | 에러코드 ( -6000 : 마켓에 해당 앱이 존재 하지 않음, 마켓에 등록하지 않은 상태에서 테스트하는 경우 발생) |
| err.message | 에러 메시지 |
updateAlert: false 일 때 data.result 의 뜻이 OS 마다 반대입니다. Android: true = 업데이트 있음, iOS: false = 업데이트 필요. application.isIOS 로 OS 를 확인해 나눠 처리하세요. 스토어에 앱이 없으면 -6000 입니다.