Mudanças incompatíveis e descontinuações

Esta página lista todas as mudanças incompatíveis e descontinuações em atualizações do SDK do Dart, organizadas por versão e área, para ajudar os desenvolvedores Dart a entender e gerenciar o impacto delas. As notas de versão completas estão disponíveis no changelog do SDK do Dart. O documento política de mudanças incompatíveis descreve a política e o processo relacionados a mudanças incompatíveis e descontinuações no Dart.

Esta página inclui os seguintes tipos de mudanças incompatíveis:

Sem versionamento

O SDK do Dart não mantém compatibilidade com versões anteriores, e o código pode quebrar assim que você atualizar a versão do seu SDK se ele depender do comportamento anterior.

Estas são a maioria das mudanças e não são marcadas de forma especial nesta lista.

Versionado por idioma

O SDK do Dart mantém a compatibilidade com versões anteriores para o código existente, e a mudança de comportamento só tem efeito (podendo quebrar código que depende do comportamento anterior) quando você atualiza a versão da linguagem do seu código.

Estas são marcadas como: Language versioned

Descontinuações

O SDK do Dart mantém a compatibilidade com código descontinuado, emitindo um aviso. As descontinuações são então removidas por completo em uma versão posterior, quebrando qualquer código que dependa do comportamento anterior.

Estas são marcadas como: Deprecated / Removed

Experimental

Parte da versão, mas ainda não tratada como estável no SDK, e pode quebrar de uma versão para outra. Mudanças experimentais nem sempre têm uma issue de mudança incompatível correspondente, mas podem ter mais detalhes no changelog do SDK.

Estas são marcadas como: Experimental

Se você tiver dúvidas ou preocupações sobre qualquer uma dessas mudanças incompatíveis, comente na issue de mudança incompatível vinculada à entrada relevante. Para ser notificado sobre futuras mudanças incompatíveis, entre no grupo Dart announce.

• Language versioned Você não pode mais usar final ou var em parâmetros que não são declarações. O Dart agora reserva ambos para declarar parâmetros em construtores primários. Remova final ou var das declarações de parâmetros afetadas. Se você ainda quiser impedir a reatribuição de parâmetros, pode usar a regra de lint parameter_assignments.
• A inferência de tipo promovido em funções geradoras internas foi ajustada.

• NetworkInterface.addresses agora retorna List<InterfaceAddress> em vez de List<InternetAddress>. O novo subtipo InterfaceAddress de InternetAddress expõe um campo prefixLength e um getter broadcast. Código que implementa NetworkInterface e sobrescreve addresses deve atualizar o tipo de retorno.
• InternetAddress.lookup não aceita mais endereços IPv4 inválidos que são tradicionalmente aceitos por inet_aton.

• JSFunction e JSExportedDartFunction agora são genéricos. JSExportedDartFunction<T>.toDart agora converte a função original encapsulada para o argumento de tipo T, e isA<JSExportedDartFunction<T>> agora também verifica se a função encapsulada é um T. Os tipos em runtime de JSFunction e JSExportedDartFunction não mudam.

• Deprecated A regra de lint avoid_private_typedef_functions está descontinuada e deve ser removida dos arquivos analysis_options.yaml.

• Deprecated A regra de lint one_member_abstracts está descontinuada e deve ser removida dos arquivos analysis_options.yaml.

• Deixou de adicionar uma linha em branco antes de um comentário no fim de uma unidade de compilação ou de um corpo com chaves.

• As cláusulas de representação de extension types agora são formatadas da mesma forma que as listas de parâmetros formais de construtores primários.

• Quando as vírgulas finais são preservadas, não insere mais uma quebra de linha antes do ; em um enum com membros, a menos que haja uma vírgula final.

• Corrigido um bug em que algumas coleções ou argumentos podiam ser divididos desnecessariamente.

• Language versioned Listas de parâmetros agora podem ser formatadas em bloco.

• Language versioned Expressões as, is e is! agora podem ser formatadas em bloco.

• Language versioned Linhas em branco são adicionadas ao redor de declarações mixin e extension type se elas não tiverem um corpo com ;.

• Language versioned Os imports agora são separados em seções.

• Language versioned Vírgulas finais agora são adicionadas para dividir as cláusulas de representação de extension types.

• Removed Os certificados raiz de fallback embutidos, usados quando os certificados do sistema não podem ser encontrados, não são mais incluídos. Se os certificados do sistema não forem encontrados, use as opções --root-certs-file ou --root-certs-cache para fornecer certificados de fallback à VM standalone do Dart.

• Dart_FileModifiedCallback em runtime/include/dart_tools_api.h agora passa int64_t since como microssegundos desde a época, em vez de milissegundos.

