> ## Documentation Index
> Fetch the complete documentation index at: https://documentation.onesignal.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Configuração do Mobile SDK
> Configure o SDK do OneSignal para Android, iOS, Huawei e frameworks multiplataforma como React Native, Flutter e Unity.
export const SdkReleasesIframe = ({sdkFilter = undefined, viewMode = undefined, height, ...frameProps}) => {
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
;
};
O SDK mobile do OneSignal habilita [notificações push](./push), [mensagens in-app](./in-app-messages-setup) e [Live Activities](./live-activities) nos seus apps iOS, Android, Huawei e Amazon. A configuração tem duas etapas:
1. **Configurar credenciais da plataforma** — conecte suas credenciais FCM, APNs, HMS ou ADM ao OneSignal
2. **Integrar o SDK** — instale o SDK do OneSignal para sua plataforma e inicialize-o no seu app
Para websites, consulte [Configuração do Web SDK](./web-push-setup).
***
## Configurar credenciais da plataforma
Cada plataforma requer suas próprias credenciais push. Configure as credenciais para cada plataforma que seu app suporta antes de integrar o SDK.
### Configure seu app e plataforma OneSignal
Configure seu app OneSignal com as plataformas que você suporta — Apple (APNs), Google (FCM), Huawei (HMS) e/ou Amazon (ADM).
Se sua organização já tem uma conta OneSignal, [peça para ser convidado](/docs/pt-BR/manage-team-members) à Organização. Caso contrário, [cadastre-se para uma conta gratuita](https://onesignal.com) para começar.
Crie um novo app clicando em **New App/Website**, ou adicione uma plataforma a um app existente em **Settings > Push & In-App**. Selecione a(s) plataforma(s) que você quer configurar e clique em **Next: Configure Your Platform**.
Insira as credenciais para sua plataforma:
* **Android**: [Configure Credenciais Firebase](/docs/pt-BR/android-firebase-credentials)
* **iOS**: [Token p8 (Recomendado)](/docs/pt-BR/ios-p8-token-based-connection-to-apns) ou [Certificado p12](/docs/pt-BR/ios-p12-generate-certificates)
* **Amazon**: [Gere API Key](/docs/pt-BR/generate-an-amazon-api-key)
* **Huawei**: [Autorize OneSignal](/docs/pt-BR/authorize-onesignal-to-send-huawei-push)
Clique em **Save & Continue** após inserir suas credenciais.
Seu **App ID** é exibido na tela final. Copie e salve-o — você precisa dele ao inicializar o SDK. Selecione sua plataforma de SDK e siga o guia de configuração.
***
## Integrar o SDK
Integre o SDK do OneSignal em apps Android nativos usando FCM.
Integre o SDK do OneSignal em apps iOS nativos usando APNs.
Configuração para ambientes React Native e Expo.
Configuração do SDK para apps Flutter usando Dart.
Configuração do SDK multiplataforma para apps mobile baseados em Unity.
Integre o SDK do OneSignal com apps .NET MAUI.
Configuração do SDK para dispositivos Huawei usando serviços push HMS.
Configuração para apps mobile híbridos Cordova, Ionic e Capacitor.
### Outras integrações
Configuração do SDK low-code para apps FlutterFlow.
Guia de integração para apps Median.co (anteriormente GoNative.io).
***
## Versões do SDK
***
## FAQ
### Os SDKs são necessários?
Não, mas são altamente recomendados e open source no [GitHub](https://github.com/OneSignal/sdks). Você pode integrar o OneSignal usando apenas a [REST API](/reference/rest-api-overview), mas os SDKs simplificam significativamente o processo, especialmente para lidar com notificações push entre plataformas.
### O que posso fazer sem o SDK?
Você pode usar as seguintes APIs diretamente:
* [Criar usuário](/reference/create-user)
* [Criar assinatura](/reference/create-subscription)
* [Atualizar usuário](/reference/update-user)
* [Atualizar assinatura](/reference/update-subscription)
* [Criar mensagem](/reference/create-message)
* [Referência de payload de notificação](./osnotification-payload)
[Mensagens in-app](./in-app-messages-setup) e [Live Activities](./live-activities) requerem o SDK — elas não podem ser entregues apenas via API.
### Por que vocês recomendam usar os SDKs?
Notificações push têm requisitos específicos de plataforma que os SDKs lidam para você, incluindo:
* Obter push tokens em Android, iOS, Huawei e web
* Gerenciar status de assinatura e prompts de opt-in do usuário
* Exibir e processar notificações push no cliente
Os APNs da Apple e o FCM do Google usam formatos de payload diferentes. O SDK do OneSignal analisa payloads personalizados para exibir e rastrear mensagens com precisão. Manter isso manualmente adiciona complexidade significativa. Saiba mais: [Build vs. Buy: What Goes Into Building a Push Notification Platform](https://onesignal.com/blog/build-vs-buy-what-goes-into-building-a-push-notification-platform/)
### Preciso de apps OneSignal separados para iOS e Android?
Não. Um único app OneSignal suporta múltiplas plataformas — iOS, Android, Huawei, Amazon e web. Configure as credenciais de cada plataforma em **Settings > Push & In-App** e todas compartilham o mesmo app, usuários e segmentos.
### Dispositivos na China ou na Huawei podem receber notificações push?
Se o dispositivo tem Google Play Services, recebe push via FCM. Se o app foi baixado da Huawei AppGallery (incluindo dispositivos Huawei não-HarmonyOS rodando Android), recebe push via HMS — configure o [SDK Huawei](./huawei-sdk-setup) para habilitar isso. O OneSignal usa FCM por padrão para dispositivos que suportam tanto HMS quanto FCM. Você pode [preferir HMS sobre FCM](./huawei-sdk-setup#prefer-hms-over-fcm-optional) se necessário.