애플 문자열 카탈로그

원본 언어와 다른 로캘은 유지하면서 XCStrings 카탈로그의 대상 언어 값을 업데이트합니다.

.xcstrings 카탈로그는 원문과 번역을 함께 보관합니다. xcode-xcstrings 파일 처리기는 같은 파일에 있는 다른 로캘을 유지하면서 카탈로그의 대상 언어 항목을 채웁니다. 언어별로 새 파일을 만드는 대신 원본 경로의 카탈로그를 변경합니다.

원본 값과 변형 #

영어 원본 값이 명시된 항목은 다음과 같습니다.

json
{
  "sourceLanguage": "en",
  "strings": {
    "checkout.title": {
      "localizations": {
        "en": {
          "stringUnit": {
            "state": "translated",
            "value": "Complete your order"
          }
        }
      }
    }
  },
  "version": "1.0"
}

원본 언어의 stringUnit.value에서 텍스트를 가져옵니다. 지원되는 복수형이나 기기별 변형은 각각 고유하게 식별되는 별도의 말단 값을 제공합니다. 항목에 원본 언어의 현지화 값이 없으면 키를 원본 텍스트로 사용합니다. 원문 자체가 키인 경우에는 이 대체 방식이 유용하지만, checkout.title 같은 기술적인 키로는 의도한 영어 메시지를 대신할 수 없습니다.

shouldTranslate: false이 있는 항목은 건너뜁니다. 카탈로그 주석은 공유 구조에 그대로 둘 수 있지만, 처리기의 힌트는 형식과 변형을 식별하는 정보입니다. 각 주석이 번역 지침으로 사용된다는 뜻은 아닙니다.

로캘별 완성도 확인 #

완성도는 요청한 로캘을 기준으로 확인합니다. 처리기는 지원되는 원본 슬롯 중 변경되었거나 대상 값이 없는 슬롯을 선택합니다. 따라서 공유 카탈로그가 이미 있어도 새 언어의 번역을 받을 수 있습니다.

CLI에서 --force을 사용해도 카탈로그에 포함된 기존 번역이 재사용될 수 있습니다. 별도의 대상 입력을 비워도 원본 카탈로그 안의 값은 삭제되지 않습니다. 원문이 바뀌지 않은 메시지의 번역 문구를 바꾸려면 아래 수정 절차를 따르세요.

출력은 현재 원본 카탈로그를 바탕으로 구성합니다. 해당하는 경우 각 항목의 기존 로캘 데이터를 유지하고, 요청한 번역을 현재 항목과 변형에 기록합니다. 원본 변경 사항과 수정하지 않은 로캘까지 포함해 공유 파일의 전체 변경 내역을 검토하세요. 새 대상 단위에는 translated 상태가 사용됩니다. 사람이 승인할지는 별도의 검토를 거쳐 결정해야 합니다.

복수형과 기기별 변형 구조는 지원되는 원본 말단 값을 따릅니다. 모든 대상 언어의 문법적 형태가 생성되거나 검증되었다고 가정하지 마세요. 변형 구성을 살펴보고 대표적인 사례를 앱에서 표시해 확인하세요.

공유 파일 출력 설정 #

CLI는 .xcstrings를 바탕으로 xcode-xcstrings을 추론하고 출력을 원본 경로에 기록합니다. 이 유형은 설정에서 별도의 targetPath을 지정할 수 없습니다. CLI 파일 빠른 시작을 가져오기 단계까지 따라 하거나, 저장소 번역을 관리형으로 진행하려면 GitHub를 사용하세요.

기존 번역 수정 #

정확히 원하는 문구로 수정하려면 Xcode에서 해당 로캘의 값을 편집하고 앱에서 확인하세요. 엔진 지침을 변경한 뒤 번역을 다시 생성하려면 먼저 대기 중인 번역 작업을 마치고 전체 카탈로그를 보존하세요. CLI의 기존 기준 상태를 유지하고 targetLocales에 원하는 언어를 포함하세요.

다시 생성하려는 대상 항목만 삭제하세요. 위 예시에서 대상 언어가 독일어라면 삭제할 항목은 strings["checkout.title"].localizations.de입니다. en, 다른 로캘, 인접한 항목은 그대로 두세요. 파일을 저장한 다음 일반 증분 푸시를 실행하세요.

sh
lingo push --wait

해당 대상 값이 빠진 상태로 변경된 카탈로그가 제출되므로 선택한 항목이 번역 대상이 됩니다. 기다리는 동안에는 파일을 편집하지 마세요. 수락하기 전에 새 독일어 값과 카탈로그 전체 변경 내역을 확인하세요. 복수형이나 기기별 변형이 있는 항목에서 해당 로캘 항목을 삭제하면 지원되는 모든 원본 변형이 다시 생성됩니다.

저장된 기준 상태를 유지한 채 일반 푸시로 이 절차를 진행하세요. 위치 인수 패턴, --backfill-missing, --key는 각각 다른 작업을 선택하며, purge은 공유 파일을 건너뜁니다.

카탈로그 전체 변경 사항 검토 #

카탈로그를 교체하거나 정리하기 전에 커밋된 카탈로그나 로컬 복사본을 보존하세요. CLI 정리는 원본과 출력이 같은 경로를 사용하는 이 형식을 건너뜁니다. 번역 하나를 다시 생성하려면 위에서 설명한 대로 해당 로캘 항목을 삭제하세요.

CLI의 카탈로그 검사만으로는 XCStrings의 로캘 완성도를 확인할 수 없습니다. Xcode와 앱 검사를 통해 리소스 포함 여부, 개발 언어, 여러 카탈로그, 자리표시자, 표시되는 변형을 확인하세요. 해당 작업 절차는 아이오에스 앱 현지화를 참고하세요. 기존 strings와 stringsdict 형식은 로캘별로 파일을 따로 사용하는 방식을 유지합니다.