Xcode String Catalog(.xcstrings) 편집하고 번역하기

LocalePilot이 읽고 쓰는 것

• 번역 누락: 현지화가 없거나, new 상태이거나, 비어 있는 경우. LocalePilot은 빈 값을 쓰지 않습니다. 번역을 지우면 Xcode처럼 해당 현지화가 삭제됩니다.
• 복수형과 기기별 변형은 편집할 수 있으며, key › plural › one 형태로 표시됩니다.
• 원본 언어: 현지화가 없는 키는 키 자체를 의미하며(Xcode 관례), 편집하기 전까지 다시 쓰이지 않습니다.
• 상태: 바꾸지 않은 값은 상태(needs_review 등)를 유지하고, 편집한 값은 translated가 됩니다.

Xcode 스타일 그대로, 최소한의 diff

변경 없는 카탈로그를 다시 쓰면 바이트 단위로 동일한 파일이 나오고, 편집은 해당 줄만 바꿉니다. 코드 리뷰에서도 읽기 쉽고, 내보내기는 다른 형식과 마찬가지로 검토, 디스크 병합, 백업을 거칩니다.

형식 지정자 검사

QA는 %@, %1$@, %d, %ld, %lld, %.2f, %u, %i, %s를 인식하며, %%는 텍스트로 취급합니다. 번역에서 지정자가 빠지거나 남으면 내보내기 전에 표시됩니다.

알려진 제한

• shouldTranslate: false가 붙은 키와 치환(%#@count@)을 쓰는 키는 손대지 않고 유지되지만 표시되지 않습니다. 이런 키는 계속 Xcode에서 관리합니다.
• String Catalog의 대상 범주는 원본에 없어도 각 언어의 CLDR 규칙을 따릅니다. 없는 원본 범주는 other 형식을 사용하며 대상 언어가 쓰지 않는 범주는 내보내지 않습니다.
• 기존 .strings 파일도 UTF-8로 지원합니다. .strings 파일에 새 언어를 추가하면 <locale>.lproj 폴더가 만들어지며, 이 폴더는 Xcode 프로젝트에 추가해야 합니다. LocalePilot은 내보내기 요약에서 이를 알려 주고 .pbxproj는 절대 수정하지 않습니다. Xcode 16의 동기화 폴더를 쓰는 프로젝트라면 따로 할 일이 없습니다.