• O método de extensão isA foi movido de JSAnyUtilityExtension para NullableObjectUtilExtension para dar suporte à verificação de tipo de qualquer Object?. Essa mudança só é incompatível se você referenciou o nome da extensão diretamente, seja aplicando a extensão diretamente ou por meio das diretivas show/hide.
• isA<JSObject>() agora trata corretamente objetos JS sem protótipos, e isA<JSAny>() faz uma verificação não trivial de que o valor é um valor JS.
• isA<JSExportedDartFunction>() agora verifica se a função é realmente uma função wrapper JS retornada por Function.toJS ou Function.toJSCaptureThis.

• dart pub cache repair agora repara, por padrão, apenas os pacotes referenciados pelo arquivo pubspec.lock do projeto atual. Para reparar todos os pacotes do cache do pub, como nas versões anteriores, passe a nova flag --all.

• A API de carregamento de módulos com carregamento deferido foi atualizada para permitir o download em lote de módulos deferidos. O embedder agora usa loadDeferredModules em vez de loadDeferredModule, em que a nova função deve receber um array de nomes de módulos em vez de nomes individuais. Todas as funções de carregamento de módulos também devem aceitar agora um callback instantiator ao qual devem passar os resultados carregados.

• JSExportedDartFunction.toDart agora lança exceção se a função JS wrapper não for resultado de Function.toJS ou Function.toJSCaptureThis, para ser consistente com DDC e dart2wasm. Antes, às vezes ela retornava incorretamente a função Dart original, mesmo se a função JS wrapper tivesse sido convertida de uma chamada à função descontinuada allowInterop.

• Deprecated A regra de lint avoid_null_checks_in_equality_operators está descontinuada e deve ser removida dos arquivos analysis_options.yaml.

• Deprecated A regra de lint prefer_final_parameters está descontinuada e deve ser removida dos arquivos analysis_options.yaml.

• Deprecated A regra de lint use_if_null_to_convert_nulls_to_bools está descontinuada e deve ser removida dos arquivos analysis_options.yaml.

• Removed Código que importa dart:js_util ou package:js agora resulta em erro de compilação ao compilar para WebAssembly.

  Invocar qualquer API dessas bibliotecas resultará em erro de runtime. Os usos devem ser migrados para dart:js_interop e dart:js_interop_unsafe.

• Funções geradoras sync* e async* sem um retorno especificado agora inferem corretamente os tipos de retorno como non-nullable quando nenhum valor null é produzido. Isso pode disparar novos diagnósticos relacionados a elementos de código desnecessários, como um operador de acesso com null-aware desnecessário (?.).

• As funções Uri.parseIPv4Address e Uri.parseIPv6Address não permitem mais incorretamente zeros à esquerda em endereços IPv4.

• Deprecated A possibilidade de implementar RegExp e RegExpMatch está descontinuada e será removida em uma versão futura.

• IOOverrides não pode mais ser implementado, mas ainda pode ser estendido.

• A extensão Uint16ListToJSInt16Array foi renomeada para Uint16ListToJSUint16Array.

• A extensão JSUint16ArrayToInt16List foi renomeada para JSUint16ArrayToUint16List.

• A função Function.toJSCaptureThis agora resulta em verificações adicionais em tempo de compilação para igualar Function.toJS. Se a função não tiver um tipo conhecido estaticamente, tiver tipos não suportados na assinatura, incluir parâmetros de tipo ou tiver quaisquer parâmetros nomeados, a chamada resultará em erro de compilação.

• A CLI dart e a VM do Dart agora são executáveis separados, com o executável e o processo da VM do Dart puro chamados dartvm. Programas Dart ainda devem ser executados com dart run.

• Os subcomandos da ferramenta dart, como dart format e dart compile, agora executam snapshots compilados com AOT das ferramentas subjacentes. Não deve haver diferença funcional além de melhorias de desempenho, mas se você encontrar incompatibilidades, por favor reporte-as.

• Removed A ferramenta dart não está mais disponível para plataformas IA32, pois o SDK do Dart não oferece mais suporte a IA32.

• Usar membros marcados como @experimental fora do pacote em que são declarados agora resulta em um aviso.

• Regras de lint habilitadas em arquivos de opções de análise incluídos agora resultam em diagnósticos de lint incompatíveis quando apropriado.

• Removed A anotação @required descontinuada de package:meta não é mais suportada. Para marcar um parâmetro como obrigatório, use a palavra-chave required.

• dart:js_util e package:js não são mais suportados ao compilar para WebAssembly. Invocar qualquer API dessas bibliotecas resultará em erro de runtime. Os usos devem ser migrados para dart:js_interop e dart:js_interop_unsafe.

• Para igualar os compiladores JS, dartify quando compilado para Wasm agora converte objetos JS Promise em objetos Dart Future em vez de objetos Dart JSValue.

