Visão geral do Play Feature Delivery

O modelo de exibição de apps do Google Play usa Android App Bundles para gerar e disponibilizar APKs otimizados para a configuração do dispositivo de cada usuário. Assim, os usuários fazem o download apenas do código e dos recursos necessários para executar o app.

O Play Feature Delivery usa recursos avançados de pacotes de apps, permitindo que determinados recursos sejam enviados condicionalmente ou transferidos por download sob demanda. Para fazer isso, é necessário primeiro separar esses recursos do app base em módulos de recursos.

Configuração do build do módulo de recurso

Quando você cria um novo módulo de recurso usando o Android Studio, o ambiente de desenvolvimento integrado aplica o seguinte plug-in do Gradle ao arquivo build.gradle do módulo.

// The following applies the dynamic-feature plugin to your feature module.
// The plugin includes the Gradle tasks and properties required to configure and build
// an app bundle that includes your feature module.

plugins {
  id 'com.android.dynamic-feature'
}

Muitas das propriedades disponíveis para o plug-in de aplicativo padrão também estão disponíveis para seu módulo de recurso. As seções a seguir descrevem as propriedades que você precisa ou não incluir na configuração da compilação do módulo de recurso.

O que não incluir na configuração do build do módulo de recurso

Como cada módulo de recurso depende do módulo base, ele também herda certas configurações. Portanto, você precisa omitir o seguinte no arquivo build.gradle do módulo de recurso:

• Configurações de assinatura: os pacotes de apps são assinados usando configurações de assinatura que você especifica no módulo base.
• A propriedade minifyEnabled: você pode ativar a redução de código para todo o projeto do app na configuração do build do módulo base. Portanto, você precisa omitir essa propriedade dos módulos de recursos. No entanto, você pode especificar outras regras do ProGuard para cada módulo de recurso.
• versionCode e versionName: ao criar seu pacote de apps, o Gradle usa as informações da versão do app fornecidas pelo módulo base. Você precisa omitir essas propriedades do arquivo build.gradle do módulo de recurso.

Estabelecer uma relação com o módulo base

Quando o Android Studio cria seu módulo de recurso, ele fica visível para o módulo base adicionando a propriedade android.dynamicFeatures ao arquivo build.gradle do módulo base, como mostrado abaixo:

// In the base module’s build.gradle file.
android {
    ...
    // Specifies feature modules that have a dependency on
    // this base module.
    dynamicFeatures = [":dynamic_feature", ":dynamic_feature2"]
}

Além disso, o Android Studio inclui o módulo base como uma dependência do módulo de recurso, conforme mostrado abaixo:

// In the feature module’s build.gradle file:
...
dependencies {
    ...
    // Declares a dependency on the base module, ':app'.
    implementation project(':app')
}

Especificar outras regras do ProGuard

Embora somente a configuração do build do módulo base possa ativar a redução de código no projeto do app, você pode fornecer regras personalizadas do ProGuard com cada módulo de recurso usando a propriedade proguardFiles (link em inglês), como mostrado abaixo.

android.buildTypes {
     release {
         // You must use the following property to specify additional ProGuard
         // rules for feature modules.
         proguardFiles 'proguard-rules-dynamic-features.pro'
     }
}

Essas regras do ProGuard são mescladas com as regras de outros módulos (incluindo o módulo base) no tempo de compilação. Assim, embora cada módulo de recurso possa especificar um novo conjunto de regras, essas regras se aplicam a todos os módulos no projeto do app.

Implantar o app

Durante o desenvolvimento do app com suporte a módulos de recursos, você pode implantar o app em um dispositivo conectado, como faria normalmente, selecionando Run > Run na barra de menus ou clicando em Run na barra de ferramentas.

Se o projeto do app incluir um ou mais módulos de recursos, você poderá escolher quais recursos incluir ao implantar o app modificando a configuração de execução/depuração existente da seguinte maneira:

1. Selecione Run > Edit Configurations na barra de menus.
2. No painel à esquerda da caixa de diálogo Run/Debug Configurations, selecione a configuração de Android App que você quer usar.
3. Em Dynamic features to deploy, na guia General, marque a caixa ao lado de cada módulo de recursos que você quer incluir durante a implantação do app.
4. Clique em OK.

Por padrão, o Android Studio não implementa seu app usando pacotes de apps. Em vez disso, o ambiente de desenvolvimento integrado cria e instala no dispositivo APKs que são otimizados para a velocidade de implantação, não para o tamanho do APK. Para configurar o Android Studio para criar e implantar APKs e experiências instantâneas a partir de um pacote de apps, modifique sua configuração de execução/depuração.

Usar módulos de recursos para entrega personalizada

Um benefício exclusivo dos módulos de recursos é a capacidade de personalizar como e quando diferentes recursos do app são transferidos por download para dispositivos com o Android 5.0 (nível 21 da API) ou mais recente. Por exemplo, para reduzir o tamanho inicial do download do app, configure determinados recursos para serem transferidos conforme necessário sob demanda ou apenas por dispositivos com suporte a determinados recursos, como funcionalidades de tirar fotos ou de realidade aumentada.

Embora você receba downloads altamente otimizados por padrão quando faz upload do app como um pacote de apps, as opções de entrega de recursos mais avançadas e personalizáveis exigem outras configurações e a modularização dos recursos do app com módulos de recursos. Ou seja, os módulos de recursos oferecem os elementos básicos para a criação de recursos modulares que você pode configurar para cada download, conforme necessário.

Imagine um app que permite ao usuário comprar e vender mercadorias em um mercado on-line. Você pode modularizar cada uma das seguintes funcionalidades do app em módulos de recursos separados:

• Login e criação da conta
• Navegação no mercado
• Disponibilização de itens para venda
• Processamento de pagamentos

A tabela abaixo descreve as diferentes opções de entrega compatíveis com módulos de recursos e como elas podem ser usadas para otimizar o tamanho inicial do download do app de mercado de exemplo.

Criar um URI para um recurso

Se você quiser acessar um recurso armazenado em um módulo usando um URI, veja como gerar um URI de módulo de recurso usando Uri.Builder():

val uri = Uri.Builder()
                .scheme(ContentResolver.SCHEME_ANDROID_RESOURCE)
                .authority(context.getPackageName()) // Look up the resources in the application with its splits loaded
                .appendPath(resources.getResourceTypeName(resId))
                .appendPath(String.format("%s:%s",
                  resources.getResourcePackageName(resId), // Look up the dynamic resource in the split namespace.
                  resources.getResourceEntryName(resId)
                  ))
                .build()

String uri = Uri.Builder()
                .scheme(ContentResolver.SCHEME_ANDROID_RESOURCE)
                .authority(context.getPackageName()) // Look up the resources in the application with its splits loaded
                .appendPath(resources.getResourceTypeName(resId))
                .appendPath(String.format("%s:%s",
                  resources.getResourcePackageName(resId), // Look up the dynamic resource in the split namespace.
                  resources.getResourceEntryName(resId)
                  ))
                .build().toString();

Cada parte do caminho para o recurso é construída no tempo de execução, garantindo que o namespace correto seja gerado após o carregamento dos APKs divididos.

Como exemplo de como o URI é gerado, suponha que você tenha um app e módulos de recursos com esses nomes:

• Nome do pacote do app: com.example.my_app_package
• Nome do pacote de recursos do elemento: com.example.my_app_package.my_dynamic_feature

Se o resId no snippet de código acima se referir a um recurso de arquivo bruto com o nome "my_video" no módulo de recurso, o código Uri.Builder() acima produzirá o seguinte:

android.resource://com.example.my_app_package/raw/com.example.my_app_package.my_dynamic_feature:my_video

