HN 日本語サマリー

← 一覧へ戻る
プログラミング

Flutter 3.47の新機能

What's New in Flutter 3.47 (flutter.dev)

165 pointsby gumby271168 コメント

要約

Flutter 3.47がリリースされ、モジュール設計によるスタンドアロンUIパッケージとデスクトップ版Impellerの導入が目玉です。MaterialとCupertinoのデザインシステムがコアSDKから分離され、個別のパッケージとして提供されるようになりました。これにより、開発サイクルの高速化と、SDKのバージョンアップに依存しないUIコンポーネントの更新が可能になります。また、デスクトップ版Impellerがデフォルトで有効になり、パフォーマンスが向上し、iOS、macOS、Xcode 27への対応も強化されています。

全文翻訳

Flutter 3.47 の新機能

Flutter 3.47 がリリースされ、エキサイティングな新アップデートが登場しました。

本日、スタンドアロンの material_ui および cupertino_ui パッケージの 1.0 リリースを歓迎します。これは、デザインシステムをコアSDKから分離するメジャーマイルストーンです。

また、パフォーマンスとツール全体を強化しています。このリリースでは、Impeller がデスクトップでデフォルトとなり、iOS、macOS、Xcode 27 向けのパイプラインを準備し、Flutter Widget Previews を安定版に移行させます。

ターミナルで flutter upgrade を実行して開始するか、読み進めてこのリリースにおける主な変更点についてさらに詳しく学びましょう。


独自の UI アドベンチャーを選択

分離された Flutter への第一歩がここにあります:Material と Cupertino がスタンドアロンパッケージとして利用可能になりました!

Flutter の最大の強みの一つは、ピクセルパーフェクトな Material および Cupertino ウィジェットをレンダリングする能力です。しかし、これらのデザインライブラリは歴史的にコアSDKに直接バンドルされていたため、開発が遅れ、貢献したり最新の状態に保ったりすることが困難でした。

このリリースではコアSDKにこれらのライブラリが引き続き含まれていますが、スタンドアロンの material_ui および cupertino_ui パッケージを選択できるようになりました。これらは pub.dev で正式にバージョン 1.0 に到達しました。

デザインロードマップの分離(オプトイン)

分離されたデザインシステムを選択することで、デザインロードマップを制御できるようになります。material_ui および cupertino_ui は現在 pub.dev に存在するため、四半期ごとの Flutter SDK リリースとは独立して、独自の週次スケジュールでバグ修正や新コンポーネントをリリースできます。

デザインシステムを分離することには、以下のメリットがあります:

  • Flutter SDK のバージョン全体をアップグレードすることなく、最新の Cupertino および Material ウィジェットスタイルを使用できます。
  • 貢献やアップデートをより迅速かつ頻繁に着地させることができます。
  • 将来的にカスタムデザインシステムを構築しやすくするために、スタイルに依存しない Flutter コアウィジェットカタログの基盤を築きます。
マイグレーション方法

プロジェクトを新しいスタンドアロンパッケージに移行するには、次のコマンドを実行します:

dart fix --apply --code=migrate_design_widgets

このツールは、package:flutter/material.dart および package:flutter/cupertino.dart からのインポートを新しいスタンドアロンパッケージに自動的に更新します。

注意: マイグレーションツールが pubspec.yaml の更新で問題に遭遇した場合(既知の初期バグ)、手動で flutter pub add material_ui(使用する場合は cupertino_ui も)を実行し、再度 dart fix --apply を実行することで解決できます。

コアSDK内の元のデザインライブラリは、11月の次の安定版リリースで正式に非推奨になる予定です。エコシステム内のパッケージを移行する場合、スタンドアロンパッケージへのこの移行をメジャーリリースとして扱ってください。

マイグレーションギャップの橋渡し

新しいスタンドアロンデザインライブラリへのエコシステムの移行を円滑に進めるため、material_ui および cupertino_ui にはマイグレーションユーティリティが付属しています。MaterialUiCompatibilityBridge を使用すると、パッケージ依存関係の一部がまだレガシーコアSDKインポートを使用している場合でも、アプリケーションをすぐにスタンドアロンパッケージに移行できます。

例えば、アプリを互換性ブリッジでラップできます:

import 'package:material_ui/material_ui.dart';
​
void main() {
  runApp(const MyApp());
}
​
class MyApp extends StatelessWidget {
  const MyApp({super.key});
​
  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      theme: ThemeData(
        colorScheme: ColorScheme.fromSeed(seedColor: const Color(0xFF6750A4)),
      ),
      builder: (BuildContext context, Widget? child) {
        return MaterialUiCompatibilityBridge(child: child!);
      },
      home: const HomeScreen(),
    );
  }
}
分離されたローカライゼーション

この移行の一環として、flutter_localizations もバンドル解除されました。Material および Cupertino ウィジェットのローカライゼーションデリゲートと翻訳済み文字列は、それぞれ package:material_ui および package:cupertino_ui 内に配置されるようになりました。

以前:

import 'package:flutter_localizations/flutter_localizations.dart';
import 'package:flutter/material.dart';
​
// ...
localizationsDelegates: const <LocalizationsDelegate<dynamic>>[
  GlobalCupertinoLocalizations.delegate,
  GlobalMaterialLocalizations.delegate,
  GlobalWidgetsLocalizations.delegate,
],

以後:

import 'package:material_ui/material_ui.dart';
​
// ...
localizationsDelegates: GlobalMaterialLocalizations.delegates,

localizationsDelegates を GlobalMaterialLocalizations.delegates に設定すると、Cupertino および Widgets デリゲートも含まれるようになり、セットアップが簡素化されます。

[画像: 分離されたパッケージのアーキテクチャ図]

ローカライゼーション構造の分離

貢献を歓迎

Material および Cupertino ライブラリへの貢献を4月に凍結したことで、スムーズな移行を保証することができました。material_ui および cupertino_ui で待機しているライブラリは、すでに使用しているライブラリと同じです。

現在、凍結を解除する準備ができたため、新しいパッケージで修正と機能が定期的にリリースされることを期待してください。現在、週次のリリースを予定しています。また、これらのパッケージをコミュニティの貢献に正式に開放できることを嬉しく思います。


次の Apple アップデートの準備

今年の秋にリリースされる Xcode 27、iOS 27、macOS 27 に向けて、Flutter がこれらのアップデートに対応できるよう、重点的に取り組んできました。ユーザーが初日から予期せぬ問題に遭遇しないように、現在 Apple のベータ版でアプリをテストすることを推奨します。

さらに、Xcode 27 をサポートするために、最小サポート OS バージョンが引き上げられました:

プラットフォーム前の最小バージョン新しい最小バージョン (Flutter 3.47+)
iOS1315
macOS10.1512
UIScene ライフサイクルの義務化

iOS 27 SDK は、すべての UIKit ベースのアプリで UIScene ライフサイクルを義務付けました。Xcode 27 でビルドされたアプリで UIScene を採用していない場合、起動時に失敗します。

ほとんどのアプリでは、Flutter CLI がビルド中にこの移行を自動的に処理します。ただし、AppDelegate にカスタムネイティブコードがある場合や、レガシーアプリケーションライフサイクルに依存するプラグインを使用している場合は、手動での移行が必要です。その場合は、UIScene/Delegate Adoption Guide に従って手動で移行する必要があります。

Intel Mac の段階的廃止

Apple の Apple Silicon への移行に合わせ、Flutter は Intel ベースの Mac のサポートを縮小しています。Intel ハードウェアでの自動テスト実行を無効にし、Flutter CLI は Intel ホストでのビルド時またはデュアルアーキテクチャをターゲットとする際に警告を表示するようになりました。これらの警告は、将来のリリースでエラーになります。

flutter config --enable-macos-arm64-only を実行することで、すぐに ARM64 のみで macOS アプリをビルドするようにオプトインできます。

Swift Package Manager の進捗

コミュニティは Swift Package Manager への移行で驚異的な進歩を遂げており、上位 100 の iOS プラグインのうち 92 がすでに移行済みです。以前 Swift Package Manager を無効にしていた場合は、flutter config --enable-swift-package-manager を実行して再度試すことができます。

CocoaPods は現在メンテナンスモードに入っているため、SwiftPM に移行しないプラグインは最終的に動作しなくなります。移行されていないプラグインは、pub.dev のスコアも低くなります。プラグインをメンテナンスしている場合は、Migration Guide を参照し、詳細については以前のブログ投稿をお読みください。