• Language versioned Null safety agora é assumido ao calcular a promoção de tipo, a alcançabilidade e a atribuição definida. Como resultado, a análise aprimorada de código morto pode fazer com que novos diagnósticos do analisador sejam disparados em código existente que antes passava na análise.

• Alguns subcomandos da ferramenta dart, como dart analyze e dart fix, agora executam snapshots compilados com AOT das ferramentas subjacentes. Não deve haver diferença funcional além de melhorias de desempenho, mas se você encontrar incompatibilidades, por favor reporte-as.

• Language versioned O limite superior da restrição do SDK flutter no pacote raiz do seu workspace agora é respeitado. Se o seu SDK atual não atender ao limite especificado, dart pub get e outras ações que recuperam dependências falharão.

• Experimental Gerar um bundle de aplicação CLI com suporte experimental a native assets agora exige o uso do subcomando dart build cli e a especificação do entrypoint da aplicação com a nova opção --target.

• Removed O construtor Element.created foi removido.
• Classes nativas em dart:html, como HtmlElement, não podem mais ser estendidas.

• Deprecated A regra de lint avoid_null_checks_in_equality_operators está descontinuada e deve ser removida dos arquivos analysis_options.yaml.

• Agora lança um erro de runtime quando um construtor factory de redirecionamento é destacado e um de seus parâmetros opcionais não nullable não recebe nenhum valor. No futuro, provavelmente isso será um erro de compilação.

• Experimental Removed As flags --experiment-new-rti e --use-old-rti não são mais suportadas.

• Language versioned O formatador fez mudanças e correções que resultam em nova saída ao formatar código com uma versão da linguagem 3.8 ou superior.

• Language versioned Variáveis locais e parâmetros nomeados _ agora não são mais de vinculação e não podem mais ser usados ou acessados.
• A análise de alcançabilidade agora considera se um campo é promovido para Null por meio de is ou as. Isso torna o sistema de tipos mais autoconsistente, pois espelha o comportamento de variáveis locais promovidas. Não se espera que essa mudança faça diferença na prática.

• Deprecated Estas bibliotecas web legadas estão oficialmente descontinuadas. Espera-se que sejam removidas em uma versão futura. Os projetos devem migrar para usar package:web e dart:js_interop. Para saber mais, veja Migre para package:web.

• Deprecated Estas bibliotecas legadas de interop com JS estão oficialmente descontinuadas. Espera-se que sejam removidas em uma versão futura. Os projetos devem migrar para usar dart:js_interop. Para saber mais, veja uso de interop com JS.

• Removed As regras de lint package_api_docs e unsafe_html foram removidas e devem ser retiradas dos arquivos analysis_options.yaml.

• Language versioned O formatador implementa um novo estilo que resulta em nova saída ao formatar código com uma versão da linguagem 3.7 ou superior.
• Removed A flag --fix do dart format não é mais suportada. Para aplicar correções semelhantes e outras, configure suas opções de análise e execute dart fix.
• Deprecated A opção --line-length do dart format foi descontinuada e está marcada para remoção. Todos os usos devem ser migrados para a nova opção --page-width.

• O contexto usado pelo Dart para realizar a inferência de tipo sobre o operando de uma expressão throw foi alterado de "tipo desconhecido" para Object. Isso torna o sistema de tipos mais autoconsistente, pois reflete o fato de que não é legal lançar null. Não se espera que essa mudança faça diferença na prática.

• Removed O construtor Platform() foi removido. Todas as instanciações de Platform devem ser removidas.
• HttpClient agora responde a um redirecionamento sem o header "Location" lançando um RedirectException em vez de um StateError.

• Deprecated As regras de lint package_api_docs e unsafe_html foram descontinuadas e estão marcadas para remoção no Dart 3.7.

• O compilador do Dart agora calcula os closures superior e inferior dos schemas de tipo logo antes de serem passados para o procedimento de teste de subtipo. Antes do Dart 3.6, o compilador os calculava no início das computações de limite superior e inferior. O analisador já seguia esse comportamento, então aplicações que já passam na análise dificilmente serão afetadas por essa mudança.

• A condição dart.library.js agora é false em imports condicionais ao compilar para WebAssembly. Deve-se usar a condição dart.library.js_interop em vez dela.

As seguintes mudanças podem resultar em pequenas alterações de formatação ao executar dart format com um SDK do Dart 3.6 ou posterior:

• Preserva parâmetros de tipo em parâmetros formais de função tipada no estilo antigo que também usam this. ou super..
• Formata corretamente imports com as cláusulas as e if.

• dart pub publish agora avisa se arquivos rastreados no git têm alterações não commitadas.

• O contexto usado pelo compilador para realizar a inferência de tipo sobre o operando de uma expressão await foi alterado para igualar o comportamento do analisador.
• O contexto usado pelo compilador para realizar a inferência de tipo sobre o lado direito de uma expressão "if-null" (e1 ?? e2) foi alterado para igualar o comportamento do analisador. O comportamento antigo pode ser restaurado fornecendo tipos explícitos.

