AppBox SDK (iOS)

AppBox SDK는 모바일 웹사이트를 앱으로 패키징하여 최소한의 개발로 App Store에 등록할 수 있는 솔루션입니다.
모바일 웹사이트에서 JavaScript 코드를 사용해 앱의 기능을 사용할 수 있으며, 약 40+ 기능을 무료로 제공합니다.
SDK 형태로 제공되며, 도메인(또는 Base URL)만 입력하면 기본 브라우저 기능부터 간편히 사용 가능합니다.

AppBox SDK 사용 샘플소스

iOS 샘플 앱: https://github.com/MobilePartnersCo/AppBoxSampleiOS

라이선스

AppBox SDK의 사용은 영구적으로 무료입니다. 기업 또는 개인 상업적인 목적으로 사용 할 수 있습니다.

개발자 메뉴얼

메뉴얼: https://console.appboxapp.com/guide/appbox/%EC%B4%88%EA%B8%B0%20%EC%84%A4%EC%A0%95

데모앱 다운로드

GooglePlay: https://play.google.com/store/apps/details?id=kr.co.mobpa.appbox
AppStore: https://apps.apple.com/kr/app/id6737824370

SDK 구성(모듈)

모듈	선택 기준	설명
`AppBoxSDK`	AppBox 기본 WebView 또는 고객사 자체 `WKWebView` bridge 사용 시	핵심(WebView/브릿지/공통 UI/스토리지/시스템 기능/웹 기반 인앱 메시지 연동)
`AppBoxPushSDK`	푸시/FCM 사용 시, 또는 AppBox 기본 WebView 조합	푸시/FCM 연동, Push-only/sendMessage 호환 native API 제공
`AppBoxHealthSDK`	HealthKit 기능 사용 시	HealthKit(걸음 수 등)
`AppBoxSnsLoginSDK`	SNS 로그인 사용 시	네이버/카카오/구글/애플 로그인
`AppBoxCoreSDK`	직접 선택하지 않음	AppBoxSDK/AppBoxPushSDK의 설정, 네트워크, CoreData, 암호화 공통 기능을 위한 내부 의존성
`AppBoxWebViewSDK`	직접 선택하지 않음	AppBoxSDK의 웹뷰 런타임/브릿지 실행을 위한 내부 의존성

필수 외부 의존성

Lottie는 AppBoxSDK 패키지에 포함되어 있지 않으므로, SDK를 사용하는 앱 타겟에 별도로 추가해야 합니다.

의존성	필수 여부	설명
`Lottie`	✅	로딩 인디케이터의 Lottie JSON / dotLottie(`.lottie`) 애니메이션 표시 지원

의존성 다이어그램(mermaid)

graph TB
    AppBoxSDK[AppBoxSDK]
    AppBoxCoreSDK[AppBoxCoreSDK]
    AppBoxWebViewSDK[AppBoxWebViewSDK]
    AppBoxPushSDK[AppBoxPushSDK]
    AppBoxHealthSDK[AppBoxHealthSDK]
    AppBoxSnsLoginSDK[AppBoxSnsLoginSDK]

    Firebase[Firebase iOS SDK<br/>11.12.0]
    KakaoSDK[Kakao iOS SDK]
    NaverSDK[Naver Login SDK]
    GoogleSignIn[Google Sign-In]
    Lottie[Lottie]

    AppBoxSDK -->|내부 의존| AppBoxCoreSDK
    AppBoxSDK -->|내부 의존| AppBoxWebViewSDK
    AppBoxSDK -->|필수| AppBoxPushSDK
    AppBoxSDK -->|앱 타겟에 별도 추가 필요| Lottie
    AppBoxSDK -.->|선택| AppBoxHealthSDK
    AppBoxSDK -.->|선택| AppBoxSnsLoginSDK

    AppBoxPushSDK --> AppBoxCoreSDK
    AppBoxPushSDK --> Firebase
    AppBoxSnsLoginSDK --> Firebase
    AppBoxSnsLoginSDK --> KakaoSDK
    AppBoxSnsLoginSDK --> NaverSDK
    AppBoxSnsLoginSDK --> GoogleSignIn

통합 방식 선택

