AI 플랫폼

접이식 iPhone 출시 전, iOS 27 API 먼저 무엇을 바꿀까? (2026)

WWDC26에서 해당 주제를 다룬 세션 번호는 278입니다. Apple Developer의 Session 278은 iPhone 앱이 iPhone Mirroring과 iPad 환경에서 조절 가능한 창 크기를 만날 수 있음을 전제로 설명합니다. 따라서 iOS 27 API 마이그레이션은 접이식 iPhone의 공식 발표를 기다리지 말고, UIScene부터 화면 참조와 공간 기반 레이아웃 순서로 즉시 시작해야 합니다. foldState나 angleDegrees 같은 내부 필드는 사용하지 않습니다.

이 글은 오래된 AppDelegate 생명주기나 UIScreen.main을 사용하는 UIKit 유지보수 담당자를 위한 내용입니다. userInterfaceIdiom, interfaceOrientation, 고정 너비와 높이로 화면을 나누는 개발자, 가을 배포 일정을 결정해야 하는 기술 책임자도 대상입니다. 접이식 기기의 이름과 크기는 아직 구현 기준으로 삼지 않습니다.

마지막 업데이트: 2026년 8월 20일. API 요구 사항과 테스트 방법은 Apple Developer의 Session 278, UIWindowScene 문서, UIScreen 문서, Xcode 27 릴리스 노트를 기준으로 확인했습니다. 접이식 기기와 가을 행사의 구체적인 날짜는 Apple의 공식 발표 전까지 확정 정보로 취급하지 않습니다.

착수 범위와 코드 기준선

먼저 저장소 전체에서 다음 항목을 검색합니다.

  • application:didFinishLaunchingWithOptions:
  • window
  • UIScreen.main
  • userInterfaceIdiom
  • interfaceOrientation
  • 고정된 너비와 높이 상수
  • 화면 비율을 키로 사용하는 이미지와 미디어 캐시
  • 스크린샷, 썸네일, 외부 화면 처리 코드

검색 결과만 저장하지 말고 영향을 받는 화면과 공통 유틸리티를 함께 기록해야 합니다. 화면이 정상적으로 보이더라도 캐시 키가 예전 화면 크기를 유지하거나 외부 화면에서 첫 번째 화면 객체를 참조하면 별도의 오류가 생길 수 있습니다.

현재 공개된 요구 사항과 아직 공개되지 않은 추측도 분리합니다. iOS 27의 조절 가능한 창 대응과 Scene 중심 구조는 구현 대상으로 볼 수 있습니다. 반면 접이식 iPhone의 공식 이름, 화면 크기, 가격, 출시일, 내부 접힘 상태 필드는 Apple이 공개한 개발 인터페이스가 아닙니다. 관련 기사를 읽었더라도 코드에는 반영하지 않습니다.

첫 번째 이행: UIScene 생명주기

레이아웃보다 먼저 생명주기를 옮겨야 합니다. 창의 소유 관계와 현재 장면을 알 수 없는 상태에서는 이후의 기하 정보와 공간 판단도 신뢰하기 어렵기 때문입니다.

기존 앱의 다음 책임을 분리합니다.

  • 앱 전체 초기화와 공통 서비스 준비
  • 창 생성과 장면 연결
  • URL 열기와 사용자 활동 처리
  • 장면별 상태 복원
  • 백그라운드 전환과 다시 활성화될 때의 장면 처리

창과 장면에 직접 연결된 코드는 SceneDelegate로 옮깁니다. 앱 전체에서 한 번만 실행되어야 하는 분석 초기화나 저장소 준비는 AppDelegate 또는 별도 서비스에 남깁니다. 여러 장면이 만들어져도 전역 객체가 장면별 창을 덮어쓰지 않는지 확인해야 합니다.

최소 변경 후에는 최신 SDK로 다음 순서를 실행합니다.

  1. 새 설치 상태에서 최초 실행합니다.
  2. 장면을 백그라운드로 보냈다가 다시 활성화합니다.
  3. URL과 사용자 활동으로 앱을 엽니다.
  4. 상태를 저장한 뒤 종료하고 복원합니다.
  5. 장면별 창이 서로의 루트 뷰와 상태를 공유하지 않는지 확인합니다.

