Xcode 27 다국어 인터페이스 미리보기는 어떻게 할까? 2026 현지화 검수

Xcode 27 릴리스 노트에는 서로 다른 현지화 환경에서 UI를 미리 보는 기능이 기록되어 있습니다(Apple의 Xcode 27 릴리스 노트). 먼저 프로젝트에 목표 언어와 번역 리소스를 준비하고, Xcode 미리보기로 레이아웃을 점검하세요. 미리보기는 초기 확인용이며, 실제 언어와 지역을 선택한 시뮬레이터나 기기 검수를 대신하지 않습니다.

이 안내는 번역을 추가하거나 갱신하는 독립 개발자와 작은 팀을 위한 것입니다.
SwiftUI와 Interface Builder에서 각자 맞는 미리보기 방법을 찾고, RTL 화면까지 검사하려는 개발자에게도 유용합니다.
원격 Mac에서 Xcode를 사용한다면 어떤 확인을 원격 환경에서 할지 판단할 수 있습니다.

마지막 업데이트: 2026년 10월 14일. Xcode 기능과 절차는 Apple의 Xcode 27 릴리스 노트 및 현지화 문서를 기준으로 확인했습니다. 설치된 패치 버전에서 메뉴와 기능이 같은지 해당 버전의 릴리스 노트도 대조하세요.

시작 단계: 목표 언어와 리소스 준비

미리보기에서 언어를 바꿔도 프로젝트에 번역 리소스가 없으면 올바른 현지화 화면을 검수할 수 없습니다. 먼저 프로젝트가 지원할 언어를 정하고, 해당 언어의 리소스가 추가되었는지 확인합니다. Apple은 언어와 지역을 프로젝트에 추가하는 절차를 언어 및 지역 지원 문서에 안내합니다.

번역 파일을 별도 도구나 번역 담당자와 주고받는 프로젝트라면 가져온 리소스가 프로젝트에 반영되었는지 확인하세요. Xcode에서 현지화 파일을 가져오는 절차는 현지화 가져오기 문서에 나와 있습니다. 화면에 기본 언어 문자열만 보인다면 미리보기 오류라고 단정하기 전에 리소스가 준비되고 연결되었는지부터 확인해야 합니다.

다음 항목을 구분해 두면 원인을 잘못 짚는 일을 줄일 수 있습니다.

• 리소스 미준비: 목표 언어의 번역 파일이 없거나 프로젝트에 반영되지 않았습니다.
• 미리보기 언어 미전환: 번역은 있지만 미리보기 환경이 기본 언어로 남아 있습니다.
• 번역 내용 문제: 목표 언어 문자열은 표시되지만 의미나 표현이 부정확합니다.
• 레이아웃 문제: 번역은 맞지만 길이와 방향이 화면 구성에 맞지 않습니다.

언어와 지역도 같은 설정으로 취급하지 마세요. 언어는 화면 문자열을 고르는 기준이고, 지역은 날짜나 숫자처럼 지역별 표현을 확인할 때 중요합니다. 배포 대상이 여러 지역이라면 화면에 표시되는 문자열뿐 아니라 지역에 따라 달라지는 값도 검사 범위에 넣으세요.

미리보기 방식 비교: SwiftUI와 Interface Builder

검사 방식은 화면을 만든 기술에 맞춰 선택합니다. Apple의 현지화 미리보기 안내는 Xcode의 미리보기 흐름을 설명합니다. 미리보기에서 언어를 선택할 때는 현재 프로젝트에서 준비된 현지화가 무엇인지 함께 확인하세요.

표의 적합도는 검사 목적에 따른 판단입니다. SwiftUI나 Interface Builder 미리보기에서 화면이 정상이어도 앱 실행 시의 언어 선택과 동작까지 확인한 것은 아닙니다.

SwiftUI: 로캘과 레이아웃 방향 확인

