VERSÃO ATUAL
Sempre disponível na lateral esquerda superior da documentação
Compartilhamento de Dados com apps Stone
A partir da versão 3.6.0, todos os dados transacionais e de ativação são compartilhados entre o SDK Android e o POS Android da Stone, permitindo que se visualize as transações no Relatório Stone ou as cancele pelo app da Stone.
Porém, informações transacionais do SDK anterior à essa versão serão perdidas na atualização, por isso recomendamos que o comportamento seja comunicado aos seus clientes.
Importante
Certifique-se de utilizar as seguintes versões mínimas das ferramentas:
- Kotlin: 1.9.0
- Java: 17
- Gradle: 7.3.3
- Android Gradle Plugin: 7.2.0
Para Versões do Android Gradle Plugin menores que 8.2
Se estiver usando uma versão do Android Gradle Plugin menor que 8.2, será necessário incluir o seguinte bloco de código no settings.gradle:
pluginManagement {
buildscript {
repositories {
mavenCentral()
maven {
url = uri("https://storage.googleapis.com/r8-releases/raw")
}
}
dependencies {
classpath("com.android.tools:r8:8.2.24")
}
}
}
Aplicação Demo
Para te ajudar a desenvolver essa integração, criamos uma aplicação que exemplifica todas as etapas da integração.
Você pode acessar o App Demo neste link .
Configurando os repositórios
Para iniciar a integração com o SDK, você precisa:
Adicione os nossos repositórios no build.gradle do seu projeto:
repositories {
maven { url "https://packagecloud.io/priv/${token}/stone/pos-android/maven2" }
}Token de Acesso ao PackageCloud
Para acessar as nossas bibliotecas de desenvolvimento, é necessário que você possua um token de acesso do serviço de distribuição de artefatos utilizado atualmente para as releases do Stone SDK, o PackageCloud.
Esse token é gerado automaticamente no processo de credenciamento e enviado por e-mail junto com as credenciais de acesso.
Caso já esteja credenciado, você deve solicitar esse token a equipe de Parcerias através do canal no Slack
Stone Partner Community, ou entre em contato com seu Biz Dev (business development)
Utilização do Token de Acesso
Recomendamos o uso do token de acesso da PackageCloud via local.properties do seu projeto por motivos de segurança
token = localProp["packageCloudReadToken"]Dependências
- Adicionar a dependência para o core da SDK:
dependencies {
implementation "br.com.stone:stone-sdk:$stone_sdk_version"
}- Caso você esteja utilizando um dispositivo POS Android, é necessário adicionar a dependência do módulo de POS Android e a dependência do seu terminal.
dependencies {
implementation "br.com.stone:stone-sdk-posandroid:$stone_sdk_version"
}Configuração por modelo
Cada modelo precisa de sua respectiva biblioteca da fabricante para funcionar. Confira Processo de Build de Aplicação