1단계: 패키지와 Product 추가 | 시작하기 | Appbox iOS SDK 가이드
1단계: 패키지와 Product 추가
1.4.0). 4. Add Package를 누르면 Product 선택 창이 뜹니다. 사용할 Product만 체크하고 Add to Target에서 앱 target을 고릅니다.
1단계: 패키지와 Product 추가
저장소 이름은 AppBoxSDKFramwork입니다. Framework로 고쳐 입력하면 패키지를 찾지 못합니다.
1.4.0). 공개 저장소라 별도 인증은 필요 없습니다.
Product 선택
| Product | 필요한 경우 | 없으면 |
|---|---|---|
AppBoxSDK | 관리 화면, 웹 브릿지, 기기 기능 47개 | import AppBoxSDK 컴파일 실패 |
AppBoxPushSDK | 푸시 알림 | Push 함수가 실패로 응답 (빌드는 성공) |
AppBoxInappMessageSDK | 네이티브 인앱 메시지 | 인앱 미표시: AppBoxInitResult.inApp.status로 확인 |
AppBoxHealthSDK | 걸음 수 | 걸음 수 조회 실패, isHealthAvailable() == false |
AppBoxSnsLoginSDK | SNS 로그인 | 로그인 실패, isAuthAvailable(...) == false |
Push, In-App, Auth, Health 함수의 선언은 AppBoxSDK에 있어 해당 Product 없이도 컴파일되고 호출까지 됩니다. 실행 모듈이 없으면 앱을 중단시키지 않고 NSError, false, 빈 결과로 실패합니다. 빌드 성공이 동작을 보장하지 않는 지점입니다.
AppBoxPushSDK는 AppBoxSDK에 포함되지 않습니다. 서로 의존하지 않으므로 푸시를 쓰는 앱은 두 Product를 각각 추가해야 합니다. 일반적인 서비스 앱은 이 조합이 기본입니다.
AppBox.shared.toastShow(...)처럼 인스턴스로 호출하는 함수들이며 AppBoxSDK에 있습니다. 자세한 내용은 기기 기능 공통 규칙 이하를 보세요.
웹뷰가 필요한 기능과 아닌 기능
webView는 선택 인자라 넣지 않아도 초기화됩니다.
| 구분 | 내용 |
|---|---|
| 웹뷰가 있어야 하는 것 | AppBox 관리 화면 실행(AppBox.start(from:)), 앱이 소유한 WebView에 브릿지 연결 |
| 웹뷰 없이 되는 것 | 푸시, 네이티브 인앱 메시지, SNS 로그인, 걸음 수, 기기 기능 47개 |
웹뷰와는 별개로 화면(뷰 컨트롤러)이 필요한 기기 기능이 14개 있습니다. 스캐너, 뷰어, 토스트처럼 화면 위에 무언가를 올리는 함수들이며, 앱이 백그라운드이거나 표시할 뷰 컨트롤러가 없으면 -5002로 실패합니다. 함수별 구분은 기기 기능 공통 규칙의 화면 요건을 보세요.
구성별 권장 조합
| 앱 구성 | 추가할 Product |
|---|---|
| 기본 AppBox 서비스 앱 | AppBoxSDK + AppBoxPushSDK |
고객사 WKWebView 연결 | AppBoxSDK + AppBoxPushSDK |
| SNS 로그인 추가 | 위 + AppBoxSnsLoginSDK |
| 걸음 수 추가 | 위 + AppBoxHealthSDK |
| 푸시 이미지 처리 | 앱 target과 NSE target 양쪽에 AppBoxPushSDK |
| 푸시만 쓰는 앱 | AppBoxPushSDK만 |
| 웹뷰 없이 네이티브 인앱만 | AppBoxInappMessageSDK (푸시 클릭, 사일런트 푸시가 필요하면 AppBoxPushSDK 추가) |
target 연결
외부 의존성
| 라이브러리 | 버전 | 함께 설치되는 Product |
|---|---|---|
| firebase-ios-sdk | 11.12.0 이상 | AppBoxPushSDK, AppBoxSnsLoginSDK |
| GoogleSignIn-iOS | 9.0.0 이상 | AppBoxSnsLoginSDK |
| kakao-ios-sdk | 2.26.0 이상 | AppBoxSnsLoginSDK |
| naveridlogin-sdk-ios-swift | 5.1.0 이상 | AppBoxSnsLoginSDK |
| AppsFlyerFramework | 6.17.6 이상 (minor 고정) | AppBoxSDK |
| lottie-spm | 4.6.0 이상 | AppBoxSDK |
Lottie와 AppsFlyerLib는 AppBoxSDK의 전이 의존성으로 함께 설치됩니다. 같은 패키지를 앱에 따로 추가하지 마세요. 버전이 다르면 충돌합니다.
푸시 이미지나 수신 집계가 필요한 앱이라면 Notification Service Extension target을 따로 만들고, 앱 target과 NSE target 양쪽에 AppBoxPushSDK를 추가하세요. 구현 코드는 Notification Service Extension 장에 있습니다.