<h2 id="%E3%81%AF%E3%81%98%E3%82%81%E3%81%AB">
<a class="header-anchor-link" href="#%E3%81%AF%E3%81%98%E3%82%81%E3%81%AB" aria-hidden="true"></a> はじめに</h2>
<p>Xcode 15がリリースされ、String Catalogが使えるようになりました。<br>
基本的な使い方は、公式ドキュメントに記載されていますが、実際に使ってみると、こう使ったほうが便利だろうなというTipsがわかってきました。</p>
<h2 id="%E5%9F%BA%E6%9C%AC%E7%9A%84%E3%81%AA%E4%BD%BF%E3%81%84%E6%96%B9">
<a class="header-anchor-link" href="#%E5%9F%BA%E6%9C%AC%E7%9A%84%E3%81%AA%E4%BD%BF%E3%81%84%E6%96%B9" aria-hidden="true"></a> 基本的な使い方</h2>
<p>String Catalog自体の基本的な使い方については、公式ドキュメントを読みましょう。<br>
Stringsファイルから解放されて幸せな気持ちになれます。</p>
<p><a href="https://developer.apple.com/documentation/Xcode/localizing-and-varying-text-with-a-string-catalog" target="_blank" rel="nofollow noopener noreferrer">https://developer.apple.com/documentation/Xcode/localizing-and-varying-text-with-a-string-catalog</a></p>
<h2 id="%E3%83%A2%E3%82%B8%E3%83%A5%E3%83%BC%E3%83%AB%E5%8D%98%E4%BD%8D%E3%81%A7%E7%AE%A1%E7%90%86%E3%81%99%E3%82%8B">
<a class="header-anchor-link" href="#%E3%83%A2%E3%82%B8%E3%83%A5%E3%83%BC%E3%83%AB%E5%8D%98%E4%BD%8D%E3%81%A7%E7%AE%A1%E7%90%86%E3%81%99%E3%82%8B" aria-hidden="true"></a> モジュール単位で管理する</h2>
<p>しかし、アプリ内のローカライズテキストを一元管理するのは大変です。<br>
String Catalogを使うことで、文字列を一元管理できるようになりますが、String Catalog自体を一つのファイルにまとめると、命名規則を厳格にする必要があったり、ファイルが肥大化してしまい、管理が大変になります。</p>
<p>そこで、モジュール単位でString Catalogを分割することで、ファイルを分割し、管理をしやすくします。</p>
<p>モジュール単位に分割するには、Swift Packageを導入します。</p>
<p>詳しくは、以下の資料を参照してください。</p>
<p><a href="https://speakerdeck.com/d_date/swift-package-centered-project-build-and-practice" target="_blank" rel="nofollow noopener noreferrer">https://speakerdeck.com/d_date/swift-package-centered-project-build-and-practice</a></p>
<p>モジュール単位にすると、命名規則を厳格にする必要がなくなります。<br>
例えば、モジュールが画面単位になっていれば、Keyを <code>Title</code>や<code>Description</code>といった汎用な名前にしても、ソースコード内での衝突は起きず、可読性も失いません。namespaceもいりません。</p>
<h2 id="%E3%83%93%E3%83%AB%E3%83%89%E3%82%BF%E3%83%BC%E3%82%B2%E3%83%83%E3%83%88%E5%88%A5%E3%81%ABstring-catalog%E3%82%92%E7%AE%A1%E7%90%86%E3%81%99%E3%82%8B">
<a class="header-anchor-link" href="#%E3%83%93%E3%83%AB%E3%83%89%E3%82%BF%E3%83%BC%E3%82%B2%E3%83%83%E3%83%88%E5%88%A5%E3%81%ABstring-catalog%E3%82%92%E7%AE%A1%E7%90%86%E3%81%99%E3%82%8B" aria-hidden="true"></a> ビルドターゲット別にString Catalogを管理する</h2>
<p>Swift Packageではなく、Xcode Projectにリンクされたファイルをローカライズするには、プロジェクトにString Catalogを追加します。<br>
これも同様にビルド時にKeyを拾いあげてくれるので、ローカライズします。</p>
<p>これと前述の資料にあるように、ビルドターゲット別にString Catalogを管理することで文字列をビルドターゲットごとに出し分けることも可能です。</p>
<h2 id="localization%E3%81%AE%E5%91%BD%E5%90%8D%E8%A6%8F%E5%89%87%E3%81%AF%E5%8E%B3%E6%A0%BC%E3%81%AB%E3%81%97%E3%81%AA%E3%81%84">
<a class="header-anchor-link" href="#localization%E3%81%AE%E5%91%BD%E5%90%8D%E8%A6%8F%E5%89%87%E3%81%AF%E5%8E%B3%E6%A0%BC%E3%81%AB%E3%81%97%E3%81%AA%E3%81%84" aria-hidden="true"></a> Localizationの命名規則は厳格にしない</h2>
<p>String Catalogの導入で気づいたLocalizationの思想としては、ソースコードに埋め込むKeyは厳密に管理しないことです。<br>
できるだけ、英語そのままで書く、長い場合はわかりやすく短縮する、といったことを意識すると、可読性が上がります。</p>
<p>例:</p>
<table>
<thead>
<tr>
<th>Key</th>
<th>English</th>
<th>Japanese</th>
</tr>
</thead>
<tbody>
<tr>
<td>GET_A_RIDE</td>
<td>Get a Ride</td>
<td>配車サービスを予約</td>
</tr>
<tr>
<td>Tap here to learn more</td>
<td>Tap here to learn more</td>
<td>詳しい情報はここをタップ</td>
</tr>
<tr>
<td>App Clip Code MenuItem</td>
<td>App Clip Code</td>
<td>App Clipコード</td>
</tr>
</tbody>
</table>
<p>これらは　<a href="https://applelocalization.com" target="_blank" rel="nofollow noopener noreferrer">Apple Localization Terms Glossary</a>から拾ってきたものですが、Appleも命名規則がバラバラですね。</p>
<h2 id="info.plist%E3%81%AE%E6%96%87%E5%AD%97%E5%88%97%E3%82%92%E7%AE%A1%E7%90%86%E3%81%99%E3%82%8B">
<a class="header-anchor-link" href="#info.plist%E3%81%AE%E6%96%87%E5%AD%97%E5%88%97%E3%82%92%E7%AE%A1%E7%90%86%E3%81%99%E3%82%8B" aria-hidden="true"></a> Info.plistの文字列を管理する</h2>
<p>さて、この記事を書いておこうと思った動機は、Info.plistをローカライズする手法がドキュメントとして記載されていないことでした。</p>
<p>公式ドキュメントをどう探しても見つけられず、インターネットを彷徨ってどうにか見つけ出したので、ここに記載しておきます。</p>
<p>Info.plistをローカライズしようと思ったときにまずおもいつくのは、Info.plistファイルを選択してLocalizationを追加することです。</p>
<h3 id="%E3%83%93%E3%83%AB%E3%83%89%E6%88%90%E6%9E%9C%E7%89%A9%E3%81%AB%E3%81%AA%E3%81%A3%E3%81%A6%E3%81%97%E3%81%BE%E3%81%A3%E3%81%9Finfo.plist">
<a class="header-anchor-link" href="#%E3%83%93%E3%83%AB%E3%83%89%E6%88%90%E6%9E%9C%E7%89%A9%E3%81%AB%E3%81%AA%E3%81%A3%E3%81%A6%E3%81%97%E3%81%BE%E3%81%A3%E3%81%9Finfo.plist" aria-hidden="true"></a> ビルド成果物になってしまったInfo.plist</h3>
<p>しかし、 <code>GENERATE_INFOPLIST_FILE</code> が追加されてから、Projectファイルに設定が内包されるようになり、記載された設定からInfo.plistが生成されるようになりました。<br>
Info.plistとして見えるものは、プロジェクトファイルには記載されないカスタムプロパティの集合です。<br>
このファイルを直接編集すると、ビルド時に設定が消えることがあるので、避けるべきです。</p>
<p>試しに、Info.plistをローカライズして日本語や英語を設定しても、まったく認識しません。<br>
というわけで、インターネットを検索すると大体出てくるこの方法は使えません。</p>
<h3 id="infoplist.strings%E3%82%92%E4%BD%BF%E3%81%86%E3%81%A8%E3%81%84%E3%81%86%E7%A4%BA%E5%94%86">
<a class="header-anchor-link" href="#infoplist.strings%E3%82%92%E4%BD%BF%E3%81%86%E3%81%A8%E3%81%84%E3%81%86%E7%A4%BA%E5%94%86" aria-hidden="true"></a> InfoPlist.stringsを使うという示唆</h3>
<p>以下のフォーラムに記載されている通り、ローカライズの設定はExportすることができます。<br>
<a href="https://developer.apple.com/forums/thread/726709" target="_blank" rel="nofollow noopener noreferrer">https://developer.apple.com/forums/thread/726709</a></p>
<blockquote>
<p>You should still be able to manually create an <code>InfoPlist.strings</code> file in your target even if <code>GENERATE_INFOPLIST_FILE</code> is enabled. Alternatively, when you export localization with Xcode by going to <strong>Product &gt; Export Localizations...</strong> Xcode will automatically generate an InfoPlist.strings file in the exported localization catalog from the localizable Info.plist keys in <strong>Targets &gt; Info</strong>.</p>
<p>Posted 6 months ago by  Frameworks Engineer</p>
</blockquote>
<p>とりあえず言われたとおりやってみると、Xcode Localization Catalog (xcloc) 形式で出力され、その中にはInfoPlistのString Catalogが含まれていました。</p>
<p>おや、話が違う…</p>
<p>出力したファイルをこねくりまわしてもうまくいきません。<br>
困り果てた挙句、次の解決策を思い付きます。</p>
<h3 id="infoplist.xcstrings%E3%83%95%E3%82%A1%E3%82%A4%E3%83%AB%E3%82%92%E8%BF%BD%E5%8A%A0%E3%81%99%E3%82%8B">
<a class="header-anchor-link" href="#infoplist.xcstrings%E3%83%95%E3%82%A1%E3%82%A4%E3%83%AB%E3%82%92%E8%BF%BD%E5%8A%A0%E3%81%99%E3%82%8B" aria-hidden="true"></a> InfoPlist.xcstringsファイルを追加する</h3>
<p>InfoPlist.stringsファイルがまだ必要だということは、InfoPlist.xcstringsファイルを認識するのではないかという仮説を立てます。</p>
<p>XcodeからString Catalogを検索し、InfoPlist.xcstringsファイルを追加します。</p>
<p><strong>動いた！！！！！</strong></p>
<p>これで、Info.plistのローカライズができました。</p>
<h2 id="%E3%81%BE%E3%81%A8%E3%82%81">
<a class="header-anchor-link" href="#%E3%81%BE%E3%81%A8%E3%82%81" aria-hidden="true"></a> まとめ</h2>
<ul>
<li>String Catalogはモジュール別・環境別に管理するとよい。</li>
<li>Localizationの命名規則は厳格にしない。</li>
<li>Info.plistをローカライズするには、InfoPlist.xcstringsファイルを追加する。</li>
</ul>
<h2 id="%E5%8F%82%E8%80%83%E8%B3%87%E6%96%99">
<a class="header-anchor-link" href="#%E5%8F%82%E8%80%83%E8%B3%87%E6%96%99" aria-hidden="true"></a> 参考資料</h2>
<ul>
<li><a href="https://developer.apple.com/documentation/Xcode/localizing-and-varying-text-with-a-string-catalog" target="_blank" rel="nofollow noopener noreferrer">https://developer.apple.com/documentation/Xcode/localizing-and-varying-text-with-a-string-catalog</a></li>
<li><a href="https://developer.apple.com/forums/thread/726709" target="_blank" rel="nofollow noopener noreferrer">https://developer.apple.com/forums/thread/726709</a></li>
</ul>


String Catalog の Practice

ビルドターゲット別にString Catalogを管理する

Localizationの命名規則は厳格にしない

ビルド成果物になってしまったInfo.plist

InfoPlist.stringsを使うという示唆

InfoPlist.xcstringsファイルを追加する

Discussion