Xcode 27.2 RC SwiftUI 미리보기 안 보임? 2026 초보자 점검

공식 Xcode 27 릴리스 노트에는 미리보기 관련 수정 사항이 기록되어 있습니다. 그렇다고 Xcode 27.2 RC에서 보이는 빈 화면이 모든 사용자에게 발생하는 문제라고 단정할 수는 없습니다. 먼저 캔버스가 닫혔는지, 열렸지만 화면이 비었는지, 미리보기 빌드가 실패했는지 구분하세요. 그런 다음 파일과 미리보기 선언, 프로젝트 빌드 상태를 확인합니다. 당장 미리보기가 안 되더라도 프로젝트 빌드와 시뮬레이터로 과제를 점검할 수 있습니다. 화면이 비었다는 이유만으로 Xcode를 다시 설치하지는 마세요.

이 글이 필요한 경우

• Xcode 27.2 RC로 SwiftUI 수업 과제를 하다가 처음 미리보기 문제를 만난 학생입니다.
• 윈도우 컴퓨터에서 원격 맥으로 Xcode를 사용하며, 문제가 프로젝트에 있는지 환경에 있는지 가려야 합니다.
• 프로젝트는 빌드되는데 미리보기만 실패해 과제 확인 방법을 찾고 있습니다.

마지막 업데이트: 2026년 10월 24일. 확인 기준은 공식 Xcode 시스템 요구 사항, 미리보기 안내와 Xcode 27 릴리스 자료입니다. RC 상태와 요구 사항은 변경될 수 있으므로 현재 공식 페이지를 기준으로 다시 확인합니다.

Xcode의 코드 편집기는 소스 코드를 작성하는 곳입니다. 캔버스는 SwiftUI 화면의 미리보기를 보여주는 영역이고, 미리보기 결과는 현재 파일과 설정에 따라 그 영역에 나타납니다. 따라서 캔버스가 안 보이는 문제와 캔버스 안이 빈 문제는 같은 증상으로 처리하면 안 됩니다.

Xcode 27.2 RC에서 Xcode Canvas를 어디서 열어야 하는지 찾는다면, 먼저 편집기에서 캔버스 표시 상태를 확인합니다. 공식 캔버스 안내는 캔버스에서 미리보기를 보고 상호 작용하는 방법을 설명합니다. 메뉴 이름이나 위치가 화면과 다르면 기억에 의존하지 말고 현재 버전의 메뉴와 공식 안내를 대조합니다.

캔버스가 열린 것만으로 미리보기가 준비된 것은 아닙니다. 영역이 보이는데 화면이 비어 있다면 다음 단계로 넘어갑니다.

먼저 미리보기를 보려는 화면 파일을 선택했는지 확인합니다. 앱의 시작 파일이나 다른 화면을 선택한 채로 캔버스만 열면 기대한 화면이 나오지 않을 수 있습니다. 다음으로 선택한 파일에 미리보기 대상이 되는 SwiftUI 화면이 있는지 봅니다.

미리보기 선언은 Xcode에 “이 화면을 이런 조건으로 보여 달라”고 알려주는 부분입니다. 수업 자료에서 제공한 선언이 있다면 이름과 위치를 먼저 확인하세요. 예제를 그대로 붙여 넣기보다, 현재 프로젝트의 화면 구성과 맞는지 비교하는 편이 안전합니다. 화면 파일에 미리보기를 추가하는 공식 안내를 기준으로 선언이 있는 위치와 역할을 확인할 수 있습니다.

주의: 미리보기 예제 코드를 임의로 추가하거나 바꾸면 원래 오류 원인이 가려질 수 있습니다. 현재 파일과 수업 예제의 차이를 먼저 기록한 뒤 한 항목씩 확인합니다.

문제가 특정 수업 화면에서만 생기는지 알고 싶다면, 프로젝트의 기존 구조를 유지한 채 단순한 화면과 비교합니다. 단순한 화면은 나오고 수업 화면만 안 나온다면 코드나 화면에 연결된 자료를 더 살핍니다. 둘 다 나오지 않는다면 캔버스 상태와 프로젝트 설정도 확인 대상입니다. 이 비교는 원인을 좁히는 방법이지, 특정 코드가 모든 환경에서 해결책이라는 뜻은 아닙니다.

오류가 뜨면 문구를 복사하거나 화면을 기록하고, 어느 파일과 줄에서 처음 나타났는지 적습니다. 그 뒤 프로젝트 전체 빌드를 실행해 결과를 비교합니다. 여기서 빌드란 소스 코드와 필요한 설정을 묶어 앱을 실행할 수 있는 형태로 만드는 과정입니다.

