.XML - Android (Strings)

本コンテンツはPhrase Language AIの機械翻訳により、英語から翻訳されています。

ファイル拡張子	.xml
API拡張	xml
インポート	はい
エクスポート	はい
複数形のサポート	はい
説明のサポート	はい
フォーマットオプションファイルがアップロードおよび/またはダウンロードされるときに指定できるこれらのオプション。アップロード/ダウンロード方法（API、CLI、リポジトリ同期など）に応じて、クエリパラメータ `Upload`、`Download` または `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

Android XMLは、Androidアプリに翻訳されたコンテンツを読み込むために使用できるAndroid特有のXMLバリエーションです。そのルート要素は、翻訳待ちの文字列を格納する多数の <string> 要素がネストされた <resources> です。これらのリソースファイルを生成するためにAndroid Studioを使用し、Phraseを使用して翻訳を管理できます。

Android Studioは、コンテンツが翻訳される必要があるかどうかを示すためにプロパティ translatable を使用します。Phraseでは、このプロパティは無視されます。これらの文字列をPhraseにプッシュする必要はありません。文字列が翻訳されるべきでない場合は、すべての非翻訳文字列を含む別のリソースファイルに定義します（例：donottranslate.xml）。

ファイル形式オプション

識別子	convert_placeholder
タイプ	ブール
アップロード	いいえ
ダウンロード	はい
デフォルト	false
概要	プレースホルダーは、特定のフォーマット要件に一致するように変換されます。例： `$s' => '$@`

識別子	escape_linebreaks
タイプ	ブール
アップロード	いいえ
ダウンロード	はい
デフォルト	false
概要	すべての改行は `\n` としてエスケープされます。

識別子	unescape_linebreaks
タイプ	ブール
アップロード	はい
ダウンロード	いいえ
デフォルト	false
概要	すべての `\n` は真の改行としてインポートされます。

識別子	enclose_in_cdata
タイプ	ブール
アップロード	いいえ
ダウンロード	はい
デフォルト	false
概要	HTMLタグを含む翻訳をCDATAで囲みます。

識別子	indent_size
タイプ	integer
アップロード	いいえ
ダウンロード	はい
デフォルト	4
概要	インデント文字の数を指定します。

識別子	indent_style
タイプ	文字列
アップロード	いいえ
ダウンロード	はい
デフォルト	スペース
概要	インデント文字を指定します。許可される値は `space` と `tab` です。

識別子	unescape_tags
タイプ	ブール
アップロード	はい
ダウンロード	いいえ
デフォルト	false
概要	すべての `<` 文字は `<` にエスケープ解除され、すべての `>` 文字はタグのために `>` にエスケープ解除されます。

識別子	include_tools_locale_definition
タイプ	ブール
アップロード	いいえ
ダウンロード	はい
デフォルト	false
概要	結果のXMLに `tools:locale` 属性を含めます。

識別子	include_tools_ignore
タイプ	ブール
アップロード	いいえ
ダウンロード	はい
デフォルト	false
概要	結果のXMLに `tools:ignore` 属性を含めます。無効にすると（デフォルト）、`tools:ignore` 属性はエクスポートされたファイルから省略されます。これによりリソースファイルがクリーンに保たれ、開発特有のリント抑制属性が含まれるのを避けることができます。

識別子	preserve_cdata
タイプ	ブール
アップロード	いいえ
ダウンロード	はい
デフォルト	false
概要	翻訳コンテンツにすでにCDATAタグが含まれている場合、このスイッチはコンテンツが追加でエスケープされるのを防ぎます。

識別子	escape_android_chars
タイプ	ブール
アップロード	いいえ
ダウンロード	はい
デフォルト	false
概要	`@`、`?` および `Tab` Android特別文字をバックスラッシュプレフィックスでエスケープします。

識別子	unescape_android_chars
タイプ	ブール
アップロード	はい
ダウンロード	いいえ
デフォルト	false
概要	`\@`、`\?`、`\t` および `\uXXXX`（コードXXXXのUnicode文字）のエスケープ解除を行います。

コードサンプル

<?xml version="1.0" encoding="UTF-8"?>
<resources>
    <string name="boolean_key">--- true
</string>
    <string name="empty_string_translation"/>
    <!-- これはこのキーの美しい説明です！ -->
    <string name="key_with_description">チェックしてみてください！このキーは説明です。（少なくとも一部のファイル形式で）</string>
    <string name="key_with_line-break">この翻訳には
a line-break.</string>
    <string name="nested.deeply.key">こんにちは、このキーはさらに深くネストされています。</string>
    <string name="nested.key">このキーは名前空間内にネストされています。</string>
    <string name="null_translation"/>
    <plurals name="pluralized_key">
        <item quantity="one">見つかったのは1つの複数形のみです。</item>
        <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>

Android XMLファイルの複数形

複数の値には、このように特別な<plurals>タグを割り当ててください：

<plurals name="messages">
        <item quantity="one">1件のメッセージを受信しました。</item>
        <item quantity="other">%s件のメッセージを受信しました。</item>        
</plurals>