앱 기본 정보 및 환경체크 | Appbox Android SDK 가이드
기기 기능
앱 내 데이터 가져오기
네이티브 영역에 저장된 값을 읽습니다. 웹과 네이티브가 공유하는 값을 가져올 때 사용합니다.
get(key, callback)
호출 형태: 패턴 B(인자 있는 값 조회).
앱 내에 데이터를 가져오기
Request 항목 정의
| Request 항목 | 필수여부 | 설명 | 기본값 |
|---|---|---|---|
key | 필수 | 가져올 데이터의 키 | - |
Response 항목 정의
| Response 결과값 | |
|---|---|
| 값 | 저장된 값 (String). 값이 없으면 빈 문자열 |
웹 브릿지에서는 앱 내 데이터 가져오기의 storage.get입니다.
AppBox Project Id
getAppId(callback)
호출 형태: 패턴 A(인자 없는 값 조회).
AppBox Project Id 가져오기
Request 항목 정의
| Request 항목 | 필수여부 | 설명 | 기본값 |
|---|---|---|---|
| - | - | 별도 요청 항목 없음 | - |
Response 항목 정의
| Response 결과값 | |
|---|---|
| 값 | AppBox project ID (String). 설정되지 않았으면 빈 문자열 |
웹 브릿지에서는 appbox.getAppId입니다.
앱 이름
getAppName(callback)
호출 형태: 패턴 A(인자 없는 값 조회).
앱 이름 가져오기
Request 항목 정의
| Request 항목 | 필수여부 | 설명 | 기본값 |
|---|---|---|---|
| - | - | 별도 요청 항목 없음 | - |
Response 항목 정의
| Response 결과값 | |
|---|---|
| 값 | 앱 이름 (String). 예: 모두의 배달 |
웹 브릿지에서는 앱 이름의 application.getAppName입니다.
앱 버전
getAppVersion(callback)
호출 형태: 패턴 A(인자 없는 값 조회).
앱 버전
Request 항목 정의
| Request 항목 | 필수여부 | 설명 | 기본값 |
|---|---|---|---|
| - | - | 별도 요청 항목 없음 | - |
Response 항목 정의
| Response 결과값 | |
|---|---|
| 값 | 앱 버전 (String). 예: 1.0.5 |
웹 브릿지에서는 앱 버전의 application.getAppVersion입니다.
배터리 상태
getBatteryLevel(callback)
호출 형태: 패턴 A(인자 없는 값 조회).
배터리 잔량 가져오기
Request 항목 정의
| Request 항목 | 필수여부 | 설명 | 기본값 |
|---|---|---|---|
| - | - | 별도 요청 항목 없음 | - |
Response 항목 정의
| Response 결과값 | |
|---|---|
| 값 | 배터리 잔량 (Float). 예: 75 |
배터리 정보를 읽지 못하면 error 없이 value가 null로 옵니다. value를 반드시 확인하세요.
웹 브릿지에서는 배터리 상태의 application.getBatteryLevel입니다.
클립보드 가져오기
getClipBoard(callback)
호출 형태: 패턴 A(인자 없는 값 조회).
클립보드 가져오기
Request 항목 정의
| Request 항목 | 필수여부 | 설명 | 기본값 |
|---|---|---|---|
| - | - | 별도 요청 항목 없음 | - |
Response 항목 정의
| Response 결과값 | |
|---|---|
| 값 | 클립보드에 저장된 값 (String). 비어 있으면 빈 문자열 |
웹 브릿지에서는 클립보드 가져오기의 application.getClipBoard입니다.
사용 언어
getCurrentLanguage(callback)
호출 형태: 패턴 A(인자 없는 값 조회).
사용 언어 가져오기
Request 항목 정의
| Request 항목 | 필수여부 | 설명 | 기본값 |
|---|---|---|---|
| - | - | 별도 요청 항목 없음 | - |
Response 항목 정의
| Response 결과값 | |
|---|---|
| 값 | 언어 코드 (String). 예: ko, en |
언어 코드만 반환합니다. 국가 코드는 포함되지 않습니다.
웹 브릿지에서는 사용 언어의 application.getCurrentLanguage입니다.
AppBox Device Info
getDeviceInfo(callback)
호출 형태: 패턴 E(Map 반환).
AppBox Device Info 가져오기
Request 항목 정의
| Request 항목 | 필수여부 | 설명 | 기본값 |
|---|---|---|---|
| - | - | 별도 요청 항목 없음 | - |
Response 항목 정의
| Response 결과값 | |
|---|---|
| 값 | Map<String, String>: 키는 deviceUserId, pushToken 두 개이며 항상 존재합니다 |
Push token이 없어도 실패가 아니라 빈 문자열입니다 (appbox-push 미포함, 미초기화, 발급 실패 모두 동일).
웹 브릿지에서는 appbox.getDeviceInfo입니다.
디바이스 모델
getDeviceModel(callback)
호출 형태: 패턴 A(인자 없는 값 조회).
디바이스 모델 가져오기
Request 항목 정의
| Request 항목 | 필수여부 | 설명 | 기본값 |
|---|---|---|---|
| - | - | 별도 요청 항목 없음 | - |
Response 항목 정의
| Response 결과값 | |
|---|---|
| 값 | 기기 모델명 (String) |
Build.MODEL 값입니다. 마케팅 제품명과 다를 수 있습니다.
웹 브릿지에서는 디바이스 모델의 application.getDeviceModel입니다.
OS 버전
getOSVersion(callback)
호출 형태: 패턴 A(인자 없는 값 조회).
OS 버전 가져오기
Request 항목 정의
| Request 항목 | 필수여부 | 설명 | 기본값 |
|---|---|---|---|
| - | - | 별도 요청 항목 없음 | - |
Response 항목 정의
| Response 결과값 | |
|---|---|
| 값 | OS 버전 문자열 (String). 예: 14 |
Build.VERSION.RELEASE 값입니다. API level이 아닙니다.
웹 브릿지에서는 OS 버전의 application.getOSVersion입니다.
패키지 명
getPackageName(callback)
호출 형태: 패턴 A(인자 없는 값 조회).
패키지 명 가져오기
Request 항목 정의
| Request 항목 | 필수여부 | 설명 | 기본값 |
|---|---|---|---|
| - | - | 별도 요청 항목 없음 | - |
Response 항목 정의
| Response 결과값 | |
|---|---|
| 값 | 패키지 명 (String). 예: com.company.service |
웹 브릿지에서는 패키지 명의 application.getPackageName입니다.
SDK 버전
getSDKVersion(callback)
호출 형태: 패턴 A(인자 없는 값 조회).
SDK 버전 가져오기
Request 항목 정의
| Request 항목 | 필수여부 | 설명 | 기본값 |
|---|---|---|---|
| - | - | 별도 요청 항목 없음 | - |
Response 항목 정의
| Response 결과값 | |
|---|---|
| 값 | AppBox SDK 버전 (String) |
설치 확인의 3층 진단에서 파이프라인 전체 동작 검증에 쓰입니다. 이 콜백이 응답하면 기기 기능 파이프라인이 동작하는 것입니다.
웹 브릿지에서는 SDK 버전의 application.getSDKVersion입니다.
디바이스 타입
getType(callback)
호출 형태: 패턴 A(인자 없는 값 조회).
디바이스 타입 (Android, iOS)
Request 항목 정의
| Request 항목 | 필수여부 | 설명 | 기본값 |
|---|---|---|---|
| - | - | 별도 요청 항목 없음 | - |
Response 항목 정의
| Response 결과값 | |
|---|---|
| 값 | 디바이스 타입 (String). 네이티브 호출에서는 항상 "Android" |
웹 브릿지에서는 디바이스 타입의 application.getType입니다.
안드로이드 여부
isAndroid(callback)
호출 형태: 패턴 A(인자 없는 값 조회).
안드로이드 인지 여부를 체크
Request 항목 정의
| Request 항목 | 필수여부 | 설명 | 기본값 |
|---|---|---|---|
| - | - | 별도 요청 항목 없음 | - |
Response 항목 정의
| Response 결과값 | |
|---|---|
| 값 | Boolean. 네이티브 호출에서는 항상 true |
웹 브릿지에서는 안드로이드 여부의 application.isAndroid입니다.
앱 최초 실행 여부
isFirstInstallLaunch(callback)
호출 형태: 패턴 A(인자 없는 값 조회).
앱 최초 실행 인지 확인
Request 항목 정의
| Request 항목 | 필수여부 | 설명 | 기본값 |
|---|---|---|---|
| - | - | 별도 요청 항목 없음 | - |
Response 항목 정의
| Response 결과값 | |
|---|---|
| 값 | 설치 후 첫 실행 여부 (Boolean) |
1회성입니다. 읽는 즉시 값이 소비되어 다음 호출부터 false가 됩니다. 여러 곳에서 호출하지 말고 한 번 읽어 앱이 보관하세요.
웹 브릿지에서는 앱 최초 실행 여부의 application.isFirstInstallLaunch입니다.
앱 실행 세션 최초 여부
isFirstSessionLaunch(callback)
호출 형태: 패턴 A(인자 없는 값 조회).
앱 실행 세션 최초 여부를 체크
Request 항목 정의
| Request 항목 | 필수여부 | 설명 | 기본값 |
|---|---|---|---|
| - | - | 별도 요청 항목 없음 | - |
Response 항목 정의
| Response 결과값 | |
|---|---|
| 값 | 세션 첫 실행 여부 (Boolean) |
1회성입니다. 읽는 즉시 값이 소비되어 다음 호출부터 false가 됩니다. 여러 곳에서 호출하지 말고 한 번 읽어 앱이 보관하세요.
웹 브릿지에서는 앱 실행 세션 최초 여부의 application.isFirstSessionLaunch입니다.
아이폰 여부
isIOS(callback)
호출 형태: 패턴 A(인자 없는 값 조회).
아이폰 인지 여부를 체크
Request 항목 정의
| Request 항목 | 필수여부 | 설명 | 기본값 |
|---|---|---|---|
| - | - | 별도 요청 항목 없음 | - |
Response 항목 정의
| Response 결과값 | |
|---|---|
| 값 | Boolean. 네이티브 호출에서는 항상 false |
웹 브릿지에서는 아이폰 여부의 application.isIOS입니다.
앱 내 데이터 삭제
remove(key, callback)
호출 형태: 패턴 B(인자 있는 값 조회).
앱에 저장된 데이터 삭제
Request 항목 정의
| Request 항목 | 필수여부 | 설명 | 기본값 |
|---|---|---|---|
key | 필수 | 삭제할 데이터의 키 | - |
Response 항목 정의
| Response 결과값 | |
|---|---|
| 값 | 성공 여부 (Boolean) |
웹 브릿지에서는 앱 내 데이터 삭제의 storage.remove입니다.
앱 내 데이터 저장
set(key, value, callback)
호출 형태: 패턴 B(인자 있는 값 조회).
앱 내에 데이터를 저장
Request 항목 정의
| Request 항목 | 필수여부 | 설명 | 기본값 |
|---|---|---|---|
key | 필수 | 저장할 데이터의 키 | - |
value | 필수 | 저장할 값 | - |
Response 항목 정의
| Response 결과값 | |
|---|---|
| 값 | 성공 여부 (Boolean) |
| 오류 코드 | -2000: key 또는 value 누락 |
웹 브릿지에서는 앱 내 데이터 저장의 storage.set입니다.
클립보드 저장
setClipBoard(message, callback)
호출 형태: 패턴 C(인자 있는 동작).
클립보드에 저장하기
Request 항목 정의
| Request 항목 | 필수여부 | 설명 | 기본값 |
|---|---|---|---|
message | 필수 | 클립보드에 저장할 내용 | - |
Response 항목 정의
| Response 결과값 | |
|---|---|
| 값 | 성공 여부 (Boolean) |
Android 13 이상에서는 민감 정보 플래그가 설정되어 클립보드 미리보기에 내용이 표시되지 않습니다.
웹 브릿지에서는 클립보드 저장의 application.setClipBoard입니다.