먼저 앱에서 누가 WKWebView를 소유하는지와 푸시만 필요한지 기준으로 통합 방식을 고릅니다. Push-only 방식과 AppBox 기본 WebView 방식은 초기화 진입점이 다르므로 한 앱에서 둘을 동시에 초기화하지 않습니다.

사용 상황	앱 타겟에 추가할 Product	초기화 진입점	설명
푸시만 사용	`AppBoxPushSDK`	`AppBoxPush.shared.initSDK(projectId:...)`	AppBox 웹뷰를 띄우지 않고 푸시, 토큰, 세그먼트, 전환, topic native API만 사용
AppBox 기본 WebView 사용	`AppBoxSDK`, `AppBoxPushSDK`	`AppBox.shared.initSDK(...)` + `AppBox.shared.start(from:)`	AppBox가 `WKWebView`, navigation, bridge 전체를 관리
SwiftUI App lifecycle	위 사용 유형과 동일	`@UIApplicationDelegateAdaptor`, `UIViewControllerRepresentable`	배포 레포의 SwiftUI 연동 가이드 참조
고객사 자체 WKWebView 사용	`AppBoxSDK` + 필요 시 `AppBoxPushSDK`	`AppBox.shared.attach(webView)`	고객사가 만든 `WKWebView`는 유지하고 AppBox 인앱/웹 SDK bridge만 연결
HealthKit 추가	위 조합 + `AppBoxHealthSDK`	별도 초기화 없음	`application.getHealthStepCount` bridge 사용 시 추가
SNS 로그인 추가	위 조합 + `AppBoxSnsLoginSDK`	`AppBoxSnsLogin.shared.initialize...`	`application.snsLogin`, `application.snsLogout` 사용 시 추가

AppBoxCoreSDK, AppBoxWebViewSDK는 내부 의존성입니다. 고객사 앱 코드에서 직접 import하거나 Product 선택 기준으로 안내하지 않습니다.

샘플에서 확인할 위치

이 샘플 앱의 실행 타겟은 AppBox 기본 WebView 방식입니다. Push-only와 고객사 자체 WKWebView 방식은 같은 SDK package에서 선택 적용할 수 있도록 README에 최소 적용 코드를 분리해 제공합니다.

사용 유형	확인 위치	적용 방법
AppBox 기본 WebView 사용	`sdkSample/AppDelegate.swift`, `sdkSample/ViewController.swift`, `sdkSample/SceneDelegate.swift`	현재 샘플 앱에 적용된 기본 흐름입니다. `AppBox.shared.initSDK(...)` 후 화면에서 `AppBox.shared.start(from:)`를 호출합니다.
푸시만 사용	README의 `2) 푸시만 사용`	`AppBoxSDK`를 초기화하지 않고 `AppBoxPushSDK`만 추가해 `AppBoxPush.shared.initSDK(projectId:...)`를 호출합니다.
고객사 자체 WKWebView 사용	README의 `3) 고객사 자체 WKWebView 사용`	기존 `WKWebView`를 유지하고 `AppBox.shared.attach(webView)`로 지원 bridge만 연결합니다.
AppsFlyer 딥링크 선택 연동	`sdkSample/AppDelegate.swift`, README의 `4) AppsFlyer 딥링크 선택 연동`	AppsFlyer를 쓰는 앱만 `AppBox.shared.configureAppsFlyer(devKey:appleAppID:)`, `configureAppsFlyerJavaScriptBridge()`, `startAppsFlyer()`를 호출합니다. URI Scheme은 Xcode URL Types에 등록하고 AppsFlyer Console에는 `{scheme}://open` 형태로 설정합니다.

SwiftUI 앱에서 사용하는 경우

현재 샘플 앱은 UIKit AppDelegate/SceneDelegate 기준입니다. SwiftUI App lifecycle 앱에서는 @UIApplicationDelegateAdaptor로 SDK 초기화와 push callback을 연결하고, AppBox 화면은 UINavigationController 기반 UIViewControllerRepresentable wrapper에서 실행해야 합니다.

자세한 내용은 AppBoxSDK 배포 레포의 SwiftUI 연동 가이드를 확인하세요.

SwiftUI 연동 가이드: https://github.com/MobilePartnersCo/AppBoxSDKFramwork/blob/main/docs/SwiftUI-Integration-Guide.md