• DateTime agora armazena microssegundos na plataforma web, aproximando-se mais do comportamento nas plataformas nativas.

• SecurityContext agora é final e não pode mais ser subclassificado.

• importModule agora aceita um JSAny em vez de uma String para dar suporte a outros valores JS também, como objetos TrustedScriptURL.
• isTruthy e not agora retornam JSBoolean em vez de bool para ser consistente com os outros métodos de operador JS.
• ExternalDartReference não implementa mais Object. Em vez disso, agora aceita um parâmetro de tipo (T) com limite Object? para capturar o tipo do objeto Dart que é externalizado.

• Removed As classes de visão não modificável para dados tipados foram removidas. Em vez de usar os construtores dessas classes, use os novos métodos asUnmodifiableView nas listas de dados tipados.

• Removed A VM do Dart não oferece mais suporte a null safety unsound.
  • A opção de CLI --no-sound-null-safety foi removida.
  • As funções Dart_NewListOf e Dart_IsLegacyType foram removidas da API C.
• Removed A função Dart_DefaultCanonicalizeUrl foi removida da API C.

• O schema de contexto de tipo de padrão para padrões de cast agora é _ (o tipo desconhecido) em vez de Object?.
• O schema de tipo usado pelos compiladores do Dart para realizar a inferência de tipo sobre o operando de um operador spread com null-aware (...?) em literais de map e set foi tornado nullable, para igualar o que já acontece em literais de lista.

• Experimental Removed A função waitFor foi removida.

• Deprecated Estas bibliotecas agora estão marcadas como legadas e receberão menos suporte no futuro. Novos projetos devem preferir usar package:web e dart:js_interop. Para saber mais, veja Migre para package:web.

• Deprecated Esta biblioteca agora está marcada como legada e receberá menos suporte no futuro. Os usos devem ser migrados para dart:js_interop e dart:js_interop_unsafe. Para saber mais, veja /go/next-gen-js-interop.

• Deprecated Esta biblioteca agora está marcada como legada e receberá menos suporte no futuro. Os usos devem ser migrados para dart:js_interop e dart:js_interop_unsafe. Para saber mais, veja /go/next-gen-js-interop.

• Stdout tem um novo campo lineTerminator, que permite que desenvolvedores controlem o terminador de linha usado por stdout e stderr. Classes que implementam Stdout devem definir o campo lineTerminator. A semântica padrão de stdout e stderr não muda.
• Deprecated A propriedade FileSystemDeleteEvent.isDirectory. Ela sempre retorna false.

• Deprecated As classes de visão não modificável para dados tipados estão descontinuadas. Em vez de usar os construtores dessas classes, use os novos métodos asUnmodifiableView nas listas de dados tipados.

• Experimental Deprecated Agora você deve especificar um formato para a opção de CLI --dump-info como binary ou json. O formato json está descontinuado e pode ser removido em uma versão futura do Dart.

• Experimental Vários argumentos de CLI de dart compile wasm foram atualizados, removidos ou substituídos. Para saber mais, execute dart compile wasm --verbose --help.

• Removed A VM do Dart não oferece mais suporte a strings externas. Como resultado, as funções Dart_IsExternalString, Dart_NewExternalLatin1String e Dart_NewExternalUTF16String foram removidas da API C do Dart.

• Experimental Removed Os seguintes experimentos estão agora aposentados, pois foram lançados no Dart 3 e não são mais necessários com uma versão da linguagem 3.0 ou superior. A configuração deles deve ser removida das opções de análise, dos comandos de CLI e das configurações da IDE.

  • patterns
  • records
  • class-modifiers
  • sealed-class

• Um getter abstrato agora é considerado promovível se não houver declarações conflitantes.

• Experimental Deprecated A função waitFor continua descontinuada por mais uma versão e está marcada para remoção no Dart 3.4.

• Deprecated Os métodos de aritmética de ponteiro elementAt nos tipos Pointer estão descontinuados. Migre para os operadores - e +.
• Experimental Removed A anotação @FfiNative, previamente descontinuada, foi removida. Os usos devem ser atualizados para usar a anotação @Native.

• Em vez de usar HttpRequest diretamente, agora é recomendado usar package:http.

• Em vez de usar HttpClient diretamente, agora é recomendado usar package:http.

• Experimental Tipos JS como JSAny têm novos tipos de representação específicos do compilador.
• Experimental Classes @staticInterop definidas pelo usuário não podem mais implementar JSAny ou JSObject. Os usos devem ser migrados para JSObject.fromInteropObject ou ser definidos como extension types.
• Experimental JSArray e JSPromise agora têm parâmetros genéricos.
• Experimental Vários membros de extensão foram movidos ou renomeados. Para saber sobre as extensões atualizadas, consulte JSAnyUtilityExtension e JSAnyOperatorExtension.

