CI/CD

折りたたみiPhoneの発表前に、iOS 27 APIでまず何を変更する?(2026)

結論:折りたたみiPhoneを待たず、公開APIの依存順で移行する

適用条件に合う選択は、今すぐ iOS 27 API移行を始めることです。 先に UIScene ライフサイクル、次に UIScreen.main などの全体画面参照、その後に端末種別・向きの分岐、最後に動的なサイズ変更を直し、Xcode 27のDevice Hubで確認します。折りたたみiPhoneの名称、サイズ、内部状態を推測した実装は行いません。

この記事は、古い AppDelegate ライフサイクルや UIScreen.main を残すUIKit開発者、userInterfaceIdiom や interfaceOrientation でレイアウトを切り替えている開発者、秋のリリース計画で「今直す範囲」と「公式発表後に待つ範囲」を分けたい技術責任者向けです。

更新情報: 2026年8月20日更新。API要件と検証方法は WWDC26 Session 278の公式説明、Apple DeveloperのUIKit資料、Xcode 27リリースノートを確認しています。折りたたみ端末の仕様と秋の発表日は、Appleによる確定情報として扱っていません。

着手前に、確定要件と未確定情報を分ける

Appleが示しているのは、iOS 27でiPhoneアプリがiPhone MirroringやiPadの環境において、固定された端末画面ではなく、サイズを変えられるウインドウに対応する必要があるという点です。Sceneライフサイクルの採用、UIScreen.main や端末種別・向きをレイアウトの根拠にしない方針も、公開資料を基準に確認できます。

一方、折りたたみiPhoneの正式名称、画面寸法、価格、発売時期、foldState や angleDegrees といった内部コード由来とされるフィールドは、公開された開発APIとして確認されていません。したがって、発表前に必要なのは折りたたみ状態の分岐ではなく、どのウインドウ幅でも成立するアプリ構造です。

最初にリポジトリ全体を検索し、次の箇所を一覧化します。

検索対象 影響しやすい処理 最初に記録する内容
AppDelegate の起動・接続処理 ウインドウ生成、URL処理、状態復元 現在の責務と移行先
UIScreen.main 画面寸法、倍率、スクリーンショット 本当に必要な情報の種類
userInterfaceIdiom 2カラム、メニュー、文字量 端末判定を空間判定へ置換する候補
interfaceOrientation 縦横別の制約や配置 機能上の向きか、単なる幅判定か
固定幅・固定高の定数 キャッシュ、画像生成、ポップオーバー ウインドウ変更時の再計算要否

この棚卸しを先に行うと、画面だけを修正して画像キャッシュや共有ユーティリティを取り残す失敗を避けられます。

第一段階:UISceneを先に成立させる

UIScene は単なる起動方式の変更ではありません。現在のウインドウ、接続状態、シーンごとのURL、状態復元を扱う土台になるため、レイアウトの修正より前に移行します。Appleの UIWindowSceneに関する公式ドキュメント で、対象SDKにおける接続とウインドウの扱いを確認してください。

移行対象は、アプリ単位のコールバックをScene単位の責務へ分解することです。

  1. Scene設定で利用する構成を確認します。
  2. SceneDelegate でウインドウを生成し、ルートビューを設定します。
  3. URLオープン処理をScene接続時とアクティブ化時の流れへ移します。
  4. 状態復元の保存・復元箇所を、シーン単位の状態とアプリ共通状態に分けます。
  5. 最新SDKで初回起動、バックグラウンド復帰、接続解除後の再接続を確認します。
  6. 起動処理が安定してから、画面サイズを参照するコードを変更します。
旧実装の責務 移行後に置く判断場所 完了の証拠
アプリ起動時のウインドウ作成 Scene接続時 起動直後に正しいルート画面が表示される
URLやユーザーアクティビティの処理 Sceneの接続・アクティブ化処理 再開時にも入力を失わない
画面状態の保存 Scene状態と共通状態の分離 シーン再接続後に状態が復元される
アプリ全体の初期化 アプリ共通の初期化処理 シーン数に依存せず一度だけ実行される

UIKitとSwiftUIの境界を先に決める

UIKitとSwiftUIが混在する場合、UIKit側だけを空間判定に変えると、SwiftUI側のsizeThatFitsやレイアウト条件と食い違うことがあります。コンポーネント境界で「利用可能な幅」「高さ」「表示密度」を共通の入力値にし、端末名や向きを直接渡さない構成にします。