전체 기능 (요약)

브라우저의 기본기능
생체 인증, 탭 메뉴/브라우저 메뉴/햄버거 메뉴, 진동, 로딩 아이콘, 토스트 메시지, 인트로
플로팅 메뉴, 로컬 푸시, 앱 평가, 달력, 팝업(전체/중앙/바텀시트), 이미지 뷰어, 외부 페이지 열기
바코드/QR 스캐너, QR/바코드 팝업, 업데이트 실행, 다른 앱 실행
공유하기, 앱 종료, 위치 조회, 전화걸기, 문자보내기, 걸음수(HealthKit), 푸시 토큰, 세그먼트 전송 등
웹 SDK 브릿지 기반 인앱 메시지 표시, 노출/클릭 이벤트 큐, INAPP 푸시 클릭 연동
OS 버전 조회(application.getOSVersion), 연락처 선택(phone.getContacts)
SNS 로그인(선택): 네이버/카카오/구글/애플 (application.snsLogin, application.snsLogout)
AppsFlyer URI Scheme Deep Link 수신 및 웹 JS handler 전달
호스트 앱 orientation 정책을 따르는 portrait/landscape 레이아웃 대응(스캐너 카메라 VC는 portrait 고정)

브라우저의 기본기능

동영상 플레이어의 전체화면 지원
KG이니시스, 토스페이먼트, 나이스페이먼츠 등의 PG결제 지원
파일 업/다운로드: WebView 내에서 파일 업로드 및 다운로드 지원
window.open()으로 새창 열기 지원

설치 방법 (SPM)

AppBoxSDK는 Swift Package Manager를 통해 배포됩니다.
AppBoxPushSDK는 Firebase(firebase-ios-sdk) 11.12.0에 종속됩니다.

Xcode에서 Project Target → Package Dependencies → + 를 눌러 패키지 추가 화면을 엽니다.

다음 SPM URL을 추가합니다.

https://github.com/MobilePartnersCo/AppBoxSDKFramwork

Dependency Rule을 설정하고 Add Package를 눌러 추가합니다.

사용 유형에 맞는 Product를 타겟에 추가합니다.

사용 유형	앱 타겟 Product
푸시만 사용	`AppBoxPushSDK`
AppBox 기본 WebView 사용	`AppBoxSDK`, `AppBoxPushSDK`
고객사 자체 WKWebView 사용	`AppBoxSDK` + 필요 시 `AppBoxPushSDK`
HealthKit 사용	`AppBoxHealthSDK` 추가
SNS 로그인 사용	`AppBoxSnsLoginSDK` 추가
푸시 이미지 Service Extension	Extension 타겟에 `AppBoxPushSDK` 추가

AppBoxCoreSDK, AppBoxWebViewSDK는 내부 의존성으로 함께 resolve되며 고객사 앱 타겟에서 직접 선택하거나 import하지 않습니다.

Lottie 패키지를 추가하고 앱 타겟에 Lottie product를 연결합니다.
```
https://github.com/airbnb/lottie-spm.git
```
설정 완료

설정

Info.plist (AppBoxSDK)

<key>NSFaceIDUsageDescription</key>
<string>생체인증을 사용하기 위해 필요합니다.</string>
<key>NSCameraUsageDescription</key>
<string>카메라를 사용하기 위해 필요합니다.</string>
<key>NSLocationWhenInUseUsageDescription</key>
<string>위치정보 제공을 위해 필요합니다.</string>
<key>NSAppTransportSecurity</key>
<dict>
    <key>NSAllowsArbitraryLoads</key>
    <true/>
</dict>
<key>UIBackgroundModes</key>
<array>
    <string>remote-notification</string>
</array>

다른 앱 열기 기능을 사용하려면 다음도 추가합니다.

<key>LSApplicationQueriesSchemes</key>
<array>
   <string>{호출할 앱 스키마}</string>
</array>

Info.plist (AppBoxHealthSDK)

<key>NSHealthShareUsageDescription</key>
<string>걸음수를 가져오기 위해 필요합니다.</string>
<key>NSHealthUpdateUsageDescription</key>
<string>걸음수를 가져오기 위해 필요합니다.</string>

