기기에 Google Play 서비스가 있으면 FCM을 통해 푸시를 받습니다. 앱이 Huawei AppGallery에서 다운로드된 경우(Android를 실행하는 비-HarmonyOS Huawei 기기 포함) HMS를 통해 푸시를 받습니다 — 이를 활성화하려면 Huawei SDK를 설정하세요. OneSignal은 HMS와 FCM을 모두 지원하는 기기에는 기본적으로 FCM을 사용합니다. 필요한 경우 FCM보다 HMS를 선호하도록 설정할 수 있습니다.
이 페이지가 도움이 되었나요?
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"OneSignal Documentation","description":"OneSignal is a platform for sending push notifications, emails, in-app messages, and SMS campaigns via a single API, Journey Builder, and a dashboard.","colors":{"primary":"#3A3DB3","light":"#E54B4D","dark":"#3A3DB3"},"logo":{"light":"https://mintcdn.com/onesignal/yJcueeDCO7UpHnnY/logo/OneSignal-Logo.svg?fit=max\u0026auto=format\u0026n=yJcueeDCO7UpHnnY\u0026q=85\u0026s=1fcfb6fef6d820fd9d99c74850711107","dark":"https://mintcdn.com/onesignal/s4WC_KzLxf8ornqq/logo/OneSignal-Logo-White.svg?fit=max\u0026auto=format\u0026n=s4WC_KzLxf8ornqq\u0026q=85\u0026s=2573a53b5aea961e18c82b3af8f31925"},"favicon":"https://mintcdn.com/onesignal/SGduBFHpiRdg5l6h/favicon.ico?fit=max\u0026auto=format\u0026n=SGduBFHpiRdg5l6h\u0026q=85\u0026s=c0a99fadc0553c658a83741c5611cef4","api":{"examples":{"languages":["curl","typescript","python","php","go","ruby","java","csharp","rust"],"autogenerate":true}},"navbar":{"links":[{"href":"mailto:support@onesignal.com","label":"Support"}],"primary":{"type":"button","label":"Dashboard","href":"https://dashboard.onesignal.com"}},"footer":{"socials":{"github":"https://github.com/OneSignal","linkedin":"https://linkedin.com/company/onesignal","youtube":"https://www.youtube.com/@onesignalofficial/playlists"}},"seo":{"metatags":{"apple-mobile-web-app-title":"OneSignal Docs"}},"fonts":{"family":"Nunito Sans"},"styling":{"eyebrows":"breadcrumbs","latex":true},"integrations":{"ga4":{"measurementId":"G-2DGWL0VYP5"},"posthog":{"apiKey":"phc_vZpvE0f5eyzcOt30FHer34yddVmNdo9kmlMVRBzLMtn","apiHost":"https://eu.i.posthog.com","sessionRecording":true}},"contextual":{"options":["copy","view","chatgpt","claude"],"display":"header"},"navigation":{"languages":[{"language":"en","href":"docs/en/home"},{"language":"cn","href":"docs/cn/home"},{"language":"ko","href":"docs/ko/home"},{"language":"ja","href":"docs/ja/home"},{"language":"tr","href":"docs/tr/home"},{"language":"pt-BR","href":"docs/pt-BR/home"},{"language":"es","href":"docs/es/home"},{"language":"fr","href":"docs/fr/home"}]}},"deployment":{"deploymentMetadataValue":{"subdomain":"onesignal","hasAudioNarration":false,"actualSubdomain":"onesignal","customDomains":["documentation.onesignal.com"],"gitSource":{"type":"github","owner":"onesignal","repo":"mintlify-docs","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"feedback":{"thumbs":true},"entitlements":{"AI_CHAT":{"status":"ENABLED"},"WEB_MCP":{"status":"ENABLED"},"NARRATION":{"status":"ENABLED"}},"buildId":"6af3b762ba298f9b99480a99","clientVersion":"0.0.4102","searchFilterCounts":[{"language":"en","tag":"User Guides","count":204},{"language":"es","tag":"Guías del Usuario","count":178},{"language":"fr","tag":"Guides utilisateur","count":178},{"language":"ja","tag":"ユーザーガイド","count":178},{"language":"ko","tag":"사용자 가이드","count":178},{"language":"pt-BR","tag":"Guia do Usuário","count":178},{"language":"tr","tag":"Kullanıcı Kılavuzları","count":178},{"language":"cn","tag":"用户指南","count":176},{"language":"en","tag":"Message channels","count":90},{"language":"es","tag":"Canales de mensajería","count":84},{"language":"fr","tag":"Canaux de messagerie","count":84},{"language":"ja","tag":"メッセージングチャネル","count":84},{"language":"ko","tag":"메시지 채널","count":84},{"language":"pt-BR","tag":"Canais de mensagem","count":84},{"language":"tr","tag":"Mesaj kanalları","count":84},{"language":"cn","tag":"消息渠道","count":83},{"language":"default","tag":"API Reference","count":68},{"language":"default","tag":"API reference","count":64},{"language":"en","tag":"Analytics \u0026 Integrations","count":53},{"language":"es","tag":"Analítica \u0026 Integraciones","count":52},{"language":"fr","tag":"Analyses et intégrations","count":52},{"language":"ja","tag":"分析 \u0026 統合","count":52},{"language":"ko","tag":"분석 \u0026 통합","count":52},{"language":"pt-BR","tag":"Análises \u0026 Integrações","count":52},{"language":"tr","tag":"Analitik ve Entegrasyonlar","count":52},{"language":"cn","tag":"分析和集成","count":51},{"language":"cn","tag":"开发者指南","count":48},{"language":"es","tag":"Guías del desarrollador","count":48},{"language":"fr","tag":"Guides développeur","count":48},{"language":"ja","tag":"開発者ガイド","count":48},{"language":"ko","tag":"개발자 가이드","count":48},{"language":"tr","tag":"Geliştirici Kılavuzları","count":48},{"language":"en","tag":"Developer Guides","count":47},{"language":"pt-BR","tag":"Guia de desenvolvedor","count":47},{"language":"en","tag":"Integrations","count":37},{"language":"es","tag":"Integraciones","count":37},{"language":"fr","tag":"Intégrations","count":37},{"language":"ja","tag":"統合","count":37},{"language":"ko","tag":"통합","count":37},{"language":"pt-BR","tag":"Integrações","count":37},{"language":"tr","tag":"Entegrasyonlar","count":37},{"language":"cn","tag":"集成","count":36},{"language":"en","tag":"Tutorials","count":35},{"language":"cn","tag":"推送通知","count":31},{"language":"cn","tag":"OneSignal 作为目的地","count":31},{"language":"en","tag":"Push","count":31},{"language":"en","tag":"OneSignal as destination","count":31},{"language":"es","tag":"Push notificaciones","count":31},{"language":"es","tag":"OneSignal como destino","count":31},{"language":"fr","tag":"Push","count":31},{"language":"fr","tag":"OneSignal comme destination","count":31},{"language":"ja","tag":"プッシュ通知","count":31},{"language":"ja","tag":"OneSignal as 宛先","count":31},{"language":"ko","tag":"푸시","count":31},{"language":"ko","tag":"OneSignal을 데이터 목적지로 사용","count":31},{"language":"pt-BR","tag":"Push notificações","count":31},{"language":"pt-BR","tag":"OneSignal como destino","count":31},{"language":"tr","tag":"Anlık bildirimler","count":31},{"language":"tr","tag":"OneSignal hedef","count":31},{"language":"en","tag":"Mobile SDKs","count":26},{"language":"cn","tag":"移动SDK","count":25},{"language":"es","tag":"SDKs móviles","count":25},{"language":"fr","tag":"SDK mobiles","count":25},{"language":"ja","tag":"モバイルSDK","count":25},{"language":"ko","tag":"모바일 SDKs","count":25},{"language":"pt-BR","tag":"SDKs móveis","count":25},{"language":"tr","tag":"Mobil SDK'lar","count":25},{"language":"cn","tag":"教程","count":24},{"language":"es","tag":"Tutoriales","count":24},{"language":"fr","tag":"Tutoriels","count":24},{"language":"ja","tag":"チュートリアル","count":24},{"language":"ko","tag":"튜토리얼","count":24},{"language":"pt-BR","tag":"Tutoriais","count":24},{"language":"tr","tag":"Eğitimler","count":24},{"language":"en","tag":"Mobile SDK setup","count":19},{"language":"cn","tag":"移动SDK设置","count":18},{"language":"es","tag":"Configuración del SDK móvil","count":18},{"language":"fr","tag":"Configuration SDK mobile","count":18},{"language":"ja","tag":"モバイルSDKセットアップ","count":18},{"language":"ko","tag":"모바일 SDK 설정","count":18},{"language":"pt-BR","tag":"Configuração do SDK móvel","count":18},{"language":"tr","tag":"Mobil SDK kurulumu","count":18},{"language":"default","tag":"Messages","count":9},{"language":"default","tag":"Users","count":9},{"language":"default","tag":"Organization","count":9},{"language":"default","tag":"Journeys","count":8},{"language":"default","tag":"Deprecated","count":6},{"language":"default","tag":"Templates","count":6},{"language":"default","tag":"Subscriptions","count":6},{"language":"default","tag":"Segments","count":5}]},"assistantConfig":{"enableStarterQuestions":false,"deflection":{"enabled":true,"email":"support@onesignal.com","showHelpButton":true}},"basePath":"","hasChatPermissions":true,"hasWebMcpPermissions":true,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-rbac-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-metadata","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":true},"customCss":[],"page":{"pagePath":"docs/ko/mobile-sdk-setup","slug":"/docs/ko/mobile-sdk-setup","pageMetadata":{"title":"모바일 SDK 설정","description":"Android, iOS, Huawei 및 React Native, Flutter, Unity와 같은 크로스 플랫폼 프레임워크용 OneSignal SDK를 설정합니다.","keywords":["모바일 SDK","Android 설정","iOS 설정","React Native","Unity","Flutter","Cordova","푸시 알림"],"href":"/docs/ko/mobile-sdk-setup"},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"Android, iOS, Huawei 및 React Native, Flutter, Unity와 같은 크로스 플랫폼 프레임워크용 OneSignal SDK를 설정합니다.\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];const SdkReleasesIframe=({sdkFilter=undefined,viewMode=undefined,height,...frameProps})=>{const{Frame}=_provideComponents()||{};if(!Frame)_missingMdxReference(`Frame`,true);const baseUrl=`https://onesignal.github.io/sdk-releases`;const buildUrl=(theme,sdkFilter,viewMode)=>{const url=new URL(baseUrl);const params=new URLSearchParams;if(theme){params.set(`theme`,theme)}if(sdkFilter){params.set(`sdk`,sdkFilter)}if(viewMode){params.set(`viewMode`,viewMode)}if(params.toString()){url.search=params.toString()}return url.toString()};const detectTheme=()=>{if(document.documentElement.classList.contains(`dark`)){return`dark`}return`light`};const[theme,setTheme]=useState(`light`);const[iframeSrc,setIframeSrc]=useState(()=>{const initialTheme=detectTheme();return buildUrl(initialTheme,sdkFilter,viewMode)});useEffect(()=>{const currentTheme=detectTheme();setTheme(currentTheme);setIframeSrc(buildUrl(currentTheme,sdkFilter,viewMode));const mediaQuery=window.matchMedia(`(prefers-color-scheme: dark)`);const handleThemeChange=()=>{const newTheme=detectTheme();setTheme(newTheme);setIframeSrc(buildUrl(newTheme,sdkFilter,viewMode))};if(mediaQuery.addEventListener){mediaQuery.addEventListener(`change`,handleThemeChange)}else{mediaQuery.addListener(handleThemeChange)}window.addEventListener(`storage`,handleThemeChange);const observer=new MutationObserver(handleThemeChange);observer.observe(document.documentElement,{attributes:true,attributeFilter:[`class`,`data-theme`]});return()=>{if(mediaQuery.removeEventListener){mediaQuery.removeEventListener(`change`,handleThemeChange)}else{mediaQuery.removeListener(handleThemeChange)}window.removeEventListener(`storage`,handleThemeChange);observer.disconnect()}},[sdkFilter,viewMode]);const getIframeHeight=()=>{if(viewMode===`table`){return`450`}if(viewMode===`mini`){return`170`}return`800`};const iframeHeight=height||getIframeHeight();return _jsx(Frame,{...frameProps,children:_jsx(`iframe`,{src:iframeSrc,width:`100%`,height:iframeHeight,frameBorder:`0`,style:{border:`none`},title:`SDK Releases`},iframeSrc)})};function _createMdxContent(props){const _components={a:`a`,hr:`hr`,li:`li`,ol:`ol`,p:`p`,strong:`strong`,ul:`ul`,..._provideComponents(),...props.components},{Accordion,Card,Columns,Frame,Heading,Info,Note,OptimizedImage,Step,Steps,_MdxComponentBoundary}=_components;if(!Accordion)_missingMdxReference(`Accordion`,true);if(!Card)_missingMdxReference(`Card`,true);if(!Columns)_missingMdxReference(`Columns`,true);if(!Frame)_missingMdxReference(`Frame`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!Info)_missingMdxReference(`Info`,true);if(!Note)_missingMdxReference(`Note`,true);if(!OptimizedImage)_missingMdxReference(`OptimizedImage`,true);if(!Step)_missingMdxReference(`Step`,true);if(!Steps)_missingMdxReference(`Steps`,true);if(!_MdxComponentBoundary)_missingMdxReference(`_MdxComponentBoundary`,true);return _jsxs(_Fragment,{children:[_jsxs(_components.p,{children:[`OneSignal 모바일 SDK는 iOS, Android, Huawei 및 Amazon 앱에서 `,_jsx(_components.a,{href:`/docs/ko/push`,children:`푸시 알림`}),`, `,_jsx(_components.a,{href:`/docs/ko/in-app-messages-setup`,children:`인앱 메시지`}),`, `,_jsx(_components.a,{href:`/docs/ko/live-activities`,children:`Live Activities`}),`를 활성화합니다. 설정은 두 단계로 이루어집니다:`]}),`\n`,_jsxs(_components.ol,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`플랫폼 자격 증명 구성`}),` — FCM, APNs, HMS 또는 ADM 자격 증명을 OneSignal에 연결`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`SDK 통합`}),` — 플랫폼용 OneSignal SDK를 설치하고 앱에서 초기화`]}),`\n`]}),`\n`,_jsxs(_components.p,{children:[`웹사이트의 경우 `,_jsx(_components.a,{href:`/docs/ko/web-push-setup`,children:`Web SDK 설정`}),`을 참조하세요.`]}),`\n`,_jsx(_components.hr,{}),`\n`,_jsx(Heading,{level:`2`,id:`플랫폼-자격-증명-구성`,children:`플랫폼 자격 증명 구성`}),`\n`,_jsx(_components.p,{children:`각 플랫폼에는 고유한 푸시 자격 증명이 필요합니다. SDK를 통합하기 전에 앱이 지원하는 모든 플랫폼의 자격 증명을 구성하세요.`}),`\n`,_jsx(Heading,{level:`3`,id:`onesignal-앱-및-플랫폼-구성`,children:`OneSignal 앱 및 플랫폼 구성`}),`\n`,_jsx(_components.p,{children:`지원하는 플랫폼(Apple (APNs), Google (FCM), Huawei (HMS), Amazon (ADM))으로 OneSignal 앱을 구성하세요.`}),`\n`,_jsx(Note,{children:_jsxs(_components.p,{children:[`조직에 이미 OneSignal 계정이 있는 경우 조직에 `,_jsx(_components.a,{href:`/docs/ko/manage-team-members`,children:`초대를 요청`}),`하세요. 그렇지 않은 경우 `,_jsx(_components.a,{href:`https://onesignal.com`,children:`무료 계정에 가입`}),`하여 시작하세요.`]})}),`\n`,_jsx(Accordion,{title:`단계별 설정 지침`,icon:`circle-chevron-down`,id:`new-app%2Fwebsite%EB%A5%BC-%ED%81%B4%EB%A6%AD%ED%95%98%EC%97%AC-%EC%83%88-%EC%95%B1%EC%9D%84-%EB%A7%8C%EB%93%A4%EA%B1%B0%EB%82%98-%EC%84%A4%EC%A0%95-%3E-%ED%91%B8%EC%8B%9C-%EB%B0%8F-%EC%9D%B8%EC%95%B1%EC%97%90%EC%84%9C-%EA%B8%B0%EC%A1%B4-%EC%95%B1%EC%97%90-%ED%94%8C%EB%9E%AB%ED%8F%BC%EC%9D%84-%EC%B6%94%EA%B0%80%ED%95%A9%EB%8B%88%EB%8B%A4.-%EA%B5%AC%EC%84%B1%ED%95%98%EB%A0%A4%EB%8A%94-%ED%94%8C%EB%9E%AB%ED%8F%BC%EC%9D%84-%EC%84%A0%ED%83%9D%ED%95%98%EA%B3%A0-next%3A-configure-your-platform%EC%9D%84-%ED%81%B4%EB%A6%AD%ED%95%A9%EB%8B%88%EB%8B%A4.%ED%94%8C%EB%9E%AB%ED%8F%BC%EC%97%90-%EB%8C%80%ED%95%9C-%EC%9E%90%EA%B2%A9-%EC%A6%9D%EB%AA%85%EC%9D%84-%EC%9E%85%EB%A0%A5%ED%95%A9%EB%8B%88%EB%8B%A4%3A-android%3A-firebase-%EC%9E%90%EA%B2%A9-%EC%A6%9D%EB%AA%85-%EC%84%A4%EC%A0%95-ios%3A-p8-%ED%86%A0%ED%81%B0(%EA%B6%8C%EC%9E%A5)-%EB%98%90%EB%8A%94-p12-%EC%9D%B8%EC%A6%9D%EC%84%9C-amazon%3A-api-%ED%82%A4-%EC%83%9D%EC%84%B1-huawei%3A-onesignal-%EA%B6%8C%ED%95%9C-%EB%B6%80%EC%97%AC-%EC%9E%90%EA%B2%A9-%EC%A6%9D%EB%AA%85%EC%9D%84-%EC%9E%85%EB%A0%A5%ED%95%9C-%ED%9B%84-save-%26-continue%EB%A5%BC-%ED%81%B4%EB%A6%AD%ED%95%A9%EB%8B%88%EB%8B%A4.%EC%95%B1-id%EA%B0%80-%EC%B5%9C%EC%A2%85-%ED%99%94%EB%A9%B4%EC%97%90-%ED%91%9C%EC%8B%9C%EB%90%A9%EB%8B%88%EB%8B%A4.-%EB%B3%B5%EC%82%AC%ED%95%98%EA%B3%A0-%EC%A0%80%EC%9E%A5%ED%95%98%EC%84%B8%EC%9A%94-%E2%80%94-sdk%EB%A5%BC-%EC%B4%88%EA%B8%B0%ED%99%94%ED%95%A0-%EB%95%8C-%ED%95%84%EC%9A%94%ED%95%A9%EB%8B%88%EB%8B%A4.-sdk-%ED%94%8C%EB%9E%AB%ED%8F%BC%EC%9D%84-%EC%84%A0%ED%83%9D%ED%95%9C-%EB%8B%A4%EC%9D%8C-%EC%84%A4%EC%A0%95-%EA%B0%80%EC%9D%B4%EB%93%9C%EB%A5%BC-%EB%94%B0%EB%A6%85%EB%8B%88%EB%8B%A4.`,children:_jsxs(Steps,{children:[_jsxs(Step,{title:`앱 만들기 또는 선택`,children:[_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`New App/Website`}),`를 클릭하여 새 앱을 만들거나 `,_jsx(_components.strong,{children:`설정 > 푸시 및 인앱`}),`에서 기존 앱에 플랫폼을 추가합니다. 구성하려는 플랫폼을 선택하고 `,_jsx(_components.strong,{children:`Next: Configure Your Platform`}),`을 클릭합니다.`]}),_jsx(Frame,{caption:`첫 번째 OneSignal 앱, 조직 및 채널 설정.`,children:_jsx(OptimizedImage,{src:`https://mintcdn.com/onesignal/BK2J-grzBpDdh8NC/images/dashboard/new-app-org-channel.png?fit=max\u0026auto=format\u0026n=BK2J-grzBpDdh8NC\u0026q=85\u0026s=ee0045484152ed15095f619344aa0564`,alt:`조직 이름, 앱 이름 및 채널 선택을 포함한 새 앱 설정 흐름을 보여주는 OneSignal 대시보드`,\"data-og-width\":`2592`,width:`2592`,\"data-og-height\":`1904`,height:`1904`,\"data-path\":`images/dashboard/new-app-org-channel.png`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/onesignal/BK2J-grzBpDdh8NC/images/dashboard/new-app-org-channel.png?w=280\u0026fit=max\u0026auto=format\u0026n=BK2J-grzBpDdh8NC\u0026q=85\u0026s=f561f13a86901e1a2acdbd8168635499 280w, https://mintcdn.com/onesignal/BK2J-grzBpDdh8NC/images/dashboard/new-app-org-channel.png?w=560\u0026fit=max\u0026auto=format\u0026n=BK2J-grzBpDdh8NC\u0026q=85\u0026s=7593b9333b4b1014ff381e29a9917248 560w, https://mintcdn.com/onesignal/BK2J-grzBpDdh8NC/images/dashboard/new-app-org-channel.png?w=840\u0026fit=max\u0026auto=format\u0026n=BK2J-grzBpDdh8NC\u0026q=85\u0026s=cb25a94f23d4618aa13f3ab02266fe92 840w, https://mintcdn.com/onesignal/BK2J-grzBpDdh8NC/images/dashboard/new-app-org-channel.png?w=1100\u0026fit=max\u0026auto=format\u0026n=BK2J-grzBpDdh8NC\u0026q=85\u0026s=ae1289473e1d3cc74948128412ddaf49 1100w, https://mintcdn.com/onesignal/BK2J-grzBpDdh8NC/images/dashboard/new-app-org-channel.png?w=1650\u0026fit=max\u0026auto=format\u0026n=BK2J-grzBpDdh8NC\u0026q=85\u0026s=0364af2ee413e616e7132fdcb455b1c0 1650w, https://mintcdn.com/onesignal/BK2J-grzBpDdh8NC/images/dashboard/new-app-org-channel.png?w=2500\u0026fit=max\u0026auto=format\u0026n=BK2J-grzBpDdh8NC\u0026q=85\u0026s=e1db1a4fc565b3a6f90c9f0a012286ca 2500w`})})]}),_jsxs(Step,{title:`플랫폼 자격 증명 구성`,children:[_jsx(_components.p,{children:`플랫폼에 대한 자격 증명을 입력합니다:`}),_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Android`}),`: `,_jsx(_components.a,{href:`/docs/ko/android-firebase-credentials`,children:`Firebase 자격 증명 설정`})]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`iOS`}),`: `,_jsx(_components.a,{href:`/docs/ko/ios-p8-token-based-connection-to-apns`,children:`p8 토큰(권장)`}),` 또는 `,_jsx(_components.a,{href:`/docs/ko/ios-p12-generate-certificates`,children:`p12 인증서`})]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Amazon`}),`: `,_jsx(_components.a,{href:`/docs/ko/generate-an-amazon-api-key`,children:`API 키 생성`})]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Huawei`}),`: `,_jsx(_components.a,{href:`/docs/ko/authorize-onesignal-to-send-huawei-push`,children:`OneSignal 권한 부여`})]}),`\n`]}),_jsxs(_components.p,{children:[`자격 증명을 입력한 후 `,_jsx(_components.strong,{children:`Save \u0026 Continue`}),`를 클릭합니다.`]})]}),_jsxs(Step,{title:`앱 ID를 저장하고 SDK 설치`,children:[_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`앱 ID`}),`가 최종 화면에 표시됩니다. 복사하고 저장하세요 — SDK를 초기화할 때 필요합니다. SDK 플랫폼을 선택한 다음 설정 가이드를 따릅니다.`]}),_jsx(Frame,{caption:`앱 ID를 저장하고 추가 팀 구성원을 초대합니다.`,children:_jsx(OptimizedImage,{src:`https://mintcdn.com/onesignal/VypVshrFHTBZfEma/images/dashboard/app-id-and-team-invite.png?fit=max\u0026auto=format\u0026n=VypVshrFHTBZfEma\u0026q=85\u0026s=e1e2aab6cca7c4aa6b9a76eff362d5af`,alt:`설정 후 앱 ID와 팀 초대 옵션을 보여주는 OneSignal 대시보드`,\"data-og-width\":`2592`,width:`2592`,\"data-og-height\":`1904`,height:`1904`,\"data-path\":`images/dashboard/app-id-and-team-invite.png`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/onesignal/VypVshrFHTBZfEma/images/dashboard/app-id-and-team-invite.png?w=280\u0026fit=max\u0026auto=format\u0026n=VypVshrFHTBZfEma\u0026q=85\u0026s=b9c148596d169748b1b5c59985dcb123 280w, https://mintcdn.com/onesignal/VypVshrFHTBZfEma/images/dashboard/app-id-and-team-invite.png?w=560\u0026fit=max\u0026auto=format\u0026n=VypVshrFHTBZfEma\u0026q=85\u0026s=515907e0935ef4656d6707d3dd20e590 560w, https://mintcdn.com/onesignal/VypVshrFHTBZfEma/images/dashboard/app-id-and-team-invite.png?w=840\u0026fit=max\u0026auto=format\u0026n=VypVshrFHTBZfEma\u0026q=85\u0026s=550f3af24a6586c1ad1a38cf821bdbd4 840w, https://mintcdn.com/onesignal/VypVshrFHTBZfEma/images/dashboard/app-id-and-team-invite.png?w=1100\u0026fit=max\u0026auto=format\u0026n=VypVshrFHTBZfEma\u0026q=85\u0026s=c000572d5a172450e3bd77de2d35c427 1100w, https://mintcdn.com/onesignal/VypVshrFHTBZfEma/images/dashboard/app-id-and-team-invite.png?w=1650\u0026fit=max\u0026auto=format\u0026n=VypVshrFHTBZfEma\u0026q=85\u0026s=84e9ff8e5638f2e5e20f2444ad4bb0c0 1650w, https://mintcdn.com/onesignal/VypVshrFHTBZfEma/images/dashboard/app-id-and-team-invite.png?w=2500\u0026fit=max\u0026auto=format\u0026n=VypVshrFHTBZfEma\u0026q=85\u0026s=cbb18f88eade13e63af36b7dd629d7df 2500w`})})]})]})}),`\n`,_jsx(_components.hr,{}),`\n`,_jsx(Heading,{level:`2`,id:`sdk-통합`,children:`SDK 통합`}),`\n`,_jsxs(Columns,{cols:2,children:[_jsx(Card,{title:`Android 네이티브`,icon:`android`,href:`/docs/ko/android-sdk-setup`,children:_jsx(_components.p,{children:`FCM을 사용하여 OneSignal SDK를 네이티브 Android 앱에 통합합니다.`})}),_jsx(Card,{title:`iOS 네이티브`,icon:`apple`,href:`/docs/ko/ios-sdk-setup`,children:_jsx(_components.p,{children:`APNs를 사용하여 OneSignal SDK를 네이티브 iOS 앱에 통합합니다.`})}),_jsx(Card,{title:`React Native 및 Expo`,icon:`react`,href:`/docs/ko/react-native-sdk-setup`,children:_jsx(_components.p,{children:`React Native 및 Expo 환경을 위한 설정.`})}),_jsx(Card,{title:`Flutter`,icon:`mobile`,href:`/docs/ko/flutter-sdk-setup`,children:_jsx(_components.p,{children:`Dart를 사용하는 Flutter 앱용 SDK 설정.`})}),_jsx(Card,{title:`Unity`,icon:`unity`,href:`/docs/ko/unity-sdk-setup`,children:_jsx(_components.p,{children:`Unity 기반 모바일 앱용 크로스 플랫폼 SDK 설정.`})}),_jsx(Card,{title:`.NET MAUI`,icon:`microsoft`,href:`/docs/ko/net-sdk-setup`,children:_jsx(_components.p,{children:`OneSignal SDK를 .NET MAUI 앱과 통합합니다.`})}),_jsx(Card,{title:`Huawei Android 네이티브`,icon:`mobile-screen`,href:`/docs/ko/huawei-sdk-setup`,children:_jsx(_components.p,{children:`HMS 푸시 서비스를 사용하는 Huawei 장치용 SDK 설정.`})}),_jsx(Card,{title:`Cordova, Ionic 및 Capacitor`,icon:`code`,href:`/docs/ko/cordova-sdk-setup`,children:_jsx(_components.p,{children:`Cordova, Ionic 및 Capacitor 하이브리드 모바일 앱을 위한 설정.`})})]}),`\n`,_jsx(Heading,{level:`3`,id:`기타-통합`,children:`기타 통합`}),`\n`,_jsxs(Columns,{cols:2,children:[_jsx(Card,{title:`FlutterFlow`,icon:`wand-magic-sparkles`,href:`/docs/ko/flutterflow-sdk-setup`,children:_jsx(_components.p,{children:`FlutterFlow 앱을 위한 로우코드 SDK 설정.`})}),_jsx(Card,{title:`Median.co`,icon:`globe`,href:`/docs/ko/median-integration`,children:_jsx(_components.p,{children:`Median.co(구 GoNative.io) 앱의 통합 가이드.`})})]}),`\n`,_jsx(_components.hr,{}),`\n`,_jsx(Heading,{level:`2`,id:`sdk-버전`,children:`SDK 버전`}),`\n`,_jsx(_MdxComponentBoundary,{name:`SdkReleasesIframe`,children:_jsx(SdkReleasesIframe,{sdkFilter:`android,ios,unity,flutter,xamarin,cordova,reactnative,dotnet`,viewMode:`table`,height:`500`})}),`\n`,_jsx(_components.hr,{}),`\n`,_jsx(Heading,{level:`2`,id:`faq`,children:`FAQ`}),`\n`,_jsx(Heading,{level:`3`,id:`sdk가-필수인가요`,children:`SDK가 필수인가요?`}),`\n`,_jsxs(_components.p,{children:[`아니요, 하지만 적극 권장됩니다 — `,_jsx(_components.a,{href:`https://github.com/OneSignal/sdks`,children:`GitHub`}),`에서 오픈 소스로 제공됩니다. `,_jsx(_components.a,{href:`/reference/rest-api-overview`,children:`REST API`}),`만 사용하여 OneSignal을 통합할 수 있지만, SDK를 사용하면 특히 플랫폼 전반에서 푸시 알림을 처리하는 프로세스가 크게 단순화됩니다.`]}),`\n`,_jsx(Heading,{level:`3`,id:`sdk-없이-할-수-있는-작업은`,children:`SDK 없이 할 수 있는 작업은?`}),`\n`,_jsx(_components.p,{children:`다음 API를 직접 사용할 수 있습니다:`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsx(_components.li,{children:_jsx(_components.a,{href:`/reference/create-user`,children:`사용자 생성`})}),`\n`,_jsx(_components.li,{children:_jsx(_components.a,{href:`/reference/create-subscription`,children:`구독 생성`})}),`\n`,_jsx(_components.li,{children:_jsx(_components.a,{href:`/reference/update-user`,children:`사용자 업데이트`})}),`\n`,_jsx(_components.li,{children:_jsx(_components.a,{href:`/reference/update-subscription`,children:`구독 업데이트`})}),`\n`,_jsx(_components.li,{children:_jsx(_components.a,{href:`/reference/create-message`,children:`메시지 생성`})}),`\n`,_jsx(_components.li,{children:_jsx(_components.a,{href:`/docs/ko/osnotification-payload`,children:`알림 페이로드 참조`})}),`\n`]}),`\n`,_jsx(Info,{children:_jsxs(_components.p,{children:[_jsx(_components.a,{href:`/docs/ko/in-app-messages-setup`,children:`인앱 메시지`}),`와 `,_jsx(_components.a,{href:`/docs/ko/live-activities`,children:`Live Activities`}),`는 SDK가 필요합니다 — API만으로는 전달할 수 없습니다.`]})}),`\n`,_jsx(Heading,{level:`3`,id:`sdk-사용을-권장하는-이유는`,children:`SDK 사용을 권장하는 이유는?`}),`\n`,_jsx(_components.p,{children:`푸시 알림에는 SDK가 처리하는 플랫폼별 요구 사항이 있습니다:`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsx(_components.li,{children:`Android, iOS, Huawei 및 웹에서 푸시 토큰 가져오기`}),`\n`,_jsx(_components.li,{children:`구독 상태 및 사용자 옵트인 프롬프트 관리`}),`\n`,_jsx(_components.li,{children:`클라이언트에서 푸시 알림 표시 및 처리`}),`\n`]}),`\n`,_jsxs(_components.p,{children:[`Apple의 APNs와 Google의 FCM은 서로 다른 페이로드 형식을 사용합니다. OneSignal SDK는 사용자 지정 페이로드를 파싱하여 메시지를 정확하게 표시하고 추적합니다. 이를 수동으로 유지 관리하면 상당한 복잡성이 추가됩니다. 자세히 알아보기: `,_jsx(_components.a,{href:`https://onesignal.com/blog/build-vs-buy-what-goes-into-building-a-push-notification-platform/`,children:`Build vs. Buy: What Goes Into Building a Push Notification Platform`})]}),`\n`,_jsx(Heading,{level:`3`,id:`ios와-android에-별도의-onesignal-앱이-필요한가요`,children:`iOS와 Android에 별도의 OneSignal 앱이 필요한가요?`}),`\n`,_jsxs(_components.p,{children:[`아니요. 단일 OneSignal 앱이 여러 플랫폼 — iOS, Android, Huawei, Amazon 및 웹 — 을 지원합니다. `,_jsx(_components.strong,{children:`설정 > 푸시 및 인앱`}),`에서 각 플랫폼의 자격 증명을 구성하면 모두 동일한 앱, 사용자 및 세그먼트를 공유합니다.`]}),`\n`,_jsx(Heading,{level:`3`,id:`중국-또는-huawei-기기가-푸시-알림을-받을-수-있나요`,children:`중국 또는 Huawei 기기가 푸시 알림을 받을 수 있나요?`}),`\n`,_jsxs(_components.p,{children:[`기기에 Google Play 서비스가 있으면 FCM을 통해 푸시를 받습니다. 앱이 Huawei AppGallery에서 다운로드된 경우(Android를 실행하는 비-HarmonyOS Huawei 기기 포함) HMS를 통해 푸시를 받습니다 — 이를 활성화하려면 `,_jsx(_components.a,{href:`/docs/ko/huawei-sdk-setup`,children:`Huawei SDK`}),`를 설정하세요. OneSignal은 HMS와 FCM을 모두 지원하는 기기에는 기본적으로 FCM을 사용합니다. 필요한 경우 `,_jsx(_components.a,{href:`/docs/ko/huawei-sdk-setup#prefer-hms-over-fcm-optional`,children:`FCM보다 HMS를 선호`}),`하도록 설정할 수 있습니다.`]})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{SdkReleasesIframe,default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"모바일 SDK 설정","description":"Android, iOS, Huawei 및 React Native, Flutter, Unity와 같은 크로스 플랫폼 프레임워크용 OneSignal SDK를 설정합니다.","keywords":["모바일 SDK","Android 설정","iOS 설정","React Native","Unity","Flutter","Cordova","푸시 알림"],"href":"/docs/ko/mobile-sdk-setup"}}},"mdxSourceWithNoJs":null,"noJsSplices":[[153,2202,")=>null;function _cr"]]},"mdxExtracts":{"tableOfContents":[{"title":"플랫폼 자격 증명 구성","slug":"플랫폼-자격-증명-구성","depth":2,"children":[{"title":"OneSignal 앱 및 플랫폼 구성","slug":"onesignal-앱-및-플랫폼-구성","depth":3,"children":[]}]},{"title":"SDK 통합","slug":"sdk-통합","depth":2,"children":[{"title":"기타 통합","slug":"기타-통합","depth":3,"children":[]}]},{"title":"SDK 버전","slug":"sdk-버전","depth":2,"children":[]},{"title":"FAQ","slug":"faq","depth":2,"children":[{"title":"SDK가 필수인가요?","slug":"sdk가-필수인가요","depth":3,"children":[]},{"title":"SDK 없이 할 수 있는 작업은?","slug":"sdk-없이-할-수-있는-작업은","depth":3,"children":[]},{"title":"SDK 사용을 권장하는 이유는?","slug":"sdk-사용을-권장하는-이유는","depth":3,"children":[]},{"title":"iOS와 Android에 별도의 OneSignal 앱이 필요한가요?","slug":"ios와-android에-별도의-onesignal-앱이-필요한가요","depth":3,"children":[]},{"title":"중국 또는 Huawei 기기가 푸시 알림을 받을 수 있나요?","slug":"중국-또는-huawei-기기가-푸시-알림을-받을-수-있나요","depth":3,"children":[]}]}],"codeExamples":{}},"jsLinks":["/_mintlify/custom/onesignal/e069c1b9f3157e14/hotjar-koala.js","/_mintlify/custom/onesignal/3e5d03885ab32f49/intercom.js","/_mintlify/custom/onesignal/dbb7af4794d1b586/munchkin-marketo.js"],"subdomain":"onesignal","siteName":"OneSignal Documentation","title":"모바일 SDK 설정 - OneSignal Documentation","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{"en":{"href":"/docs/en/mobile-sdk-setup","matchLevel":1},"cn":{"href":"/docs/cn/mobile-sdk-setup","matchLevel":1},"ko":{"href":"/docs/ko/mobile-sdk-setup","matchLevel":0},"ja":{"href":"/docs/ja/mobile-sdk-setup","matchLevel":1},"tr":{"href":"/docs/tr/mobile-sdk-setup","matchLevel":1},"pt-BR":{"href":"/docs/pt-BR/mobile-sdk-setup","matchLevel":1},"es":{"href":"/docs/es/mobile-sdk-setup","matchLevel":1},"fr":{"href":"/docs/fr/mobile-sdk-setup","matchLevel":1}}},"lastModified":"2026-05-06T00:15:09.383Z","originalFileLocation":"docs/ko/mobile-sdk-setup.mdx","locale":"ko"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Android, iOS, Huawei 및 React Native, Flutter, Unity와 같은 크로스 플랫폼 프레임워크용 OneSignal SDK를 설정합니다.\">\u003cmeta data-mint-head name=\"application-name\" content=\"OneSignal Documentation\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/onesignal/eCiRydtW5fLfLRWp/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/onesignal/eCiRydtW5fLfLRWp/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/onesignal/eCiRydtW5fLfLRWp/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/onesignal/eCiRydtW5fLfLRWp/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/onesignal/eCiRydtW5fLfLRWp/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/onesignal/eCiRydtW5fLfLRWp/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/onesignal/eCiRydtW5fLfLRWp/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/onesignal/eCiRydtW5fLfLRWp/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/onesignal/eCiRydtW5fLfLRWp/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"모바일 SDK 설정 - OneSignal Documentation\">\u003cmeta data-mint-head property=\"og:description\" content=\"Android, iOS, Huawei 및 React Native, Flutter, Unity와 같은 크로스 플랫폼 프레임워크용 OneSignal SDK를 설정합니다.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"OneSignal Documentation\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://documentation.onesignal.com/docs/ko/mobile-sdk-setup\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://onesignal.mintlify.site/_mintlify/api/og/v2?division=%EB%AA%A8%EB%B0%94%EC%9D%BC+SDK+%EC%84%A4%EC%A0%95\u0026amp;title=%EB%AA%A8%EB%B0%94%EC%9D%BC+SDK+%EC%84%A4%EC%A0%95\u0026amp;description=Android%2C+iOS%2C+Huawei+%EB%B0%8F+React+Native%2C+Flutter%2C+Unity%EC%99%80+%EA%B0%99%EC%9D%80+%ED%81%AC%EB%A1%9C%EC%8A%A4+%ED%94%8C%EB%9E%AB%ED%8F%BC+%ED%94%84%EB%A0%88%EC%9E%84%EC%9B%8C%ED%81%AC%EC%9A%A9+OneSignal+SDK%EB%A5%BC+%EC%84%A4%EC%A0%95%ED%95%A9%EB%8B%88%EB%8B%A4.\u0026amp;theme=12e705baa88dc8cc6d7a9877\u0026amp;signature=6069d645e1bb09102c05a230c300c0ae7ddc412e4be9d6041444305122edd85b\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"모바일 SDK 설정 - OneSignal Documentation\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Android, iOS, Huawei 및 React Native, Flutter, Unity와 같은 크로스 플랫폼 프레임워크용 OneSignal SDK를 설정합니다.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://onesignal.mintlify.site/_mintlify/api/og/v2?division=%EB%AA%A8%EB%B0%94%EC%9D%BC+SDK+%EC%84%A4%EC%A0%95\u0026amp;title=%EB%AA%A8%EB%B0%94%EC%9D%BC+SDK+%EC%84%A4%EC%A0%95\u0026amp;description=Android%2C+iOS%2C+Huawei+%EB%B0%8F+React+Native%2C+Flutter%2C+Unity%EC%99%80+%EA%B0%99%EC%9D%80+%ED%81%AC%EB%A1%9C%EC%8A%A4+%ED%94%8C%EB%9E%AB%ED%8F%BC+%ED%94%84%EB%A0%88%EC%9E%84%EC%9B%8C%ED%81%AC%EC%9A%A9+OneSignal+SDK%EB%A5%BC+%EC%84%A4%EC%A0%95%ED%95%A9%EB%8B%88%EB%8B%A4.\u0026amp;theme=12e705baa88dc8cc6d7a9877\u0026amp;signature=6069d645e1bb09102c05a230c300c0ae7ddc412e4be9d6041444305122edd85b\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/onesignal/eCiRydtW5fLfLRWp/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"OneSignal Docs\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#3A3DB3\">\u003clink data-mint-head rel=\"canonical\" href=\"https://documentation.onesignal.com/docs/ko/mobile-sdk-setup\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/docs/ko/mobile-sdk-setup.md\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"ko\" href=\"https://documentation.onesignal.com/docs/ko/mobile-sdk-setup\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"en\" href=\"https://documentation.onesignal.com/docs/en/mobile-sdk-setup\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"zh\" href=\"https://documentation.onesignal.com/docs/cn/mobile-sdk-setup\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"ja\" href=\"https://documentation.onesignal.com/docs/ja/mobile-sdk-setup\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"tr\" href=\"https://documentation.onesignal.com/docs/tr/mobile-sdk-setup\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"pt-BR\" href=\"https://documentation.onesignal.com/docs/pt-BR/mobile-sdk-setup\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"es\" href=\"https://documentation.onesignal.com/docs/es/mobile-sdk-setup\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"fr\" href=\"https://documentation.onesignal.com/docs/fr/mobile-sdk-setup\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"x-default\" href=\"https://documentation.onesignal.com/docs/en/mobile-sdk-setup\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://documentation.onesignal.com/#organization\",\"name\":\"OneSignal Documentation\",\"url\":\"https://documentation.onesignal.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/onesignal/yJcueeDCO7UpHnnY/logo/OneSignal-Logo.svg?fit=max\u0026auto=format\u0026n=yJcueeDCO7UpHnnY\u0026q=85\u0026s=1fcfb6fef6d820fd9d99c74850711107\"}},{\"@type\":\"WebSite\",\"@id\":\"https://documentation.onesignal.com#website\",\"name\":\"OneSignal Documentation\",\"url\":\"https://documentation.onesignal.com\",\"publisher\":{\"@id\":\"https://documentation.onesignal.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://documentation.onesignal.com/docs/ko/mobile-sdk-setup#webpage\",\"url\":\"https://documentation.onesignal.com/docs/ko/mobile-sdk-setup\",\"name\":\"모바일 SDK 설정\",\"description\":\"Android, iOS, Huawei 및 React Native, Flutter, Unity와 같은 크로스 플랫폼 프레임워크용 OneSignal SDK를 설정합니다.\",\"dateModified\":\"2026-05-06T00:15:09.383Z\",\"isPartOf\":{\"@id\":\"https://documentation.onesignal.com#website\"},\"breadcrumb\":{\"@id\":\"https://documentation.onesignal.com/docs/ko/mobile-sdk-setup#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://documentation.onesignal.com/docs/ko/mobile-sdk-setup#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"OneSignal Documentation\",\"item\":\"https://documentation.onesignal.com\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"모바일 SDK 설정\",\"item\":\"https://documentation.onesignal.com/docs/ko/mobile-sdk-setup\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://documentation.onesignal.com/docs/ko/mobile-sdk-setup#article\",\"headline\":\"모바일 SDK 설정\",\"name\":\"모바일 SDK 설정\",\"description\":\"Android, iOS, Huawei 및 React Native, Flutter, Unity와 같은 크로스 플랫폼 프레임워크용 OneSignal SDK를 설정합니다.\",\"url\":\"https://documentation.onesignal.com/docs/ko/mobile-sdk-setup\",\"mainEntityOfPage\":{\"@id\":\"https://documentation.onesignal.com/docs/ko/mobile-sdk-setup#webpage\"},\"dateModified\":\"2026-05-06T00:15:09.383Z\",\"keywords\":\"모바일 SDK, Android 설정, iOS 설정, React Native, Unity, Flutter, Cordova, 푸시 알림\",\"publisher\":{\"@id\":\"https://documentation.onesignal.com/#organization\"},\"isPartOf\":{\"@id\":\"https://documentation.onesignal.com#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"OneSignal Documentation\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"OneSignal Documentation\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/docs/ko/mobile-sdk-setup.md","siteName":"OneSignal Documentation","nav":{"global":null,"languages":[{"language":"en","pages":[{"title":"en","href":"/docs/en/mobile-sdk-setup"}]},{"language":"cn","pages":[{"title":"cn","href":"/docs/cn/mobile-sdk-setup"}]},{"language":"ko","tabs":[{"tab":"홈","pages":[{"title":"홈","href":"/docs/ko/home"}]},{"tab":"사용자 가이드","pages":[{"title":"사용자 가이드","href":"/docs/ko/quickstart-guide"}]},{"tab":"개발자 가이드","groups":[{"group":"개발자 문서","pages":[{"title":"개발자","href":"/docs/ko/developers"},{"title":"신원 확인","href":"/docs/ko/identity-verification"},{"group":"사용자 모델","pages":[{"title":"사용자 모델 및 마이그레이션 가이드","href":"/docs/ko/user-model-migration-guide"},{"title":"모바일 SDK 매핑","href":"/docs/ko/device-user-model-mobile-sdk-mapping"},{"title":"웹 SDK 매핑","description":"레거시 Player 모델과 새로운 User 모델 간의 OneSignal 웹 SDK 메서드를 비교하세요. TypeScript 기반 코드 예제 및 업데이트된 메서드 참조를 통해 구현을 마이그레이션하는 방법을 알아보세요.","href":"/docs/ko/device-user-model-web-sdk-mapping"}]}]},{"group":"모바일 SDKs","pages":[{"group":"모바일 SDK 설정","pages":[{"title":"모바일 SDK 설정","href":"/docs/ko/mobile-sdk-setup"},{"group":"플랫폼 자격 증명 설정","pages":[{"title":"Android Firebase 자격 증명","description":"OneSignal에서 Firebase Cloud Messaging(FCM) Service Account 자격 증명을 구성하여 Google Play 스토어의 앱에 Android 푸시 알림을 활성화하세요.","href":"/docs/ko/android-firebase-credentials"},{"title":"iOS p8 토큰 기반 APNs 연결","href":"/docs/ko/ios-p8-token-based-connection-to-apns"},{"title":"iOS p12 인증서 생성","href":"/docs/ko/ios-p12-generate-certificates"},{"title":"Amazon API 키 생성","href":"/docs/ko/generate-an-amazon-api-key"},{"title":"Huawei 승인","href":"/docs/ko/authorize-onesignal-to-send-huawei-push"}]},{"title":"iOS SDK 설정","href":"/docs/ko/ios-sdk-setup"},{"title":"Android SDK 설정","href":"/docs/ko/android-sdk-setup"},{"title":"Unity SDK 설정","href":"/docs/ko/unity-sdk-setup"},{"title":"React Native SDK 설정","href":"/docs/ko/react-native-sdk-setup"},{"title":"Expo SDK 설정","href":"/docs/ko/react-native-expo-sdk-setup"},{"title":"Flutter SDK 설정","href":"/docs/ko/flutter-sdk-setup"},{"title":"Flutterflow SDK 설정","href":"/docs/ko/flutterflow-sdk-setup"},{"title":"Cordova SDK 설정","href":"/docs/ko/cordova-sdk-setup"},{"title":"Capacitor SDK 설정","href":"/docs/ko/capacitor-sdk-setup"},{"title":".NET MAUI SDK 설정","href":"/docs/ko/net-sdk-setup"},{"title":"Amazon SDK 설정","href":"/docs/ko/amazon-sdk-setup"},{"title":"Huawei SDK 설정","href":"/docs/ko/huawei-sdk-setup"}]},{"group":"모바일 SDK 참조","pages":[{"title":"모바일 SDK 레퍼런스","href":"/docs/ko/mobile-sdk-reference"},{"title":"Mobile Service Extensions","href":"/docs/ko/service-extensions"},{"title":"알림 트레이 관리","href":"/docs/ko/managing-the-notification-tray"},{"title":"OSNotification payload","href":"/docs/ko/osnotification-payload"},{"title":"iOS: App Clip 지원","href":"/docs/ko/app-clip-support"}]},{"group":"모바일 SDK 문제 해결","pages":[{"title":"Mobile SDK 문제 해결","href":"/docs/ko/mobile-troubleshooting"},{"title":"디버그 로그 가져오기","href":"/docs/ko/capturing-a-debug-log"}]}]},{"group":"웹 SDKs","pages":[{"group":"웹 SDK 설정","pages":[{"title":"웹 SDK 설정","href":"/docs/ko/web-sdk-setup"},{"title":"iOS 웹 푸시 설정","href":"/docs/ko/web-push-for-ios"},{"title":"OneSignal service worker","href":"/docs/ko/onesignal-service-worker"},{"title":"OneSignal Web SDK를 사용한 사용자 지정 코드 웹 푸시 설정","href":"/docs/ko/web-push-custom-code-setup"},{"title":"Google Tag Manager 설정","href":"/docs/ko/google-tag-manager"},{"title":"Angular 웹 SDK 설정","href":"/docs/ko/angular-setup"},{"title":"ReactJS 및 NextJS 설정","href":"/docs/ko/react-js-setup"},{"title":"Vue JS Web SDK 설정","href":"/docs/ko/vue-js-setup"}]},{"title":"웹 SDK 참조","href":"/docs/ko/web-sdk-reference"},{"group":"웹 SDK 문제 해결","pages":[{"title":"Web SDK 문제 해결","href":"/docs/ko/troubleshooting-web-push"},{"title":"캐시 지우기 및 푸시 권한 재설정","href":"/docs/ko/clearing-cache-and-resetting-push-permissions"},{"title":"웹 푸시 Webhook","href":"/docs/ko/webhooks"}]}]},{"group":"실시간 현황","pages":[{"title":"Live Activities 개발자 설정","href":"/docs/ko/live-activities-developer-setup"},{"title":"크로스 플랫폼 Live Activity SDK 설정","href":"/docs/ko/cross-platform-live-activity-setup"},{"title":"Android Live Update 알림","href":"/docs/ko/android-live-notifications"}]},{"group":"데스크탑 \u0026 워치 설정","pages":[{"title":"macOS 앱 설정","href":"/docs/ko/macos-app-setup"},{"title":"Windows 앱 설정","href":"/docs/ko/windows-app-setup"},{"title":"watchOS 및 Wear OS 지원","href":"/docs/ko/watchos-and-wear-os-support"}]}]},{"tab":"튜토리얼","pages":[{"title":"튜토리얼","href":"/docs/ko/tutorials"}]},{"tab":"API Reference","pages":[{"title":"API Reference","href":"/reference/rest-api-overview"}]},{"tab":"Release Notes","pages":[{"title":"Release Notes","href":"/release-notes/changelog"}]}],"global":{"anchors":[{"anchor":"Blog","icon":"newspaper","href":"https://onesignal.com/blog"},{"anchor":"GitHub","icon":"github","href":"https://github.com/OneSignal"},{"anchor":"YouTube","icon":"youtube","href":"https://www.youtube.com/@onesignalofficial/playlists"}]}},{"language":"ja","pages":[{"title":"ja","href":"/docs/ja/mobile-sdk-setup"}]},{"language":"tr","pages":[{"title":"tr","href":"/docs/tr/mobile-sdk-setup"}]},{"language":"pt-BR","pages":[{"title":"pt-BR","href":"/docs/pt-BR/mobile-sdk-setup"}]},{"language":"es","pages":[{"title":"es","href":"/docs/es/mobile-sdk-setup"}]},{"language":"fr","pages":[{"title":"fr","href":"/docs/fr/mobile-sdk-setup"}]}]},"basePath":"","title":"모바일 SDK 설정 - OneSignal Documentation","buildId":"dpl_596ePT575z4qnAFksq1biRW97aLY","deploymentId":"dpl_596ePT575z4qnAFksq1biRW97aLY","dynamics":["07c022d89b","a74be98ba7"],"chunks":["Frame-BXrZabKK.js","DynamicMarkdown-CtasenyM.js","zoom-image-lightbox-C5F0mVLH.js","lightbox-handle-r17bVUz3.js"]}