이 단계가 끝나지 않았다면 UIScreen.main 제거와 레이아웃 변경을 한 커밋에 섞지 않는 편이 안전합니다. 생명주기 전환을 먼저 병합하고, 실행과 복원 로그를 남긴 뒤 다음 단계로 넘어갑니다.

두 번째 이행: 전역 화면 참조

UIScreen.main은 모든 호출부에서 같은 대체 API로 바꾸는 대상이 아닙니다. 호출 목적을 세 갈래로 나누어야 합니다.

  • 현재 표시 장치의 정보가 필요하면 현재 UIWindowScene에서 컨텍스트를 얻습니다.
  • 배율이나 환경 특성이 필요하면 현재 뷰의 traitCollection을 사용합니다.
  • 실제로 배치할 공간이 필요하면 현재 뷰 또는 컨테이너의 bounds를 우선합니다.

Apple의 UIWindowScene 기하 정보 문서는 장면의 좌표 공간을 별도로 다룹니다. 이 구분은 창이 기기 전체 화면보다 작을 수 있는 환경에서 특히 중요합니다.

다음과 같은 단순 치환은 피합니다.

// 화면 전체를 레이아웃 기준으로 사용하던 코드
let width = UIScreen.main.bounds.width

// 해당 화면을 소유한 컨테이너의 실제 공간을 사용
let width = containerView.bounds.width

두 코드가 같은 결과를 내는 고정 화면에서는 차이가 작아 보입니다. 그러나 iPhone Mirroring에서 창을 줄이거나 iPad에서 분할된 장면을 실행하면 첫 번째 값은 현재 콘텐츠 영역을 설명하지 못할 수 있습니다.

레이아웃 외부도 함께 조사합니다. 이미지 축소 크기, 동영상 출력 크기, 썸네일 생성, 캐시 키, PDF와 스크린샷 저장 크기, 외부 모니터 분기에서 전역 화면 참조가 남아 있지 않아야 합니다. UIScreen의 역할을 확인할 때는 공식 UIScreen 문서와 현재 장면의 문서를 함께 비교합니다.

세 번째 이행: 기기 분기에서 공간 판단으로

userInterfaceIdiom == .phone은 더 이상 “항상 좁은 화면”이라는 뜻으로 사용할 수 없습니다. 반대로 .pad라고 해서 모든 화면에서 두 열을 유지할 수 있는 것도 아닙니다. 두 열, 메뉴 노출, 콘텐츠 밀도, 보조 패널 표시 여부를 현재 사용 가능한 공간으로 결정합니다.

interfaceOrientation도 같은 방식으로 분류합니다. 카메라 미리보기, 센서, 동영상 방향처럼 실제 방향 정보가 필요한 기능은 방향 값을 유지할 수 있습니다. 단순히 가로 폭이 넓다는 이유로 레이아웃을 바꾸는 코드는 컨테이너 크기와 크기 특성으로 옮깁니다.

UIKit과 SwiftUI를 함께 사용하는 앱은 경계에서 공간의 의미를 통일해야 합니다.

  • UIKit 컨테이너가 전달하는 크기를 SwiftUI의 제안 크기와 혼동하지 않습니다.
  • SwiftUI에서 기기 종류를 보고 정한 분기와 UIKit 제약 조건의 분기가 충돌하지 않는지 확인합니다.
  • 두 열을 표시할 수 있는 최소 공간을 하나의 정책으로 정의합니다.
  • 정책 결과만 하위 컴포넌트에 전달하고, 각 컴포넌트가 다시 기기 종류를 추측하지 않게 합니다.

이렇게 해야 iPhone Mirroring의 창 크기를 바꿨을 때 상위 화면은 넓은 레이아웃을 선택했지만 하위 메뉴는 좁은 레이아웃을 유지하는 식의 불일치를 줄일 수 있습니다.

