증상: SwiftUI 화면의 문구가 코드 곳곳에 흩어져 있고, 한국어와 영어가 섞입니다.
빠른 해결: Xcode의 String Catalog에 화면 문구를 모으고, 언어별로 실제 실행해 긴 문장과 동적 내용까지 확인하세요.

이 안내는 첫 SwiftUI 과제에 한국어와 영어를 넣으려는 학생에게 적합합니다.
기존 코드에서 화면 문구를 정리하려는 초보자, 번역과 언어 전환을 함께 점검해야 하는 팀 과제 구성원에게도 도움이 됩니다.

먼저 확인할 것: iOS 27 앱의 한국어와 영어 지원 범위

먼저 모든 화면을 번역하려고 하지 마세요. 제출할 화면에서 사용자가 직접 보는 제목, 버튼, 안내 문구부터 골라 String Catalog에 관리하는 것이 좋습니다. 서로 다른 언어의 문장을 코드에서 조각내 이어 붙이지 마세요. 문장 순서가 달라질 수 있고, 빠진 번역을 찾기도 어려워집니다.

Apple은 Xcode의 String Catalog로 현지화할 텍스트를 관리하고 앱에 언어를 추가하는 방법을 안내합니다. String Catalog와 텍스트 현지화 안내와 앱에서 여러 언어를 지원하는 방법을 참고해 프로젝트의 실제 Xcode 버전에 맞춰 진행하세요.

다만 iOS 27과 Xcode의 모든 기능이 안정 버전에서 동일하게 제공된다고 단정하면 안 됩니다. Apple의 Xcode 27.2 공개 시험판 출시 설명은 해당 버전이 시험판임을 확인하는 자료입니다. 화면 메뉴와 기능은 설치한 버전의 문서에서 다시 확인하세요.

기존 코드에서 사용자에게 보이는 문구를 골라내기

다음처럼 화면에서 읽히는 문구와 내부 데이터를 구분하세요.

  • 화면 제목, 버튼 이름, 입력 안내, 오류 설명은 사용자가 읽으므로 현지화 대상입니다.
  • 변수 이름, 내부 식별자, 디버그 출력은 사용자가 보는 화면 문구가 아니라면 번역하지 않습니다.
  • 사용자가 입력했거나 서버에서 받은 제품 이름 같은 데이터는 코드에 박아 둔 문구와 성격이 다릅니다. 과제에서 번역 대상인지 먼저 정하세요.

SwiftUI에서는 화면에 표시할 텍스트를 현지화 가능한 방식으로 작성하고, 카탈로그에 언어별 문구를 채웁니다. Xcode가 코드에서 문구를 찾을 수 있는 위치와 형태에는 경계가 있습니다. 그래서 문자열이 자동으로 들어오지 않으면 해당 문자열이 실제 화면에 표시되는지, Apple의 현지화 텍스트 준비 안내에 맞는 형태인지 점검하세요. 자동 수집이 모든 문자열을 대신 정리해 주는 것은 아닙니다.

주의: 카탈로그에 항목이 있다는 사실만으로 번역이 완성된 것은 아닙니다. 각 언어에 실제 번역이 들어 있는지와 실행 화면에서 올바르게 나타나는지를 따로 확인하세요.

문장을 이어 붙이지 말고 동적 텍스트까지 설계하기

수량이나 사용자 이름처럼 실행 중 바뀌는 값이 문장에 들어간다면, 한국어 문장 조각과 영어 문장 조각을 코드에서 이어 붙이는 방식을 피하세요. 언어마다 단어의 순서와 표현 방식이 다를 수 있습니다. 문장 전체를 현지화 가능한 리소스로 관리하고, 숫자나 값은 해당 문장이 사용하는 형식에 맞게 넣으세요.

예를 들어 항목 수를 알려 주는 문장은 숫자만 바꿔 끼우면 끝나는 문제가 아닐 수 있습니다. 단수와 복수 표현을 포함해 언어별 문장을 준비하고, 실제 값으로 화면을 확인해야 합니다. String Catalog의 변형 항목과 시스템의 현지화 형식을 활용할 수 있는지는 사용 중인 Xcode 문서를 확인하세요. Apple의 String Catalog 안내에서 지원 방식과 편집 방법을 확인할 수 있습니다.

결정 도구: 해당하는 조건을 확인하고 다음 작업을 고르기

아래 항목을 확인한 뒤, 해당하는 경로를 선택하세요.

  • [ ] 제출 화면이 적고 문구도 많지 않다면: 화면 문구를 목록으로 만들고 해당 항목부터 String Catalog로 옮기세요. 처음부터 모든 리소스를 번역하지 않아도 됩니다.
  • [ ] 수량이나 사용자 입력값이 문장에 들어간다면: 문장을 여러 조각으로 나누어 붙이지 마세요. 전체 문장과 동적 값을 현지화 리소스에 맞게 구성하고 실제 값으로 실행해 확인하세요.
  • [ ] 팀원이 번역을 나눠 맡는다면: 각 항목에 화면 위치와 문맥을 적고 현지화 파일을 내보내 공유하세요. 개인 과제이고 문구가 적다면, 먼저 직접 정리한 뒤 두 언어로 실행해도 됩니다.
  • [ ] Xcode를 쓸 수 있는 Mac이 있다면: 그 환경에서 빌드하고 언어별 실행까지 확인하세요. 사용할 수 있는 Mac이 없다면: 문구와 번역 초안을 먼저 준비하고, 과제 검증에 실행 결과가 필요할 때 학교나 지인의 Mac을 빌리거나 원격 Mac을 검토하세요.
  • [ ] 과제에서 실제 실행 화면을 요구하지 않는다면: 번역할 항목과 문구의 맥락을 준비하는 단계부터 진행하세요. 실행 결과 제출이 필수라면: Mac과 Xcode 환경을 확보하기 전에는 검증을 마쳤다고 판단하지 마세요.