• As classes de visão não modificável para dados tipados serão descontinuadas no Dart 3.4. Em vez de usar os construtores dessas classes, use os novos métodos asUnmodifiableView nas listas de dados tipados.

• Experimental Todas as classes wrapper nativas agora são marcadas como base para que nenhum de seus subtipos possa ser implementado.

• O Invocation que é passado para noSuchMethod não tem mais um memberName minificado, mesmo quando compilado com --minify.

• Experimental Proíbe importar bibliotecas legadas de interop com JS. Prefira usar dart:js_interop e dart:js_interop_unsafe.

• Experimental Diretivas inválidas em comentários dart doc agora são reportadas pelo analisador.

• Devido a melhorias na promoção de tipo, os seguintes diagnósticos do analisador podem ser disparados em código existente que antes passava na análise:

  • unnecessary_non_null_assertion
  • unnecessary_cast
  • invalid_null_aware_operator

• As regras iterable_contains_unrelated_type e list_remove_unrelated_type foram removidas. Considere migrar para a regra collection_methods_unrelated_type ampliada.

• As seguintes regras foram removidas por não serem mais necessárias com o sound null safety. Você deve remover a configuração delas dos seus arquivos analysis_options.yaml e de quaisquer comentários de ignore.

  • always_require_non_null_named_parameters
  • avoid_returning_null
  • avoid_returning_null_for_future

• Language versioned Mudou o ponto de divisão para padrões refutáveis para o padrão de nível superior, de modo que a promoção de tipo em instruções if-case seja consistente independentemente de o valor avaliado poder lançar uma exceção.

• Experimental Deprecated A função waitFor.

• Os tipos de retorno de utf8.encode() e Utf8Codec.encode() foram alterados de List<int> para Uint8List.

• Deprecated O método Service.getIsolateID.

• NativeCallable.nativeFunction foi alterado para que as chamadas agora lancem um erro se o receptor já estiver fechado, em vez de retornar nullptr.

• Eliminou espaços em branco no final dos headers HTTP.
• Inseriu um espaço no ponto de dobra de valores de header dobrados que HttpClientResponse.headers e HttpRequest.headers retornam.

• Experimental Removed JSNumber.toDart em favor de toDartDouble e toDartInt.
• Experimental Removed Object.toJS em favor de Object.toJSBox.
• Experimental APIs de interop externo com JS usando dart:js_interop foram restritas a um conjunto de tipos permitidos.
• Experimental Uso de isNull e isUndefined no dart2wasm foi proibido.
• Experimental As APIs typeofEquals e instanceof foram alteradas para retornar bool em vez de JSBoolean. Além disso, typeofEquals agora recebe String em vez de JSString.
• Experimental Os tipos JSAny e JSObject foram alterados para que só possam ser implementados, e não estendidos, por tipos @staticInterop definidos pelo usuário.
• Experimental JSArray.withLength foi alterado para receber int em vez de JSNumber.

• Foram adicionados interceptors para os tipos JavaScript Symbol e BigInt; eles não devem mais ser usados com classes package:js.

• Foram adicionados interceptors para os tipos JavaScript Symbol e BigInt; eles não devem mais ser usados com classes package:js.

• Language versioned A promoção de campos privados final pode fazer com que os seguintes avisos do analisador sejam disparados em código existente que antes passava na análise:

  • unnecessary_non_null_assertion
  • invalid_null_aware_operator
  • unnecessary_cast
  dart

  class C {
    final num? _x = null;
  ​
    void test() {
      if (_x != null) {
        print(_x! * 2); // unnecessary_non_null_assertion
        print(_x?.abs()); // invalid_null_aware_operator
      }
      if (_x is int) {
        print((_x as int).bitLength); // unnecessary_cast
      }
    }
  }
  

  content_copy

• Adicionado o modificador interface a classes puramente abstratas: MultiStreamController, StreamConsumer, StreamIterator e StreamTransformer.

• Adicionado sameSite à classe Cookie, e adicionada a classe SameSite.
• FileSystemEvent é sealed. Isso significa que FileSystemEvent não pode ser estendido nem implementado.

• Experimental Removed ObjectLiteral; crie um literal de objeto sem membros nomeados usando {}.jsify().

• Membros external @staticInterop e membros de extensão external não podem mais ser usados como tear-offs. Declare um closure ou um método não external que chame esses membros, e use-o no lugar.
• Membros external @staticInterop e membros de extensão external vão gerar um código JS um pouco diferente para métodos que têm parâmetros opcionais.

• Language versioned A interpretação de casos de switch foi alterada de expressões constantes para padrões.