• 프로젝트 빌드도 실패합니다. 오류가 가리키는 코드와 프로젝트 설정을 먼저 살핍니다. 오류가 처음 나타난 위치와 메시지를 기준으로 수정하고 다시 빌드합니다.
• 프로젝트는 빌드되지만 미리보기만 실패합니다. 코드 전체가 실행 불가능하다고 결론 내리지 마세요. 선택한 파일, 미리보기 선언, 현재 캔버스 상태를 따로 확인합니다.
• 특정 실행 대상이나 설정에서만 실패합니다. 프로젝트의 빌드 구성과 실행 대상을 대조합니다. 프로젝트 빌드 구성 안내를 참고해 현재 선택된 구성이 과제와 맞는지 살핍니다.

오류 문구는 원인을 찾는 단서이지, 메시지 하나만으로 미리보기 문제의 원인이 확정되는 것은 아닙니다. Xcode 27의 릴리스 노트에 미리보기 수정 기록이 있다는 점도 배경 정보로만 사용합니다. 해당 기록만으로 현재 RC에서 똑같은 문제가 발생한다거나, 특정 수정이 현재 증상을 해결한다고 볼 수는 없습니다.

코드를 고쳤는데 화면이 그대로라면 새 문제를 만들기 전에 상태를 확인합니다.

• 파일을 저장했는지 확인합니다.
• 캔버스가 열려 있고 미리보기가 시작된 상태인지 확인합니다.
• 간단한 화면으로 바꿔도 같은 현상인지 비교합니다.
• 오류가 다시 나타나면 새 오류 문구와 직전 변경 사항을 함께 기록합니다.
• 문제가 특정 화면에서만 재현되는지, 프로젝트의 다른 화면에서도 같은지 살핍니다.

이 순서로 확인하면 문제가 특정 화면 코드나 연결 자료에 가까운지, 캔버스나 프로젝트 전반에 가까운지 가늠할 수 있습니다. 간단한 화면에서도 실패한다면 그 결과와 버전 정보를 모아 환경 점검으로 넘어갑니다. 반대로 다른 화면은 정상이라면 Xcode 재설치보다 해당 화면의 변경 사항을 되짚는 편이 먼저입니다.

캐시 삭제, 시스템 설정 변경, 재설치를 기본 처방으로 삼지 마세요. 먼저 오류 기록과 재현 범위를 확보해야 합니다. 기록이 없으면 조치 전후를 비교하기 어렵고, 수업 프로젝트의 다른 상태까지 바뀔 수 있습니다.

네. 미리보기가 작동하지 않아도 프로젝트가 빌드된다면 시뮬레이터에서 앱을 실행해 과제를 확인할 수 있습니다. 다만 두 방법은 확인 범위가 다릅니다. 미리보기는 코드 편집 중 화면을 살펴보는 데 쓰이고, 시뮬레이터 실행은 빌드된 앱이 실행 대상에서 어떻게 동작하는지 확인하는 데 쓰입니다.

시뮬레이터 실행 방법과 대상 선택은 공식 실행 안내를 참고합니다. 수업 제출 기준이 화면 동작이나 실행 결과라면 이를 확인 자료로 활용할 수 있습니다. 반대로 제출 항목에 캔버스 화면이나 미리보기 작동 확인이 명시되어 있다면, 시뮬레이터 성공만으로 그 요구까지 충족했다고 보기는 어렵습니다.

윈도우 컴퓨터에서 원격 맥을 쓰는 경우에는 문제를 프로젝트와 접속 환경으로 나눕니다. 사용 중인 Xcode와 맥오에스 버전, 선택한 실행 대상, 문제가 나타난 단계, 오류 문구를 기록합니다. 그다음 공식 시스템 요구 사항에서 현재 버전과 운영체제 조합이 지원되는지 확인합니다.

집이나 학교의 다른 환경과 비교할 수 있다면 같은 프로젝트와 같은 절차를 사용합니다. 프로젝트 복사본이 달라지거나 실행 대상이 바뀌면 결과 비교가 어려워집니다. 공식 자료와 맞지 않는 환경이라면 지원되는 조건을 먼저 확인합니다. 반대로 조건이 맞고 프로젝트 빌드도 통과한다면, 캔버스와 해당 화면의 미리보기 선언을 중심으로 오류 기록을 정리합니다.

현재 장비에서 Xcode를 쓸 수 없다면 MESHLAUNCH의 원격 맥 이용 방법과 맥 미니 대여 가격 안내을 살펴보고 수업 요구 사항과 맞는지 비교할 수 있습니다. 학교 컴퓨터는 설치 권한이 제한될 수 있고, 윈도우만으로는 Xcode와 맥오에스 기반 확인을 그대로 할 수 없습니다. 맥을 직접 구매하면 초기 지출이 생기고, 가상 환경은 실제 맥에서의 확인을 대신하지 못할 수 있습니다. 이런 제약을 피하면서 과제 기간에만 맥 환경이 필요한 학생이라면 MESHLAUNCH의 원격 맥을 임시 개발 환경으로 검토할 수 있습니다. 다만 장기간 계속 사용하는 경우나 직접 연결할 물리 장비가 필요한 과제라면 대여가 맞지 않을 수 있으니, 먼저 수업의 제출 조건과 필요한 사용 기간을 확인하세요.