Info.plist (AppBoxSnsLoginSDK, 선택)

<key>CFBundleURLTypes</key>
<array>
  <!-- Google -->
  <dict>
    <key>CFBundleURLSchemes</key>
    <array>
      <string>com.googleusercontent.apps.YOUR_CLIENT_ID</string>
    </array>
  </dict>
  <!-- Naver -->
  <dict>
    <key>CFBundleURLSchemes</key>
    <array>
      <string>YOUR_NAVER_URL_SCHEME</string>
    </array>
  </dict>
  <!-- Kakao -->
  <dict>
    <key>CFBundleURLSchemes</key>
    <array>
      <string>kakaoYOUR_KAKAO_APP_KEY</string>
    </array>
  </dict>
</array>

<key>LSApplicationQueriesSchemes</key>
<array>
  <string>kakaokompassauth</string>
  <string>kakaotalk</string>
  <string>naversearchapp</string>
  <string>naversearchthirdlogin</string>
</array>

Info.plist (AppsFlyer URI Scheme 딥링크, 선택)

AppsFlyer URI Scheme 딥링크를 사용하는 앱은 Xcode URL Types에 수신 scheme을 등록합니다. devKey, appleAppID는 Info.plist 필수 키가 아니며 AppBox.shared.configureAppsFlyer(devKey:appleAppID:)에 문자열로 전달합니다.

<key>CFBundleURLTypes</key>
<array>
  <dict>
    <key>CFBundleURLName</key>
    <string>AppsFlyer Deep Link</string>
    <key>CFBundleURLSchemes</key>
    <array>
      <string>YOUR_URI_SCHEME</string>
    </array>
  </dict>
</array>

AppsFlyer OneLink/URI Scheme 설정의 deep link URL은 {scheme}://open 형태를 사용합니다. Universal Link forwarding은 v1.2.14 README 범위에 포함하지 않습니다.

Signing & Capabilities

HealthKit (AppBoxHealthSDK)

걸음수를 사용하려면 Signing & Capabilities에 HealthKit을 추가해야합니다.

Targets → Signing & Capabilities → + Capability
HealthKit 검색 후 적용
설정 완료

Push Notifications (AppBoxPushSDK)

푸시를 사용하려면 Signing & Capabilities에 Push Notifications을 추가해야합니다.

Targets → Signing & Capabilities → + Capability
Push Notifications 검색 후 적용
설정 완료

Service Extension (푸시 이미지 사용 시, AppBoxPushSDK)

푸시에 이미지를 사용하려면 Notification Service Extension을 추가하고 App Groups를 설정합니다.

Extension 추가(예시)
Notification Service Extension 선택
이름 입력 후 생성
Don't Activate
Extension의 Minimum Deployment를 메인 앱과 동일하게 설정
메인 앱에 App Groups 추가
App Group 생성 및 활성화
Extension 타겟에도 동일 App Group 활성화
Extension 타겟에 AppBoxPushSDK 추가

NotificationService.swift 적용 예시:

import UserNotifications
import AppBoxPushSDK

class NotificationService: UNNotificationServiceExtension {

  override func didReceive(_ request: UNNotificationRequest,
                           withContentHandler contentHandler: @escaping (UNNotificationContent) -> Void) {
    AppBoxPush.shared.createFCMImage(request, withContentHandler: contentHandler)
  }
}

사용법

1) AppBox 기본 WebView 사용

AppBox가 웹뷰를 생성하고 bridge 전체를 관리하는 방식입니다. 웹사이트를 앱처럼 패키징하는 일반 AppBoxSDK 사용자는 이 방식을 사용합니다.

import UIKit
import WebKit
import UserNotifications
import AppBoxSDK
import AppBoxPushSDK
import AppBoxSnsLoginSDK

@main
final class AppDelegate: UIResponder, UIApplicationDelegate, UNUserNotificationCenterDelegate {
  func application(_ application: UIApplication,
                   didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?) -> Bool {
    UNUserNotificationCenter.current().delegate = self

    // Google 로그인 등 Firebase Client ID가 필요한 기능은 AppBox 초기화 전에 설정합니다.
    AppBoxPush.shared.initializeFirebaseClientID(
      clientID: "YOUR_FIREBASE_CLIENTID"
    )

    let appBoxWebConfig = AppBoxWebConfig()
    let wkWebViewConfig = WKWebViewConfiguration()
    if #available(iOS 14.0, *) {
      wkWebViewConfig.defaultWebpagePreferences.allowsContentJavaScript = true
    } else {
      wkWebViewConfig.preferences.javaScriptEnabled = true
    }
    appBoxWebConfig.wKWebViewConfiguration = wkWebViewConfig

