.XML - 안드로이드 (Strings)

컨텐츠는 영어 텍스트를 Phrase Language AI를 이용해 기계 번역한 것입니다.

파일 확장명	.xml
API Extension	xml
가져오기	예
내보내기	예
복수형 지원	예
설명 지원	예
형식 옵션 파일이 업로드되거나 다운로드될 때 지정할 수 있는 옵션입니다. 업로드/다운로드 방법(API, CLI, Repo 동기화 등)에 따라, `업로드`, `다운로드` 또는 `phrase.yml` 구성 파일의 쿼리 매개변수로 지정할 수 있습니다.	convert_placeholder escape_linebreaks unescape_linebreaks enclose_in_cdata indent_size indent_style unescape_tags include_tools_ignore include_tools_locale_definition escape_android_chars unescape_android_chars

안드로이드 XML은 안드로이드 앱에 번역된 콘텐츠를 로드하는 데 사용할 수 있는 안드로이드 전용 XML 변형입니다. 그 루트 요소는 수많은 <resources>와 그 아래에 중첩된 <string> 요소로 구성되어 있으며, 번역 대기 중인 문자열을 저장합니다. 안드로이드 스튜디오를 사용하여 이러한 리소스 파일을 생성하고 Phrase를 사용하여 번역을 관리할 수 있습니다.

안드로이드 스튜디오는 콘텐츠가 번역되어야 하는지를 나타내기 위해 번역 가능 속성을 사용합니다. Phrase에서는 이 속성이 무시됩니다. 이 문자열을 Phrase에 푸시할 필요가 없습니다. 문자열이 번역되지 않아야 하는 경우, 모든 번역하지 않을 문자열(예: donottranslate.xml)이 포함된 별도의 리소스 파일에 정의하십시오.

형식 옵션

식별자	convert_placeholder
유형	부울
업로드	아니요
다운로드	예
기본값	false
설명	자리 표시자는 형식 특정 요구 사항에 맞게 변환됩니다. 예: `$s' => '$@`

식별자	escape_linebreaks
유형	부울
업로드	아니요
다운로드	예
기본값	false
설명	모든 줄 바꿈은 `\n`로 이스케이프됩니다.

식별자	unescape_linebreaks
유형	부울
업로드	예
다운로드	아니요
기본값	false
설명	모든 `\n`은 실제 새 줄로 가져옵니다.

식별자	enclose_in_cdata
유형	부울
업로드	아니요
다운로드	예
기본값	false
설명	HTML 태그가 포함된 번역을 CDATA로 감쌉니다.

식별자	indent_size
유형	정수
업로드	아니요
다운로드	예
기본값	4
설명	들여쓰기 문자의 수를 지정합니다.

식별자	indent_style
유형	문자열
업로드	아니요
다운로드	예
기본값	공백
설명	들여쓰기 문자를 지정합니다. 허용된 값은 `공백` 및 `탭`입니다.

식별자	unescape_tags
유형	부울
업로드	예
다운로드	아니요
기본값	false
설명	모든 `<` 문자는 `<`로 이스케이프 해제되고 모든 `>` 문자는 태그에 대해 `>`로 이스케이프 해제됩니다.

식별자	include_tools_locale_definition
유형	부울
업로드	아니요
다운로드	예
기본값	false
설명	결과 XML에 `도구:로캘` 속성을 포함합니다.

식별자	include_tools_ignore
유형	부울
업로드	아니요
다운로드	예
기본값	false
설명	결과 XML에 `도구:무시` 속성을 포함합니다. 비활성화된 경우(기본값), `도구:무시` 속성은 내보낸 파일에서 생략됩니다. 이것은 리소스 파일을 깔끔하게 유지하고 개발 전용 린트 억제 속성을 포함하지 않도록 도와줍니다.

식별자	preserve_cdata
유형	부울
업로드	아니요
다운로드	예
기본값	false
설명	번역 콘텐츠에 이미 CDATA 태그가 포함되어 있는 경우, 이 스위치는 콘텐츠가 추가로 이스케이프되는 것을 방지합니다.

식별자	escape_android_chars
유형	부울
업로드	아니요
다운로드	예
기본값	false
설명	`@`, `?` 및 `탭` 안드로이드 특수 문자를 백슬래시 접두사로 이스케이프합니다.

식별자	unescape_android_chars
유형	부울
업로드	예
다운로드	아니요
기본값	false
설명	`\@`, `\?`, `\t` 및 `\uXXXX` (코드 XXXX를 가진 유니코드 문자)의 이스케이프 해제를 수행합니다.

코드 샘플

<?xml version="1.0" encoding="UTF-8"?>
<resources>
    <string name="boolean_key">--- true
</string>
    <string name="empty_string_translation"/>
    <!-- 이 키에 대한 아름다운 설명입니다! -->
    <문자열 name="key_with_description">확인해 보세요! 이 키에는 설명이 있습니다! (최소 일부 형식에서)</문자열>
    <문자열 name="key_with_line-break">이 번역은
a line-break.</string>
    <문자열 name="nested.deeply.key">안녕하세요, 이 키는 더 깊이 중첩되어 있습니다.</문자열>
    <문자열 name="nested.key">이 키는 네임스페이스 안에 중첩되어 있습니다.</문자열>
    <string name="null_translation"/>
    <plurals name="pluralized_key">
        <항목 수="one">단수 형태가 하나만 발견되었습니다.</항목>
        <item quantity="other">안녕하세요, 당신은 %s 복수형이 있습니다!</item>        
    </plurals>
    <string-array name="sample_collection">
        <item>첫 번째 항목</item>
        <item>두 번째 항목</item>
        <item>세 번째 항목</item>
    </string-array>
    <string name="simple_key">메시지가 있는 키입니다.</string>
    <string name="unverified_key">이 번역은 아직 확인되지 않았으며 기다리고 있습니다.</string> (일부 형식에서 이 상태를 내보내기도 합니다)</string>
</resources>

안드로이드 XML 파일의 복수형

복수 값을 위해 다음과 같은 특별한 <plurals> 태그를 할당하세요:

<plurals name="messages">
        <item quantity="one">하나의 메시지가 수신되었습니다.</item>
        <item quantity="other">%s messages received.</item>        
</plurals>