---
title: "Getting Started"
url: "https://devcenter.stone.com.br/sdk-android-preparando-aplicacao"
image: "https://devcenter.stone.com.br/_og/d/c_Ocean.takumi,title_Getting+Started,props_eyJ0aGVtZSI6eyJtb2RlIjoibGlnaHQiLCJjb2xvcnMiOnsicHJpbWFyeSI6IiMzMEE2NkQifX19,p_Ii9zZGstYW5kcm9pZC1wcmVwYXJhbmRvLWFwbGljYWNhbyI,s_yUgPy4GP0vA4NLu5.png"
---

# Getting Started

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:

```groovy
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](#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](https://github.com/stone-payments/demo-sdk-android/) .

## [Configurando os repositórios](#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:

```java
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](https://packagecloud.io/).

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

```groovy
token = localProp["packageCloudReadToken"]
```

## [Dependências](#dependências)

1.  Adicionar a dependência para o core da SDK:

```groovy
dependencies {
  implementation "br.com.stone:stone-sdk:$stone_sdk_version"
}
```

2.  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**.

```groovy
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](https://devcenter.stone.com.br/processo-de-build-de-aplica%C3%A7%C3%A3o)

---

**Jornada: [Começar a integrar](https://devcenter.stone.com.br/sdk-android-evolua-ao-nosso-lado)**  
Etapa 8 de 14

[**Etapa anterior**App Demo SDK Providers](https://devcenter.stone.com.br/sdk-android-faq-duvidas-frequentes)[**Próxima etapa**Especificação de versão da aplicação](https://devcenter.stone.com.br/sdk-android-especificacoes-de-version-name)

Siga a Stone nas redes sociais

[](https://www.facebook.com/stonepagamentos/)[](https://x.com/sejastone/)[](https://www.instagram.com/stone/)[](https://br.linkedin.com/company/stone-co)[](https://www.youtube.com/channel/UCk4L4JykgoDkN8YeuxkNqIQ)

© Stone Instituição de Pagamento S.A. CNPJ 16.501.555/0001-57

Av. Rebouças, 2880, 4º andar, Pinheiros, CEP 05.402-500 – São Paulo/SP

Instituição de pagamento autorizada pelo Banco Central do Brasil, nas modalidades de credenciadora e emissora de moeda eletrônica.