    AppBox.shared.initSDK(
      baseUrl: "https://www.example.com",
      projectId: "YOUR_PROJECT_ID",
      webConfig: appBoxWebConfig,
      debugMode: true
    )

    AppBox.shared.preloadWebView()
    AppBox.shared.setPullDownRefresh(used: true)

    AppBoxSnsLogin.shared.initializeKakao(appKey: "YOUR_KAKAO_APPKEY")
    AppBoxSnsLogin.shared.initializeNaver(
      appName: "YOUR_NID_APPNAME",
      clientId: "YOUR_NID_CLIENTID",
      clientSecret: "YOUR_NID_CLIENTSECRET",
      urlScheme: "YOUR_NID_URLSCHEME"
    )

    return true
  }

  func application(_ application: UIApplication,
                   didRegisterForRemoteNotificationsWithDeviceToken deviceToken: Data) {
    AppBoxPush.shared.appBoxPushApnsToken(apnsToken: deviceToken)
  }

  func application(_ app: UIApplication,
                   open url: URL,
                   options: [UIApplication.OpenURLOptionsKey : Any] = [:]) -> Bool {
    if AppBox.shared.handleURL(url, options: options) { return true }
    return false
  }

  func application(_ application: UIApplication,
                   continue userActivity: NSUserActivity,
                   restorationHandler: @escaping ([UIUserActivityRestoring]?) -> Void) -> Bool {
    _ = AppBox.shared.handleUserActivity(userActivity)
    return false
  }

  func userNotificationCenter(_ center: UNUserNotificationCenter,
                              didReceive response: UNNotificationResponse,
                              withCompletionHandler completionHandler: @escaping () -> Void) {
    AppBox.shared.movePush(response: response)
    completionHandler()
  }

  func application(_ application: UIApplication,
                   didReceiveRemoteNotification userInfo: [AnyHashable : Any],
                   fetchCompletionHandler completionHandler: @escaping (UIBackgroundFetchResult) -> Void) {
    AppBox.shared.handledidReceiveRemoteNotification(userInfo: userInfo)
    completionHandler(.newData)
  }
}

웹뷰 실행:

AppBox.shared.start(from: self) { isSuccess, error in
  if isSuccess {
    print("AppBox:: SDK 실행 성공")
  } else {
    print(error?.localizedDescription ?? "error : unknown Error")
  }
}

2) 푸시만 사용

웹뷰가 필요 없고 푸시만 사용하는 앱은 AppBoxSDK를 초기화하지 않습니다. baseUrl도 필요 없습니다.

import UIKit
import UserNotifications
import AppBoxPushSDK

@main
final class AppDelegate: UIResponder, UIApplicationDelegate, UNUserNotificationCenterDelegate, AppBoxPushDelegate {
  func application(_ application: UIApplication,
                   didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?) -> Bool {
    UNUserNotificationCenter.current().delegate = self
    AppBoxPush.shared.delegate = self

    AppBoxPush.shared.initSDK(
      projectId: "YOUR_PROJECT_ID",
      debugMode: false,
      autoRegisterForAPNS: true
    ) { result, error, pushPermissionGranted in
      if let error = error {
        print("AppBoxPush init failed: \(error.localizedDescription)")
        return
      }

      print(result?.message ?? "")
      print(pushPermissionGranted?.boolValue ?? false)
    }

    return true
  }

  func application(_ application: UIApplication,
                   didRegisterForRemoteNotificationsWithDeviceToken deviceToken: Data) {
    AppBoxPush.shared.application(
      didRegisterForRemoteNotificationsWithDeviceToken: deviceToken
    ) { result, error in
      print(error?.localizedDescription ?? result?.token ?? "")
    }
  }