네 번째 이행: 연속 크기 변화 처리

창 크기 변경은 한 번의 회전 이벤트가 아닙니다. 드래그 중에는 레이아웃이 여러 번 다시 계산될 수 있으므로, 변경 처리와 비싼 작업을 분리해야 합니다.

다음 항목을 각각 확인합니다.

  • 오토 레이아웃 제약 조건이 새 컨테이너 크기를 반영하는지
  • 컬렉션 뷰의 열 수와 셀 크기가 다시 계산되는지
  • 그려 둔 이미지와 그래픽 캐시가 이전 크기를 계속 사용하지 않는지
  • 동영상과 금속 기반 렌더링 영역이 새 bounds를 반영하는지
  • 팝업, 메뉴, 시트가 화면 가장자리 밖에 남지 않는지
  • 크기 변경 때마다 네트워크 요청이나 전체 데이터 재계산을 실행하지 않는지

필요한 화면은 trait 변화와 장면의 유효한 기하 변화에 등록합니다. 다만 드래그의 모든 순간에 큰 이미지 재생성이나 전체 목록 정렬을 실행하면 입력 반응이 나빠질 수 있습니다. 즉시 필요한 제약 조건 갱신과, 크기 변화가 멈춘 뒤 처리해도 되는 캐시 재생성을 분리합니다.

최소 검증 상태는 좁은 창, 넓은 창, 정사각형에 가까운 창, 좁은 상태에서 넓은 상태로 이어지는 연속 드래그입니다. 각 상태에서 콘텐츠 잘림, 겹침, 사라진 버튼, 이전 캐시 잔존, 팝업 위치 오류를 기록합니다.

FAQ: 단계별 이행에서 자주 막히는 지점

iOS 27에서 UIScreen.main을 계속 사용하면 안 되는 이유는 무엇인가요?

창 크기가 기기 전체 화면과 일치하지 않는 실행 환경이 늘었기 때문입니다. 현재 창의 표시 정보는 windowScene에서, 배율은 traitCollection에서, 실제 배치 크기는 뷰나 컨테이너의 bounds에서 읽어야 합니다. UIScreen.main을 일괄 치환하면 이미지 캐시나 외부 화면 처리까지 잘못될 수 있으므로 호출 목적별로 나누어 수정해야 합니다.

오래된 UIKit 앱은 UIScene으로 어떻게 옮겨야 하나요?

먼저 기존 AppDelegate에 남은 창 생성, URL 처리, 상태 복원, 연결 처리를 목록화합니다. 그다음 창과 장면 연결에 관한 책임을 SceneDelegate로 옮기고, 앱 수준 상태와 장면 수준 상태를 분리합니다. 최신 SDK로 새로 실행한 뒤 최초 연결, 백그라운드 복귀, 여러 장면 생성과 상태 복원을 각각 확인해야 합니다.

iPhone Mirroring에서 창 크기를 바꾸면 레이아웃이 무너지는 문제는 어떻게 고치나요?

전화기인지 태블릿인지로 두 열 레이아웃을 결정하지 말고 현재 컨테이너의 가로와 세로 공간을 기준으로 판단해야 합니다. 제약 조건, 컬렉션 레이아웃, 팝업 위치, 미디어 렌더링 크기를 창 변화 때 다시 계산하도록 구성합니다. 좁은 창, 넓은 창, 정사각형에 가까운 창, 연속 드래그를 모두 확인해야 합니다.

Xcode 27 Device Hub에서 크기 조절 창을 시험하는 순서는 어떻게 되나요?

먼저 Device Hub에서 창을 좁은 상태와 넓은 상태로 각각 배치하고, 정사각형에 가까운 비율도 추가합니다. 이후 창을 천천히 드래그하면서 겹침과 잘림, 이전 크기의 캐시가 남는지 확인합니다. Previews는 빠른 레이아웃 점검에 사용하고, iPhone Mirroring과 iPad 동작 및 카메라 같은 하드웨어 의존 기능은 실제 장치에서 별도로 검증해야 합니다.

