Appbox SDK 초기 설정 | Android·iOS 연동 시작 방법

SDK 가이드

클라우드 빌드 앱 SDK 연동 가이드

앱박스 SDK는 네이티브 기능 탭 메뉴, 생체 인증, 걸음 수, QR 인식 등 50여 개 기능을 사용하기위해서는 가이드에 따라 연동이 필요합니다.




Bridge를 통해 JavaScript 몇 줄만으로 웹에서 네이티브 기능을 실행하고 결과를 전달받을 수 있습니다.
flow


앱박스 SDK 샘플 소스를 다운로드하여 직접 빌드할 수 있습니다.







초기 설정 방법

아래 처럼 따라하면 쉽게 연동 및 테스트할 수 있습니다.

1

JavaScript 선언

(필수) 사이트의 <head>와 </head> 사이에 아래 스크립트를 추가하세요.

Javascript
1 <script src="https://console.appboxapp.com/import/appbox.v3.js"></script>
2

2

기능 실행

(옵션) 앱박스에서 제공하는 다양한 웹뷰 기능 중 고객님 사이트에 필요한 기능이 있다면 해당 기능을 사이트에 추가하세요.
예를 들어, 자동로그인에 생체인증을 추가해서 생체인증이 완료 후 최종 로그인을 완료하고 싶다면 아래처럼 생체인증 javascript 연동 코드를 넣어줍니다.

Javascript
1 // 생체인증 진행
2 AppboxSDK.application.biometricAuth(
3 {
4 haptic: true
7 }, (err, data) => {
8 if (err) {
9 console.error( "생체 인증 실패:", "code:", err.code, "message:", err.message ); // 생체인증 실패 메시지. 다음 프로세스
10 } else {
11 console.log( "생체 인증 OK:", "result:", data.result ); // 생체인증 완료 후 서비스 진입.
12 }
13 }
14 );

3

코드 분기

(옵션) 웹에서 동작하는 기존 기능과 AppBox 기능을 분리해야 하는 경우, 아래와 같이 분기하여 실행할 수 있습니다.
기존 모바일 웹브라우저가 아닌 AppBox 환경에서만 실행해야 할 때 isAppBoxSDK()로 분기하세요.

Javascript
1 // Appbox SDK WebView 환경 여부 체크
2 if(AppboxSDK.application.isAppBoxSDK()){
3 console.log("앱박스 SDK에서 실행");
4 } else {
5 console.error("앱박스 SDK가 아님");
6 };

4

앱빌드

(필수) 앱박스 콘솔에 로그인하여 앱 아이콘, 앱 이름, 사이트 주소만 입력하여 앱을 빌드 합니다.

Android 앱 빌드

iOS 앱 빌드

5

앱 테스트

(옵션) 푸시 메시지, 인앱 메시지를 정상적으로 수신하는지, 웹 앱 기능이 정상적으로 동작하는지 테스트 합니다.
푸시 메시지, 인앱 메시지 발송은 별다른 설정없이 빌드하고 설치하여 바로 발송 테스트 할 수 있습니다. Free 사용자도 일정 한도 내에서 발송 가능합니다.

푸시 메시지 수신 테스트,     인앱 메시지 수신 테스트,     웹 앱 기능 테스트




6

앱 심사요청

(필수) 앱을 마켓에 심사 요청합니다. 직접 심사요청이 어려운 경우, 문의를 통해 의뢰하세요. 최단 기간 내에 앱을 마켓에 출시할 수 있습니다.

앱 데모체험
지금 웹사이트 주소를 입력하고
데모 앱을 체험해 보세요!
앱으로 바꾸고 싶은 당신의 웹사이트 주소를 입력해 보세요. 즉각 체험할 수 있는 데모 앱을 받을 수 있습니다.

QR 코드
QR 코드를 찍고 앱으로 바뀐
웹사이트를 지금 바로 확인해 보세요!
www.naver.com
QR 코드를 촬영하면 입력하신 주소의
앱 예시 화면을 테스트할 수 있습니다.
* 스캔 후 바로 앱 다운로드 이동합니다.