Announcing Dart 3.14【日本語訳】

訳者 はじめに

Connie Ooiさんによる「Announcing Dart 3.14」(原文)の日本語訳です。勝手に訳して、後から許可をとる。

Dart 3.14 リリース発表

Dart 3.14 のリリースを発表できることを大変うれしく思います!

円周率(pi)にちなんだ今回のリリースでは、ブラウザでアイデアを試すところから、クロスプラットフォームアプリを構築し、次のリリースに向けてパッケージをアップグレードするところまで、開発ワークフローがひとつの輪としてつながります。刷新された DartPad ではアイデアや pub.dev のパッケージを試せるようになり、dart migrate によって SDK バージョンをまたぐコードベースの移行を自動化できます。また、ハードウェア SIMD による WebAssembly の性能向上、ブラウザ外での Wasm モジュール実行、安定版となった FFIgen と JNIgen によるネイティブプラットフォーム API の呼び出しも可能になりました。

Dart を更新するか、flutter upgrade を実行して、Dart 3.14 の新機能を見ていきましょう。UI フレームワーク側の変更点については、関連記事 What's new in Flutter 3.50 もご覧ください。

ツールのアップデート

dart migrate ツールによるパッケージの自動アップグレード

Dart パッケージを新しい SDK バージョンに更新するには、SDK のバージョン制約を引き上げ、新バージョンでの破壊的変更を回避したり、新たに推奨されるコードスタイルに従ったりするためにコードを修正する必要があります。しかし、リリースごとに有効にすべき lint や必要なコード変更を特定するのは簡単ではありません。

新しい dart migrate ツールは、パッケージを一度に1バージョンずつ更新して、この作業を自動化します。各バージョンについて、次の処理を行います。

  1. バージョン制約を変更する前に必要な dart fix の修正を適用し、パッケージを準備する。
  2. pubspec.yaml の SDK バージョン制約の下限を引き上げる。

新バージョンへの更新後には、新機能を活用したり新しいスタイル推奨事項に従ったりするための修正を、任意で適用できます。

たとえば、SDK 制約が ^3.12.0 のパッケージを考えます。

