Pular para o conteúdo principal

Início Rápido Ionic

Requisitos​

Passo 1 - Obtendo o SDK​

Para obter nosso plugin Ionic, execute o seguinte comando no diretório raiz do seu projeto a partir do terminal na raiz do seu projeto Ionic.

npm install @grouplinknetwork/ionic-grouplink-sdk
npx cap sync

Passo 2 - Importando o SDK​

Primeiro, importe as dependências necessárias para o arquivo de inicialização da sua aplicação.

import * as Grouplink from "@grouplinknetwork/group-link-ionic-plugin";

Passo 3 - Configurando as especificidades da plataforma​

Especificidades do iOS​

Para garantir o funcionamento adequado do plugin em dispositivos iOS, você precisa inserir strings específicas no arquivo info.plist da sua aplicação. Essas strings estão relacionadas a permissões e capacidades do aplicativo. Você pode encontrar instruções detalhadas sobre como inseri-las consultando a documentação Permissões Necessárias para iOS.

Especificidades do Android​

Adicione o repositório JitPack ao seu arquivo de build. Adicione-o ao seu build.gradle raiz no final dos repositórios:

allprojects {
    repositories {
        ...
        maven { url 'https://jitpack.io' }
    }
}

Passo 4 - Chamando as funções do SDK​

Agora que você instalou e importou corretamente o plugin Ionic, basta chamar as funções do SDK no seu arquivo de inicialização. Recomendamos inicializar o SDK do Group Link no início da sua aplicação na função constructor() da sua aplicação:

constructor() {
    Grouplink.GLStart(
      "GROUP_LINK_TOKEN"
    );
  }

Solicitando permissões de Bluetooth e Localização​

Se o seu aplicativo não solicitar permissões de Bluetooth, Localização ou Notificações, o SDK do Group Link pode lidar com esse processo para você. No entanto, ainda é necessário solicitar essas permissões ao usuário para que o SDK funcione corretamente. Você pode iniciar esse processo chamando a função Grouplink.GLRequestPermissions().

// Solicitando as permissões de Bluetooth, localização e notificações do usuário;
Grouplink.GLRequestPermissions();

Obtendo o userID fornecido pelo usuário​

O userID é um identificador String opcional que é único para cada usuário dentro da rede Group Link. Utilizando este ID, você pode identificar quando um usuário específico se aproxima de um dos nossos dispositivos.

// Solicitando o userId do usuário;
Grouplink.GLGetUserID().then((id) => {
  this.userId = id;
});

Passo 5 - Configurando a capacidade de Notificação Push​

Para utilizar nossas notificações personalizadas no painel, você precisa chamar a função Grouplink.GLSetNotificationToken(). Esta função espera um parâmetro String, que representa o token de notificação do usuário. No iOS, esse token é fornecido pelo APNS (Apple Push Notification Service), enquanto no Android, ele é obtido através do Firebase Cloud Messaging.

Grouplink.GLSetNotificationToken("NOTIFICATION_TOKEN");

Agora, com o SDK do Group Link em sua aplicação, você pode utilizar seus recursos perfeitamente.