• Language versioned Declarações de classe de bibliotecas que foram atualizadas para o Dart 3.0 não podem mais ser usadas como mixins por padrão.

• O Dart reporta um erro de compilação se uma instrução continue tiver como alvo um label que não é um loop (instruções for, do e while) nem um membro de switch.

• As seguintes classes existentes foram transformadas em classes mixin: Iterable, IterableMixin, IterableBase, ListMixin, SetMixin, MapMixin, LinkedListEntry, StringConversionSink.

• Deprecated APIs descontinuadas.

• Removed Removida a classe descontinuada DeferredLibrary.

• Language versioned Mudanças nas bibliotecas da plataforma.

• Removed Removida a constante descontinuada MAX_USER_TAGS. Use maxUserTags em vez dela.
• Removed Removidas as classes descontinuadas Metrics, Metric, Counter, e Gauge, pois estavam quebradas desde o Dart 2.0.

• Experimental Deprecated A anotação @FfiNative agora está descontinuada. Os usos devem ser atualizados para usar a anotação @Native.

• Removed Removidos os métodos descontinuados registerElement e registerElement2 em Document e HtmlDocument.

• Language versioned A interface Random só pode ser implementada, não estendida.

• Atualizado NetworkProfiling para acomodar novos ids String que são introduzidos no vm_service:11.0.0.

• Marcado código adicional como inalcançável devido aos tipos Null e Never.
• Não delega nomes privados inacessíveis para noSuchMethod.
• Reporta um erro de compilação para todas as dependências cíclicas durante a inferência de tipo de nível superior.

• Removed A API previamente descontinuada [DEFAULT_BUFFER_SIZE] em JsonUtf8Encoder foi removida.

• Removed APIs previamente descontinuadas removidas kInvalidParams, kExtensionError, kExtensionErrorMax e kExtensionErrorMin em ServiceExtensionResponse.

• O tipo de argumento de runtime de Pointer foi alterado para Never em preparação para remover completamente o argumento de tipo de runtime. Pointer.toString foi alterado para não reportar nenhum argumento de tipo.

• Não permite content-length headers negativos ou hexadecimais.
• File.create agora recebe um novo parâmetro bool opcional exclusive, e, quando é true, a operação falha se o arquivo de destino já existir.
• Chamar ResourceHandle.toFile(), ResourceHandle.toSocket(), ResourceHandle.toRawSocket() ou ResourceHandle.toRawDatagramSocket() mais de uma vez agora lança um StateError.

• SendPort.send voltou a ter verificações estritas sobre o conteúdo das mensagens ao enviar mensagens entre isolates que não são conhecidos por compartilhar o mesmo código.

• Removed APIs removidas MirrorsUsed e Comment.

• Mudanças incompatíveis na funcionalidade de preview @staticInterop:
  • Classes com essa anotação não podem mais usar construtores generativos external. Veja 48730 e 49941 para mais detalhes.
  • Classes com membros de extensão external dessa anotação não podem mais usar parâmetros de tipo.
  • Classes com essa anotação também devem ter a anotação @JS.
  • Classes com essa anotação não podem ser implementadas por classes sem essa anotação.

• dart2js não aceita mais URIs HTTP como entradas.

• Removido o suporte a mixin de classes que não estendem Object.

• Alterada a propriedade uri de RedirectException em dart:io para ser nullable.
• Removidas constantes nas APIs de rede de dart:io seguindo a convenção SCREAMING_CAPS.
• A VM do Dart não restaura mais automaticamente as configurações iniciais do terminal ao sair.

• Descontinuado por completo o arquivo .packages.

• Removidas as ferramentas standalone dart2js e dartdevc.
• Removida a ferramenta standalone dartanalyzer.

• Adicionada nova propriedade connectionFactory a HttpClient.
• Adicionada nova propriedade keyLog a HttpClient, que permite registrar chaves TLS para fins de depuração.
• Removidas constantes em dart:io seguindo a convenção SCREAMING_CAPS
• Adicionada nova propriedade allowLegacyUnsafeRenegotiation a SecurityContext, que permite renegociação TLS para sockets seguros de cliente.

• Deprecated Descontinuada a ferramenta standalone dart2js.
• Deprecated Descontinuada a ferramenta standalone dartdevc.
• Removed Removida a ferramenta standalone dartdoc.

• No Windows, Directory.rename não vai mais excluir um diretório se newPath especificar um. Em vez disso, uma FileSystemException será lançada.
• Removed Removida a API Platform.packageRoot.

• Removed Removida a API Isolate.packageRoot.

• Deprecated Descontinuada a ferramenta standalone dartanalyzer.
• Deprecated Descontinuada a ferramenta standalone dartdoc.
• Removed Removida a ferramenta standalone pub descontinuada.

