애플 문자열
조회 키를 유지하면서 애플 문자열 테이블의 값을 번역하고, 재구성한 텍스트를 이스케이프 처리합니다.
애플 문자열 테이블은 고정된 조회 키와 화면에 표시할 텍스트를 연결합니다. xcode-strings 파일 처리기는 오른쪽 값만 번역하고 키는 그대로 유지한 채, 이스케이프 처리한 문자열 리터럴을 로캘별 .strings 파일에 다시 기록합니다.
키와 값 #
예를 들면 다음과 같습니다.
/* Checkout heading */
"checkout.title" = "Complete your order";
"delivery.estimate" = "Delivery within %d days";오른쪽의 두 값은 텍스트 단위입니다. checkout.title 및 delivery.estimate는 조회 키로 그대로 유지됩니다. 주석도 항목과 함께 보존되지만, 이 처리기는 주석 내용을 번역 힌트로 변환하지 않습니다. 짧은 레이블의 의미가 모호하다면 번역 워크플로에서 지원하는 방식으로 맥락을 제공하세요.
따옴표로 묶인 키와 값, 대입 기호, 세미콜론은 모두 지원되는 문자열 테이블 구문입니다. 파서는 지원되는 이스케이프 시퀀스를 디코딩하고, 출력 시에는 따옴표, 백슬래시, 줄 바꿈, 탭, 캐리지 리턴을 이스케이프 처리합니다. 값을 교체해도 주변 주석과 항목 간 공백은 그대로 유지됩니다.
병합 및 리소스 배치 #
이전 원본을 기준으로 키별 값의 변경 여부를 판별하고, 기존 대상에서 유지할 번역을 가져옵니다. 항목 구성과 주석은 현재 원본을 따릅니다. 메시지가 바뀌면 일반적인 원본 업데이트를 사용하고, 번역 지침을 바꾼 뒤 파일 전체를 갱신하려면 별도로 전체 갱신을 실행하세요. CLI 범위를 참고하세요.
로캘 리소스는 애플리케이션이 불러오는 위치에 배치하세요. 예를 들면 en.lproj/Localizable.strings 및 de.lproj/Localizable.strings입니다. Base.lproj에 있는 원본은 로캘 이름으로 된 디렉터리에 있는 원본과 경로를 도출하는 방식이 다릅니다. 선택한 도구로 대상 경로를 확인하세요. 테이블을 번역하는 것만으로는 애플리케이션의 개발 언어나 리소스 포함 여부가 설정되지 않습니다.
문자열 테이블 설정 및 불러오기 #
CLI는 .strings에서 xcode-strings을 추론합니다. 선택 및 경로 규칙은 CLI 설정을, 관리형 저장소 출력은 GitHub를 참고하세요.
앱에서 대상 테이블을 불러오고 실제 값으로 형식 지정자를 테스트하세요. 복수형 선택 리소스에는 문자열 사전을 사용하세요. 프로젝트에서 문자열 카탈로그를 사용한다면 해당 공유 파일의 병합 규칙을 따르세요. 로캘별로 카탈로그 이름을 바꾸면 리소스 구조가 달라집니다.