◉ANTIGRAVITY LABEN
記事一覧/アプリ開発
▣ アプリ開発/2026-08-19中級

Liquid Glass の猶予フラグ UIDesignRequiresCompatibility を、Xcode 27 に外される前に自分で外す

Xcode 27 でビルドすると Info.plist の UIDesignRequiresCompatibility は効きません。Xcode 26 のままフラグを false にして崩れを先に洗い出す手順、症状別の切り分け表、UIScene 移行の完全なコード、2027年4月の SDK 期限までの順番をまとめました。

iOS 274Liquid GlassXcode 27SwiftUI10個人開発127

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 など)下の棚卸しスクリプトの項目 1safeAreaInset(edge:) へ置き換え、余白はシステムに任せる
バーがくすむ・色が二重に見えるconfigureWithOpaqueBackground() と背景色の上書き項目 2 の Appearance 代入を一時的にコメントアウトして比較背景の上書きをやめ、色は tint やコンテンツ側へ
一部の画面だけ要素の位置がずれるsubviews の添字参照がシステム挿入のビューで狂う項目 3。View Hierarchy デバッガで階層を数える添字ではなく型・識別子・tag で引く
iPad や外部ディスプレイで寸法がおかしいUIScreen.main を前提にした寸法計算項目 4view.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 移行を先に済ませ、そのあと AUIKit の 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月までの順番

私が実際に進めた順番を、そのまま書きます。

  1. Xcode 26 のまま UIDesignRequiresCompatibility を false にしてビルド(ここで初めて現実が見えます)
  2. 崩れた画面のスクリーンショットを、修正前の状態で保存
  3. 棚卸しスクリプトの実行と、エージェントによる判定の付与
  4. バーの高さの決め打ちを safeAreaInset へ置き換え
  5. バーの背景の上書きを外し、ブランドカラーは tint やコンテンツ側へ
  6. UIScreen.main を windowScene.screen 経由に置き換え
  7. UIScene ライフサイクルへ移行(単一ウィンドウのままで可)
  8. 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

シェア

お読みいただきありがとうございます

Antigravity Lab は広告なしで運営しており、サーバー費用などの運営コストはメンバーシップのご支援で賄っています。実装コード・ベンチマーク・本番設計パターンなど、実務でお役立ていただける記事を毎日更新しています。もし読んでよかったと感じていただけましたら、ぜひご覧ください。

  • ✦コピー&ペーストで使える実装コード付き
  • ✦毎日新しい上級ガイドを追加
  • ✦¥580/月 または ¥1,480 の永久アクセス
メンバーシップを見る →

もしこの記事がお役に立ちましたら、チップ(¥150)で応援いただけると大変励みになります。広告なしでの運営を続けるため、皆さまのご支援が大きな力になっています。

関連記事

▣ アプリ開発2026-04-03
Antigravity × SwiftUI Live Activities & Dynamic Island:iOS 26 対応実装ガイド
AntigravityのAI支援で SwiftUI Live Activities と Dynamic Island を実装する実践ガイド。ActivityKit の設計、ロックスクリーンと Dynamic Island の UI、APNs バックグラウンド更新、配信ロスト・stale 表示・複数同時起動時の優先順位まで、個人開発でアプリを運用しながら拾った知見を書き残しました。
▣ アプリ開発2026-11-12
Web フォントの配信確認は Origin ヘッダ付きの curl でも行う:代替書体のまま 13 日間気づかなかった記録
自分のサイトで欧文フォントだけが 13 日間 404 のまま、代替書体で描かれていました。素の curl は 200 を返し、ブラウザが送る Origin 付きの要求だけが古い 404 を受け取っていたためです。3 通りの要求を並べる確認スクリプト、エラー応答に長期キャッシュを乗せない設定、変種まで届くパージの選び方を書き残します。
▣ アプリ開発2026-10-30
画像の拡大表示を Esc で閉じたら、背面のスクロールが戻らなくなりました。dialog 要素に載せ替えて数えたこと
作品の拡大表示を直したとき、Esc で閉じない・背面が動く・閉じるボタンが画像に重なる、の三つを順に潰しました。dialog 要素へ載せ替えても残った「Esc のあとスクロールが戻らない」不具合まで、確認スクリプトと数字で書き残します。