Primeiros passos

Saiba como preparar seu ambiente de desenvolvimento para trabalhar com a Biblioteca de vinculação de dados, incluindo suporte para código de vinculação de dados no Android Studio.

A Biblioteca de vinculação de dados oferece flexibilidade e ampla compatibilidade. Por ser uma biblioteca de suporte, ela pode ser usada com dispositivos com o Android 4.0 (nível 14 da API) ou mais recente.

Recomendamos usar o Plug-in do Android para Gradle mais recente no seu projeto. Contudo, a vinculação de dados é compatível com a versão 1.5.0 e posteriores. Para mais informações, consulte como atualizar o Plug-in do Android para Gradle.

Ambiente de compilação

Para começar a usar a vinculação de dados, faça o download da biblioteca no repositório de suporte no SDK Manager do Android. Para mais informações, consulte Atualizar o ambiente de desenvolvimento integrado e as Ferramentas do SDK.

Para configurar o app para usar a vinculação de dados, ative a opção de build dataBinding no arquivo build.gradle no módulo do app, conforme mostrado no exemplo abaixo:

android {
    ...
    buildFeatures {
        dataBinding true
    }
}

Compatibilidade do Android Studio com a vinculação de dados

O Android Studio é compatível com muitos dos recursos de edição de código de vinculação de dados. Por exemplo, ele oferece suporte aos seguintes recursos para expressões de vinculação de dados:

  • Destaque de sintaxe
  • Sinalização de erros de sintaxe da linguagem de expressão
  • Preenchimento do código XML
  • Referências, incluindo navegação, como navegar até uma declaração, e documentação rápida.

O painel Preview no Layout Editor mostra o valor padrão das expressões de vinculação de dados, se fornecido. Por exemplo, o painel Preview mostra o valor my_default no widget TextView declarado no exemplo abaixo:

<TextView android:layout_width="wrap_content"
    android:layout_height="wrap_content"
    android:text="@{user.firstName, default=my_default}"/>

Se você precisar mostrar um valor padrão apenas durante a fase de design do projeto, use os atributos tools em vez dos valores de expressão padrão, conforme descrito na Referência de atributos de ferramentas.

Outros recursos

Para saber mais sobre a vinculação de dados, consulte os seguintes recursos adicionais.