Nextail React Native SDK (nextail-rn-sdk)

Bridge React Native oficial da Nextail para a SDK nativa Android publicada no Maven Central como tech.nextail:nextail-sdk:1.0.1.

Status

• Plataforma suportada nesta versao: Android
• iOS: ainda nao suportado nesta release
• Dependencia nativa Android: tech.nextail:nextail-sdk:1.0.1

A SDK React Native da Nextail faz a ponte entre o seu app e o SDK nativo Android, permitindo:

• Registrar dispositivos.
• Associar usuários (userId / cpf / username) a devices.
• Receber notificações push enviadas via painel.

Instalação

No seu projeto React Native:

npm install nextail-rn-sdk
# ou
yarn add nextail-rn-sdk

No Android do app consumidor, garanta que o projeto usa mavenCentral() nos repositories do Gradle para resolver a dependencia nativa.

Uso básico

No ponto de inicialização do seu app (por exemplo, App.tsx ou logo após o login do usuário), faça:

import { initialize } from "nextail-rn-sdk";

async function setupNextail() {
  await initialize("YOUR_APP_ID", "YOUR_APP_KEY", "USER_ID");
}

• YOUR_APP_ID: ID da aplicação, obtido no painel Nextail na área de configurações da aplicação.
• YOUR_APP_KEY: chave de autenticação da aplicação, também disponível no painel.
• USER_ID: identificador único do usuário no seu sistema (por exemplo,CPF ou ID da tabela de usuários), esse campo é opcional, se não desejar enviar o identificador do usuário, enviar um campo vazio.

Depois de inicializar a SDK:

• Os devices começam a ser registrados na sua conta Nextail.
• Você pode criar campanhas no painel segmentando por app e, se aplicável, por usuário.

Permissão de notificação (Android 13+)

No Android 13 ou superior, a permissão de notificação é solicitada automaticamente na primeira chamada a initialize(). O usuário verá o diálogo do sistema; não é necessário abrir as configurações manualmente para ativar o recebimento de push.

Plataformas não suportadas

Se algum metodo da biblioteca for chamado fora do Android, a bridge lancara um erro explicito informando que nextail-rn-sdk suporta apenas Android nesta versao.

Publicando no npm

Pré-requisitos

• Node + Yarn instalados.
• Acesso ao npm:
  • npm login (ou configure um token via .npmrc).
• Java runtime disponível (usado pelo build que gera lib/ via react-native-builder-bob).

Opção recomendada: yarn release (release-it)

Use quando você quer que o projeto:

• faça o bump de versão (semver),
• gere tag no git,
• rode yarn prepare,
• e publique no npm.

No diretório sdks/react-native, rode:

cd sdks/react-native
yarn typecheck
yarn lint
yarn release --patch
# ou: --minor / --major

Opção alternativa: publicar manualmente com npm publish

Use quando você já atualizou a versão no sdks/react-native/package.json manualmente ou não quer usar tags do git.

1. Gere os artefatos de build:

cd sdks/react-native
yarn typecheck
yarn prepare

2. Valide antes:

npm publish --dry-run

3. Publicar:

npm publish

Se o npm publish falhar com 401 Unauthorized, faça npm login ou configure o token do npm.