• Atualizada a classe SecurityContext para definir a versão mínima do protocolo TLS como TLS1_2_VERSION (1.2) em vez de TLS1_VERSION.

• A biblioteca dart:web_sql foi totalmente excluída.

• Removido window.openDatabase (relacionado à exclusão de dart:web_sql acima).

• Removida a ferramenta standalone dart2native.
• Removida a ferramenta standalone dartfmt.

• Removido o suporte a native extensions no estilo dart-ext:
• Isolates criados pela API Isolate.spawn() agrupados para operar no mesmo heap gerenciado e, portanto, compartilhar várias estruturas de dados internas da VM.

• Os callbacks de setter .authenticate e .authenticateProxy em HttpClient agora devem aceitar um argumento realm nullable (para código já migrado para null safety).

• A maioria dos tipos expostos por esta biblioteca não pode mais ser estendida, implementada ou usada como mixin.

• Expandos e os parâmetros object de Dart_NewWeakPersistentHandle e Dart_NewFinalizableHandle não aceitam mais Pointer e subtipos de Struct

• Descontinuada a ferramenta standalone dart2native
• Descontinuada a ferramenta standalone dartfmt.

• dart2js não oferece mais suporte a navegadores legados, porque emite JavaScript ES6+ por padrão.

• Alteradas as relações de subtipo das classes de package:js para ficarem mais corretas e consistentes com o Dart2JS.

• Não é mais válido usar uma String que corresponda a uma anotação @Native em uma anotação @JS() para uma classe de interop JS não anônima.

• O null safety agora é habilitado por padrão em todo código que não optou por sair.
• Corrigido um bug de implementação em que this às vezes passava por promoção de tipo em extensões.

• Descontinuadas invocações com um T genérico de sizeOf<T>, Pointer<T>.elementAt(), Pointer<T extends Struct>.ref e Pointer<T extends Struct>[]
• Descontinuado allocate em package:ffi, pois ele não será mais capaz de invocar sizeOf<T> de forma genérica.
• Descontinuados subtipos de Struct sem nenhum membro nativo.

• Dart_WeakPersistentHandle não se auto-exclui mais quando o objeto referenciado é coletado pelo garbage collector, para evitar race conditions.
• Renomeado Dart_WeakPersistentHandleFinalizer para Dart_HandleFinalizer e removido o argumento handle dele.

• A restrição do SDK do Dart agora é obrigatória no pubspec.yaml.

• Renomeado dart_api_dl.cc para dart_api_dl.c e alterado para um arquivo C puro.

• Ao codificar uma string contendo surrogates não pareados como UTF-8, os surrogates não pareados serão codificados como caracteres de substituição (U+FFFD).
• Ao decodificar UTF-8, surrogates codificados serão tratados como entrada malformada.
• Alterado o número de caracteres de substituição emitidos para sequências de entrada malformadas, para igualar o padrão de codificação WHATWG, ao decodificar UTF-8 com allowMalformed: true.

• CssClassSet.add() e CssClassSet.toggle agora retornam false em vez de null se o CssClassSet corresponder a múltiplos elementos.

• Os compiladores web (dart2js e DDC) agora produzem um erro de compilação se dart:mirrors for importado.

• Ao imprimir uma string usando a função print, a implementação padrão imprime quaisquer surrogates não pareados da string como caracteres de substituição (U+FFFD).
• A função Dart_StringToUTF8 na API do Dart converte surrogates não pareados em caracteres de substituição.

• Corrigido um bug de implementação em que a inferência de variáveis locais usava incorretamente o tipo promovido de uma variável de tipo.
• Corrigido um bug de implementação envolvendo as cláusulas implements Function, extends Function ou with Function, que não tinham mais efeito desde o Dart 2.0.0.

• Alterado o tipo de retorno de StreamSubscription.cancel() para Future<void>.
• Dividida a função runZoned() em duas funções: runZoned() e runZonedGuarded(), sendo que esta última tem um parâmetro onError obrigatório, e a primeira não tem nenhum.
• Erros passados para Completer.completeError(), Stream.addError(), Future.error(), etc. não podem mais ser null.
• Stack traces agora são non-null.

• Três membros de RuneIterator não retornam mais null quando acessados antes da primeira chamada a moveNext().
• O valor padrão de defaultValue em String.fromEnvironment() agora é uma string vazia em vez de null.
• O valor padrão do parâmetro defaultValue de int.fromEnvironment() agora é zero.

• Alterados Pointer.asFunction() e DynamicLibrary.lookupFunction() para métodos de extensão.

