Pular para o conteúdo principal

Início Rápido Android - Libs

O primeiro passo é instalar a biblioteca vinculando a dependência no seu arquivo build.gradle. Isso é feito através da instalação automática do Gradle.

Você precisará adicionar o repositório JitPack ao seu arquivo de build. Isso deve ser adicionado no final dos repositórios do seu build.gradle raiz:

repositories {
    google()
    mavenCentral()
    maven { url "https://jitpack.io" }
}

Em seguida, no seu arquivo build.gradle(app), baixe a biblioteca para o seu projeto adicionando a seguinte linha. Observe que o compiledSdk mínimo é 31.

dependencies{
    ...
    //Adicione esta linha
    implementation "com.grouplinknetwork:lib-grouplinknetwork:4.5.60"
}

Observe que após integrar o Grouplink, você pode precisar configurar o multidex.

O próximo passo é inicializar a biblioteca. Isso é feito adicionando a seguinte linha dentro da classe Application do aplicativo que usará o SDK ou adicionando a linha no método que inicializará o SDK dentro do APP:

kotlin

class App : Application() {
    override fun onCreate() {
        super.onCreate()
        ...
        ...
        //O Grouplink deve ser inicializado dentro
        //do onCreate da Application principal registrada.

        //adicione a seguinte linha
        GroupLink.register(
            context.applicationContext,
            "<GROUPLINK_TOKEN>",
            false //true se você quiser testar se a implementação está funcionando.
        )
    }
    ...
}

Você também deve adicionar as seguintes permissões necessárias nas instruções de integração ou diretamente no AndroidManifest do SDK:

 <uses-permission android:name="android.permission.INTERNET" />
  <uses-permission android:name="android.permission.ACCESS_FINE_LOCATION " />
  <uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION" />
  <uses-permission android:name="android.permission.BLUETOOTH_ADMIN" />
  <uses-permission android:name="android.permission.ACCESS_WIFI_STATE" />
  <uses-permission android:name="android.permission.FOREGROUND_SERVICE"/>
  <!-- Permissões obrigatórias para Android 12 e acima.-->
  <!-- Além disso, elas devem ser solicitadas em tempo de execução. -->
  <uses-permission android:name="android.permission.BLUETOOTH_SCAN"
        android:minSdkVersion="31"
        android:usesPermissionFlags="neverForLocation" />
    <uses-permission android:name="android.permission.BLUETOOTH_ADVERTISE" />
    <uses-permission android:name="android.permission.BLUETOOTH_CONNECT" />
  <!-- Permissões obrigatórias para Android 13 e acima. -->
  <!-- Além disso, devem ser solicitadas em tempo de execução. -->
  <uses-permission android:name="android.permission.FOREGROUND_SERVICE_LOCATION/>
  <uses-permission android:name="android.permission.POST_NOTIFICATIONS"/>

Idealmente, as seguintes permissões ajudariam o SDK a iniciar a varredura mesmo nas piores condições e cenários de ambiente:

<uses-permission android:name="android.permission.BLUETOOTH_PRIVILEGED"/>
<uses-permission android:name="android.permission.SYSTEM_ALERT_WINDOW/>
<uses-permission android:name="android.permission.QUERY_ALL_PACKAGES/>
<uses-permission android:name="android.permission.ACCESS_BACKGROUND_LOCATION/>