요구 사항
- Flutterflow 플랜: Standard 이상
- 구성된 OneSignal 앱 및 플랫폼
- Xcode 14+가 있는 macOS(설정 지침은 Xcode 16.2 사용)
- iOS 12+, iPadOS 12+ 또는 iOS 16.2+를 실행하는 Xcode 시뮬레이터가 있는 기기
- CocoaPods 1.16.2+
- Google Play 스토어(서비스)가 설치된 Android 7.0+ 기기 또는 에뮬레이터
OneSignal 앱 및 플랫폼 구성
푸시 알림에 필요한 설정 OneSignal로 푸시 알림 전송을 시작하려면 먼저 지원하는 모든 플랫폼(Apple (APNs), Google (FCM), Huawei (HMS) 및/또는 Amazon (ADM))으로 OneSignal 앱을 구성해야 합니다.조직에 이미 OneSignal 계정이 있는 경우 관리자 역할로 초대를 요청하여 앱을 구성하세요. 그렇지 않은 경우 무료 계정에 가입하여 시작하세요.
OneSignal 앱 구성을 위한 단계별 지침.
OneSignal 앱 구성을 위한 단계별 지침.
단일 OneSignal 앱에서 여러 플랫폼(iOS, Android, Huawei, Amazon, Web)을 관리할 수 있습니다.
앱 만들기 또는 선택
- 기존 앱에 플랫폼을 추가하려면 OneSignal 대시보드에서 설정 > 푸시 및 인앱으로 이동합니다.
- 처음부터 시작하려면 New App/Website를 클릭하고 프롬프트를 따릅니다.

플랫폼 설정 및 활성화
- 앱 및 조직에 대해 명확하고 인식 가능한 이름을 선택합니다.
- 구성하려는 플랫폼(iOS, Android 등)을 선택합니다.
- Next: Configure Your Platform을 클릭합니다.

플랫폼 자격 증명 구성
플랫폼에 따라 프롬프트를 따릅니다:
- Android: Firebase 자격 증명 설정
- iOS: p8 토큰(권장) 또는 p12 인증서
- Amazon: API 키 생성
- Huawei: OneSignal 권한 부여
설정
1. 새 사용자 지정 작업 만들기
Flutterflow 프로젝트에서 Custom Code로 이동한 다음 +Add 버튼을 클릭하고 Action을 선택합니다.
dependency

YOUR_APP_ID를 OneSignal 대시보드 **설정 > 키 및 ID**에서 찾을 수 있는 OneSignal 앱 ID로 교체합니다.
OneSignal 앱에 액세스할 수 없는 경우 팀 구성원에게 초대를 요청하세요.
Flutter
onesignal 작업을 클릭합니다.


2. 프로젝트 내보내기
- APK 다운로드 (Android 전용)
- 전체 프로젝트 다운로드 (iOS 및 Android)
Developer Menu를 열고 APK를 다운로드합니다:
APK가 다운로드되면 APK를 Android 에뮬레이터로 드래그하여 설치하여 앱을 테스트할 수 있습니다. 푸시 기능은 즉시 작동해야 하며 네이티브 프롬프트를 통해 푸시 권한을 제공하는 즉시 기기에 푸시 알림을 보낼 수 있습니다.

3. iOS 설정
다운로드한 프로젝트는 iOS에서 실행할 준비가 되지 않았을 가능성이 높습니다. OneSignal 특정 추가 사항을 설정하기 전에 프로젝트가 완전히 빌드되었는지 확인해야 합니다. 이를 위해:- 터미널 창을 열고 다운로드한 프로젝트의
ios폴더로 cd(디렉터리 변경)합니다. - 터미널에
flutter build ios를 입력하고 Enter 키를 누릅니다. 빌드가 완료될 때까지 기다립니다. 프로젝트 크기에 따라 시간이 걸릴 수 있습니다. - 여전히 터미널에
pod install을 입력하고 Enter 키를 누릅니다. Pod 설치가 완료될 때까지 기다립니다.
.xcworkspace 파일을 Xcode에서 엽니다.
루트 프로젝트 > 기본 앱 대상 > Signing & Capabilities를 선택합니다.
Push Notifications가 활성화되지 않은 경우 + Capability를 클릭하고 Push Notifications를 추가합니다. Team 및 Bundle Identifier에 대한 올바른 세부 정보를 입력했는지 확인하세요.