第二段階:UIScreen.mainを用途別APIへ分解する

iOS 27 API移行で、UIScreen.main を別のAPIへ一括置換する方法は適切ではありません。画面そのものの情報、表示倍率、現在のレイアウト領域は、それぞれ異なる文脈を持つためです。UIScreen の公開仕様は Apple DeveloperのUIScreen資料 で確認し、現在のSceneやViewに結び付く情報を優先します。

欲しい情報 推奨する取得元 置換時の確認
現在の表示環境 windowScene とその関連オブジェクト 対象ウインドウを取り違えていないか
表示倍率や特性 現在のtraitCollection 画像生成や文字表示の条件と一致するか
レイアウト可能な寸法 現在のViewまたはコンテナのbounds safe areaや親制約を反映しているか
座標変換 Sceneの座標空間 ウインドウ間・画面間の変換を混同していないか

画面サイズを使っている箇所では、まず用途を分類します。スクリーンショットやサムネイル生成なら対象Viewの大きさ、画像キャッシュのキーならサイズと倍率、外部ディスプレイ処理なら対象Sceneの情報というように、同じ数値を使い回さないことが重要です。

Appleの UIWindowSceneの座標空間に関する資料 も参照し、座標変換を画面全体の固定値で処理していないか確認します。

第三段階:端末判定を可用領域の判断へ置き換える

userInterfaceIdiom == .phone だから1カラム、.pad だから2カラムという設計は、可変ウインドウでは成立しません。狭いiPadウインドウと広いiPhone Mirroringウインドウは、端末種別が異なっていても同じレイアウト条件になる可能性があります。

interfaceOrientation も、カメラの向きやセンサー処理など本当に方向が必要な機能と、単に横幅を推測するための分岐に分けます。後者はsize class、コンテナのbounds、利用可能な空間を根拠に置き換えます。

let availableWidth = contentView.bounds.width

if availableWidth >= twoColumnMinimumWidth {
    showSplitLayout()
} else {
    showCompactLayout()
}

この例で重要なのは、折りたたみ端末の寸法を予測することではなく、レイアウトが必要とする条件をコードに残すことです。twoColumnMinimumWidth の値は画面種類から決めず、実際のコンテンツが重ならずに表示できる設計上の基準として管理します。

第四段階:連続したサイズ変更に耐える処理へ直す

ウインドウがドラッグ中に変化すると、制約、Collection Viewのレイアウト、描画キャッシュ、動画レンダリング、ポップオーバー位置が一時的に古い寸法を保持することがあります。traitの変化、Sceneの有効なジオメトリ変化、コンテナサイズの更新を入口にして、必要な処理だけを無効化します。

ただし、リサイズのたびに重い画像変換やネットワーク処理を実行してはいけません。表示範囲の計算と制約更新は即時に行い、キャッシュ再生成やデータ取得はサイズ確定後、または変更をまとめたタイミングに分けます。

次の順序で確認すると、画面の見た目だけでなく内部状態も追跡できます。

  • [ ] 狭いウインドウで文字、ボタン、画像が切れない
  • [ ] 広いウインドウで不要な余白や不自然な引き伸ばしがない
  • [ ] 正方形に近い比率で2カラムが衝突しない
  • [ ] ドラッグ中に制約警告が発生しない
  • [ ] サイズ変更後に古い画像キャッシュを表示しない
  • [ ] ポップオーバー、メニュー、キーボード回避領域が新しい座標に追従する
  • [ ] 動画や描画処理がサイズ変更のたびに初期化されない
  • [ ] SwiftUIとUIKitの表示条件が異なる状態にならない

FAQ:移行時に詰まりやすい4点

iOS 27でUIScreen.mainを使い続けると何が問題になりますか?

UIScreen.main を画面サイズや倍率の判断に使うと、現在のウインドウ、iPhone Mirroring、iPad、外部ディスプレイの文脈を取り違えるおそれがあります。画面情報、倍率、レイアウト可能領域を分離し、ViewやSceneから取得する設計へ変更します。

古いUIKitアプリをUISceneライフサイクルへ移行する順番は?

SceneDelegateでウインドウ生成と接続処理を成立させ、次にURL処理、状態復元、起動時の分岐を移します。最新SDKで起動と再接続を確認してからレイアウトを直すと、ライフサイクル不具合と表示不具合の切り分けが容易になります。

iPhone Mirroringでウインドウを変えるとレイアウトが崩れる場合の直し方は?

