Ciclo de vida de descontinuação no Flutter

Remoção confiável de código descontinuado em um cronograma programado.

Um novo ano está chegando, e na equipe do Flutter estamos nos preparando para um começo limpo em 2021.

Em preparação, vamos remover algumas das APIs descontinuadas no framework do Flutter.

Remover descontinuações no framework do Flutter não é novidade. Eu mesmo já fiz isso no passado. Uma busca rápida mostra que descontinuações foram removidas sem um cronograma definido, porque nossa política de descontinuação não especifica quando removê-las. Como queremos oferecer uma experiência consistente e confiável para nossos usuários, decidimos criar um tempo de vida padrão para as descontinuações.

Este artigo discute nossas políticas atuais para breaking changes e descontinuações, como elas são colocadas em prática e como estão evoluindo para proporcionar uma experiência melhor aos nossos usuários.

Breaking changes no Flutter

Foto de [CHUTTERSNAP](https://unsplash.com/@chuttersnap?utm_source=medium&utm_medium=referral) no [Unsplash](https://unsplash.com?utm_source=medium&utm_medium=referral)
Foto de CHUTTERSNAP no Unsplash

O processo para descontinuar código no Flutter começa com nossa política de breaking changes. Descontinuações são consideradas breaking changes, o que significa que devem seguir as diretrizes do documento de design público, que exige um período para discussão. (O documento de design desta proposta é Implementando um tempo de vida para descontinuações.) Além de fornecer um documento de design, conversamos no Discord de colaboradores do Flutter e em grupos populares como flutter-announce e flutter-dev, tudo isso antes de fazer qualquer mudança. Esta é uma das minhas partes favoritas do processo como engenheiro: eu tenho a chance de ouvir vocês. Nossa maravilhosa comunidade está incrivelmente engajada nesse processo, e somos melhores por isso. Em várias ocasiões, vi o design de um recurso melhorar muito, graças ao feedback da comunidade, depois de divulgá-lo por esses canais.

Os autores de breaking changes migram o código de clientes afetado por uma breaking change. Na última atualização da nossa política de breaking changes, convidamos você a enviar seus testes para nosso repositório de testes de clientes. Esses testes são nosso sinal de que uma mudança é disruptiva, e estamos comprometidos em trabalhar com os autores dos testes para migrar o código deles antes de fazer a mudança.

Também oferecemos guias de migração para nossas breaking changes. Esses guias têm como objetivo ajudar os usuários a migrar o código após atualizar para a versão mais recente do Flutter. Se você viu um dos nossos anúncios de lançamento, também destacamos as quebras em uma determinada versão e indicamos recursos úteis para atualizar seus apps.

Em uma pesquisa anterior, perguntamos aos usuários sobre suas preferências em relação a breaking changes. Descobrimos que nossos usuários achavam que as breaking changes deixam o código mais limpo e que elas têm valor para eles, por isso geralmente preferimos uma breaking change a uma descontinuação. De acordo com o estudo:

No geral, 78% disseram que preferem breaking changes que resultem na API mais limpa possível; isso também torna a API mais fácil de aprender e usar.

Nossa política de breaking changes é baseada nesse estudo. Como sempre, há exceções para toda regra. Recentemente descontinuei alguns métodos muito populares em favor de um novo widget. Se sabemos que uma mudança específica é uma quebra significativa que afeta muitos usuários, vamos descontinuar. Descontinuar permite um período de carência para migração, mantendo todas as ferramentas geradas pela política de breaking changes.

Descontinuações antigas

Foto de [Dilyara Garifullina](https://unsplash.com/@dilja96?utm_source=medium&utm_medium=referral) no [Unsplash](https://unsplash.com?utm_source=medium&utm_medium=referral)
Foto de Dilyara Garifullina no Unsplash

O período de carência para migração começa quando a descontinuação é lançada no canal stable. O prazo para o fim desse período é de 1 ano calendário ou 4 releases stable, o que for mais longo. Para definir um cronograma que achamos confortável, analisamos nosso crescimento e adoção, e avaliamos alguns dos apps e pacotes Flutter de código aberto.

Queremos que nossos usuários possam contar com esse cronograma, em vez de se perguntarem se a próxima release vai trazer uma barreira inesperada para atualizar porque uma descontinuação desapareceu. Também queremos garantir que comunicamos essas mudanças com bastante antecedência, e nos comprometemos a anunciar as descontinuações que chegam ao fim de sua vida útil antes de começar a removê-las. Nesse espírito, gostaria de compartilhar com vocês o primeiro lote de descontinuações que chegaram ao fim de vida, agora que o Flutter 1.22 está disponível.

Como esta é a primeira vez que colocamos essa política em prática, há bastante descontinuações — algumas anteriores ao Flutter 1.0! Várias delas também são anteriores à nossa política de breaking changes. Vamos trabalhar em ferramentas de migração e orientações para todas elas. Espere ver essas descontinuações removidas do framework Flutter até nossa próxima release stable, com anúncios nos nossos canais habituais conforme forem sendo removidas.

Enquanto começamos a implementar essas mudanças, esperamos ouvir vocês! Estamos sempre aceitando submissões para nosso repositório de testes de clientes, onde trabalhamos com vocês para migrar seu código antes de fazer uma quebra. Para saber mais sobre o repositório de testes e como enviar seus testes, dê uma olhada no README dos testes do Flutter. Conforme fizermos essas mudanças, usaremos os canais Flutter Contributor Discord, flutter-announce e flutter-dev para avisar vocês e pedir feedback. Então, se ainda não entrou em um desses grupos, por favor entre! Esperamos ouvir vocês e trabalhar juntos.

Mais do Flutter