Godot 4.7.1へ今移行すべきか。制作中プロジェクトの判断表とテスト項目

Godot 4.7.1が2026年7月14日に公開された。公式発表では、4.7安定版から42人の貢献者による78件の修正を取り込み、4.7に対する既知の非互換性は現時点でないとしている。すでに4.7で制作しているなら、バックアップと短い回帰テストを前提に4.7.1へ上げる判断が基本になる。

ただし、4.6から4.7.1へ移る場合は話が違う。78件は4.7から4.7.1までの修正数であり、4.6からの移行コストや、すべての不具合が解消したことを示す数字ではない。4.6→4.7には公式の破壊的変更一覧があるため、制作段階と必要機能から別の判断をする必要がある。

先に結論：現在の版と制作段階で決める

現在地	今の判断	先に確認すること
4.7で制作中	4.7.1へ上げる	作業コピーで起動し、主要シーン、保存データ、対象OSへの書き出しを確認する
4.6以前・企画／試作段階	4.7.1を候補にする	利用予定のアドオン、C#、GDExtension、書き出し先が4.7対応済みか調べる
4.6・制作中で4.7機能が必要	移行ブランチで試す	得られる効果と、破壊的変更への修正工数を同じ表で比較する
4.6・リリース直前	原則として現行版を維持	進行を止める不具合が4.7.1で直るなど、移行理由が明確な場合だけ検証する
C#／GDExtension／エディタープラグイン依存が大きい	通常より広く試す	公式移行ガイドのバイナリ互換・ソース互換と、各依存物の対応版を確認する

4.7の新機能は「使うもの」だけ移行理由にする

4.7にはHDR出力、DrawableTexture2D、新しいAsset Store、Android端末内での開発を広げるGABEなどがある。機能数の多さではなく、自分のプロジェクトで置き換わる作業と追加される試験を見れば、移行の価値を判断しやすい。

4.7の要素	移行理由になるケース	試験範囲
HDR出力	HDRディスプレイ向けの明部表現を製品要件に含める	Forward+／Mobileで、対応実機とSDR環境の両方を比較する。CompatibilityレンダラーとWebは対象外
DrawableTexture2D	実行中のテクスチャー描画をViewportやRenderingDevice中心の構成から整理したい	描画結果、更新頻度、メモリー、書き出しビルドでの挙動を既存実装と比較する
新しいAsset Store	アセット探索、評価表示、バックグラウンド処理（スレッド化）を含む新しい配布基盤を制作フローで使う	導入するアセットの4.7対応版、ライセンス、依存関係を個別に確認する
Android＋GABE	Android端末上でGradle書き出しやプラグイン利用まで完結させたい	必要なGABE companionを用意し、署名、対象ストア用ビルド、利用プラグイン、ソフトキーボードを実機で確認する

HDR出力はWindows、macOS、LinuxのWayland、iOS、visionOSが公式の対応範囲で、対応ディスプレイとOS設定も必要になる。WebやCompatibilityレンダラーを主対象にする作品では、HDRだけを理由に移行する意味はない。DrawableTexture2Dも、現状の描画経路に問題がなければ、リリース直前に置き換える理由にはしにくい。

Androidについては、GABEの安定版により、従来PCが必要だったプラグインや独自Gradle設定を含む書き出しを端末側で扱える範囲が広がった。一方、これは全プロジェクトのAndroid工程を自動的に無検証にするものではない。4.7.1にはAndroidエディターのEditorSettings未初期化エラーとソフトキーボードのBackspaceに関する修正も入ったが、自分が使う入力方式と配布設定は実機で確かめる。

4.7.1の78件は、試験を絞る手掛かりにする

4.7.1の修正には、Tree操作時のクラッシュ、タッチ操作によるシーンツリーのドラッグ＆ドロップ、GraphEditの表示、ネットワーク接続の二重破棄、ナビゲーション回避の一時停止復帰、非均一スケール時のライティングちらつき、平行投影カメラの影などが含まれる。該当機能を使うプロジェクトなら、その再現条件を回帰テストの先頭に置ける。

逆に、一覧に自分の症状が見当たらない場合、件数だけで直ったと推測しない。公式発表は「unexpected changes」があれば報告するよう求め、アップグレード時にもGitなどのバージョン管理やバックアップを勧めている。安定版の保守更新でも、プロジェクト固有の組み合わせまで保証するものではない。

移行ブランチで回すテストチェックリスト

1. 戻れる状態を作る。現行版でコミットまたはアーカイブを残し、メイン作業とは別の移行ブランチとプロジェクトコピーを用意する。
2. 差分の入口を特定する。4.6以前からなら、公式の4.7移行ガイドを使い、利用中のクラス、メソッド、列挙型、インポーター、拡張APIを検索する。
3. コードと拡張を確認する。GDScriptの警告とエラー、C#の再ビルド、GDExtension、エディタープラグイン、Asset Store由来アドオンを順に起動する。
4. 作品の中核を通す。起動、主要シーン遷移、入力、アニメーション、物理、ナビゲーション、通信、保存／読込を、普段のスモークテストと同じ条件で実行する。
5. 対象環境へ書き出す。Windows、macOS、Linux、Android、iOS、Webなど実際の出荷先で起動する。HDRはHDR／SDR、Androidは端末入力と署名済みビルドまで分けて見る。
6. 見た目と性能を比較する。基準場面のスクリーンショット、フレーム時間、メモリー、ロード時間を現行版と並べ、許容差を決める。
7. 採用条件を記録する。修正が必要な箇所、未対応の依存物、回避策、元の版へ戻す条件を残し、通過後にだけ制作ブランチへ反映する。

実際の移行直前には、最新の4.7系メンテナンスリリースと、利用するアドオン／GDExtensionの対応状況を改めて確認する。この記事の4.7.1という版番号だけを固定的な推奨として扱わない。

参照した情報源

一次情報、補助報道、コミュニティ観測を役割別に表示しています。

一次情報

Godot Engine — Maintenance release: Godot 4.7.1

4.7.1の公開日、42人の貢献者、4.7からの78件の修正、主な修正内容、4.7に対する既知の非互換性が現時点でないこと、アップグレード時のバックアップ推奨を確認。

一次情報

Godot Engine — Godot 4.7

Godot 4.7の公式リリースページ。HDR出力、DrawableTexture2D、新しいAsset Store、Android開発環境GABEの概要と、既存プロジェクトでは破壊的変更を移行ガイドで確認する注意を参照。

公式資料

Godot Engine Documentation — Upgrading from Godot 4.6 to Godot 4.7

4.6から4.7の破壊的変更をシステム別に確認。GDScript、C#のバイナリ／ソース互換性や、型変更、名称変更、引数追加、API削除があるため、4.7→4.7.1と分けて判断する根拠。

公式資料

Godot Engine — HDR output arrives in Godot 4.7

HDR出力の対応OS、グラフィックスドライバー、Forward+／Mobileレンダラー対応、Compatibility／Web非対応、対応ディスプレイとOS設定の条件を確認。

公式資料

Godot Engine — GABE stable release

Android端末上でのGradle書き出し、プラグインや独自設定の利用、Google PlayとMeta Horizon向け公開を含むGABE安定版の範囲を確認。

公式資料

Godot Engine Documentation — DrawableTexture2D

DrawableTexture2Dがソーステクスチャーから矩形へ直接描画し、シェーダーマテリアルや追加ターゲットを扱えるAPIであることを確認。