Notification Service Extension 추가
OneSignalNotificationServiceExtension을 사용하면 iOS 애플리케이션이 이미지, 버튼 및 배지가 있는 리치 알림을 받을 수 있습니다. OneSignal의 확인된 전달 분석 기능에도 필요합니다. Xcode에서 **File > New > Target…**을 선택합니다. Notification Service Extension을 선택한 다음 Next를 클릭합니다.
OneSignalNotificationServiceExtension으로 입력하고 Finish를 누릅니다.



App Groups 추가
App Groups를 사용하면 앱이 활성 상태가 아니더라도 알림이 수신될 때 앱과 OneSignalNotificationServiceExtension이 통신할 수 있습니다. 배지 및 확인된 전달에 필요합니다. 기본 앱 대상 > Signing & Capabilities > + Capability > App Groups를 선택합니다.
group.YOUR_BUNDLE_IDENTIFIER.onesignal로 설정합니다. 여기서 YOUR_BUNDLE_IDENTIFIER는 기본 애플리케이션 “Bundle Identifier”와 동일합니다.


group.YOUR_BUNDLE_IDENTIFIER.onesignal로 설정합니다. 여기서 YOUR_BUNDLE_IDENTIFIER는 **기본 애플리케이션 “Bundle Identifier”**와 동일합니다.
OneSignalNotificationServiceExtension을 포함하지 마세요.

사용자 지정 App Group 이름 설정을 위한 선택적 지침
사용자 지정 App Group 이름 설정을 위한 선택적 지침
이 단계는 기본 앱 그룹 이름(
group.{your_bundle_id}.onesignal)을 사용하지 않으려는 경우에만 필요합니다.Info.plist 파일을 열고 String 유형으로 새 OneSignal_app_groups_key를 추가합니다.마지막 단계에서 확인한 그룹 이름을 값으로 입력합니다.OneSignalNotificationServiceExtension 폴더 아래의 Info.plist에 대해서도 동일하게 수행해야 합니다.OneSignalNotificationServiceExtension에 OneSignal SDK 추가
ios/Podfile을 업데이트하여 다음을 포함합니다:
Podfile 상단에 platform :ios, '11.0'이 있는지 확인하세요. - 또는 앱에 필요한 경우 더 최신 iOS 버전을 사용하세요.
ios 디렉터리로 cd한 다음 pod install을 실행합니다.
아래 오류가 표시되면 podfile 상단에 use_frameworks!를 추가하고 다시 시도하세요.
OneSignalNotificationServiceExtension 코드
Xcode 프로젝트 네비게이터에서 OneSignalNotificationServiceExtension 폴더를 선택하고NotificationService.m 또는 NotificationService.swift 파일을 엽니다.
전체 파일의 내용을 다음 코드로 교체합니다.

Testing the OneSignal SDK integration
This guide helps you verify that your OneSignal SDK integration is working correctly by testing push notifications, subscription registration, and in-app messaging.Check mobile subscriptions
Launch your app on a test device.
The native push permission prompt should appear automatically if you added the 
requestPermission method during initialization.
Check your OneSignal dashboard
Before accepting the prompt, check the OneSignal dashboard:
- Go to Audience > Subscriptions.
- You should see a new entry with the status “Never Subscribed”.

Refresh the OneSignal dashboard Subscription's page.
The subscription’s status should now show Subscribed.

You have successfully created a mobile subscription.
Mobile subscriptions are created when users first open your app on a device or if they uninstall and reinstall your app on the same device.
Set up test subscriptions
Test subscriptions are helpful for testing a push notification before sending a message.Add to Test Subscriptions.
In the dashboard, next to the subscription, click the Options (three dots) button and select Add to Test Subscriptions.

Name your subscription.
Name the subscription so you can easily identify your device later in the Test Subscriptions tab.
Name the segment.
Name the segment
Test Users (the name is important because it will be used later).Send test push via API
Get your App API Key and App ID.
In your OneSignal dashboard, go to Settings > Keys & IDs.
Update the provided code.
Replace
YOUR_APP_API_KEY and YOUR_APP_ID in the code below with your actual keys. This code uses the Test Users segment we created earlier.Check images and confirmed delivery.
If all setup steps were completed successfully, the test subscriptions should receive a notification with an image included:

Images will appear small in the collapsed notification view. Expand the notification to see the full image.
Check for confirmed delivery.
In your dashboard, go to Delivery > Sent Messages, then click the message to view stats.You should see the confirmed stat, meaning the device received the push.
If you’re on a Professional plan or higher, scroll to Audience Activity to see subscription-level confirmation:


You have successfully sent a notification via our API to a segment.
Send an in-app message
In-app messages let you communicate with users while they are using your app.Close or background your app on the device.
This is because users must meet the in-app audience criteria before a new session starts. In OneSignal, a new session starts when the user opens your app after it has been in the background or closed for at least 30 seconds. For more details, see our guide on how in-app messages are displayed.
Create an in-app message.
- In your OneSignal dashboard, navigate to Messages > In-App > New In-App.
- Find and select the Welcome message.
- Set your Audience as the Test Users segment we used previously.

Schedule frequency.
Under Schedule > How often do you want to show this message? select Every time trigger conditions are satisfied.

Make message live.
Click Make Message Live so it is available to your Test Users each time they open the app.
You have successfully setup the OneSignal SDK and learned important concepts like:
- Gathering Subscriptions, setting Test subscriptions, and creating Segments.
- Sending Push with images and Confirmed Delivery using Segments and our Create message API.
- Sending In-app messages.
User identification
Previously, we demonstrated how to create mobile Subscriptions. Now we’ll expand to identifying Users across all their subscriptions (including push, email, and SMS) using the OneSignal SDK. We’ll cover External IDs, tags, multi-channel subscriptions, privacy, and event tracking to help you unify and engage users across platforms.Assign External ID
Use an External ID to identify users consistently across devices, email addresses, and phone numbers using your backend’s user identifier. This ensures your messaging stays unified across channels and 3rd party systems (especially important for Integrations). Set the External ID with our SDK’slogin method each time they are identified by your app.
OneSignal generates unique read-only IDs for subscriptions (Subscription ID) and users (OneSignal ID).As users download your app on different devices, subscribe to your website, and/or provide you email addresses and phone numbers outside of your app, new subscriptions will be created.Setting the External ID via our SDK is highly recommended to identify users across all their subscriptions, regardless of how they are created.
Add data tags
Tags are key-value pairs of string data you can use to store user properties (likeusername, role, or preferences) and events (like purchase_date, game_level, or user interactions). Tags power advanced Message Personalization and Segmentation allowing for more advanced use cases.
Set tags with our SDK addTag and addTags methods as events occur in your app.
In this example, the user reached level 6 identifiable by the tag called current_level set to a value of 6.




Add email and/or SMS subscriptions
Earlier we saw how our SDK creates mobile subscriptions to send push and in-app messages. You can also reach users through emails and SMS channels by creating the corresponding subscriptions.- Use the
addEmailmethod to create email subscriptions. - Use the
addSmsmethod to create SMS subscriptions.

Best practices for multi-channel communication
- Obtain explicit consent before adding email or SMS subscriptions.
- Explain the benefits of each communication channel to users.
- Provide channel preferences so users can select which channels they prefer.
Privacy & user consent
To control when OneSignal collects user data, use the SDK’s consent gating methods:setConsentRequired(true): Prevents data collection until consent is given.setConsentGiven(true): Enables data collection once consent is granted.
Prompt for push permissions
Instead of callingrequestPermission() immediately on app open, take a more strategic approach. Use an in-app message to explain the value of push notifications before requesting permission.
For best practices and implementation details, see our Prompt for push permissions guide.
Listen to push, user, and in-app events
Use SDK listeners to react to user actions and state changes. The SDK provides several event listeners for you to hook into. See our SDK reference guide for more details.Push notification events
addClickListener(): Detect when a notification is tapped. Helpful for Deep Linking.addForegroundLifecycleListener(): Control how notifications behave in foreground.
User state changes
addObserver()for user state: Detect when the External ID is set.addPermissionObserver(): Track the user’s specific interaction with the native push permission prompt.addObserver()for push subscription: Track when the push subscription status changes.
In-app message events
addClickListener(): Handle in-app click actions. Ideal for deep linking or tracking events.addLifecycleListener(): Track full lifecycle of in-app messages (shown, clicked, dismissed, etc.).
Advanced setup & capabilities
Explore more capabilities to enhance your integration:- 🔁 Migrating to OneSignal from another service
- 🌍 Location tracking
- 🔗 Deep Linking
- 🔌 Integrations
- 🧩 Mobile Service Extensions
- 🛎️ Action buttons
- 🌐 Multi-language messaging
- 🛡️ Identity Verification
- 📊 Custom Outcomes
- 📲 Live Activities
Mobile SDK setup & reference
Make sure you’ve enabled all key features by reviewing the Mobile push setup guide. For full details on available methods and configuration options, visit the Mobile SDK reference.Congratulations! You’ve successfully completed the Mobile SDK setup guide.