Esse URI pode ser usado pelo seu app para acessar o recurso deste módulo.

Para validar os caminhos no URI, use o APK Analyzer para inspecionar o APK do módulo de recurso e determinar o nome do pacote:

Considerações sobre módulos de recursos

Com os módulos de recursos, você pode aumentar a velocidade de compilação e de engenharia e personalizar amplamente a entrega dos recursos do app, reduzindo o tamanho dele. No entanto, há algumas restrições e casos extremos que devem ser considerados ao usar os módulos de recursos:

• A instalação de 50 ou mais módulos de recursos em um único dispositivo, por entrega condicional ou sob demanda, pode causar problemas de desempenho. Os módulos de tempo de instalação, que não são configurados como removíveis, são incluídos automaticamente no módulo base e contam apenas como um módulo de recurso em cada dispositivo.
• Limite o número de módulos configurados como removíveis para entrega na instalação a 10 ou menos. Caso contrário, o tempo de download e instalação do app poderá aumentar.
• Apenas dispositivos com o Android 5.0 (nível 21 da API) e versões mais recentes são compatíveis com download e instalação de recursos sob demanda. Para disponibilizar o recurso para versões anteriores do Android, ative a opção Fusing ao criar um módulo de recurso.
• Para que o app tenha acesso aos módulos de recursos transferidos por download que são enviados sob demanda, ative a SplitCompat.
• Os módulos de recursos não podem especificar as atividades no manifesto com android:exported definido como true. Isso porque não há garantia de que o dispositivo tenha feito o download do módulo de recurso quando outro app tentar iniciar a atividade. Além disso, seu app precisa confirmar se um recurso foi transferido por download antes de tentar acessar o código e os recursos relacionados. Para saber mais, leia Gerenciar módulos instalados.
• Como o Play Feature Delivery exige que você publique seu aplicativo usando um pacote de apps, verifique se há problemas conhecidos com o pacote de apps.

Referência ao manifesto do módulo de recurso

Durante a criação de um novo módulo de recurso usando o Android Studio, o ambiente de desenvolvimento integrado inclui a maioria dos atributos de manifesto que o módulo precisa para se comportar como um módulo de recurso. Além disso, alguns atributos são injetados pelo sistema no tempo de compilação. Assim, você não precisa especificar nem modificá-los. A tabela a seguir descreve os atributos do manifesto que são importantes para os módulos de recursos.

Outros recursos

Para saber mais sobre o uso de módulos de recursos, experimente os recursos a seguir.

Postagens do blog (em inglês)

• Novos recursos para ajudar você a desenvolver, lançar e expandir seus negócios no Google Play
• As atualizações mais recentes do Android App Bundle, incluindo a API de outros idiomas
• Plaid : uma história de modularização

Vídeos (em inglês)

• Entrega personalizável com o Android App Bundle e compartilhamento fácil de builds de teste
• Novas ferramentas para otimizar o tamanho do app e aumentar as instalações no Google Play

Termos de Serviço e segurança dos dados

Ao acessar ou usar a biblioteca Play Feature Delivery, você concorda com os Termos de Serviço do kit de desenvolvimento de software da Play Core. Leia e entenda todos os termos e políticas aplicáveis antes de acessar a biblioteca.

Segurança dos dados

As bibliotecas do Google Play são a interface do ambiente de execução do seu app na Google Play Store. Quando você usa a Play Core no seu app, a Play Store executa processos próprios, que incluem o processamento de dados regido pelos Termos de Serviço do Google Play. As informações abaixo descrevem como as bibliotecas da Play Core lidam com os dados para processar solicitações específicas do app.

API de outros idiomas

Play Feature Delivery

Nosso objetivo é oferecer o máximo de transparência possível, mas você é o único responsável por decidir como responder ao formulário da seção "Segurança dos dados" do Google Play com relação à coleta, ao compartilhamento e às práticas de segurança dos dados do usuário do seu app.