Configuração

1) Adicionar repositórios

Primeiramente, será necessário adicionar os repositórios Maven necessários para o desenvolvimento no arquivo settings.gradle.kts:

dependencyResolutionManagement {
    repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS)
  
    repositories {
        // Outros repositorios (google, mavenLocal, etc)

        maven {
            url = uri("https://jitpack.io")
        }
        
        // Maven PayOsSdkDebug
        maven {
            url = uri("URL_MAVEN_PAYTIME_TAPONPHONESDK_DEBUG") // ou RELEASE
            credentials {
                username = "USERNAME_MAVEN_PAYTIME_TAPONPHONESDK_DEBUG" // ou RELEASE
                password = "PASSWORD_MAVEN_PAYTIME_TAPONPHONESDK_DEBUG" // ou RELEASE 
            }
            authentication {
                create<BasicAuthentication>("basic")
            }
        }
    }
}

🚧
Obs.: Não se esqueça de sincronizar o projeto após adicionar o repositório.

📘
Para acessar o repositório Maven privado, a Paytime irá providenciar a URL de conexão, nome de usuário e senha.
São usadas 2 configurações Maven diferentes, uma para TapOnPhoneSdkDebug e outra para TapOnPhoneSdkRelease, cada uma com sua própria URL, nome de usuário e senha.
A configuração para TapOnPhoneSdkRelease só será disponibilizada após a conclusão do processo de homologação.

❗️
É importante que as credenciais de conexão com o repositório Maven não sejam adicionadas diretamente no código (hard-coded). Recomenda-se utilizar arquivos de ambiente (.env) ou o local.properties e não adicionar esses arquivos na ferramenta de controle de versão (git, por exemplo).

2) Configuração e dependências do Gradle

Adicione as seguintes configurações e dependências ao arquivo build.gradle.kts da sua aplicação:

plugins {
    // Outros plugins
    id("com.google.devtools.ksp") version "2.3.5"
}

android {
    defaultConfig {
        minSdk = 30
    }
    
    // Crie a assinatura para release
    signingConfigs {
        create("release") {
            storeFile = file("release.keystore")
            storePassword = "APP_KEY_PASSWORD"
            keyAlias = "APP_KEY_ALIAS"
            keyPassword = "APP_KEY_PASSWORD"
        }
    }

    buildTypes {
        release {
            signingConfig = signingConfigs.getByName("release")
            
            // Habilitar Minify
            isMinifyEnabled = true
            proguardFiles(
                getDefaultProguardFile("proguard-android-optimize.txt"),
                "proguard-rules.pro"
            )
        }
    }
    
    kotlin {
        jvmToolchain(11)
    }
}

dependencies {
    // Outras dependencias do seu app
  
    // Implementacao do TapOnPhoneSdkDebug
    debugImplementation("com.paytime:taponphonesdk-debug:1.0.0")
    
    // Implementacao do TapOnPhoneSdkRelease
    // Apos a homologacao e receber as credencias do repositorio release
    // voce podera adicionar a dependencia de release
    releaseImplementation("com.paytime:taponphonesdk-release:1.0.0")
}

🚧
Obs.: Não se esqueça de sincronizar o projeto após adicionar as dependências.

3) Configurar o AndroidManifest.xml

Adicione as seguintes permissões ao arquivo AndroidManifest.xml da sua aplicação:

<uses-permission android:name="android.permission.INTERNET" />
<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />
<uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE" />
<uses-permission android:name="android.permission.READ_PHONE_STATE" />
<uses-permission android:name="android.permission.READ_PHONE_STATE" />
<uses-permission android:name="android.permission.VIBRATE" />
<uses-permission android:name="android.permission.NFC" />
<uses-permission android:name="android.permission.HIGH_SAMPLING_RATE_SENSORS" />
<uses-permission android:name="android.permission.BLUETOOTH" />
<uses-permission android:name="android.permission.BLUETOOTH_SCAN" />
<uses-permission android:name="android.permission.BLUETOOTH_CONNECT" />
<uses-permission android:name="android.permission.BLUETOOTH_ADVERTISE" />
<uses-permission android:name="android.permission.BLUETOOTH_ADMIN" />
<uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" />
<uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION" />

4) Minification (Pro Guard / R8)

É crucial que, para a versão release, você habilite a minificação. Isso reduzirá drasticamente o tamanho do seu APK de release (economia de banda para isntalar/atualizar o app), além de adicionar uma camada de segurança maior contra engenharia reversa do APK.

🚧
Como habilitar a minificação:
No arquivo build.gradle.kts da sua aplicação, em android -> buildTypes -> release, adicione a opção isMinifyEnabled = true
-> Verificar item 2) Configuração e dependências do Gradle dessa página

O TapOnPhoneSdk já fornece, através do consumer-rules.pro todas as regras de ProGuard necessárias para a SDK. Você só precisará adicionar suas próprias regras, caso necessário, dependendo das outras dependências que seu app usa e da sua própria implementação.