Xcode 26 に上げたとき、私は Info.plist に UIDesignRequiresCompatibility を書き足して、見た目の変更を先送りしました。手元の壁紙アプリは全画面の画像ビューアと独自の下部バーで組んでいて、Liquid Glass をそのまま浴びると何が起きるのか読めなかったからです。
そのフラグを、iOS 27 の正式版が出る前に自分で false に戻しました。外される日を待つより、外す日を自分で決めたほうが痛みが小さいと考えたからです。崩れた箇所は 3 つで、どれも「そのうち直す」で済ませられるものではありませんでした。
いまは iOS 27 も Xcode 27 も出そろい、状況はひとつ先へ進んでいます。この記事は、まだ Xcode 26 でビルドして出している方が、Xcode 27 に上げる前に何をどの順で確かめればよいかを、私が実際に踏んだ順番のまま書き残したものです。
いま、どこまで来ているのか(2026年11月時点)
最初にお伝えしたいのは、フラグの「猶予」はもう Xcode 26 の中にしか残っていない、ということです。Apple は WWDC25 の段階で、この互換オプションを「一時的な措置で、次のメジャーリリースで削除する」と予告していました。
| 時期 | 内容 | 確度 |
|---|---|---|
| 2026年4月28日 | App Store への提出は iOS 26 SDK(Xcode 26)ビルドが必須に | Apple 公式の告知 |
| 2026年9月14日 | iOS 27 の正式配信。Xcode 27 ビルドの提出受付はその直前から開始 | Apple の発表・各報道 |
| Xcode 27 でビルドしたとき | UIDesignRequiresCompatibility は効かず、標準コントロールは Liquid Glass で描かれる | WWDC25 の予告どおり・開発者の報告で確認 |
| Xcode 27 でビルドしたとき | UIScene ライフサイクルを採用していないアプリは起動しない | TN3187(Apple のテクニカルノート) |
| 2027年4月 | App Store への提出に iOS 27 SDK ビルドが必須になる | Apple の告知として報道あり・正確な日付は公式の Upcoming Requirements で確認を |
つまり、Xcode 26 で出し続けられる期間は、長くても来年の春までです。その間に Xcode 27 へ上げた瞬間、見た目の変更と起動条件の変更が同じ日に降ってきます。片方ずつ片づけておくのが、この期間のいちばん安全な使い方なのだと思います。
フラグを false にして、Xcode 26 のまま予行演習する
外し方は Info.plist の 1 行を消すか、値を false にするだけです。Info.plist をファイルとして持たないプロジェクトでは、ターゲットの Info タブ(Custom iOS Target Properties)に同じキーが入っていないかを見てください。
<!-- Before: 見た目を iOS 18 世代のまま据え置いていた -->
<key>UIDesignRequiresCompatibility</key>
<true/>
<!-- After: Xcode 26 のまま、Xcode 27 で強制される見た目を先に再現する -->
<key>UIDesignRequiresCompatibility</key>
<false/>これで Xcode 26 のままビルドすれば、標準のバーやボタンは新しいデザインで描かれます。SDK を上げずに、来春の見た目だけを先に借りる——このフラグのいちばんの使い道はここにあります。キーを消すのではなく false にしておくと、差分を見返したときに「意図して戻した」ことが残るので、私はこちらを選びました。
ビルドしたら、修正に入る前に主要な画面のスクリーンショットを撮っておきます。崩れた状態の記録は、あとで「どこまで直したか」を判断する物差しになります。
最初に崩れたのは、全画面ビューアの下端でした
壁紙アプリは画像を全画面で表示し、下端に保存・共有・お気に入りのボタンを並べています。この配置を、長いあいだタブバーの高さを前提にした固定値で組んでいました。
// Before: バーの高さを決め打ちして下端から持ち上げていた
struct ViewerScreen: View {
let item: Wallpaper
var body: some View {
VStack(spacing: 0) {
WallpaperCanvas(item: item)
ActionBar(item: item)
.padding(.bottom, 49) // タブバーの高さぶん
}
.ignoresSafeArea()
}
}Liquid Glass のタブバーはコンテンツの上に浮く形になり、スクロールに応じて縮みます。セーフエリアの値そのものが状況で変わるので、49 という固定値は正しくなくなります。実機では、ボタン列がタブバーに半分潜り込みました。
// After: 下端の余白はシステムに教えてもらう
struct ViewerScreen: View {
let item: Wallpaper
var body: some View {
WallpaperCanvas(item: item)
.ignoresSafeArea() // 画像だけは端まで敷く
.safeAreaInset(edge: .bottom) {
ActionBar(item: item) // 高さの決め打ちをやめる
}
}
}ignoresSafeArea() を画像にだけ付け、ボタン列は safeAreaInset に預けるのが要点です。以前は VStack 全体にセーフエリア無視をかけていたため、システムに位置を任せる余地がありませんでした。固定値を消しただけの小さな差分ですが、バーの高さを定数で持っている箇所は、次に何かが浮いたり縮んだりしたときに必ずもう一度壊れます。
カスタム背景色は「効かなくなる」のではなく「濁ります」
もうひとつの崩れは、ナビゲーションバーの背景色でした。ブランドカラーに合わせて不透明の背景を指定していたところ、ガラスの質感と干渉して、くすんだ見た目になりました。
// Before: 不透明の背景を自前で指定していた
let appearance = UINavigationBarAppearance()
appearance.configureWithOpaqueBackground()
appearance.backgroundColor = .brandBackground
UINavigationBar.appearance().standardAppearance = appearance
UINavigationBar.appearance().scrollEdgeAppearance = appearance厄介なのは、エラーも警告も出ないことです。ビルドは通り、ただ質感だけが悪くなります。スクリーンショットを並べて比べるまで、私は気づけませんでした。
// After: バーの背景はシステムに任せ、色はコンテンツ側のアクセントへ
// UINavigationBarAppearance の上書きをやめる(上の 5 行を削除)
struct LibraryScreen: View {
var body: some View {
NavigationStack {
WallpaperGrid()
.navigationTitle("ライブラリ")
}
.tint(.brandAccent) // ブランドカラーはボタンや選択状態に残す
}
}ブランドの色を捨てたわけではありません。バーの背景から、ボタンや選択状態の色へ置き場所を移しただけです。加えて、システムが挿入するビューで既存のレイアウト計算がずれる報告もあるため、subviews[0] のようにビュー階層を数えて位置を決めている箇所があれば、同時に見ておく価値があります。
症状から原因を切り分ける
フラグを false にしたあと、私の手元と、同じ移行をした方々の報告で多かった症状を並べます。上から順に疑うと早く当たります。
| 症状 | 原因の候補 | 確かめ方 | 直し方 |
|---|---|---|---|
| ボタン列や入力欄がタブバーに潜る | バーの高さの決め打ち(44・49・83 など) | 下の棚卸しスクリプトの項目 1 | safeAreaInset(edge:) へ置き換え、余白はシステムに任せる |
| バーがくすむ・色が二重に見える | configureWithOpaqueBackground() と背景色の上書き | 項目 2 の Appearance 代入を一時的にコメントアウトして比較 | 背景の上書きをやめ、色は tint やコンテンツ側へ |
| 一部の画面だけ要素の位置がずれる | subviews の添字参照がシステム挿入のビューで狂う | 項目 3。View Hierarchy デバッガで階層を数える | 添字ではなく型・識別子・tag で引く |
| iPad や外部ディスプレイで寸法がおかしい | UIScreen.main を前提にした寸法計算 | 項目 4 | view.window?.windowScene?.screen や GeometryReader へ |
| Xcode 27 でビルドすると起動直後に何も表示されない | UIScene ライフサイクル未採用 | Info.plist に UIApplicationSceneManifest があるか(項目 6) | 後述の SceneDelegate 移行 |
エージェントに任せたのは修正ではなく、箇所の棚卸しでした
この点検で Antigravity に頼んだのは、直すことではなく、疑わしい箇所を全部並べることでした。最初は「Liquid Glass 対応をして」とまとめて頼んでしまい、意図的に固定値を置いていた箇所まで書き換えられて、差分を一行ずつ戻す羽目になりました。そこから分け方を変えました。
いまは、機械的に見つかるものは先にスクリプトで並べ、その一覧をエージェントに渡して「なぜ問題になりうるか」を一行ずつ添えてもらっています。macOS 標準の bash と grep で動くようにしてあります。
#!/usr/bin/env bash
# liquid_glass_audit.sh — 修正はせず、Liquid Glass / UIScene 移行で疑わしい行だけを並べる
# 使い方: bash liquid_glass_audit.sh <プロジェクトのルート>
set -u
ROOT="${1:-.}"
HITS=0
scan() {
local label="$1" pattern="$2" include="$3" out
out=$(grep -rnE --include="$include" "$pattern" "$ROOT" 2>/dev/null)
echo "## $label"
if [ -n "$out" ]; then echo "$out"; HITS=$((HITS + $(echo "$out" | wc -l))); else echo "(なし)"; fi
echo
}
scan "1. バーの高さの決め打ち(44/49/83/96)" '\.(padding|offset|frame)\(.*[^0-9](44|49|83|96)[^0-9]' '*.swift'
scan "2. バーの Appearance を自前で組んでいる箇所" 'UI(Navigation|Tab|Tool)BarAppearance\(' '*.swift'
scan "3. subviews の添字参照" 'subviews\[[0-9]+\]' '*.swift'
scan "4. UIScreen.main の参照" 'UIScreen\.main([^A-Za-z]|$)' '*.swift'
scan "5. AppDelegate 側のライフサイクル" 'func application(DidBecomeActive|WillResignActive|DidEnterBackground|WillEnterForeground)|open url: URL' '*.swift'
scan "6. Info.plist の互換フラグと Scene 設定" 'UIDesignRequiresCompatibility|UIApplicationSceneManifest' '*.plist'
echo "候補: ${HITS} 行(修正はしていません)"
# 終了コード: 候補あり=1 / なし=0(CI で「増えていないか」を見る用途)
[ "$HITS" -eq 0 ]小さな検証用のフォルダで走らせると、次のように出ます(項目 2・3・5 は省略しています)。
## 1. バーの高さの決め打ち(44/49/83/96)
./App/Viewer.swift:1: .padding(.bottom, 49)
## 4. UIScreen.main の参照
./App/Viewer.swift:4:let scale = UIScreen.main.scale
## 6. Info.plist の互換フラグと Scene 設定
./App/Info.plist:1:<key>UIDesignRequiresCompatibility</key>
候補: 6 行(修正はしていません)UIScreen.mainScreenSize のような似た名前の自作プロパティは拾わないよう、正規表現の後ろを区切っています。項目 1 は padding(.horizontal, 44) のような無関係の 44 も拾うので、偽陽性が出る前提で読んでください。
エージェントへの依頼文は、出力の形と「直さない」ことだけを決めておけば足りました。
添付の liquid_glass_audit.sh の出力を読み、各行について
「Liquid Glass か UIScene 移行で問題になりうるか」を 高 / 中 / 低 で判定し、理由を 1 行で添えてください。
コードは変更しないでください。判定が「低」のものは、そう判断した根拠も書いてください。出てきた一覧のうち、実際に手を入れたのは半分ほどです。残りは「読んで問題ないと確認した」記録として残しました。移行でいちばん時間を食うのは、直す作業よりも「ここは大丈夫だ」と確信する作業なのだと思います。洗い出しはエージェントに、直すかどうかの判断は自分の手元に——この線引きにしてから、戻す差分が出なくなりました。
Liquid Glass より先に、UIScene ライフサイクルを見てください
見た目の話を先に書きましたが、優先順位はこちらが上です。TN3187 は、iOS 26 の次のメジャーリリースの SDK でビルドしたとき、UIScene ライフサイクルを採用していないアプリは起動しないと述べています。見た目が崩れるのと、起動しないのとでは、被害の桁が違います。
SwiftUI の @main struct ...: App で始まるアプリは、すでにシーンベースで動いています。対象になるのは、AppDelegate が window を自前で持っている UIKit のアプリです。私の古いほうのアプリがまさにそれで、application(_:didFinishLaunchingWithOptions:) の中で UIWindow(frame: UIScreen.main.bounds) を作っていました。
まず Info.plist に Scene の設定を足します。単一ウィンドウのまま移行するなら、UIApplicationSupportsMultipleScenes は false で構いません。
<key>UIApplicationSceneManifest</key>
<dict>
<key>UIApplicationSupportsMultipleScenes</key>
<false/>
<key>UISceneConfigurations</key>
<dict>
<key>UIWindowSceneSessionRoleApplication</key>
<array>
<dict>
<key>UISceneConfigurationName</key>
<string>Default Configuration</string>
<key>UISceneDelegateClassName</key>
<string>$(PRODUCT_MODULE_NAME).SceneDelegate</string>
</dict>
</array>
</dict>
</dict>次に SceneDelegate を作り、AppDelegate にあった画面の立ち上げと、URL・ライフサイクルの処理をこちらへ移します。
import UIKit
final class SceneDelegate: UIResponder, UIWindowSceneDelegate {
var window: UIWindow?
func scene(_ scene: UIScene,
willConnectTo session: UISceneSession,
options connectionOptions: UIScene.ConnectionOptions) {
guard let windowScene = scene as? UIWindowScene else { return }
let window = UIWindow(windowScene: windowScene) // UIScreen.main を使わない
window.rootViewController = RootViewController()
window.makeKeyAndVisible()
self.window = window
// 冷えた状態からの起動で渡された URL は、ここでしか受け取れない
if let url = connectionOptions.urlContexts.first?.url {
DeepLinkRouter.shared.open(url)
}
}
func scene(_ scene: UIScene, openURLContexts URLContexts: Set<UIOpenURLContext>) {
if let url = URLContexts.first?.url {
DeepLinkRouter.shared.open(url) // 起動中に開かれた URL
}
}
func sceneDidBecomeActive(_ scene: UIScene) {
AdSession.shared.resume()
}
func sceneDidEnterBackground(_ scene: UIScene) {
LibraryStore.shared.save()
}
}AppDelegate 側は、プッシュ通知の登録や SDK の初期化のように「アプリ全体で一度」の処理だけを残します。
| AppDelegate に書いていたもの | 移行先 |
|---|---|
window の生成と rootViewController の設定 | scene(_:willConnectTo:options:) |
applicationDidBecomeActive(_:) | sceneDidBecomeActive(_:) |
applicationDidEnterBackground(_:) | sceneDidEnterBackground(_:) |
application(_:open:options:) | scene(_:openURLContexts:) と、起動時は connectionOptions.urlContexts |
| プッシュ通知の登録・SDK の初期化 | AppDelegate に残す |
私がいちばん長く手を止めたのは、表の 4 行目でした。openURLContexts だけを実装して、アプリが終了している状態から URL で開かれたときに何も起きないことに、しばらく気づけませんでした。冷えた起動の URL は connectionOptions に入ってくるので、上のコードのように両方で受けてください。
移行の進め方を比べる
同じゴールでも、どこから手を付けるかで手戻りの量が変わります。私が検討した三つの進め方を並べます。
| 進め方 | 向いている場合 | 弱いところ |
|---|---|---|
| A. Xcode 26 のままフラグを false にし、見た目だけ先に直す | リリースの頻度が高く、SDK を上げる日を先に決められない | UIScene の問題は見えないまま残る |
| B. Xcode 26 のまま UIScene 移行を先に済ませ、そのあと A | UIKit の AppDelegate が window を持っている古いアプリ | 見た目の確認が後ろにずれる |
| C. いきなり Xcode 27 に上げて、両方を一度に直す | SwiftUI の App ライフサイクルで、カスタムバーが少ない新しいアプリ | 崩れの原因が見た目か起動かを切り分けにくい |
判断の基準は一つで、AppDelegate が window を作っているなら B、作っていないなら A、どちらにも当たらない小さなアプリなら Cです。私の古いアプリは B、新しいほうは A で進めました。
よくある誤解
「フラグを YES のまま Xcode 27 でビルドすれば、まだ据え置ける」——据え置けません。Xcode 27 でビルドした時点でフラグは効かなくなります。Xcode 26 のビルドを提出できるあいだだけの猶予です。
「フラグを外せば、Xcode 27 への準備は終わる」——見た目の準備しか終わりません。UIScene の採用は別の要件で、こちらは起動そのものに関わります。
「SwiftUI のアプリなら何もしなくてよい」——ライフサイクルは問題になりにくいものの、UIViewRepresentable で包んだ UIKit の画面や、UIApplicationDelegateAdaptor で残している AppDelegate の処理は棚卸しの対象です。見た目の崩れは SwiftUI でも起こります。
2027年4月までの順番
私が実際に進めた順番を、そのまま書きます。
- Xcode 26 のまま
UIDesignRequiresCompatibilityを false にしてビルド(ここで初めて現実が見えます) - 崩れた画面のスクリーンショットを、修正前の状態で保存
- 棚卸しスクリプトの実行と、エージェントによる判定の付与
- バーの高さの決め打ちを
safeAreaInsetへ置き換え - バーの背景の上書きを外し、ブランドカラーは
tintやコンテンツ側へ UIScreen.mainをwindowScene.screen経由に置き換え- UIScene ライフサイクルへ移行(単一ウィンドウのままで可)
- Xcode 27 に上げてビルドし、通知・URL・ウィジェットからの起動経路を一つずつ確認
1 から 5 までは、私の場合アプリ一本あたり半日ほどで終わりました。逆に言えば、期限の直前にまとめてやると、その半日が「リリースを止めている半日」になります。
次に詰まる一歩
Xcode 27 に上げて最初に当たるのは、たいてい起動経路です。通知から開いたとき、URL から開いたとき、ウィジェットから開いたときで、SceneDelegate のどこを通るかが違います。この順番の確かめ方はiOS 27 の RC から正式リリースまでの5日間 — 画面より先に、初期化の順番と権利の復元を確かめますにまとめました。
コードの外、たとえばエージェント向けのルールファイルや README に「iOS 26」と書いたままの箇所も、上げたあとで食い違いを生みます。その洗い出しはiOS 27 の配信日が決まってから、私が最初に grep したのは AGENTS.md でしたで扱っています。提出までを自動化している方は、iOS アプリのリリースパイプラインの記事のビルド設定も Xcode 27 に合わせて見直しておくと安心です。
今日できることは、Info.plist の 1 行を false にしてビルドすることだけです。それだけで、来年の春に困る箇所が今日わかります。この一手だけは、どれほど忙しい週でも先送りしないようにしています。
参考: Meet Liquid Glass(WWDC25 Session 219) / UIDesignRequiresCompatibility(Apple Developer Documentation) / TN3187: Migrating to the UIKit scene-based life cycle