SwiftUI에서는 캔버스에서 검사할 미리보기 구성을 고르고, 목표 로캘이 적용된 상태인지 확인합니다. 화면마다 표시 문자열이 바뀌는지, 긴 번역이 한 줄에 갇히지 않는지, 버튼의 글자가 읽히는지 살펴보세요. 콘텐츠가 중요한 순서대로 읽히는지도 점검해야 합니다.

의사 코드는 다음처럼 뷰 환경에 로캘을 지정하는 방식으로 구성할 수 있습니다.

#Preview("Français") {
    ContentView()
        .environment(\.locale, Locale(identifier: "fr-FR"))
}

여기서 확인하는 언어와 지역은 프로젝트의 실제 지원 대상에 맞춰 바꾸세요. 미리보기 이름만 바뀌고 화면 문자열이 그대로라면 먼저 리소스 연결과 뷰의 문자열 사용 방식을 점검합니다. 문자열을 코드에 직접 고정해 두면 현지화 리소스가 있어도 화면에서 기대한 번역을 불러오지 못할 수 있습니다. 인터페이스를 현지화에 맞게 준비하는 기준은 Apple의 인터페이스 준비 문서에서 확인할 수 있습니다.

RTL 언어는 번역 문자열만 바꿔서는 검수가 끝나지 않습니다. 정렬, 좌우 이동을 나타내는 화살표, 탐색 흐름, 아이콘 방향을 따로 확인하세요. SwiftUI의 레이아웃 방향은 Apple의 LayoutDirection 문서를 참고해 처리할 수 있습니다.

주의: 오른쪽에서 왼쪽으로 쓰는 언어를 대상으로 한다면 화면의 모든 아이콘을 무조건 뒤집지 마세요. 방향을 따라야 하는 탐색 표시와 원래 모양을 유지해야 하는 상징 아이콘을 구분해 검사해야 합니다.

Storyboard와 XIB: 제약 조건 확인

Interface Builder에서는 대상 화면을 열고, 준비된 현지화 또는 사용할 수 있는 의사 언어 미리보기를 선택합니다. 긴 문자열이 라벨의 표시 영역을 넘는지, 버튼과 셀의 크기가 텍스트를 수용하는지, 제약 조건 때문에 내용이 겹치지 않는지 확인하세요.

의사 언어는 실제 번역 대신 확장된 문자열 등으로 공간 문제를 드러내는 보조 수단입니다. 사용할 수 있는 미리보기 종류와 설정은 설치된 Xcode 버전 및 프로젝트 상태를 기준으로 확인해야 합니다. 이를 통과했다는 이유만으로 앱 실행 시의 모든 언어 설정이 올바르다고 판단해서는 안 됩니다.

발견 단계: 문제를 재현 가능한 수정 항목으로 전환

화면에 문제가 보이면 “번역이 이상하다”처럼 넓게 기록하지 말고, 다시 확인할 수 있는 조건으로 나눕니다.

• 텍스트 잘림: 화면과 컨트롤 이름, 목표 언어, 잘린 문자열을 적습니다.
• 레이아웃 확장 실패: 줄바꿈이 막혔는지, 고정 너비나 높이가 원인인지 살핍니다.
• RTL 방향 불일치: 영향을 받은 정렬, 탐색 표시, 아이콘을 각각 기록합니다.
• 현지화 리소스 누락: 화면에 표시된 기본 문자열과 기대한 리소스를 대조합니다.
• 지역 표현 오류: 날짜나 숫자처럼 지역 설정에 따라 확인할 값을 별도로 적습니다.

문제가 발생한 화면, 언어와 지역, 재현 조건을 한 묶음으로 기록하면 수정 후 같은 상황을 다시 만들 수 있습니다. 먼저 번역 리소스나 레이아웃을 고친 뒤, 처음 발견한 미리보기 조건으로 재검사하세요. 수정 전후의 조건이 달라지면 문제가 해결된 것인지 판단하기 어렵습니다.

미리보기 이후: 시뮬레이터와 기기에서 실행 검수