  func userNotificationCenter(_ center: UNUserNotificationCenter,
                              didReceive response: UNNotificationResponse,
                              withCompletionHandler completionHandler: @escaping () -> Void) {
    AppBoxPush.shared.saveNotiClick(response)
    completionHandler()
  }

  func appBoxPushTokenDidUpdate(_ token: String?) {
    print("AppBox push token updated: \(token ?? "")")
  }
}

Push-only에서 사용할 수 있는 native API 예시:

AppBoxPush.shared.saveSegment(segment: ["grade": "vip"])
AppBoxPush.shared.trackingConversion(conversionCode: "purchase")
AppBoxPush.shared.subscribeToTopic("event_2026")
AppBoxPush.shared.unsubscribeFromTopic("event_2026")
let token = AppBoxPush.shared.getPushToken()

3) 고객사 자체 WKWebView 사용

이미 앱에서 직접 관리하는 WKWebView가 있다면 AppBox가 웹뷰를 새로 띄우지 않고 bridge만 연결합니다.

import UIKit
import WebKit
import AppBoxSDK

final class CustomerWebViewController: UIViewController, WKNavigationDelegate {
  private let webView = WKWebView()

  override func viewDidLoad() {
    super.viewDidLoad()

    AppBox.shared.attach(webView)
    AppBox.shared.setActiveWebView(webView)
    AppBox.shared.attachNavigationObservation(webView, forwardingTo: self)
  }

  override func viewDidDisappear(_ animated: Bool) {
    super.viewDidDisappear(animated)

    AppBox.shared.detach(webView)
    AppBox.shared.detachNavigationObservation(webView)
  }
}

고객사 자체 WKWebView attach 경로는 웹 인앱메시지 lifecycle 연결이 목적입니다. 허용 action은 appbox.notification.ping, appbox.getAppId, inapp.* 중심이며, 전체 AppBox bridge action을 외부 웹뷰에 모두 열지 않습니다.

4) AppsFlyer 딥링크 선택 연동

AppsFlyer URI Scheme 딥링크는 AppBoxSDK API로 설정합니다. 서비스 앱은 AppsFlyer SDK 타입을 직접 import하지 않습니다. devKey와 appleAppID는 문자열로 전달하며 JS function name은 받지 않습니다. Native는 항상 현재 AppBox WebView에 window.AppboxSDK.deepLink.onReceive(payload)를 호출합니다.

AppBox.shared.configureAppsFlyer(
  devKey: "YOUR_APPSFLYER_DEV_KEY",
  appleAppID: "YOUR_NUMERIC_APP_STORE_ID"
)
AppBox.shared.configureAppsFlyerJavaScriptBridge()
AppBox.shared.startAppsFlyer()

웹앱은 v3.js가 제공하는 handler 등록 방식으로 payload를 사용합니다. JS payload에는 rawParams가 포함되지 않으며, top-level 값은 deep_link_value, sub parameter 객체명은 subParam입니다.

window.AppboxSDK.deepLink.setOnReceive(function(payload) {
  console.log('[AppBoxSDK][AppsFlyer]', payload.deep_link_value, payload.subParam);
});

AppsFlyer URI Scheme 딥링크 URL은 {scheme}://open 형태로 설정합니다. Scene 기반 앱은 URLContext options를 SDK에 전달하고, AppBox의 기존 UserActivity 처리 코드는 유지할 수 있습니다.

func scene(_ scene: UIScene, continue userActivity: NSUserActivity) {
  _ = AppBox.shared.handleUserActivity(userActivity)
}

func scene(_ scene: UIScene, openURLContexts URLContexts: Set<UIOpenURLContext>) {
  guard let context = URLContexts.first else { return }
  _ = AppBox.shared.handleURL(context.url, options: appOpenOptions(from: context))
}

private func appOpenOptions(from context: UIOpenURLContext) -> [UIApplication.OpenURLOptionsKey: Any] {
  var result: [UIApplication.OpenURLOptionsKey: Any] = [:]
  if let sourceApplication = context.options.sourceApplication {
    result[.sourceApplication] = sourceApplication
  }
  if let annotation = context.options.annotation {
    result[.annotation] = annotation
  }
  result[.openInPlace] = context.options.openInPlace
  return result
}

5) 추가 기능 설정