자주 막히는 지점을 FAQ로 해결하기

SwiftUI 앱에 한국어와 영어를 추가할 때

먼저 프로젝트가 지원할 언어를 설정하고, 사용자에게 보이는 텍스트를 현지화 가능한 방식으로 작성하세요. String Catalog에서 언어별 문구를 관리한 다음 각 언어로 실행해 확인합니다. 처음부터 프로젝트의 모든 리소스를 번역할 필요는 없습니다. 과제에서 보여 줄 화면과 채점 대상 문구부터 옮기면 누락을 찾고 수정하기 쉽습니다.

문자열이 카탈로그에 자동으로 나타나지 않을 때

문자열이 화면에 표시되는 문구인지부터 확인하세요. 변수에 담긴 값, 디버그 메시지, 실행 중 외부에서 받아오는 데이터가 자동으로 번역 대상이 되는 것은 아닙니다. 현지화 가능한 텍스트로 쓰였는지와 Xcode가 인식할 수 있는 코드 위치인지 확인하세요. 그래도 빠진 항목은 문서에서 권장하는 방식으로 명시적으로 정리하고, 카탈로그의 번역 상태를 다시 확인하면 됩니다.

시스템 언어를 바꿔 앱을 확인할 때

Xcode의 실행 환경에서 앱 언어를 바꾸거나 현지화 테스트 안내에 따라 언어별 실행을 준비하세요. 그런 다음 제목, 버튼, 안내 문구가 선택한 언어로 표시되는지 확인합니다. 짧은 문구뿐 아니라 영어처럼 길이가 달라질 수 있는 문장도 봐야 합니다. Apple의 앱 현지화 실행 테스트 안내를 따라 실제 실행 결과를 확인하세요.

Mac이 없을 때 할 수 있는 준비

번역할 문구와 화면 위치를 정리하는 일은 먼저 진행할 수 있습니다. 그러나 프로젝트를 Xcode에서 빌드하고 실제 전환 결과를 확인하는 단계에는 Xcode가 동작하는 Mac이 필요합니다. Xcode 시스템 요구 사항에서 사용 중인 환경이 맞는지 확인하세요. 학교 장비를 쓸 수 없다면 원격 Mac 학습 환경 안내를 살펴보고 과제 기간에 맞는지 판단할 수 있습니다.

팀 과제라면 번역을 넘기기 전에 맥락을 적기

번역할 항목만 전달하면 팀원이 문구의 역할을 알기 어렵습니다. “완료”가 저장 완료인지 과제 제출 완료인지에 따라 알맞은 표현이 달라질 수 있습니다. 각 항목에 화면 위치, 문구의 의미, 동적 값이 들어가는지를 함께 적으세요.

Xcode가 제공하는 내보내기와 가져오기 흐름을 사용하면 현지화 자료를 팀원과 주고받을 수 있습니다. Apple의 현지화 내보내기 안내를 따라 파일을 준비하고, 가져온 뒤 번역 누락이나 변경 사항이 없는지 다시 확인하세요. 자동 번역은 초안 작성에 도움을 줄 수 있지만, 앱 화면에서 자연스럽고 정확한지 확인하는 과정까지 대신하지는 않습니다.

제출 전에는 두 언어로 직접 실행하기

마지막 확인은 카탈로그 파일만 보는 것으로 끝내지 마세요. 각 언어로 앱을 실행하고 화면을 살펴보세요.

  • 기본 언어와 추가 언어에서 제목, 버튼, 안내 문구가 각각 표시되는지 확인합니다.
  • 영어 문장이 길어졌을 때 버튼 밖으로 넘치거나 화면 요소를 가리지 않는지 봅니다.
  • 수량이나 사용자 입력값이 들어가는 문구를 실제 값으로 시험합니다.
  • 번역하지 않기로 한 제품 데이터와 내부 정보가 의도대로 남아 있는지 확인합니다.
  • 팀 과제라면 내보낸 파일을 다시 가져온 뒤 변경된 항목과 빠진 번역을 점검합니다.

문구가 String Catalog에 들어 있다는 것은 관리가 시작됐다는 뜻이지, 다국어 과제가 통과했다는 뜻은 아닙니다. 최종 판단은 한국어와 영어의 실제 실행 화면을 기준으로 하세요.

Apple 문서와 Xcode 출시 설명을 대조해 확인한 날짜는 2026년 9월 26일입니다. Xcode의 시험판 기능이나 메뉴는 버전에 따라 달라질 수 있으므로, 제출 직전에 현지화 안내와 설치된 Xcode의 출시 설명을 다시 확인하세요.

학교나 지인의 Mac을 일정에 맞춰 쓸 수 있다면 직접 빌드하고 확인하는 것이 좋습니다. 반대로 과제에 Mac 환경이 필요하지만 당장 빌릴 수 없다면, 원격 Mac으로 필요한 기간만 실습하는 방법도 있습니다. 오래 사용할 장비가 필요하거나 물리 장치와 직접 연결해야 하는 경우에는 직접 사용할 Mac이 더 맞을 수 있습니다. 현재 쓰는 컴퓨터만으로는 Xcode 실행과 iOS 화면 검증이 어렵고, 학교 장비는 사용 시간이 제한되며, 가상 환경은 실제 프로젝트 요구와 맞지 않을 수 있습니다. 그런 조건이라면 MACCOME의 Mac 사용 환경과 주문 안내를 확인한 뒤 과제 일정에 필요한 방식인지 비교해 보세요.