<div class="joplin-editable"><pre class="joplin-source" hidden="" data-joplin-language="dart" data-joplin-source-open="```dart
" data-joplin-source-close="
```">class WeakPasswordException implements Exception {}

void checkPassword(final String password, final int minLength) {
  if (password.length < minLength) {
    throw WeakPasswordException();
  }
}

このツールは、Dart 3.13 ではコンパイルエラーとなる仮引数の final を削除することで、事前の修正を行います。その後、pubspec.yaml の SDK 制約を更新し、空のクラスに新しいセミコロン構文を採用することでコードを整理します。

<div class="joplin-editable"><pre class="joplin-source" hidden="" data-joplin-language="dart" data-joplin-source-open="```dart
" data-joplin-source-close="
```">class WeakPasswordException implements Exception;

void checkPassword(String password, int minLength) {
  if (password.length < minLength) {
    throw WeakPasswordException();
  }
}

移行処理が完了すると、各ステップで行われた変更の概要に加え、任意で適用できるクリーンアップ修正が報告されます。

<div class="joplin-editable"><pre class="joplin-source" hidden="" data-joplin-language="text" data-joplin-source-open="```text
" data-joplin-source-close="
```">my_package:
  3.12.0 -> 3.13.0:
    Preparatory changes:
      2 changes made in 1 file.

      my_package/lib/password.dart
        avoid_final_parameters • 2 changes

    SDK constraint:
      Bumped ^3.12.0 -> ^3.13.0

Optional cleanup fixes can modernize your code further:

  my_package: 1 change in 1 file
    empty_container_bodies • 1 change

To preview them, run 'dart pub get' and then 'dart migrate --dry-run --step=cleanup' on the same packages.

パッケージへの変更内容を事前に確認するには、--dry-run フラグを使います。

<div class="joplin-editable"><pre class="joplin-source" hidden="" data-joplin-language="bash" data-joplin-source-open="```bash
" data-joplin-source-close="
```">dart migrate --dry-run

提案された変更を適用するには、--apply フラグを使います。

<div class="joplin-editable"><pre class="joplin-source" hidden="" data-joplin-language="bash" data-joplin-source-open="```bash
" data-joplin-source-close="
```">dart migrate --apply

規模の大きいコードベースで、SDK 制約の更新前後に修正内容を確認したい場合は、--step フラグで処理を個別に実行できます。

<div class="joplin-editable"><pre class="joplin-source" hidden="" data-joplin-language="bash" data-joplin-source-open="```bash
" data-joplin-source-close="
```"># 制約を引き上げず、事前修正だけを実行
dart migrate --apply --step=prepare

# 事前修正を適用した後、制約の引き上げとクリーンアップを実行
dart migrate --apply --step=bump,cleanup

デフォルトでは、パッケージをマイナーバージョン1つ分だけ更新します。一度に複数バージョンを移行するには、--target-sdk フラグを使います。

<div class="joplin-editable"><pre class="joplin-source" hidden="" data-joplin-language="bash" data-joplin-source-open="```bash
" data-joplin-source-close="
```">dart migrate --apply --target-sdk=3.14.0

注意: dart migrate は、SDK 制約が Dart 3.0 以降を要求するパッケージにのみ対応しています。

詳細: Dart migrate のドキュメント

Analysis Server の性能改善

SDK のアップグレードを円滑にすることに加え、ワークスペースが拡大しても IDE の応答性を維持し、AI コーディングエージェントを使ったワークフローを高速化することは、ツールチームの重要な目標です。Dart Analysis Server には、次の性能改善が導入されました。

  • ファイル探索の高速化: 特に多数の Analysis Context を含むワークスペースで、Find References(参照の検索) などのリクエストが高速になります。
  • 処理のブロッキング軽減: 従来はコード整形などのほかの処理を妨げていたタスクが、ブロックしにくくなりました。
  • サーバー起動の高速化: パッケージ設定や解析オプションの変更によって Analysis Server が解析を再開する場合も含め、起動時間を短縮しました。
  • documentColor リクエストの高速化: documentColor の処理を高速化し、編集中にこれを待っていたほかの Analysis Server リクエストも進めやすくなりました。
  • analyzer プラグインの解析ルートの限定: プラグインの解析ルートを、そのプラグインのコンテキストルートに制限することで解析速度を向上させました。

Pub のアップデート

ETag キャッシュによる依存関係解決の高速化

dart pub では、中規模から大規模のプロジェクトにおける、キャッシュが温まった状態での依存関係解決が高速化し、通信量も大幅に減りました。従来、dart pub get、upgrade、add で依存関係を解決する際、pub は各パッケージの公開バージョン一覧を pub.dev に問い合わせ、新バージョンや公開取り消し、セキュリティアドバイザリを確認していました。そのため、情報に変化がなくても数 MB のメタデータを再ダウンロードすることがありました。

今回から、dart pub はパッケージ一覧のキャッシュとともにサーバーの ETag をローカルの pub キャッシュへ保存し、キャッシュがある場合は条件付きの If-None-Match リクエストを送ります。パッケージ一覧に変更がないとき、pub.dev は本文が空の 304 Not Modified を返し、pub は再ダウンロードせずキャッシュを再利用します。依存パッケージが144個ある Flutter プロジェクトでは、繰り返しダウンロードしていたバージョン一覧のデータ約1.5 MBを削減でき、特に低速・高遅延の回線で依存関係解決が高速になります。

刷新された DartPad ベータ版

ブラウザで Dart と Flutter を手軽に、より高速に試せるよう全面的に再設計した DartPad のベータ版を公開しました。

新しい DartPad は package:dartpad 上に構築されています。Dart コンパイラ、analyzer、pub クライアントを WebAssembly にコンパイルし、Web Worker 内でローカル実行します。これにより、リモートサーバーの応答を待つことなくブラウザ内でコードを解析・コンパイルでき、フィードバックが速くなります。Language Server Protocol(LSP)も完全サポートし、IDE と同様のコード補完、ホバー時のドキュメント表示、定義への移動、クイックフィックスを利用できます。

この技術基盤の大きな特徴は、pub.dev からパッケージを取り込めることです。従来のように許可リストにある一部のパッケージに限定されず、実際のプロジェクトで使うライブラリをその場で試せます。また、複数ファイルにも対応し、実際のアプリと同じようにウィジェットやデータモデルを整理できます。

新しい DartPad は、ローカルマシン、サーバー、Web ブラウザで実行できるフルスタック言語としての Dart の汎用性を示しています。主要ツール自体が Dart で書かれているため、それらを WebAssembly にコンパイルすることで、開発ワークフロー全体をブラウザ内で動かせるのです。

試す: dartpad.dev

Web プラットフォームのアップデート

ブラウザと Wasm ランタイム向け WebAssembly 例外処理の標準化

Dart の WebAssembly アプリが、より多くのブラウザやブラウザ外の Wasm 実行環境で、そのまま動くようになりました。ブラウザでは、dart2wasm が標準化された WebAssembly の try_table 例外処理命令をデフォルトで生成するようになりました。また、Safari 26.5 以前のストリーミングコンパイルの問題にも対処し、Chrome 137 以降、Safari 26.2 以降、Firefox 147 以降で WebAssembly を利用可能にしています。

ブラウザ外では、try_table の採用により、dart compile wasm --standalone でコンパイラが JavaScript の例外ラッパーに依存していた最後の部分がなくなりました(コミュニティメンバー Simon Binder 氏による貢献)。これにより、JavaScript ホストなしで Wasmtime などの Wasm ランタイムで直接実行できる標準的な .wasm バイナリが生成され、エッジワーカー、プラグインシステム、サーバー側の Wasm 環境で Dart を使いやすくなります。WASI や WebAssembly Component Model を試す場合は、Simon Binder 氏のコミュニティパッケージ wasm_tools と、その GitHub リポジトリをご覧ください。

詳細: WebAssembly のドキュメント

ハードウェア 128 ビット WebAssembly SIMD

対応ランタイムの拡大に加え、今回のリリースでは WebAssembly の性能が大きく向上しました。コミュニティメンバー Modestas Valauskas 氏による60件以上の SDK への貢献により、dart2wasm は Int32x4、Float32x4、Float64x2 と、それらに対応する型付きデータのリストビューを、ハードウェアの128ビット WebAssembly SIMD(v128)命令へ直接コンパイルするようになりました。ネイティブ環境の dart:typed_data における Int32x4 演算も拡充・最適化され、ネイティブおよび WebAssembly の SIMD ベンチマークで最大4倍の高速化を実現しました。

詳細: dart:typed_data ライブラリのドキュメント

--no-deprecated-js-interop によるレガシー Web ライブラリの廃止準備

WebAssembly の普及と Dart の Web プラットフォームの近代化に伴い、従来の Web および JavaScript 相互運用ライブラリ(dart:html、dart:js、dart:js_util、package:js、関連する dart:* ブラウザライブラリ)は非推奨となっており、今後の Dart SDK リリースで削除される予定です。移行には時間がかかりますが、package:web と dart:js_interop に移ることで、WebAssembly との完全な互換性を含む、より堅牢で標準化された Dart Web 開発環境を利用できます。

移行準備を支援するため、dart compile js(dart2js)と ddc が --no-deprecated-js-interop をサポートしました。このオプションは、これらのライブラリへの直接・間接の import をコンパイル時に拒否し、条件付き import で使われる dart.library.* の環境条件を false に設定します。

今のうちにパッケージやアプリで dart compile js --no-deprecated-js-interop(Flutter 3.50 では flutter build web --no-deprecated-js-interop)を実行し、残っている利用箇所を dart:js_interop と package:web に移行してください。

詳細: JS interop のドキュメント、package:web への移行

コアエンジンとランタイムのアップデート

dart:typed_data の高速な範囲比較

性能が重要なコードでバイトバッファの一部を比較する際に、sublistView を割り当てて各要素を順に比較する必要がなくなりました(従来の例としては package:collection の ListEquality があります)。dart:typed_data に、すべての整数型付きデータリスト(Uint8List、Int8List、Uint8ClampedList、Uint16List、Int16List、Uint32List、Int32List、Uint64List、Int64List)および ByteData 向けの rangeEquals 拡張メソッドが追加されました。

<div class="joplin-editable"><pre class="joplin-source" hidden="" data-joplin-language="dart" data-joplin-source-open="```dart
" data-joplin-source-close="
```">import 'dart:typed_data';

void main() {
  final packet = Uint8List.fromList([0x89, 0x50, 0x4E, 0x47, 0x0D, 0x0A]);
  final pngMagic = Uint8List.fromList([0x89, 0x50, 0x4E, 0x47]);

  // Compare packet[0..4] against pngMagic[0..4] without allocating views:
  if (packet.rangeEquals(0, 4, pngMagic)) {
    print('PNG header matched');
  }
}

内部的には、rangeEquals は Dart VM 上では memcmp、dart2wasm では Wasm 配列の直接読み込み(ByteData では32ビット単位)、JavaScript では効率的な型付き配列ループとして実装されます。これにより、どのターゲットでも追加のメモリ割り当てを伴わない高速な比較ができます。

詳細: dart:typed_data ライブラリのドキュメント

ネイティブ API との直接相互運用

コアランタイムの改善に加え、Dart からネイティブプラットフォームのライブラリを呼び出す仕組みが、本番環境で使える段階になりました。Dart 3.14 では、Objective-C 向け FFIgen と JNIgen が安定版になりました。

プラットフォームチャネルの定型コードを手作業で書く代わりに、FFIgen と JNIgen で Dart らしい型安全なバインディングを自動生成し、Objective-C、Java、Kotlin の API を Dart から直接呼び出せます。安定版に至ったのは、Dart パッケージや Flutter プラグインの構築時の負担を軽減するために、長年にわたって設計・改善・フィードバックを重ねた結果です。用途に応じた相互運用方式の選び方については、近日中に Flutter ブログで詳しく紹介する予定です。

詳細: ネイティブ相互運用のドキュメント

今後の展望:言語ロードマップ

開発チームは、this promotion と static extensions の実装を引き続き進めています。今後のリリースで詳しくお知らせしますので、ご期待ください。

詳細: Dart language funnel

コミュニティ

Dart の体系化された RFC プロセス

Dart の各リリースではコミュニティの貢献者が大きな役割を果たしており、Dart 3.14 のスタンドアロン WebAssembly とハードウェア SIMD の改善もその例です。Dart エコシステムの成長に伴い、プロジェクトの重要な意思決定を追跡し、参加しやすくすることを目指しています。Dart プロジェクトでは、チームの合意が必要な大規模変更の提案・評価に、より体系的な方法を採用します。今後、そのような変更には Request for Comments(RFC)の作成が必要になります。

このプロセスは、チームメンバーとコミュニティの貢献者の双方が利用でき、Dart チームとプロジェクトリーダーからフィードバックや正式な承認を得るためのものです。また、設計に関する議論や意思決定の記録を一か所にまとめることで、チームが何に取り組んでいるかをより明確に示します。

詳細: Dart RFC リポジトリ

Dart 3.14 を試してみよう

円周率にちなんだ今回のリリースは、DartPad で pub.dev のパッケージをブラウザ上で試すところから、高性能な WebAssembly・ネイティブアプリのリリース、dart migrate を使ったバージョンアップの自動化まで、開発の一連の流れをつなぎます。その内部では、Dart のコンパイラ、analyzer、pub クライアント自体が WebAssembly にコンパイルされ、ブラウザ上で Dart を実行しています。

この循環は Dart コミュニティにも広がっています。Dart 3.14 の主要な改善の数々はオープンソース貢献者によって直接実現されました。また、新しい RFC プロセスによって、Dart プロジェクトで大規模な技術変更がどのように設計・レビュー・共有されるかが、より透明になります。コードの提供、Issue の報告、フィードバックに協力してくださった皆さん、ありがとうございます!

ぜひ flutter upgrade を実行するか、最新の Dart SDK をダウンロードして、新しい DartPad のベータプレビューをお試しください。そして、ご意見を GitHub の Issue トラッカーでお聞かせください。Dart を使って開発していただき、ありがとうございます!

詳細: Dart SDK の変更履歴