배포 전 검증과 되돌리기

Xcode 27의 Device Hub에서는 여러 창 비율을 빠르게 재현할 수 있습니다. Xcode 27 릴리스 노트를 확인한 뒤 좁은 창과 넓은 창을 만들고, Previews에서 컴포넌트 단위 레이아웃을 먼저 점검합니다.

그다음 실제 장치에서 iPhone Mirroring과 iPad 실행 결과를 확인합니다. 시뮬레이터나 Device Hub만으로 카메라, 센서, 외부 화면, 성능 특성을 대신 검증할 수는 없습니다. 테스트 환경이 분리되어야 한다면 KuzCloud 콘솔에서 안정 버전과 Xcode 27 작업 환경을 나누어 운영하는 방안도 검토할 수 있습니다.

커밋은 다음 세 묶음으로 나누는 편이 좋습니다.

  • UIScene 생명주기 전환
  • 화면 참조와 공간 기반 레이아웃 변경
  • 동적 크기 변화와 캐시 무효화 처리

각 커밋이 독립적으로 빌드되고 되돌아가는지 확인합니다. 접이식 iPhone이 공식 발표된 뒤에는 공식 장치 형태와 SDK가 제공하는 테스트 항목만 추가하면 됩니다. 이미 공간 중심으로 구현했다면 핵심 레이아웃을 다시 뒤집을 필요가 없습니다.

배포 전 확인 목록

  • [ ] AppDelegate와 SceneDelegate의 책임이 분리되어 있습니다.
  • [ ] 창 생성과 상태 복원이 장면 단위로 동작합니다.
  • [ ] UIScreen.main 호출을 목적별로 분류하고 필요한 곳을 교체했습니다.
  • [ ] 이미지, 썸네일, 캐시 키, 외부 화면 코드까지 검색했습니다.
  • [ ] userInterfaceIdiom이 레이아웃 선택의 유일한 기준으로 남아 있지 않습니다.
  • [ ] 방향 정보가 필요한 기능과 공간 판단용 코드를 분리했습니다.
  • [ ] UIKit과 SwiftUI가 같은 공간 정책을 사용합니다.
  • [ ] 좁은 창, 넓은 창, 정사각형에 가까운 창을 확인했습니다.
  • [ ] 연속 드래그 중 캐시와 팝업 위치가 갱신됩니다.
  • [ ] Device Hub와 Previews 검증 뒤 실제 장치 검증을 완료했습니다.
  • [ ] 생명주기, 레이아웃, 동적 갱신 변경을 별도 커밋으로 되돌릴 수 있습니다.

현재 Mac 한 대에서 안정 버전과 Xcode 27을 번갈아 설치하는 방식은 SDK 충돌, 프로젝트 전환 시간, 테스트 상태 공유라는 단점이 있습니다. 특히 같은 장비에서 배포 후보와 실험 브랜치를 동시에 검증하면 잘못된 SDK로 빌드하거나 이전 캐시를 새 결과로 오인하기 쉽습니다. 이 작업이 짧은 마이그레이션 기간에 집중된다면, KuzCloud의 클라우드 맥 운영 안내를 확인해 격리된 테스트 환경을 먼저 마련하는 편이 합리적입니다. 장기적으로 고정된 고부하 빌드가 필요하거나 물리 카메라와 센서 연결이 핵심인 팀에는 자체 Mac이 더 적합하지만, 임시 iOS 27 API 마이그레이션과 Device Hub 검증에는 필요한 기간만 Mac 환경을 확보하는 방식이 더 유연할 수 있습니다.

접이식 화면 대응을 위한 개발 환경을 지금 준비하십시오

KuzCloud의 전용 원격 맥에서 다양한 화면 크기와 창 배치를 바꾸며 앱의 적응형 화면 구성을 점검할 수 있습니다.

브라우저 기반 원격 데스크톱과 터미널 접속을 지원하므로 화면 전환과 크기 변화에 따른 동작을 빠르게 확인할 수 있습니다.