1단계: 패키지와 Product 추가 | 초기 설정 | Appbox iOS SDK 가이드

1단계: 패키지와 Product 추가

(필수) SDK는 Swift Package Manager로 배포됩니다. Xcode에서 다음 순서로 추가합니다.
1. File → Add Package Dependencies를 엽니다. 2. 오른쪽 위 검색창에 아래 저장소 URL을 넣습니다. 3. Dependency Rule에서 사용할 버전을 지정합니다(예: Exact Version 1.4.0). 4. Add Package를 누르면 Product 선택 창이 뜹니다. 사용할 Product만 체크하고 Add to Target에서 앱 target을 고릅니다.

1단계: 패키지와 Product 추가

Text
1 https://github.com/MobilePartnersCo/AppBoxSDKFramwork.git

저장소 이름은 AppBoxSDKFramwork입니다. Framework로 고쳐 입력하면 패키지를 찾지 못합니다.

버전 규칙은 사용할 릴리스 태그를 지정합니다(예: 1.4.0). 공개 저장소라 별도 인증은 필요 없습니다.

Product 선택

공개 Product는 5개입니다. 사용하는 것만 앱 target에 추가하세요.
Product필요한 경우없으면
AppBoxSDK관리 화면, 웹 브릿지, 기기 기능 47개import AppBoxSDK 컴파일 실패
AppBoxPushSDK푸시 알림Push 함수가 실패로 응답 (빌드는 성공)
AppBoxInappMessageSDK네이티브 인앱 메시지인앱 미표시: AppBoxInitResult.inApp.status로 확인
AppBoxHealthSDK걸음 수걸음 수 조회 실패, isHealthAvailable() == false
AppBoxSnsLoginSDKSNS 로그인로그인 실패, isAuthAvailable(...) == false

Push, In-App, Auth, Health 함수의 선언은 AppBoxSDK에 있어 해당 Product 없이도 컴파일되고 호출까지 됩니다. 실행 모듈이 없으면 앱을 중단시키지 않고 NSError, false, 빈 결과로 실패합니다. 빌드 성공이 동작을 보장하지 않는 지점입니다.

AppBoxPushSDK는 AppBoxSDK에 포함되지 않습니다. 서로 의존하지 않으므로 푸시를 쓰는 앱은 두 Product를 각각 추가해야 합니다. 일반적인 서비스 앱은 이 조합이 기본입니다.

기기 기능 47개는 AppBox.shared.toastShow(...)처럼 인스턴스로 호출하는 함수들이며 AppBoxSDK에 있습니다. 자세한 내용은 기기 기능 공통 규칙 이하를 보세요.

웹뷰가 필요한 기능과 아닌 기능

AppBox 관리 화면(웹뷰)을 쓰지 않는 네이티브 앱도 SDK 대부분을 그대로 사용할 수 있습니다. 초기화 설정의 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는 앱 target의 General → Frameworks, Libraries, and Embedded Content에서 Embed & Sign으로 설정하세요.

외부 의존성

SDK가 SPM으로 함께 설치하는 라이브러리입니다. 앱이 같은 라이브러리를 다른 버전으로 쓰고 있으면 충돌할 수 있습니다.
라이브러리버전함께 설치되는 Product
firebase-ios-sdk11.12.0 이상AppBoxPushSDK, AppBoxSnsLoginSDK
GoogleSignIn-iOS9.0.0 이상AppBoxSnsLoginSDK
kakao-ios-sdk2.26.0 이상AppBoxSnsLoginSDK
naveridlogin-sdk-ios-swift5.1.0 이상AppBoxSnsLoginSDK
AppsFlyerFramework6.17.6 이상 (minor 고정)AppBoxSDK
lottie-spm4.6.0 이상AppBoxSDK

Lottie와 AppsFlyerLib는 AppBoxSDK의 전이 의존성으로 함께 설치됩니다. 같은 패키지를 앱에 따로 추가하지 마세요. 버전이 다르면 충돌합니다.

푸시 이미지나 수신 집계가 필요한 앱이라면 Notification Service Extension target을 따로 만들고, 앱 target과 NSE target 양쪽에 AppBoxPushSDK를 추가하세요. 구현 코드는 Notification Service Extension 장에 있습니다.

www.naver.com
QR 코드를 촬영하면 입력하신 주소의
앱 예시 화면을 테스트할 수 있습니다.
* 스캔 후 바로 앱 다운로드 이동합니다.