미리보기는 빠른 UI 확인에 유용하지만 실제 실행 검수는 별도 단계입니다. 시뮬레이터나 기기에서 앱을 목표 언어와 지역으로 실행하고, 화면 이동과 주요 동작 중 문자열이 제대로 반영되는지 확인하세요. Apple은 앱 실행 중 현지화를 시험하는 절차를 현지화 실행 테스트 문서에 설명합니다.

출시 판단은 아래처럼 나누세요.

• 미리보기 통과: 눈에 띄는 잘림, 겹침, 방향 문제가 발견되지 않았습니다.
• 실행 검수 통과: 시뮬레이터나 기기에서 목표 언어와 지역을 적용해 주요 화면을 확인했습니다.
• 출시 준비 완료: 번역 내용까지 목표 언어 사용자가 검토했고, 발견된 결함을 수정한 뒤 재확인했습니다.

미리보기에서 보이지 않던 실행 환경의 문제는 이 단계에서 찾습니다. 번역의 자연스러움이나 문화적 적절성은 UI 배치만으로 판단할 수 없습니다. 번역을 담당하는 사람이나 해당 언어 사용자에게 주요 화면의 문구를 검토받고, 문제가 발견되면 리소스와 화면을 다시 확인하세요. 다국어 앱을 구성할 때 참고할 Apple의 여러 언어 지원 안내도 함께 살펴볼 수 있습니다.

원격 Mac 사용 전 점검 목록

Xcode는 macOS에서 사용해야 합니다. 로컬 Mac에서 작업하기 어렵다면 원격 환경에서 미리보기와 시뮬레이터 검수를 나눠 진행할 수 있는지 먼저 정하세요. 원격 접속만으로도 화면을 살필 수 있는 작업과, 실제 기기 연결이나 현장 접근이 필요한 검수는 다릅니다.

• [ ] 프로젝트에 검사할 언어가 지원 언어로 추가되어 있습니다.
• [ ] 목표 언어의 번역 리소스를 가져왔고, 화면에서 사용할 수 있습니다.
• [ ] 검사할 언어와 지역을 구분해 목록으로 만들었습니다.
• [ ] SwiftUI 또는 Interface Builder에서 목표 환경의 미리보기를 확인했습니다.
• [ ] 긴 문구, 줄바꿈, 버튼, 콘텐츠 우선순위를 검사했습니다.
• [ ] RTL 대상이면 정렬과 방향에 민감한 요소를 따로 살폈습니다.
• [ ] 발견한 문제마다 화면, 언어와 지역, 재현 조건을 기록했습니다.
• [ ] 수정 후 동일한 조건으로 미리보기를 다시 확인했습니다.
• [ ] 시뮬레이터나 기기에서 앱을 실행하고 목표 언어와 지역을 검수했습니다.
• [ ] 번역 품질을 화면 배치 검수와 별도로 확인했습니다.

원격 Mac이 필요한 작업과 로컬에서 처리할 수 있는 범위를 먼저 정리하려면 Mac 환경과 요금 안내를 확인하세요. 지속적인 원격 개발 환경이 필요한 경우에는 원격 Mac 환경 확인도 살펴볼 수 있습니다.

로컬 Mac만 사용하면 원격 접속이나 상시 실행 환경을 따로 마련할 필요가 없지만, Xcode 작업을 위한 기기를 직접 보유하고 관리해야 합니다. 일반적인 다른 운영체제 환경에서는 Xcode를 실행할 수 없고, 기존 Mac에 작업을 몰아 두면 디스크와 사용 시간을 놓고 다른 개발 작업과 경쟁할 수 있습니다. 여러 언어의 화면을 반복 확인해야 하지만 사용할 Mac이 없다면 MacDate의 원격 Mac을 단기 테스트 환경으로 검토해 보세요. 다만 실제 기기 연결이나 물리 인터페이스가 꼭 필요한 검수라면 원격 환경이 맞지 않을 수 있으므로, 먼저 접속 방식과 프로젝트에 필요한 기능을 확인한 뒤 선택하는 편이 안전합니다.