Pular para o conteúdo principal

Quickstart OutSystems Developer Cloud (ODC)

A biblioteca mobile do GroupLinkSDK gerencia as permissões de Bluetooth, Serviços em Segundo Plano, Localização e Notificação, com compatibilidade com iOS 15+ e Android 8+.

Requisitos​

  • Softwares necessários:
  • Permissões necessárias:
    • Acesso ao OutSystems Forge para baixar as dependências

Passo 1 - Obtendo a Biblioteca Mobile​

  1. No ODC Studio, clique em Install from Forge.

  1. Busque por GroupLinkSDK e clique em Install.

  1. Abra a biblioteca Mobile, clique em Try library, selecione o seu aplicativo e clique em Confirm.

Passo 2 - Configurando as especificidades da plataforma (Obrigatório)​

Criando o arquivo buildAction.json​

Crie um arquivo buildAction.json com o seguinte conteúdo:

{
    "platforms": {
        "ios": {
			"plist": [
                {
                    "replace": false,
                    "entries": [
                        {
                            "UIBackgroundModes": [
                                "location",
                                "bluetooth-central",
                                "bluetooth-peripheral",
                                "fetch",
                                "processing"
                            ],
                            "BGTaskSchedulerPermittedIdentifiers": [
                                "com.grouplinknetwork.bgtask"
                            ]
                        }
                    ]
                }
            ],
            "entitlements": {
                "replace": false,
                "entries": [
                    {
                        "com.apple.developer.networking.wifi-info": true
                    }
                ]
            }
        }
    }
}

Importando para os Resources do App​

Importe o arquivo buildAction.json para a pasta Resources do seu aplicativo e defina a sua Deploy Action como Deploy to Target Directory.

Referenciando na Extensibility do App​

Referencie o arquivo nas Extensibility Configurations do aplicativo:

{
  "buildConfigurations": {
    "buildAction": {
      "config": "$resources.buildAction.json"
    }
  }
}

Passo 3 - Usando as Client Actions do SDK​

O GroupLinkSDK expõe 4 Client Actions. Você pode arrastá-las para os seus fluxos de lógica.

StartSDK​

Inicializa o Group Link SDK. Requer um Token de autenticação.

Recomenda-se chamar esta action no evento de inicialização do aplicativo (OnReady), na primeira tela do aplicativo.

RequestPermissions​

Trata as solicitações nativas de permissão ao usuário. Ela adapta as solicitações de acordo com a versão do sistema operacional:

  • Android 11: Apenas Localização
  • Android 12: Localização e Bluetooth
  • Android 13+: Localização, Bluetooth e Notificações

Recomenda-se chamar esta action no evento de inicialização do aplicativo (OnReady), na primeira tela do aplicativo, logo abaixo da action StartSDK.

StartSDKAndRequestPermissions​

Unifica StartSDK e RequestPermissions em um único nó. Requer um Token de autenticação.

Recomenda-se chamar esta action no evento de inicialização do aplicativo (OnReady), na primeira tela do aplicativo.

SetNotificationName​

Configura a identificação remota do dispositivo. Recebe um parâmetro NotificationName (String).

A chamada deste método é obrigatória para a geração de determinados relatórios da plataforma.

Agora que o Group Link SDK está implementado e os recursos nativos estão configurados, o seu aplicativo ODC está pronto para interagir com o nosso ecossistema!