안드로이드 리소스
안드로이드 리소스 이름과 로캘 디렉터리 규칙을 유지하면서 지원되는 문자열, 배열, 복수형을 번역합니다.
안드로이드는 리소스 이름을 통해 화면에 표시되는 텍스트를 애플리케이션 코드와 연결합니다. android 파일 처리기는 이 이름을 유지하면서 <resources> 루트 안의 지원되는 문자열, 문자열 배열 항목, 복수형 항목을 번역합니다. 수량 속성과 배열 위치는 안드로이드가 불러올 값을 식별하는 데 그대로 사용됩니다.
리소스 선택 #
리소스 파일에는 번역된 텍스트와 고정된 제품 이름을 함께 넣을 수 있습니다.
<resources>
<string name="checkout_title">Complete your order</string>
<string name="brand" translatable="false">Acme</string>
<string-array name="delivery_methods">
<item>Standard delivery</item>
<item>Express delivery</item>
</string-array>
<plurals name="items">
<item quantity="one">%d item</item>
<item quantity="other">%d items</item>
</plurals>
</resources>번역할 값은 리소스 이름, 배열 위치, 복수형 수량으로 식별합니다. brand 항목은 translatable="false" 속성이 있어 건너뜁니다. 배열 항목의 식별 정보에는 위치도 포함되므로, 배열 순서를 바꾸면 텍스트가 기존 번역문과 대응되는 방식이 달라집니다. 현재 CLI는 안드로이드 --key 선택을 지원하지 않으므로, 소스 파일 전체를 선택하세요.
처리기는 각 항목의 문자 데이터를 읽고, <b> 또는 <xliff:g> 같은 하위 요소가 있는 항목은 건너뜁니다. 이처럼 서식이 포함된 리소스는 검토를 마친 번역문을 별도로 제공하고, 해당 파일의 나머지 작업이 완료되면 번역이 빠짐없이 제공되었는지 확인하세요. 인라인 XML 주석 앞뒤의 텍스트는 하나로 합쳐져 번역됩니다. 값을 교체할 때 해당 인라인 주석이 제거될 수 있으며, 주석 내용은 번역 힌트로 사용되지 않습니다.
CDATA가 하나의 텍스트 값을 이루면 텍스트로 해석되며, 재구성할 때도 이를 감싸는 구문이 유지됩니다. CDATA 안의 마크업은 보호되는 하위 구조가 아니라 번역 대상으로 전달되는 텍스트의 일부입니다. 해당 리소스는 애플리케이션의 실제 렌더링 코드로 확인하세요.
로캘별 파일 배치 #
일반적인 소스 경로는 res/values/strings.xml이며, 독일어 번역문은 res/values-de/strings.xml에 배치합니다. 지역 및 문자 체계 한정자는 values- 뒤에 임의의 로캘 문자열을 붙이는 방식이 아니라, values-pt-rBR 또는 values-b+zh+Hans처럼 안드로이드 표기법을 따라야 합니다.
CLI의 경로 생성 기능은 안드로이드 형식을 명시하면 접미사가 없는 values 디렉터리를 인식합니다. 이처럼 지원되는 디렉터리 구조에서는 별도로 values-en 심볼릭 링크를 만들 필요가 없습니다. 해당 형식에서 기본으로 사용하는 안드로이드 로캘 표기법과 명시적인 대상 경로는 CLI 구성에서 설정해야 합니다. 출력 결과를 수락하기 전에 생성된 경로를 확인하세요.
재사용 및 부분 출력 #
이전 소스 텍스트는 리소스 식별 정보를 기준으로 비교합니다. 재구성할 때는 기존 번역문에서 일치하는 값을 가져옵니다. 소스가 변경되면 일반적인 lingo push --wait을 사용하고, 파일 전체를 강제로 갱신하기 전에는 승인된 번역문을 보존하세요. 고정 텍스트는 translatable="false" 표시가 있는 리소스에 넣어야 합니다. CLI의 lockedKeys 항목은 안드로이드 리소스를 제어하는 수단이 아닙니다.
처리기는 소스의 복수형 범주를 유지합니다. 다만 모든 대상 로캘에 필요한 범주가 빠짐없이 포함되거나 표현이 올바르다고 보장하지는 않습니다. 애플리케이션의 리소스 로더로 수량과 서식 지정 변수를 테스트하세요.
안드로이드 리소스 구성 및 확인 #
.xml CLI 소스에는 format: "android"을 명시적으로 설정하세요. XML만으로는 안드로이드 리소스에 사용되는 요소와 속성을 식별할 수 없습니다. GitHub App에서도 설정된 유형을 사용할 수 있습니다.
가져온 리소스를 안드로이드 도구로 빌드한 다음, 문자열, 배열, 복수형을 사용하는 화면을 열어 보세요. 안드로이드 앱 현지화하기 안내에 따라 작업 흐름을 마무리하세요. lingo check은 소스 변경이나 대상 파일 누락을 보고하며, 파일 내부의 안드로이드 리소스 누락은 보고하지 않습니다.