• Alterada a assinatura dos métodos de HttpHeaders add() e set.
• A classe Socket agora lança uma SocketException se o socket tiver sido explicitamente destruído ou atualizado para um socket seguro ao definir ou obter opções de socket.
• A classe Process agora lança um StateError se o processo estiver desanexado (ProcessStartMode.detached e ProcessStartMode.detachedWithStdio) ao acessar o getter exitCode.
• A classe Process agora também lança quando não está conectada ao stdio do processo filho (ProcessStartMode.detached e ProcessStartMode.inheritStdio) ao acessar os getters stdin, stdout e stderr.
• O objeto fictício retornado se FileStat.stat() ou FileStat.statSync() falhar agora contém timestamps Unix epoch em vez de null para os getters accessed, changed e modified.
• A classe HeaderValue agora faz o parsing de forma mais estrita em dois casos de borda inválidos.

Corrigimos várias inconsistências entre o DDC e o Dart2JS para que os usuários encontrem com menos frequência código aceito por um compilador, mas que depois falha no outro.

• Excluída a versão legada (baseada no analisador) do DDC.
• Funções passadas para JavaScript usando a especificação de interop package:js recomendada agora devem ser encapsuladas com uma chamada a allowInterop.
• Construtores em classes @JS() devem ser marcados com external.

• Os limites de parâmetros de tipo correspondentes agora só precisam ser subtipos mútuos, em vez de estruturalmente iguais, salvo renomeação das variáveis de tipo dos limites e equiparação de todos os tipos topo.
• Os tipos agora são normalizados.
• Construtores em classes @JS() devem ser marcados com external.
• Removida por completo a flag --package-root, que era oculta e desabilitada no Dart 2.0.0.

• O SDK do Dart para macOS agora está disponível apenas para x64.

• Membros de extensão estáticos são acessíveis quando importados com um prefixo.

• Adicionado IOOverrides.serverSocketBind para facilitar a escrita de testes que desejam simular ServerSocket.bind.

• Alterada a inferência ao usar valores Null em um contexto FutureOr. Ou seja, restrições de formas semelhantes a Null <: FutureOr<T> agora produzem Null como solução para T.

• A API agora usa membros de extensão estáticos.
• Removidos Pointer.allocate e Pointer.free de gerenciamento de memória.
• Pointer.offsetBy foi removido; use cast e elementAt no lugar.

• Vários métodos e propriedades de várias bibliotecas principais, que declaravam um tipo de retorno List<int>, foram atualizados para declarar um tipo de retorno Uint8List.

• Os parâmetros posicionais opcionais name e value do construtor da classe Cookie agora são obrigatórios.
• Os setters name e value da classe Cookie agora validam que as strings são formadas pelo conjunto de caracteres permitido e não são null.

• Pacotes publicados no pub.dev não podem mais conter dependências git.

• A covariância de variáveis de tipo usadas em super-interfaces agora é imposta.

• Isolate.resolvePackageUri sempre lançará um UnsupportedError quando compilado com dart2js ou DDC.

• Corrigido um bug na classe StreamIterator em que await for permitia null como stream.

• A propriedade klass do getter na classe InstanceConstant da API de AST do Kernel foi renomeada para classNode, por consistência.
• Atualizada a implementação de Link para usar links simbólicos verdadeiros em vez de junctions no Windows.

• Adicionar a um IOSink fechado agora lança um StateError.

• Corrigida uma brecha de soundness ao usar dart:mirrors para invocar refletivamente um método de forma incorreta, violando seus tipos estáticos.

• Vários erros estáticos que deveriam ter sido detectados e reportados não eram suportados no 2.0.0. Eles agora são reportados, o que significa que código incorreto existente pode mostrar novos erros:
  • Mixins devem sobrescrever corretamente suas superclasses.
  • Argumentos de tipo implícitos em cláusulas extends devem satisfazer os limites da classe.
  • Membros de instância devem sombrear prefixos.
  • Invocações de construtor devem usar sintaxe válida, mesmo com new opcional.
  • Argumentos de tipo de typedefs genéricos devem satisfazer seus limites.
  • Classes não podem implementar FutureOr.
  • Métodos abstratos não podem sobrescrever de forma unsound um método concreto.
  • Construtores constantes não podem redirecionar para construtores não constantes.
  • Setters com o mesmo nome da classe envolvente não são permitidos.

• Chaves duplicadas em um map const não são permitidas e produzem um erro de compilação.

• Substituído o sistema de tipos estático opcional e unsound por um sistema de tipos sound que usa inferência de tipos e verificações em runtime, anteriormente chamado de strong mode.
• Funções marcadas como async agora executam de forma síncrona até a primeira instrução await.

• Constantes nas bibliotecas principais renomeadas de SCREAMING_CAPS para lowerCamelCase.
• Adicionados muitos novos métodos às classes das bibliotecas principais que precisarão ser implementados se você implementar as interfaces dessas classes.
• dart:isolate e dart:mirrors não são mais suportados ao usar o Dart para web.

• Substituído o sistema de build baseado em transformers do pub por um novo sistema de build.