Flutter: o problema de destino da API de nível 34 do Android 14 continua apesar das atualizações

Por que ainda estou vendo um aviso de nível 34 da API?

No desenvolvimento do Flutter, direcionar o nível de API Android mais recente é fundamental para garantir a compatibilidade do aplicativo com novos recursos e atualizações de segurança. Recentemente, depois de alterar targetSdkVersion para API de nível 34 (Android 14), os desenvolvedores relataram que o Play Console ainda alerta que o aplicativo deve ser direcionado ao Android 14 ou superior, apesar de uma compilação bem-sucedida.

Essa disparidade pode causar confusão, especialmente quando pacotes de apps anteriores ainda estão em execução no console. Compreender como as versões anteriores afetam o upload atual e abordar esse aviso são essenciais para o lançamento eficaz do seu aplicativo Flutter.

Compreendendo a solução para segmentação em nível de API no Flutter

O primeiro script modifica a configuração do Android do projeto Flutter para garantir que o aplicativo esteja direcionado corretamente ao nível 34 da API. Os comandos cruciais são compileSdkVersion e targetSdkVersion, que especificam as versões do Android SDK usadas durante a compilação e implantação. Definir compileSdkVersion como 34 garante que o programa seja criado usando o Android 14, enquanto targetSdkVersion especifica a versão pretendida do Android para o aplicativo ser executado. Essas modificações atualizam as configurações do projeto para atender aos padrões de envio mais recentes da Google Play Store, removendo o aviso sobre níveis de API não suportados.

O segundo script se comunica com a Google Play Console API via Python. Ele automatiza o processo de detecção e remoção de pacotes de software mais antigos que podem causar problemas. google.auth.default() retorna as credenciais padrão para acessar a API Play Store, enquanto build('androidpublisher', 'v3') inicializa a Google Play Developer API. O script então utiliza service.edits().bundles().list() para obter pacotes de aplicativos ativos e, se uma versão antiga for descoberta, service.edits().bundles().delete() exclui. Por fim, o comando service.edits().commit() salva e aplica todas as alterações, garantindo que o aplicativo esteja livre de quaisquer pacotes desatualizados que possam causar a mensagem de erro.

android {
    compileSdkVersion 34
    defaultConfig {
        applicationId "com.example.myapp"
        minSdkVersion 21
        targetSdkVersion 34
        versionCode 1
        versionName "1.0"
    }
}

import google.auth
from googleapiclient.discovery import build
credentials, project = google.auth.default()
service = build('androidpublisher', 'v3', credentials=credentials)
package_name = 'com.example.myapp'
edit_id = service.edits().insert(body={}, packageName=package_name).execute()['id']
bundles = service.edits().bundles().list(packageName=package_name, editId=edit_id).execute()
for bundle in bundles['bundles']:
    if bundle['versionCode'] == 1:  # First build still active
        service.edits().bundles().delete(packageName=package_name, editId=edit_id,
                                        bundleId=bundle['id']).execute()
service.edits().commit(packageName=package_name, editId=edit_id).execute()

Resolvendo pacotes conflitantes em atualizações de aplicativos Flutter.

Um problema comum ao atualizar targetSdkVersion de um aplicativo Flutter é a presença de pacotes de aplicativos antigos que ainda são mostrados como ativos no Google Play Console. Mesmo que esses pacotes estejam desatualizados, eles podem impedir que a versão mais recente seja reconhecida corretamente, resultando em avisos como “O aplicativo deve ser direcionado ao Android 14 (API de nível 34) ou superior”. Embora seja necessário alterar targetSdkVersion para 34, os desenvolvedores também devem garantir que as versões anteriores não interrompam o processo de atualização. O gerenciamento de versões de aplicativos, principalmente a eliminação de pacotes obsoletos, pode ajudar a resolver esse problema.

Além de definir adequadamente o nível de API de destino no arquivo build.gradle, as versões ativas devem ser revisadas regularmente no Google Play Console. Os desenvolvedores devem usar ferramentas como a Google Play Developer API ou desativar manualmente pacotes desatualizados. Isso garante que a Play Store reflita com precisão a configuração de compilação mais recente. Como o Google Play exige que os aplicativos sigam critérios rigorosos de controle de versão para atualizações, controlar o código e os pacotes no Play Console garante uma transição tranquila e reduz a probabilidade de encontrar avisos não resolvidos no nível da API.