메인 콘텐츠로 건너뛰기
OneSignal 모바일 SDK는 iOS, Android, Huawei 및 Amazon 앱에서 푸시 알림, 인앱 메시지, Live Activities를 활성화합니다. 설정은 두 단계로 이루어집니다:
  1. 플랫폼 자격 증명 구성 — FCM, APNs, HMS 또는 ADM 자격 증명을 OneSignal에 연결
  2. SDK 통합 — 플랫폼용 OneSignal SDK를 설치하고 앱에서 초기화
웹사이트의 경우 Web SDK 설정을 참조하세요.

플랫폼 자격 증명 구성

각 플랫폼에는 고유한 푸시 자격 증명이 필요합니다. SDK를 통합하기 전에 앱이 지원하는 모든 플랫폼의 자격 증명을 구성하세요.

OneSignal 앱 및 플랫폼 구성

지원하는 플랫폼(Apple (APNs), Google (FCM), Huawei (HMS), Amazon (ADM))으로 OneSignal 앱을 구성하세요.
조직에 이미 OneSignal 계정이 있는 경우 조직에 초대를 요청하세요. 그렇지 않은 경우 무료 계정에 가입하여 시작하세요.
1

앱 만들기 또는 선택

New App/Website를 클릭하여 새 앱을 만들거나 설정 > 푸시 및 인앱에서 기존 앱에 플랫폼을 추가합니다. 구성하려는 플랫폼을 선택하고 Next: Configure Your Platform을 클릭합니다.
조직 이름, 앱 이름 및 채널 선택을 포함한 새 앱 설정 흐름을 보여주는 OneSignal 대시보드
2

플랫폼 자격 증명 구성

플랫폼에 대한 자격 증명을 입력합니다:자격 증명을 입력한 후 Save & Continue를 클릭합니다.
3

앱 ID를 저장하고 SDK 설치

앱 ID가 최종 화면에 표시됩니다. 복사하고 저장하세요 — SDK를 초기화할 때 필요합니다. SDK 플랫폼을 선택한 다음 설정 가이드를 따릅니다.
설정 후 앱 ID와 팀 초대 옵션을 보여주는 OneSignal 대시보드

SDK 통합

Android 네이티브

FCM을 사용하여 OneSignal SDK를 네이티브 Android 앱에 통합합니다.

iOS 네이티브

APNs를 사용하여 OneSignal SDK를 네이티브 iOS 앱에 통합합니다.

React Native 및 Expo

React Native 및 Expo 환경을 위한 설정.

Flutter

Dart를 사용하는 Flutter 앱용 SDK 설정.

Unity

Unity 기반 모바일 앱용 크로스 플랫폼 SDK 설정.

.NET MAUI

OneSignal SDK를 .NET MAUI 앱과 통합합니다.

Huawei Android 네이티브

HMS 푸시 서비스를 사용하는 Huawei 장치용 SDK 설정.

Cordova, Ionic 및 Capacitor

Cordova, Ionic 및 Capacitor 하이브리드 모바일 앱을 위한 설정.

기타 통합

FlutterFlow

FlutterFlow 앱을 위한 로우코드 SDK 설정.

Median.co

Median.co(구 GoNative.io) 앱의 통합 가이드.

SDK 버전


FAQ

SDK가 필수인가요?

아니요, 하지만 적극 권장됩니다 — GitHub에서 오픈 소스로 제공됩니다. REST API만 사용하여 OneSignal을 통합할 수 있지만, SDK를 사용하면 특히 플랫폼 전반에서 푸시 알림을 처리하는 프로세스가 크게 단순화됩니다.

SDK 없이 할 수 있는 작업은?

다음 API를 직접 사용할 수 있습니다:
인앱 메시지Live Activities는 SDK가 필요합니다 — API만으로는 전달할 수 없습니다.

SDK 사용을 권장하는 이유는?

푸시 알림에는 SDK가 처리하는 플랫폼별 요구 사항이 있습니다:
  • Android, iOS, Huawei 및 웹에서 푸시 토큰 가져오기
  • 구독 상태 및 사용자 옵트인 프롬프트 관리
  • 클라이언트에서 푸시 알림 표시 및 처리
Apple의 APNs와 Google의 FCM은 서로 다른 페이로드 형식을 사용합니다. OneSignal SDK는 사용자 지정 페이로드를 파싱하여 메시지를 정확하게 표시하고 추적합니다. 이를 수동으로 유지 관리하면 상당한 복잡성이 추가됩니다. 자세히 알아보기: Build vs. Buy: What Goes Into Building a Push Notification Platform

iOS와 Android에 별도의 OneSignal 앱이 필요한가요?

아니요. 단일 OneSignal 앱이 여러 플랫폼 — iOS, Android, Huawei, Amazon 및 웹 — 을 지원합니다. 설정 > 푸시 및 인앱에서 각 플랫폼의 자격 증명을 구성하면 모두 동일한 앱, 사용자 및 세그먼트를 공유합니다.

중국 또는 Huawei 기기가 푸시 알림을 받을 수 있나요?

기기에 Google Play 서비스가 있으면 FCM을 통해 푸시를 받습니다. 앱이 Huawei AppGallery에서 다운로드된 경우(Android를 실행하는 비-HarmonyOS Huawei 기기 포함) HMS를 통해 푸시를 받습니다 — 이를 활성화하려면 Huawei SDK를 설정하세요. OneSignal은 HMS와 FCM을 모두 지원하는 기기에는 기본적으로 FCM을 사용합니다. 필요한 경우 FCM보다 HMS를 선호하도록 설정할 수 있습니다.