Playground で delegate メソッドを扱うにはどうする？
delegate が呼ばれるクラスの実装が必要、Playground でクラス定義できるの？
というあたりが疑問だったけど Playground でも普通にクラス定義が可能で delegate も試せるらしい。
下記の前回のコードに
クラス定義とクラス生成、delegate の設定のコードを追加してみる。
これで delegate メソッド内で出力している print の内容がコンソールに順次表示されていく。
クラスを定義する箇所はコードの先頭でなくても良くて、delegate を生成する直前にクラス定義のコードを挟むなんて事も出来る。
Playground を使って簡単なオーディオ再生のテストを行う。
スニペットを実行確認するのにいちいちダミーのアプリを作ったりしなくていいのが Playground の便利なところ。
Playground なので言語は Swift
まずババッと以下のコードを書いてみる。
オーディオファイルを用意したりするのも面倒なので簡単に AVSpeechSynthesizer を使ってテキスト読み上げを行う。
import UIKit import AVFoundation let string = "あのイーハトーヴォのすきとおった風、夏でも底に冷たさをもつ青いそら、うつくしい森で飾られたモーリオ市、郊外のぎらぎらひかる草の波。またそのなかでいっしょになったたくさんのひとたち、ファゼーロとロザーロ、羊飼のミーロや、顔の赤いこどもたち、地主のテーモ、山猫博士のボーガント・テストゥパーゴなど、いまこの暗い巨きな石の建物のなかで考えていると、みんなむかし風のなつかしい青い幻燈のように思われます。" let synthesizer = AVSpeechSynthesizer() let voice = AVSpeechSynthesisVoice(language: "ja-JP") let utterance = AVSpeechUtterance(string: string) utterance.voice = voice synthesizer.speakUtterance(utterance)
読み上げするのが日本語テキストのため AVSpeechSynthesisVoice を使って日本語の声を設定してやる必要があるのに注意。
（Playground では Mac のシステム環境に設定に関わらず en_US の Locale で動作するようで、en_US の声で日本語テキストを読み上げさせてもできない。）
と、このコードを実際に Playground で実行してみると一番最後の行を実行した時にすぐ処理が終了してしまい、音声読み上げがされないという事態に直面する。
ここが今回の肝で、Playground でオーディオ再生をするには XCPlayground module の XCPlaygroundPage クラスを使う。
import XCPlayground XCPlaygroundPage.currentPage.needsIndefiniteExecution = true
これでOK
以下ドキュメントより
Set needsIndefiniteExecution to true to continue execution after the end of top-level code.
最終的な実装コードは以下
これで Playground 上でオーディオ再生（音声読みあげ）を実行確認する事ができる *1
*1:うまく再生されない場合は Playground のウィンドウ下部にある再生停止ボタンを押して処理を再実行させてみると良い
iOS の言語設定の言語一覧画面と同じような画面を作ろうと思って実装してみたら中国語の場合に思い通りにいかなかったメモ
iOS の言語設定の言語一覧画面
cell.textLabel.title には現地語でのローカライズ表記
cell.detailTextLabel.title にはシステム言語でのローカライズ表記で言語が表示されている。
これらをとりあえず見えてる範囲で同じ表記になるよう実装してみる。
ロケールの identifier は以下のように場合によっては言語コード+国コードの形になっている。
コメント部分に記載した様におおよそ設定画面と同じように表示されている。*1
問題は中国語で、まず日本語表記では「簡体中文」「繁体中文」と表記されて欲しいところが「中文」のみが表示されている。
また現地語表記では「香港」が「中華人民共和国香港特別行政区」と表示されている。
試しにコードから取得できる中国語の全リストを洗ってみる。
香港とマカオは 中華人民共和国XXX特別行政区 と付与されるらしい。
これをシステム設定の表記に合わせるには、直接 displayNameForKey: メソッドを呼ばずに1つクッションをかまして特定の NSLocaleIdentifier の時には自前で用意したローカライズ文字列を返す様にしてやる事で対応できる。
また「中文」の表記の部分についても同様に、システム設定の表記に合わせるには特定の NSLocaleLanguageCode の時には自前のローカライズ文字列を返す様にする事で対応できる。
*2
現在一番新しいローカライズの方法が XLIFF を使ったプロジェクト全体のローカライズになる。
この方法は Base Internationalization 方式でのローカライズを想定している。
Xcode のプロジェクトナビゲーターでプロジェクトを選択した状態でメニューから
Editor > Export for Localization... を選択する。
保存ダイアログ
保存すると指定したディレクトリにフォルダが作られて en.xliff が保存される。
XLIFF ファイルの中身は以下
<?xml version="1.0" encoding="UTF-8" standalone="no"?> <xliff xmlns="urn:oasis:names:tc:xliff:document:1.2" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" version="1.2" xsi:schemaLocation="urn:oasis:names:tc:xliff:document:1.2 http://docs.oasis-open.org/xliff/v1.2/os/xliff-core-1.2-strict.xsd"> <file original="Test/Base.lproj/LaunchScreen.storyboard" source-language="en" datatype="plaintext"> <header> <tool tool-id="com.apple.dt.xcode" tool-name="Xcode" tool-version="7.2.1" build-num="7C1002"/> </header> <body/> </file> <file original="Test/Base.lproj/Main.storyboard" source-language="en" datatype="plaintext"> <header> <tool tool-id="com.apple.dt.xcode" tool-name="Xcode" tool-version="7.2.1" build-num="7C1002"/> </header> <body> <trans-unit id="H4E-4z-9nL.text"> <source>Label</source> <note>Class = "UILabel"; text = "Label"; ObjectID = "H4E-4z-9nL";</note> </trans-unit> </body> </file> <file original="Test/Info.plist" source-language="en" datatype="plaintext"> <header> <tool tool-id="com.apple.dt.xcode" tool-name="Xcode" tool-version="7.2.1" build-num="7C1002"/> </header> <body> <trans-unit id="CFBundleName"> <source>$(PRODUCT_NAME)</source> </trans-unit> <trans-unit id="CFBundleShortVersionString"> <source>1.0</source> </trans-unit> </body> </file> <file original="TestTests/Info.plist" source-language="en" datatype="plaintext"> <header> <tool tool-id="com.apple.dt.xcode" tool-name="Xcode" tool-version="7.2.1" build-num="7C1002"/> </header> <body> <trans-unit id="CFBundleName"> <source>$(PRODUCT_NAME)</source> </trans-unit> <trans-unit id="CFBundleShortVersionString"> <source>1.0</source> </trans-unit> </body> </file> <file original="TestUITests/Info.plist" source-language="en" datatype="plaintext"> <header> <tool tool-id="com.apple.dt.xcode" tool-name="Xcode" tool-version="7.2.1" build-num="7C1002"/> </header> <body> <trans-unit id="CFBundleName"> <source>$(PRODUCT_NAME)</source> </trans-unit> <trans-unit id="CFBundleShortVersionString"> <source>1.0</source> </trans-unit> </body> </file> </xliff>
file タグを見ると storyboard ファイル以外に Info.plist といったファイルも全部リストアップされているのが分かる。
Xcode の方で Localize をオンにしているファイルが全てこのようにして XLIFF に含まれる事になる。
またコード上にマクロで以下のように書かれている場合は
NSLocalizedString(@"key", @"comment");
XLIFF の中身に以下が追加される。
<file original="Test/Localizable.strings" source-language="en" datatype="plaintext" target-language="ja"> <header> <tool tool-id="com.apple.dt.xcode" tool-name="Xcode" tool-version="7.2.1" build-num="7C1002"/> </header> <body> <trans-unit id="key"> <source>key</source> <note>comment</note> </trans-unit> </body> </file>
素晴らしい事に、XLIFF を使うと xib, storyboard, ソースファイル、その他テキストファイルの全てで必要な翻訳を一括して管理できる。
ちなみに先ほど作ったファイルの中身は
source-language="en"
となっていてソースの言語にデフォルトの en が入っている。
Xcode のプロジェクトの翻訳ベースがデフォルトでは英語に設定されているのでこのようにソース言語が en の指定になっている。
そして XLIFF の中身で重要なのが以下
<trans-unit id="H4E-4z-9nL.text"> <source>Label</source> <note>Class = "UILabel"; text = "Label"; ObjectID = "H4E-4z-9nL";</note> </trans-unit>
trans-unit の id がキー文字
source が元言語での文字列
note はコメント部分になる
Xcode のプロジェクト設定の Localizations で Japanese を追加してXLIFFの書き出しを行う。
するとダイアログには既存のローカライズ言語を書き出すかどうかのオプションが表示される。
保存すると指定したディレクトリにフォルダが作られて en.xliff と ja.xliff が保存される。
以下は ja.xliff の一部抜粋
<file original="Test/Base.lproj/Main.storyboard" source-language="en" datatype="plaintext" target-language="ja"> <header> <tool tool-id="com.apple.dt.xcode" tool-name="Xcode" tool-version="7.2.1" build-num="7C1002"/> </header> <body> <trans-unit id="H4E-4z-9nL.text"> <source>Label</source> <target>Label</target> <note>Class = "UILabel"; text = "Label"; ObjectID = "H4E-4z-9nL";</note> </trans-unit> </body> </file>
先ほどの source-language="en" の指定に加えて target-language="ja" が追加されている。
そして source の下に target が設定されている。このターゲットの中身を変更してローカライズ作業をしていく。
以下のように target を編集して翻訳を行ったら
<trans-unit id="H4E-4z-9nL.text"> <source>Label</source> <target>ラベル</target> <note>Class = "UILabel"; text = "Label"; ObjectID = "H4E-4z-9nL";</note> </trans-unit>
Xcode のメニューの
Editor > Import Localization... を選択する。
読み込むXLIFFファイルを選択すると読み込み後の結果を確認する画面が表示されて
ファイルを読み込むとそれぞれのローカライズテキストの .strings に結果が反映される。
storyboard を編集し画面にボタンを追加する。
XLIFF を書き出すと中身は以下のようになっている
<trans-unit id="H4E-4z-9nL.text"> <source>Label</source> <target>ラベル</target> <note>Class = "UILabel"; text = "Label"; ObjectID = "H4E-4z-9nL";</note> </trans-unit> <trans-unit id="xCS-6h-0Sr.normalTitle"> <source>Button</source> <note>Class = "UIButton"; normalTitle = "Button"; ObjectID = "xCS-6h-0Sr";</note> </trans-unit>
翻訳済みのものは翻訳済みの内容が反映されていて、新たに追加された要素は target が空になっている。
<target>ボタン</target> のように target を追加して翻訳を行ったら Xcode で編集した XLIFF を読み込む。
すると新しく翻訳を行った要素が適切な .strings に追加されている。
XLIFF を使えば xib, storyboard の編集後の翻訳の更新を簡単に行う事ができる。
また、読み込みの際に未翻訳のテキストを一覧表示してくれる機能があるのでローカライズ漏れがないようにチェックする事もできる。
man のサンプルは以下
xcodebuild -exportLocalizations -project name.xcodeproj -localizationPath path [[-exportLanguage language] ...]
サンプル
書き出し言語毎に -exportLanguage を指定する。
この例では ja.xliff, ru.xliff, de.xliff, it.xliff の4つが作成される。
xcodebuild -exportLocalizations -project <xcode_project_file_path> -localizationPath <directory_path> -exportLanguage ja -exportLanguage ru -exportLanguage de -exportLanguage it
man のサンプルは以下
xcodebuild -importLocalizations -project name.xcodeproj -localizationPath path
サンプル
`xcodebuild -importLocalizations -project <xcode_project_file_path> -localizationPath <translated_xliff_path>
読み込む XLIFF ファイル内で <target> が存在しない未翻訳の部分があると
Incoming translated string is missing (Key: "<Key>") という形でエラーを出してくれる。
XLIFF を使うとプロジェクト全体で必要な翻訳をまとめて行うことが出来る。
UIの追加更新にも対応できる。
コマンドラインベースでの書き出しと読み込みもサポートしていて自動化もできる。
あとは XLIFF をいい感じに扱えるエディタか翻訳を流し込みできるスクリプトやツールがあればローカライズ作業はかなり捗る。
関連
前回
今回は前回の ibtool を使ったローカライズの話の続き
ibtool には incremental localization という機能がある。
コマンドの形式
ibtool --previous-file <old_file> --incremental-file <old_translated_file> --localize-incremental --write <new_translated_file> <current_modified_file>
--previous-file <old_file> には翻訳元の古いファイル（編集前ファイル）を指定
--incremental-file <old_translated_file> には翻訳済みの古いファイル（編集前ファイル）を指定
インクリメンタルの効果を分かりやすくするために文字列の翻訳以外にラベルの位置も変更している。つまり言語毎の xib storyboard ファイルを別個に編集済みの状態。
--write <new_translated_file> には新規に作成する翻訳済みファイルを指定
最後に更新済みの翻訳元ファイル <current_modified_file> を指定
更新内容は以下の通りボタンを追加している
コマンドを実行
ibtool --previous-file Main_old.storyboard --incremental-file Main_ja_old.storyboard --localize-incremental --write Main_new_translated.storyboard Main.storyboard
作成された Main_new_translated.storyboard の中身は以下
翻訳済みの古いファイル（編集前ファイル）に翻訳元ファイルの変更点のみが反映されている。
（この時ボタンの追加以外にラベルの位置も変更していたとすると、それも変更点として扱われ生成後のファイルには新しいラベル位置が反映される。今回はラベルは移動させていないので変更無しと扱われて、翻訳済みの古いファイル（編集前ファイル）のラベル位置がキープされている）
コマンド実行時に --import-strings-file を使って更新分の翻訳も同時に行う事ができる。
genstrings などを使って更新内容分の strings ファイルを用意しておく。
/* Class = "UIButton"; normalTitle = "Button"; ObjectID = "WnY-Sl-xIW"; */ "WnY-Sl-xIW.normalTitle" = "Button";
コマンド
ibtool --previous-file Main_old.storyboard --incremental-file Main_ja_old.storyboard --localize-incremental --write Main_new_translated.storyboard --import-strings-file Main_diff.strings Main.storyboard
作成された Main_new_translated.storyboard を見ると以下のように更新を反映しつつ翻訳も同時に行われている。
ibtool を使った incremental なローカライズを駆使すると言語毎に大きく異なるレイアウトの xib storyboard を使いつつ上手く翻訳を反映していく事が出来そう。ただし作業は複雑。
今は Base Internationalization が主流だし、その仕組みの中で Auto Layout を駆使して言語別のレイアウト変更に対応するのがベターだと思う。
関連
サンプルに使用する Main.storyboard ファイルは ViewController の上に1つ UILabel が載っているだけの状態
storyboard ファイルの中身のXMLは以下
<?xml version="1.0" encoding="UTF-8" standalone="no"?> <document type="com.apple.InterfaceBuilder3.CocoaTouch.Storyboard.XIB" version="3.0" toolsVersion="9532" systemVersion="15D21" targetRuntime="iOS.CocoaTouch" propertyAccessControl="none" useAutolayout="YES" useTraitCollections="YES" initialViewController="BYZ-38-t0r"> <dependencies> <plugIn identifier="com.apple.InterfaceBuilder.IBCocoaTouchPlugin" version="9530"/> </dependencies> <scenes> <!--View Controller--> <scene sceneID="tne-QT-ifu"> <objects> <viewController id="BYZ-38-t0r" customClass="ViewController" sceneMemberID="viewController"> <layoutGuides> <viewControllerLayoutGuide type="top" id="y3c-jy-aDJ"/> <viewControllerLayoutGuide type="bottom" id="wfy-db-euE"/> </layoutGuides> <view key="view" contentMode="scaleToFill" id="8bC-Xf-vdC"> <rect key="frame" x="0.0" y="0.0" width="600" height="600"/> <autoresizingMask key="autoresizingMask" widthSizable="YES" heightSizable="YES"/> <subviews> <label opaque="NO" userInteractionEnabled="NO" contentMode="left" horizontalHuggingPriority="251" verticalHuggingPriority="251" fixedFrame="YES" text="Label" textAlignment="natural" lineBreakMode="tailTruncation" baselineAdjustment="alignBaselines" adjustsFontSizeToFit="NO" translatesAutoresizingMaskIntoConstraints="NO" id="H4E-4z-9nL"> <rect key="frame" x="20" y="20" width="80" height="21"/> <fontDescription key="fontDescription" type="system" pointSize="17"/> <color key="textColor" red="0.0" green="0.0" blue="0.0" alpha="1" colorSpace="calibratedRGB"/> <nil key="highlightedColor"/> </label> </subviews> <color key="backgroundColor" white="1" alpha="1" colorSpace="custom" customColorSpace="calibratedWhite"/> </view> </viewController> <placeholder placeholderIdentifier="IBFirstResponder" id="dkx-z0-nzr" sceneMemberID="firstResponder"/> </objects> <point key="canvasLocation" x="506" y="407"/> </scene> </scenes> </document>
ibtool --generate-strings-file Main.strings Main.storyboard
または
ibtool --export-strings-file Main.strings Main.storyboard
生成された strings
/* Class = "UILabel"; text = "Label"; ObjectID = "H4E-4z-9nL"; */ "H4E-4z-9nL.text" = "Label";
ibtool --export-xliff Main.xliff Main.storyboard
生成された .xliff
<?xml version="1.0" encoding="UTF-8" standalone="no"?> <xliff xmlns="urn:oasis:names:tc:xliff:document:1.2" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:ib="com.apple.InterfaceBuilder3" version="1.2" xsi:schemaLocation="urn:oasis:names:tc:xliff:document:1.2 xliff-core-1.2-transitional.xsd"> <file original="Main.storyboard" datatype="x-com.apple.InterfaceBuilder3.Storyboard.XIB" tool-id="com.apple.ibtool" source-language="en"> <header> <tool tool-id="com.apple.ibtool" tool-name="ibtool" tool-version="9532"></tool> </header> <body> <group ib:member-type="objects"> <group ib:object-id="BYZ-38-t0r" ib:class="UIViewController"> <group ib:object-id="y3c-jy-aDJ" ib:class="NSObject"></group> <group ib:object-id="wfy-db-euE" ib:class="NSObject"></group> <group ib:object-id="8bC-Xf-vdC" ib:class="UIView"> <group ib:object-id="H4E-4z-9nL" ib:class="UILabel"> <trans-unit ib:key-path-category="string" id="H4E-4z-9nL.text" ib:key-path="text"> <source>Label</source> </trans-unit> </group> </group> </group> <group ib:object-id="pQ7-8c-0OJ" ib:class="UIStoryboardEntryPointIndicator"></group> </group> <group ib:member-type="connections"></group> </body> </file> </xliff>
ちなみに
ibtool --export-xliff Main.xliff --source-language ja --target-language ru Main.storyboard
とオプションを付けると xliff の3行目の末尾に以下のように source-language と target-language の指定が入る。
<file original="Main.storyboard" datatype="x-com.apple.InterfaceBuilder3.Storyboard.XIB" tool-id="com.apple.ibtool" source-language="ja" target-language="ru">
storyboard 上で英語以外の言語でパーツを配置しているような場合にこのオプションを使って xliff を書き出すといいのかも知れない。
ibtool は xib や storyboard 自体がローカライズされて複数ファイル存在するケースでのローカライズを想定した機能になっているようで、翻訳したファイルと元の xib, storyboard ファイルを使って言語別の xib, storyboard 作ったり、生成済みの言語別 xib, storyboard ファイルに翻訳済みのファイルの内容を反映する事が出来るらしい。
でも今時は言語別に xib, storybpard ファイルを作らないで strings ファイルを複数作って適応させる Base Internationalization の方法が主流だと思うので ibtool での xib, storyboard ファイルの生成はあまり使わないかも。
翻訳した strings ファイル
/* Class = "UILabel"; text = "Label"; ObjectID = "H4E-4z-9nL"; */ "H4E-4z-9nL.text" = "ラベル";
以下のコマンドで翻訳済み strings を使って翻訳を反映した storyboard ファイルを生成する
--import-strings Main.strings --write Main_ja.storyboard Main.storyboard
source タグの下に target タグを追加して翻訳する
<source>Label</source> <target>ラベル</ラベル>>
<?xml version="1.0" encoding="UTF-8" standalone="no"?> <xliff xmlns="urn:oasis:names:tc:xliff:document:1.2" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:ib="com.apple.InterfaceBuilder3" version="1.2" xsi:schemaLocation="urn:oasis:names:tc:xliff:document:1.2 xliff-core-1.2-transitional.xsd"> <file original="Main.storyboard" datatype="x-com.apple.InterfaceBuilder3.Storyboard.XIB" tool-id="com.apple.ibtool" source-language="en"> <header> <tool tool-id="com.apple.ibtool" tool-name="ibtool" tool-version="9532"></tool> </header> <body> <group ib:member-type="objects"> <group ib:object-id="BYZ-38-t0r" ib:class="UIViewController"> <group ib:object-id="y3c-jy-aDJ" ib:class="NSObject"></group> <group ib:object-id="wfy-db-euE" ib:class="NSObject"></group> <group ib:object-id="8bC-Xf-vdC" ib:class="UIView"> <group ib:object-id="H4E-4z-9nL" ib:class="UILabel"> <trans-unit ib:key-path-category="string" id="H4E-4z-9nL.text" ib:key-path="text"> <source>Label</source> <target>ラベル</target> </trans-unit> </group> </group> </group> <group ib:object-id="h1d-p0-wP2" ib:class="UIStoryboardEntryPointIndicator"></group> </group> <group ib:member-type="connections"></group> </body> </file> </xliff>
以下のコマンドで翻訳済み xliff を使って翻訳を反映した xib, storyboard ファイルを生成する
ibtool --import-xliff Main.xliff --write Main_ja.storyboard Main.storyboard
生成された Main_ja.storyboard を開いてみると翻訳が反映されている。
続き
関連
genstrings は C や Objective-C のソースコードファイルから .strings ファイルを生成するユーティリティで、以下のマクロと関数を Localizable.strings に書き出してくれる。
NSLocalizedString("key", comment); CFCopyLocalizedString("key", comment);
また、以下のマクロと関数の場合はテーブル名の .strings ファイルに書き出してくれる。
NSLocalizedStringFromTable("key", Table, comment); CFCopyLocalizedStringFromTable("key", Table, comment); NSLocalizedStringFromTableInBundle("key", Table, bundle, comment); CFCopyLocalizedStringFromTableInBundle("key", Table, bundle, comment); NSLocalizedStringWithDefaultValue("key", Table, bundle, "value", comment); CFCopyLocalizedStringWithDefaultValue("key", Table, bundle, "value", comment);
例えば .m ファイルに以下のように記述する。
NSLocalizedString(@"key", @"comment");
そしてターミナル等で genstrings <filepath> とコマンドを実行するとカレントディレクトリに Localizable.strings を生成してくれて、そのファイルの中身は以下のようになっている。
/* comment */ "key" = "key";
ちなみに試してみたところソース上でコメントアウトしている部分に関しても抽出してエントリに追加してくれるらしい。
このコマンドはデフォルトではファイルの上書き保存をするだけでマージはしてくれないので、genstrings で Localizable.strings を生成後に strings ファイルを編集してローカライズを行った後、再びこのコマンドを呼ぶと編集内容が全てクリアされてしまう。
genstrings でファイル生成後にソース上に NSLocalizedString が追記された場合は手動でそれを Localizable.strings に反映させてやる必要がある。
-a オプションの説明には append output to the old strings files. と書かれているが、文字通りエントリを追記していくのみで重複のチェックまでは行ってくれない。
例えばソースに以下のように書かれた .m ファイルに対して
NSLocalizedString(@"key", @"comment");
以下のように2回コマンドを実行する。
genstrings <filepath> genstrings <filepath>
するとこのようにエントリが単に追記されるだけになる。
/* comment */ "key" = "key"; /* comment */ "key" = "key";
genstrings コマンド自体はそこそこ使える機能だけど重複チェックや差分のマージなど足りない点もあるので他のコマンドやプログラムと組み合わせて使うと良さそう。
関連
