3단계: 초기화 | 시작하기 | Appbox iOS SDK 가이드

3단계: 초기화

(필수) 초기화는 앱 시작 시 한 번, AppDelegate의 didFinishLaunchingWithOptions에서 진행합니다. common은 필수이고, 나머지 설정은 1단계에서 추가한 Product에 맞춰 넣습니다.

3단계: 초기화

Swift
1 import AppBoxSDK
2
3 func application(
4 _ application: UIApplication,
5 didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?
6 ) -> Bool {
7 let config = AppBoxInitConfig(
8 common: AppBoxCommonConfig(
9 projectId: "<PROJECT_ID>" // AppBox 콘솔에서 발급
10 ),
11 webView: AppBoxWebViewConfig(
12 baseURL: "https://service.example.com" // 관리 화면이 처음 여는 HTTPS 주소
13 ),
14 push: AppBoxPushConfig()
15 )
16 AppBox.initialize(config) { result in
17 // 모듈별 status: .INITIALIZED / .SKIPPED / .FAILED
18 // 해석은 SDK 초기화 페이지 참고
19 }
20 return true
21 }
1 @import AppBoxSDK;
2
3 - (BOOL)application:(UIApplication *)application
4 didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {
5 AppBoxCommonConfig *common =
6 [[AppBoxCommonConfig alloc] initWithProjectId:@"<PROJECT_ID>" // AppBox 콘솔에서 발급
7 debugMode:NO];
8 AppBoxWebViewConfig *webView =
9 [[AppBoxWebViewConfig alloc] initWithBaseURL:@"https://service.example.com"
10 webConfig:[[AppBoxWebConfig alloc] init]];
11 AppBoxInitConfig *config =
12 [[AppBoxInitConfig alloc] initWithCommon:common
13 webView:webView
14 push:[[AppBoxPushConfig alloc] init]
15 inApp:[[AppBoxInAppConfig alloc] init]
16 auth:nil
17 appsFlyer:nil
18 initializationTimeout:30];
19
20 [AppBox initializeWithConfig:config completion:^(AppBoxInitResult *result) {
21 // 모듈별 status: INITIALIZED / SKIPPED / FAILED: 해석은 SDK 초기화 페이지 참고
22 }];
23 return YES;
24 }

AppBox 관리 화면을 쓰지 않는 앱은 webView를 넣지 않습니다. 선택 인자라 생략하면 되고, 푸시, 인앱, 로그인, 걸음 수, 기기 기능은 그대로 동작합니다.

초기화 전에 부른 기능 함수는 앱을 중단시키지 않고 NSError나 false로 실패합니다. 앱 시작 직후 SDK 기능을 쓰는 앱이라면 초기화 완료 callback 이후로 호출을 미루세요.

Firebase

GoogleService-Info.plist는 넣지 않아도 됩니다. AppBox 콘솔에 Firebase 설정이 등록돼 있으면, SDK가 프로젝트 ID와 Bundle ID로 설정을 받아 Firebase를 초기화합니다. 앱이 Firebase를 직접 관리할 때만 plist를 넣습니다.

앱이 이미 FirebaseApp.configure()를 호출한다면 AppBox 초기화 전에 끝내세요. SDK가 기존 FirebaseApp을 재사용합니다. 두 경로로 중복 초기화하지 마세요.

AppDelegate 전체 예제는 AppBoxSampleiOS에서 확인할 수 있습니다. 인자 전체와 반환값 해석은 SDK 초기화 페이지가 정본입니다. SNS 로그인, AppsFlyer 설정값은 각 장에서 다룹니다.
www.naver.com
QR 코드를 촬영하면 입력하신 주소의
앱 예시 화면을 테스트할 수 있습니다.
* 스캔 후 바로 앱 다운로드 이동합니다.