端末種別や向きではなく、現在のコンテナサイズ、size class、traitの変化で表示を再計算します。制約、Collection View、画像キャッシュ、ポップオーバーを、狭い状態、広い状態、正方形に近い状態、連続ドラッグで検証します。

Xcode 27のDevice Hubで可変ウインドウをどう確認しますか?

Device Hubで異なる比率のウインドウを作り、起動直後、ドラッグ中、サイズ確定後を記録します。Previewsは構成確認に使い、iPhone MirroringとiPadではカメラ、センサー、外部画面など、シミュレーションだけで代替できない機能を別に確認します。

公開前:テスト環境とロールバック範囲を固定する

Xcode 27のDevice HubとPreviewsでは、まず複数の幅・高さを持つ画面を並べ、レイアウト条件の抜けを見つけます。次に実機相当のiPhone MirroringとiPad環境で、ウインドウの変更、復帰、入力、外部機能を確認します。Device Hubの機能と制限は、Xcode 27の公式リリースノートに合わせて再確認します。

検証環境 主な目的 代替できない確認
Xcode 27 Device Hub 比率とサイズの組み合わせを広く確認 実機依存のセンサー挙動
SwiftUI Previews コンポーネント境界と条件分岐を確認 起動・復帰・外部接続
iPhone Mirroring 可変ウインドウ中の操作と表示を確認 端末固有の物理機能
iPad実行環境 広い・狭い空間での実際の遷移を確認 未提供の折りたたみ専用API

コミットは、UIScene 移行、画面参照の分離、レイアウト意味論の変更、動的更新の修正に分けます。各変更を独立して戻せる状態にしておけば、秋のSDK更新で問題が出た際に、全改修を取り消すのではなく原因の層だけを戻せます。

段階 今すぐ実施する範囲 公式発表後に追加する範囲
ライフサイクル Scene接続、URL、状態復元 追加シーン構成の確認
レイアウト 空間、コンテナ、traitに基づく判断 公式に公開された形状の検証
動的更新 連続サイズ変更とキャッシュ無効化 新しい画面比率の回帰試験
API利用 公開済みUIKit APIのみ 新SDKで正式公開されたAPIのみ

折りたたみiPhoneが正式発表された場合も、まず公式のサイズやSDK資料をテストケースへ追加します。foldState や angleDegrees のような未確認フィールドを先にコードへ埋め込む必要はありません。

Mac環境を分ける判断と、現行構成の限界

この移行では、安定版の既存プロジェクトとXcode 27の検証用プロジェクトを同じMac環境で混在させると、SDK選択、Derived Data、署名設定、実機接続の切り分けに時間がかかります。特に公開前の回帰確認を止められないチームでは、検証用のMac環境を分離するほうが管理しやすい場合があります。

選択肢 向いている条件 注意点
手元のMacを共有 小規模な検証で、既存工程を止められる SDK、キャッシュ、署名環境が混ざりやすい
Macを別途購入 長期の安定運用と物理接続が必要 初期費用、保守、保管、入れ替えを負担する
Macをレンタル beta検証や秋季リリース前だけ環境を分けたい 長期の固定負荷や物理機器要件には不向き

まずは KuzCloudのヘルプ で接続方式と利用条件を確認し、必要な期間が明確なら料金プランと照合します。長期にわたり同じMacで高負荷処理を続ける場合や、カメラ・センサー・特殊な物理インターフェースを直接扱う場合は、レンタルより専用の手元環境が適しています。

一方、現在の構成が「1台のMacで安定版とXcode 27を切り替える」方式なら、SDKの切り替え、キャッシュの分離不足、実機テストの占有、ロールバック時の復旧待ちが現実的な弱点になります。公開前の限られた期間だけ検証環境を増やすなら、KuzCloudのMacレンタルで作業環境を分け、既存の開発機を安定版の回帰用に残すほうが、変更の影響範囲を管理しやすい選択です。

コード側は、発表後に全面的に作り直すのではなく、公開要件に基づく移行を先に完了させます。公式サイズが出た時点では、新しい比率をテストに加え、必要な箇所だけを調整する計画にしておくと、未確認情報に依存した実装を避けられます。

新しい画面仕様への対応をKuzCloudで効率化しませんか

KuzCloudのリモートMac環境なら、可変ウインドウに対応したアプリの動作検証をすぐに始められます。

手元の端末に開発環境を追加することなく、ビルドや画面レイアウトの確認をリモートで進められます。