このリリースでは、コミュニティコントリビューターの @lukemmtt によるビルド時間の最適化も含まれています。彼は、ビルドプロセスの早い段階で不要な SwiftPM パッケージスキームを除外することでビルドパイプラインを改善しました(#186006)。


Wasm をデフォルトに設定

Flutter ウェブアプリケーションの WebAssembly (Wasm) をデフォルトで有効にするために積極的に取り組んでおり、ブラウザにネイティブライクなパフォーマンスをもたらします。まだ Wasm でウェブアプリをテストしていない場合は、リリースビルドコマンドに --wasm フラグを渡すことで、今日からオプトインできます:

flutter build web --release --wasm

この移行に備えるにあたり、Wasm はレガシー dart:html ライブラリはサポートされていないため、コードベースを新しい JS インタオペパッケージ(package:web)に移行する必要があることに留意してください。プロジェクトのパッケージ依存関係をアップグレードすると、これらのレガシーインタオペの問題は自動的に解決されることがよくあります。

大規模なウェブアプリケーションのスケーリングを支援するため、このリリースでは Wasm の遅延ロードの実験的サポートも導入しています。メインチャンネルのフラグで利用可能で、Wasm アプリケーションをより小さく、遅延ロード可能なモジュールに分割し、初期ロード時間を最適化できます:

flutter build web --release --wasm --enable-wasm-deferred-loading

デスクトップにモダンなグラフィックスが登場:Impeller

私たちは、デスクトッププラットフォームを高性能グラフィックスのファーストクラスターゲットにすることにコミットしています。Flutter 3.47 では、Impeller が macOS、Windows、Linux のデフォルトレンダラーになります。

Impeller は Flutter の次世代レンダリングエンジンで、Skia を置き換えるためにゼロから構築されました。Metal (macOS) や Vulkan (Windows, Linux) のようなモダンなハードウェア API をターゲットにすることで、Impeller は実行時に動的にコンパイルするのではなく、ビルド時に固定セットのシェーダーをコンパイルします。これにより、アニメーションが初めて再生される際の短いカクつき(シェーダーコンパイルジャンクと呼ばれる)が解消され、最初のフレームから一貫してスムーズな遷移が実現されます。詳細については、Impeller レンダリングエンジンのドキュメントをご覧ください。

一時的に Impeller をオプトアウトする必要がある場合は、次の手順に従ってください:

  • macOS: Info.plist で FLTEnableImpeller を false に設定します。
  • Windows: main.cpp に project.set_impeller_switch(flutter::ImpellerSwitch::Disabled) を追加します。
  • Linux: my_application.cc で fl_dart_project_set_enable_impeller(project, FALSE) を呼び出します。

フォールバックオプションは将来のリリースで削除されるため、Skia の使用に戻る必要がある場合はバグを報告してください。さらに、Wide Gamut Color が macOS でデフォルトで有効になり、対応ハードウェアで豊かで鮮やかな正確な色再現を提供します。

実験的なマルチウィンドウの進捗

Canonical とのパートナーシップ、およびメンテナーの @robert-ancell と @mattkae のおかげで、実験的なデスクトップウィンドウ API を拡張しています。Linux および Windows はポップアップウィンドウ(#185866, #184516)をサポートするようになり、ネイティブのコンテキストメニューやユーティリティパレットを構築できるようになりました。

[画像: Win32 のポップアップウィンドウ]

Win32 のポップアップウィンドウ

また、プラットフォーム固有のコントローラーで windowHandle をクエリできるようになり、基盤となるネイティブウィンドウ(HWND、NSWindow、または GtkWindow)への直接ポインタを取得できるようになりました。これにより、Windows のドック可能なペインのような高度なネイティブ機能へのアクセスが可能になります。これは @orestesgaolin が提供したドック可能なペインデモです:

[画像: ドック可能なペインデモ]

ドック可能なペインデモ

ウィンドウフォーカスと実現に関するいくつかのバグも修正しました。Windows では、ウィンドウのアクティベート時にバックグラウンドウィンドウが前面に表示されたり、アプリ再開時にフォーカスが奪われたりすることがなくなりました。これはコントリビューターの @9AZX によるものです(#188016):

[画像: Windows のウィンドウフォーカスと実現の修正]

Windows のウィンドウフォーカスと実現の修正

Linux では、マルチウィンドウ作成時に、コンポジターからの最初のフレームを受け取る前に明示的にウィンドウが実現されるようになり、初期レンダリング警告やコンポジターのアサーションが修正されました。

また、コンテンツに合わせてサイズ変更される新しい API を追加しました。これにより、コンテンツに合わせて自動的にサイズ調整される通常のウィンドウやダイアログウィンドウを作成できます。

デスクトップ向けのフレーバー

Windows および Linux で Flutter フレーバーがサポートされるようになりました。

例えば、pubspec.yaml ファイルで異なるフレーバーに対して異なるアセットを使用できます:

flutter:
  assets:
    - path: assets/flavor_a/images
      flavors:
        - flavor_a
    - path: assets/flavor_b/images
      flavors:
        - flavor_c

--flavor オプションを使用してフレーバーを指定します。例:

  • flutter build windows --flavor flavor_a
  • flutter build linux --flavor flavor_a

@AngeloAvv の素晴らしい貢献に感謝します(#187034, #187029)!

よりシャープなデスクトップテキスト

デスクトップ画面は、モバイルディスプレイよりもピクセル密度が低いことが多いですが、グラフィックスの計算能力は高くなっています。デスクトップでよりシャープなテキストとクリーンなベクター曲線を提供するために、Impeller を使用する Flutter エンジンは、macOS、Linux、Windows で Signed Distance Function (SDF) レンダリングを利用するようになりました。


安定版プレビューと GenUI のアップデート

Widget Previews が安定版に

Flutter Widget Preview が安定版になり、アプリケーション全体をビルドまたは起動することなく、個々の UI コンポーネントを即座にレンダリング、検査、イテレーションできるようになりました。

この安定版リリースでは、以下のことが期待できます:

  • .widget_preview/ フォルダでのローカルプロジェクトキャッシュによる、繰り返し発生するセットアップオーバーヘッドの排除により、起動時間が短縮されます。
  • 複雑なマトリックステストのためのシーケンシャルテーマレイヤリングをサポートする抽象的な PreviewThemeData API による、より柔軟なテスト。
  • Web ウィジェットのプレビュー時に自動的な Web アセット同期。ホストプロジェクトの web/ アセットを直接コピーし、カスタムテーマを適用したり、Flutter Web を使用する際に index.html ファイルをカスタマイズしたりします。
GenUI における継続的な進歩

Flutter のエコシステムは、開発者が GenUI を使用してユーザー向けに新しい種類のエージェンティックな体験を創造するニーズを満たすために進化し続けています。genui パッケージのバージョン 0.10.0 が最近リリースされ、多くの修正と新機能が追加されました。その中には以下が含まれます:

  • プロトコルに関連するクラス(式、カタログエントリなど)を集中化する新しい a2ui_core パッケージ。
  • A2UI のクライアントサイド関数サポート。これにより、検証、派生値、その他の小さなタスクのために、エージェントにクライアントに指示できる関数を提供できます。これは、ラウンドトリップなしで実行されます。

プラットフォームエクスペリエンスの洗練

このセクションでは、すべてのプラットフォームで開発者とユーザーのエクスペリエンスを向上させるために、コミュニティと Flutter チームによって貢献されたターゲットを絞った改善点を強調します。

Android

Android では、修正キー(Shift など)がイベント中にスタックする仮想キーボードの問題を解決しました。キーレスポンダーは、仮想キーボード入力に対して物理キー合成をスキップするようになり、キーボード操作がクリーンに保たれます。

Android 依存関係マトリックス

安定したビルドを保証するため、Flutter 3.47 は以下の Android 依存関係バージョンに対して検証されています:

  • Java: 17 (最小必須バージョン)
  • Kotlin Gradle Plugin (KGP): 2.4.0
  • Android Gradle Plugin (AGP): 9.1.0 (KGP 2.4.0 と互換性のある最新版)
  • Gradle: 9.3.1 (AGP 9.1.0 の最小必須バージョン)

将来のリリースでアプリケーションが正常にビルドされることを保証するために、ビルドファイルで Flutter SDK が提供する標準 API レベル変数を使用することを推奨します。このリリースでは、これらは以下のデフォルト値で設定されています:

  • flutter.compileSdkVersion (API 36)
  • flutter.targetSdkVersion (API 36)
  • flutter.minSdkVersion (API 24)
iOS および macOS

iOS 開発者向けに、コード署名がより透明になりました。コミュニティメンバーの @alex-medinsh のおかげで、CLI は証明書を選択する際にチーム ID とチーム名の両方を表示します(#184665)。

さらに、コミュニティメンバーの @mozammal-hossain は、署名に失敗した場合にプロビジョニングプロファイルのエラーメッセージを明確にすることで、トラブルシューティングを改善しました(#184051)。

デスクトップ

デスクトッププラットフォームもターゲットを絞った洗練を受けました。Windows での韓国語テキスト入力時のキャレット位置の問題が解決されました(@CHOIgoung 氏、#186353 感謝)。また、Windows プラグインは FlutterEngine::PostPlatformThreadTask を使用して、プラットフォームスレッドから高負荷なタスクをオフロードできるようになりました。Linux では、@CodeDoctorDE がスタイラスの回転と圧力レポートを追加しました(#186831)。

グラフィックスとエンジン

エンジンでは、OpenGLES をターゲットとするフラグメントシェーダーは、テクスチャを読み取る際に条件付きの座標反転を必要としなくなりました。これは現在頂点シェーダーで処理されます。詳細については、OpenGLES レンダリングからテクスチャへの破壊的変更ページを参照してください。

フレームワークの洗練

最後に、フレームワーク自体がよりスムーズになり、主要コンポーネント全体にわたる改善が行われました:

アクセシビリティとセマンティクス: Android のハイコントラストおよびカラー反転設定が自動検出されるようになりました(@xxxOVALxxx 氏、MediaQueryData.highContrast および MediaQueryData.invertColors、#182263 感謝)。Text.rich 内のネストされたテキストスパンがセマンティクスツリー内のレイアウトシーケンスと一致するようになり、キーボードフォーカスブロックが BlockSemantics に追加されました。

[画像: Android アクセシビリティ設定]

Android アクセシビリティ設定

テキストと選択: モバイルでのテキスト選択ハンドルが、マイナーなスクロール中に安定するようになり、キーボードショートカットで開いている選択メニューを閉じることができるようになりました。Android では、選択ハンドルが画面上部に近い位置にある場合にコンテキストメニューを隠さなくなりました(@JhonaCodes 氏、#182663 感謝)。

BEFOREAFTER
[画像: メニューに重なる選択ハンドル][画像: 正しく配置された選択ハンドル]

空のスクロール可能なコンテナで選択が開始された際の SelectableRegion のクラッシュも修正し、フェードアウトした選択可能テキストの視覚的なハイライトアーティファクトを解決しました(@ikramhasan 氏、#183628 感謝)。

BEFOREAFTER
[画像: ハイライト前][画像: ハイライト後]

ジェスチャーとスクロール: プラットフォームビュー経由で埋め込まれたネイティブ iOS ビューのジェスチャー伝播が改善されました。EdgeDraggingAutoScroller はアクティブなスクロールビューの ScrollPhysics を尊重するようになり、ロックされたリストでの自動スクロールを防ぎます。

[画像: EdgeDraggingAutoScroller デモ]

EdgeDraggingAutoScroller デモ

コアウィジェットの強化: ImageIcon 内で useOriginalColors: true を使用して元の色を保持(#180491)、AnimatedCrossFade でクリッピング動作を指定(#184545)、ImageStreamListener で画像ストリームエラーを直接追跡できるようになりました。


アップグレードの準備

要素は揃い、基盤は整いました。あとはこれらのアップグレードをローカルマシンに適用するだけです:

flutter upgrade

SDK がバックグラウンドで更新されている間に、(楽しい方の)宿題があります:

  • コントリビューターを紹介:ポップコーンを用意して、このリリースを可能にしたコミュニティメンバーを称える新しいビデオシリーズ「Introducing: Flutter Notable Commits」をご覧ください。
  • 詳細を確認:破壊的変更ページを簡単に確認して、スタンドアロン UI パッケージの移行に備えましょう。

この新しく改善されたバージョンの Flutter で皆さんが何を構築するかを見るのを楽しみにしています!