AppBox.shared.setDebug(debugMode: true)
AppBox.shared.setPullDownRefresh(used: true)
AppBox.shared.preloadWebView()

인트로 설정(선택):

if let introItem1 = AppBoxIntroItems(imageUrl: "https://example.com/image.jpg") {
  let intro = AppBoxIntro(
    indicatorDefColor: "#a7abab",
    indicatorSelColor: "#000000",
    fontColor: "#000000",
    item: [introItem1]
  )
  AppBox.shared.setIntro(intro)
}

웹 브릿지 지원 범위

브릿지 액션은 WebView 안의 웹 페이지에서 네이티브 기능을 호출할 때 사용하는 인터페이스입니다. 네이티브 앱에서 SDK만 연동하는 경우에는 상세 request/response 스키마를 직접 참조할 필요가 없습니다.

사용 방식	브릿지 사용 여부	설명
푸시만 사용	사용 안 함	`AppBoxPushSDK`의 네이티브 API만 연동합니다.
AppBox 기본 WebView 사용	사용	`AppBoxSDK`가 관리하는 WebView에서 AppBox 브릿지 액션을 사용할 수 있습니다.
고객사 자체 WKWebView 사용	제한 사용	`attach(webView:)` 이후 지원되는 브릿지 액션만 사용할 수 있습니다.

주요 브릿지 액션 예시는 릴리즈 노트와 기능 요약에 포함되어 있습니다. 상세 request/response 스키마는 고객사 연동 범위에 따라 별도 제공됩니다.

요구 사항

iOS 13.0 이상
Swift 5.4 이상
Xcode 15.0 이상 권장

주의 사항

AppBox 기본 WebView 방식은 AppBox.shared.initSDK(...) 이후에 start, preload, bridge 기반 기능을 호출합니다.
Push-only 방식은 AppBox.shared.initSDK(...)를 호출하지 않고 AppBoxPush.shared.initSDK(projectId:...)만 사용합니다.
고객사 자체 WKWebView attach 방식은 지원 action 범위가 제한됩니다.

지원

이메일: contact@mobpa.co.kr
홈페이지: https://www.appboxapp.com

Name		Name	Last commit message	Last commit date
Latest commit History 65 Commits
appBoxNotiServiceExtension		appBoxNotiServiceExtension
sdkSample.xcodeproj		sdkSample.xcodeproj
sdkSample		sdkSample
README.md		README.md

Folders and files

Latest commit

History

Repository files navigation

AppBox SDK (iOS)

AppBox SDK 사용 샘플소스

라이선스

개발자 메뉴얼

데모앱 다운로드

최신 업데이트 (v1.2.14, 2026.05.15)

v1.2.10 (2026.05.15)

v1.2.9 (2026.05.15)

v1.2.8 (2026.05.12)

v1.2.7 (2026.05.11)

v1.2.6 (2026.04.29)

v1.2.4 (2026.04.29)

v1.2.3 (2026.04.17)

v1.2.0 (2026.03.05)

v1.0.55 (2026.02.26)

v1.0.54 (2026.02.12)

v1.0.44 (2025.12.12)

SDK 구성(모듈)

필수 외부 의존성

통합 방식 선택

샘플에서 확인할 위치

SwiftUI 앱에서 사용하는 경우

전체 기능 (요약)

브라우저의 기본기능

설치 방법 (SPM)

설정

Info.plist (AppBoxSDK)

Info.plist (AppBoxHealthSDK)

Info.plist (AppBoxSnsLoginSDK, 선택)

Info.plist (AppsFlyer URI Scheme 딥링크, 선택)

Signing & Capabilities

HealthKit (AppBoxHealthSDK)

Push Notifications (AppBoxPushSDK)

Service Extension (푸시 이미지 사용 시, AppBoxPushSDK)

사용법

1) AppBox 기본 WebView 사용

2) 푸시만 사용

3) 고객사 자체 WKWebView 사용

4) AppsFlyer 딥링크 선택 연동

5) 추가 기능 설정

웹 브릿지 지원 범위

요구 사항

주의 사항

지원

About

Resources

Uh oh!

Stars

Watchers

Forks

Releases 16

Packages 0

Uh oh!

Contributors

Uh oh!

Languages

Packages