Safx

フリーの国際化ツールLocalization Suiteを試す

2012-01-31T00:39:00.000+09:00

フリーの国際化ツールLocalization Suiteの存在を最近知ったので、便利かどうか試してみることにしました。

なお、この文書では例としてOS X 10.6.8環境下で、Xcode 4.2のプロジェクト作成時のテンプレートであるMaster Detailed Application (Story board未使用)をLocalization Manager 11.4などを用いてローカライズします。

インストール

Localization SuiteからLocalization Suite.tbzをダウンロードします。

これを解凍し、作成されたフォルダLocalization Suiteをアプリケーションフォルダにでも入れればよいでしょう。

ローカライズ前準備

Xcode 4.2のテンプレートであるMaster Detailed ApplicationのプロジェクトをStory board未使用で作成します。
プロジェクト内の適切な場所で次のようにして.stringsファイルを作成します。

> genstrings -o en.lproj *.m
作成されたLocalization.stringsをプロジェクトに追加してLocalizationにJapaneseを追加します。

ローカライズ手順

Localization Managerを起動します。
[File] → [New] → [From Xcode Project...]を選択します。ローカライズプロジェクトを作成することになるのでプロジェクト名を指定して[Save]します。
読み込むXcodeプロジェクトを選択します。
なぜかLocalization.stringsが取り込まれないので左端中ほどにある [+] をクリック。
そして、Localization.stringsを選択し[Open]。
これでローカライズが必要なファイルがプロジェクトに含まれました。ここから日本語ローカライズを追加しましょう。左下の [+] をクリックします。
ダイアログからjaを[Add]します (テキストボックスに入力すると候補が絞り込まれます)。
その後、右下の[Edit...]をクリックすると.locを作成して、Localizerが起動しますのでJapaneseの欄に翻訳を入力して保存します。

ちなみに、下に元の文字列に近い候補が出たりします。このスクリーンショットではiPhoneとiPadのxibで同じ文字列があるので表示されています。
Localization Managerのファイル(.ldb)とLocalizerのファイル(.loc)は完全に独立しているようなので、書き戻す必要があります。Localization Managerに戻り、[Edit...]の左の[Read In...]をクリックすると.ldbに書き戻されます。
最後に、右下の[Synchronize]をクリックするとローカライズファイルが作成されます。Xcodeで実行して確かめてみましょう。

あとは、変更があるたびに[Rescan]して翻訳追加、[Synchronize]を繰り返します。

長所

Localization Suiteを使う利点は次のものが挙げられます。ほとんどの点は他のローカライズツールに言えることでもあります。

似ているエントリの翻訳から自動翻訳できる (iPhoneとiPadで同じようなxibがあるときに便利)
辞書が使える (今回は利用していませんが、表記揺れを防ぐことができるかも)
追加・削除されたエントリのメンテナンスが自動的に行われる
翻訳対象ファイルが複数あってもまとめて編集できる
各翻訳言語ごとの翻訳状況が一覧で把握できる

問題点

ここまで読んできて、良いことづくめのツールのように見えるかもしれませんが、次のように問題点も多く、私個人はこのツールを利用していません。

編集したLocalizerのファイルが取り込めないときがある
SynchronizeするたびにXcodeプロジェクトのスキーマがおかしくなる
ストーリーボードに対応していない
ヘルプなどの情報が少ない

1.については、最初の1、2回はLocalizerファイルの[Read In...]が使えるのですが、それ以後は次のようなエラーが出て、使えなくなってしまいます。

Old Localizer files without bundles are no longer supported!

Localizerなしでもそれなりに利用できるのですが、自動翻訳などの便利機能が使えなくなるので利用価値が半減してしまいます。

以上、いろいろ問題点を挙げましたが結局のところ、私個人の翻訳対象が1言語/100キー程度ということでわざわざローカライズツールを使うまでもないという結論に逹したというのが大きな理由です。多言語翻訳や大量の翻訳が必要になったときに、また検討してみたいと思います。

まとめ

Localization Suiteの利用法や使用感を紹介しました。ちなみに、ローカライズツールはApp Storeにもいくつかありますので興味を持たれた方は試してみてはいかがでしょうか。

Googleのバグ予測アルゴリズムのMercurial拡張を書いてみました

2012-01-24T00:33:00.001+09:00

昨年のPublickeyで紹介されていたGoogleのバグ予測アルゴリズムの記事を見て、簡単に書けそうな気がしたのでMercurial拡張を書いてみました。

コード

以前の自分の記事なんかを参考に書きました。GitHubに上げておきます。

safx/hg-predict-bug - GitHub

あまりに単純すぎて正しく書けているのか少し不安です。

インストール

ダウンロードしたコードを適当な場所に置き、.hgrcに次のような風に追加します。

[extensions]
bugprediction=/path/to/predictbug.py

使いかた

hg predictでファイル名を指定してください。オプションはありません。

> hg predict *.m | sort -rn 
2.88 DFFileListViewController.m
2.72 DFRestClient.m
2.27 DFDetailViewController.m
2.18 DFImageViewController.m
2.16 DFPasswordViewController.m

2011年の人気記事一覧と統計情報

2012-01-10T22:18:00.000+09:00

あけましておめでとうございます。2011年に本ブログの記事の中で人気のあったページや統計情報をまとめてみました。これらはGoogle Analyticsの情報に基づいています。

2011年にアクセス数の多かったページは次の通りです。相変らず他のアプリケーションやサービスとの連携記事が人気があるようです。ここまで固定だとランキングする意味がない気がしてきました。

ページビュー数の月ごとの遷移は次のようになりました。

年間ページビューのブラウザ別の割合は次のようになりました。Google Analyticsの結果だとIEがほとんどいないことになっています。

年間ページビューのOSバージョン別の割合は次の通りです。年間で見ると10.6とXPが多いですが12月のみのデータだと10.6と10.7が共に28%、XPが13%、7が12%となっており、移行が始まっているのがわかります。

NSLoggerで手軽にログを取る方法について

2011-12-19T00:38:00.000+09:00

NSLoggerはiOSとOS X上で動作するロガーです。簡単に言えばNSLogの代わりとなるようなものですが、次のような特徴を持っています。

ログにレベルやタグを指定できる。
画像をログに出せる。
Mac OS X上で動作する専用ビューワで内容を確認できる。フィルタや検索も可能。
専用ビューワでリモート接続されたアプリのログが表示できる (デフォルトでSSLを利用)。
ログを保存して後で見ることができる。

いろいろ多機能にも関わらず導入は簡単で、使いかたもNSLogと大差ありません。そこで、本記事ではNSLogger 1.0をXcode 4.2に導入する手順と、簡単な利用法を紹介します。

なお、NSLoggerはARCに対応しており、BSDライセンスで提供されています。

ダウンロードとテスト

まずダウンロードしてサンプルアプリをコンパイルして動作確認を行います。

NSLoggerのダウンロードページからNSLogger 1.0.zipをダウンロードします。
ダウンロードしたファイルを解凍し、NSLogger.appを/Applicationsにでも入れておきます。
NSLogger.appを起動しておきます。次のようなステータスウィンドウが表示されるはずです。
ディレクトリExamples内にサンプルがありますのでコンパイルして実行します。
Start Sending Logsをタップします。
ログウィンドウが開き、ログが表示されていきます。

ログビューワの利用法

ログビューワNSLogger.appの利用法を簡単に紹介します。

メインウィンドウを次に示します。右ペインにログが表示されます。ここには時間、スレッド、タグ、ログメッセージ、ログの画像が表示されていきます。

ステータスバーにある f ボタンを押すと各ログメッセージにファイル、行数、関数名などが表示されます。これは後で少しだけ紹介する、末尾に F が付いているログ関数を利用すると表示することができます。

右下は簡易フィルタです。レベル、タグで条件に当てはまるものだけ表示することができます。

左下はフィルタです。次の例は適当なものですが、このように関数名やログレベルを条件にすることができます。

アプリケーションへの導入

自分のアプリへの導入は次のような手順で行います。

Add to your project/iOS - Mac OS X内にある次の3ファイルをプロジェクトに追加します。
- LoggerCommon.h
- LoggerClient.h
- LoggerClient.m
次の2フレームワークを追加します。
- CFNetwork.framework
- SystemConfiguration.framework
後は次の関数を呼ぶだけです。第1引数がタグ、第2引数がログレベル、第3引数以降がフォーマット付き文字列になります。
```
LogMessage(@"network", 0, @"なんかのエラー: %@", url);
```

基本API

NSLoggerの基本APIの一部を次に示します。

void LogMessageCompat(NSString *format, ...);
void LogMessage(NSString *tag, int level, NSString *format, ...);
void LogData(NSString *tag, int level, NSData *data);
void LogImageData(NSString *tag, int level, int width, int height, NSData *data);
void LogMarker(NSString *text);

LogMessageCompatがNSLogと同じようにメッセージを出力するものです。LogImageDataで画像を出力できたりします。詳細や他の関数などはNSLogger APIを参照してください。

NSLogger.appの自動起動

Edit SchemeでRun MyApp.appのPre-actionsにopen -g -a NSLoggerと記述しておくことで、デバッグ時に自動でNSLogger.appが起動するようになります。

マクロの登録

NSLogのときと同様の方法でデバッグビルド時のみログ出力を有効にすることもできます。個人的にはApache Log4jのログレベルを参考にしつつ、末尾に F が付いているログ関数を使って、MyApp-prefix.pchに次のように書いて用いています。

#ifdef DEBUG
    #import "LoggerClient.h"
    #define XLOG_FATAL   0
    #define XLOG_ERROR   1
    #define XLOG_WARNING 2
    #define XLOG_INFO    3
    #define XLOG_DEBUG   4
    #define XLOG_TRACE   5
    #define XLog(tag,level,...)            LogMessageF  (__FILE__,__LINE__,__FUNCTION__,tag,level,__VA_ARGS__)
    #define XLogData(tag,level,w,h,data)   LogDataF     (__FILE__,__LINE__,__FUNCTION__,tag,level,    data)
    #define XLogImage(tag,level,w,h,data)  LogImageDataF(__FILE__,__LINE__,__FUNCTION__,tag,level,w,h,data)
    #define XLogMarker(text)               LogMarker(text)
#else
    #define XLog(...)         do{}while(0)
    #define XLogData(...)     do{}while(0)
    #define XLogImage(...)    do{}while(0)
    #define XLogMarker(...)   do{}while(0)
#endif

まとめ

NSLoggerの導入手順と簡単な利用法を紹介しました。

Xcode4.2でのDropbox SDK v1のサンプルアプリケーションのコンパイルについて

2011-12-14T23:47:00.000+09:00

以前の記事でDropbox SDKのサンプルアプリケーションをコンパイルする方法を紹介しました。

あれから、Dropbox SDK v1がリリースされ、Xcodeも4.2になってサンプルアプリのコンパイル方法が多少変更されていますので、あらためてサンプルのコンパイル手順を簡単に紹介します。

事前にディベロッパキー(App-keyとApp-secret)を取得しておきます。詳細は以前の記事を参照してください。
DropboxのディベロッパサイトからiOS SDKをダウンロードします。
dropbox-ios-sdk-1.0.zipを解凍します。
ディレクトリexamples/DBRouletteからXcodeプロジェクトを開きます。

DBRouletteAppDelegate.mのapplication:didFinishLaunchingWithOptions:にapp-keyとapp-secretをセットします。

-(BOOL)application:(UIApplication*)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {
  // アプリ起動前にいくつかの変数をセット
  NSString* appKey = @"App keyをセット";
  NSString* appSecret = @"App secretをセット";
  NSString* root = kDBRootDropbox; // kDBRootAppFolder か kDBRootDropbox のどちらか

認証方法が変更されているため、Info.plistのURL Schemesを設定します。スキーマ名は「db-」としなければなりません。

そうしていない場合はDropboxSDKが次のようなエラーを報告するかもしれません。

2011-12-02 01:38:03.935 DBRoulette[8405:207] [ERROR] DropboxSDK: unable to link; app isn't registered for correct URL scheme (db-xxxxxxxxxxxxxxx)

なお、カスタムURLスキーム自体については「iOSで独自カスタムURLスキームを設定する方法について」を参照してください。

コンパイルして実行し、Link DropboxをタップするとSafariが起動します。アクセスを許可すると、以前の同様にPhotosフォルダ内にある画像ファイルをランダムに表示します。

まとめ

Xcode4.2でのDropbox SDK v1のサンプルアプリケーションのコンパイルについて紹介しました。

Dropbox API V1が正式版になりました

2011-10-24T00:53:00.002+09:00

10月23日にbetaが取れて正式版のDropbox API V1がアナウンスされましたので、Changelogで述べられている内容を挙げていきます。

ARCを用いているプロジェクトでも利用可能なようにframework化した。そのため、importを次のように変更させる必要がある。
```
#import <DropboxSDK/DropboxSDK.h>
```
新しい認証メソッドを利用するようにした。SDKでのログインやアカウント作成はできなくなったのでDBSession#linkを用いる必要がある。これは公式アプリ(インストールされているなら)、もしくはSafariを起動させて、ユーザにアクセス許可設定をさせるようになっている。
アプリ中に複数ユーザを扱えるようにした。
DBMetadataにrevフィールドを追加した。revisionは非推奨となった。
DBRestClient#loadRevisionsForFile:で過去ファイルのリビジョンのリストを取得できるようになった。ファイルの取得にはloadFile:atRev:intoPath:を、復元にはrestoreFile:toRev:を用いる。
ファイルアップロード方法の更新した。parentRevパラメータがオプションに追加され、アップロード時にサーバ側のバージョンと異なるときはコンフリクトしたと見なして別名のファイルを作成する。DBRestClientDelegateのコールバックにメタデータが追加されており(restClient:uploadedFile:from:metadata:)、コンフリクトした場合はそのファイル名などを確認できる。
DBRestClientに検索のメソッドsearchPath:forKeyword:を追加した。
DBRestClientにファイル共有のメソッドloadSharableLinkForFile:を追加した。
DBRestClientにファイルストリーミングのリンクを作成するメソッドoadStreamableURLForFile:を追加した。
.pngと.gifのサムネイルダウンロードでは.pngが得られるようにした。
バグフィックス

なお、利用にはiOS SDK 4.2以降、Xcode 3.2.5以降が必要とのことです。beta版から大きく違いはなさそうですが正式バージョンがアナウンスされたので対応アプリも増えていくことでしょう。

Dropbox API v1 Betaがアナウンスされました

2011-09-17T23:38:00.000+09:00

9月15日にDropbox API v1 Betaがアナウンスされました。blogで述べられている内容についてiOSに関連のあるおもしろそうなものから順に挙げていきます。

新APIになって、ファイルの共有、ストリーミング、ファイル名検索、リビジョンサポートの機能が追加された。
アップロードオプションが改良されて衝突の解消や不用意な上書きを回避できるようになった。
セキュリティ機能が改善されて、新しいシングルサインオン認証が追加された。
ディベロッパサイトを更新した。
iOS, Android, Python, Ruby, JavaのSDKがアップデートされた。
ウェブアプリがサポートされるようになった。
"app folder"モードのサポートが再び追加された (以前は"sandbox"と呼ばれていた)。

追加されたメソッドの中でよさそうなものは次の通り。uploadFileについては以前のものは非推奨になっているようです。

/* This will load a file as it existed at a given rev */
- (void)loadFile:(NSString *)path atRev:(NSString *)rev intoPath:(NSString *)destPath;

/* Uploads a file that will be named filename to the given path on the server. sourcePath is the
   full path of the file you want to upload. If you are modifying a file, parentRev represents the
   rev of the file before you modified it as returned from the server. If you are uploading a new
   file set parentRev to nil. */
- (void)uploadFile:(NSString *)filename toPath:(NSString *)path withParentRev:(NSString *)parentRev
    fromPath:(NSString *)sourcePath;

/* Loads a list of up to 10 DBMetadata objects representing past revisions of the file at path */
- (void)loadRevisionsForFile:(NSString *)path;

/* Restores a file at path as it existed at the given rev and returns the metadata of the restored
   file after restoration */
- (void)restoreFile:(NSString *)path toRev:(NSString *)rev;

- (void)searchPath:(NSString*)path forKeyword:(NSString*)keyword;

- (void)loadSharableLinkForFile:(NSString *)path;

- (void)loadStreamableURLForFile:(NSString *)path;

リビジョン関連のメソッドが増えているのでリビジョンの判定や処理が楽になりそうです。まだ試していませんが、ストリーミングも楽にできそうですし全体的に使いやすくなっている印象を受けました。正式版が待ちどおしいですね。

QuickDialogを用いて簡単にダイアログを作成・表示する

2011-09-04T18:32:00.001+09:00

QuickDialogはUITableViewを使わないで簡単にダイアログを作成・表示するiOS用のライブラリで、Apacheライセンスで配布されています。

本記事ではQuickDialogの導入と利用の手順を簡単に説明します。なお、自動参照カウント(ARC)を利用しているので利用にはXCode 4.2 betaが必要です。

導入

GitHub for Macをインストールします。

GitHubのQuickDialogへ行き、Clone in Macをクリックします。

GitHub for Macが起動して必要な設定を埋めてくれているので[OK]をクリック。

プロジェクトを作成します。
プロジェクトに先ほどCloneしたQuickDialog内のフォルダquickdialogを追加します。
プロジェクトの[Build Phase]→[Link Binary with Libraries]にMapKit.Frameworkを追加します。

sample/quickdialogexample-Prefix.pchを参考に、Foobar-Prefix.pchに次のようなimportを追加します。

#import "QuickDialogController.h"
#import "QuickDialogController+Loading.h"
#import "QuickDialogStyleProvider.h"
#import "QLabelElement.h"
#import "QBadgeElement.h"
#import "QBooleanElement.h"
#import "QButtonElement.h"
#import "QDateTimeInlineElement.h"
#import "QFloatElement.h"
#import "QMapElement.h"
#import "QRadioElement.h"
#import "QRadioItemElement.h"
#import "QTextElement.h"
#import "QWebElement.h"
#import "QDecimalElement.h"
#import "QSortingSection.h"
#import "QDateTimeElement.h"

利用法

次のように、QRootElementにいろいろ要素を追加していき、最後にこれを用いてQuickDialogControllerを作成します。

QRootElement* root = [[QRootElement alloc] init];
root.grouped = YES;
root.title = @"ダイアログサンプル";

QSection* detailsSection = [[QSection alloc] initWithTitle:@"いろいろサンプル"];     
[root addSection:detailsSection];

QFloatElement* q1 = [[QFloatElement alloc] initWithTitle:@"スライダー" value:1];
[detailsSection addElement:q1];

QDecimalElement* q2 = [[QDecimalElement alloc] initWithTitle:@"10進数" value:0.25];  
[detailsSection addElement:q2];

QBadgeElement* q3 = [[QBadgeElement alloc] initWithTitle:@"バッジ付き" Value:@"Foo"];
q3.badge = @"1";
[detailsSection addElement:q3];

QBooleanElement* q4 = [[QBooleanElement alloc] initWithTitle:@"Boolean" BoolValue:TRUE];
[detailsSection addElement:q4];

QDateTimeInlineElement* q5 = [[QDateTimeInlineElement alloc] initWithTitle:@"時間" date:[NSDate date]];
[detailsSection addElement:q5];

QuickDialogController* qcont = [[QuickDialogController alloc] initWithRoot:root];
UINavigationController* navigation = [[UINavigationController alloc] initWithRootViewController:qcont];
[self presentModalViewController:navigation animated:YES];

これで次のようなビューが作成されます。

Blocksを用いてビューが消える時のコールバックを設定することもできます。

q1.key = @"slider-value";
q2.key = @"decimal-value";
q3.key = @"badge-value";
q4.key = @"bool-value";
q5.key = @"time-value";

qcont.willDisappearCallback = ^() {
    NSMutableDictionary *dict = [[NSMutableDictionary alloc] init];
    [root fetchValueIntoObject:dict];

    NSString *msg = @"Values:";
    for (NSString *aKey in dict){
        msg = [msg stringByAppendingFormat:@"\n- %@: %@", aKey, [dict valueForKey:aKey]];
    }
    UIAlertView *alert = [[UIAlertView alloc] initWithTitle:@"Hello"
                                                message:msg delegate:self cancelButtonTitle:@"OK" otherButtonTitles:nil];
    [alert show];
};

これで、ビューが消えるときに次のようなアラートが表示されます。

テーブルのセルには時間やマップを扱えるものがあります。QuickDialog内にサンプルがありますので試してみるとよいでしょう。

まとめ

QuickDialogの導入と利用について簡単に説明しました。

2011年上半期の人気記事一覧と統計情報

2011-07-02T20:14:00.003+09:00

2011年上半期で本ブログの記事の中で人気のあったページや統計情報をまとめてみました。これらはGoogle AnalyticsとBloggerの統計タブによる情報に基づいています。

2011年上半期の間でアクセス数の多かったページは次の通りです。他のアプリケーションやサービスとの連携記事が人気があるようです。

ページビュー数の月ごとの遷移は次のようになりました。今年に入ってから徐々にアクセスが増えています。

ブログ開設から全期間内でのページビューのブラウザ別の割合は次のようになりました。1%未満のものにはOpera, OneRiot, RockMeltなどがありました。

ブラウザ	割合
Safari	26%
Firefox	24%
Chrome	21%
Apple-PubSub	10%
Internet Explorer	9%
Google Desktop	4%
Mobile	2%

ブログ開設から全期間内でのページビューのOS別の割合は次の通りです。やはりMacが多いです。なお、1%未満のものにはLinux, iPod, Androidなどがありました。

OS	割合
Mac	55%
Windows	36%
iPhone	4%
Other Unix	1%
iPad	1%

今後は、もう少し更新頻度を上げたいと思っておりますので文章的に小さめの記事が増えるかもしれませんが、引き続きプログラム関連の記事をメインにしていくつもりです。

Shibokenを用いたCPython用バインディングの生成について

2011-06-26T22:25:00.006+09:00

ShibokenはC++ライブラリからCPython用バインディングを生成するPySide付属のユーティリティです。本来はPySideプロジェクトが、QtのCPython用バインディングを作るためのツールですが他のC++ライブラリにも適用できます。

そこで、本記事ではShibokenを用いて既存のC++ライブラリのバインディングを作成し、それを用いるまでの手順を簡単に説明します。なお、環境はMac OS XでApple公式のPythonを用いています。

Shibokenの概要

Shibokenは次の3つから構成されています。

API ExtractorはPySideで使われているバインディング生成ライブラリです。ライブラリヘッダを解析した情報と型情報が書かれたXMLファイルの情報を統合して、選択した言語のバインディングを生成します。
Generator RunnerはAPI Extractorのコマンドラインフロントエンドです。
ShibokenはC++ライブラリからCPython用バインディングを生成するGenerator Runnerプラグインです。

また、生成の過程を表したものが上の図です。設定ファイルや型情報ファイルを与えると、ヘッダファイル群を読み込んでPython用のバインディングが作られます。後はこれをコンパイルしてやればPythonで利用できるようになります。

libraw-liteのPythonバインディング作成

LibRaw-LiteはデジタルカメラのRawファイルを扱うためのC++ライブラリです。今回はこのライブラリをPythonで使えるようにします。

まずはライブラリを解凍して、コンパイルします。

> make

次に、libraw.h内のLibRaw::addmaskedborderstobitmap()はヘッダには宣言されていますが、定義が存在しないために削除します。そうしなければ、pythonでimportしたときに次のようなエラーになります。

ImportError: dlopen(./libraw.so, 2): Symbol not found: __ZN6LibRaw28add_masked_borders_to_bitmapEv
  Referenced from: /Users/foobar/src/LibRaw-Lite-0.7.2/python/libraw/libraw.so
  Expected in: flat namespace

そして、shibokenがライブラリのヘッダファイルを簡単に取り込めるようにするため、必要なヘッダをまとめたファイルを作成します。

> ls libraw/*.h | awk '{printf("#include \"%s\"\n", $1)}' > shiboken.h

続いて、型情報を記述するためのファイルshiboken_typesystem.xmlを用意します。これは次のようなファイルになっており、typesystemのpackageでは出力時のpythonのパッケージ名をlibrawを指定しています。また、primitive-typeは基本型を指定し、object-typeはC++の型をターゲット言語(ここではPython)にマッピングさせるようにしています。

> cat shiboken_typesystem.xml
<?xml version="1.0"?>
<typesystem package="libraw">
  <primitive-type name="char"/>
  <primitive-type name="int"/>
  <primitive-type name="float"/>
  <primitive-type name="double"/>
  <primitive-type name="unsigned" />
  <primitive-type name="unsigned int" />
  <primitive-type name="size_t" />
  <object-type name="LibRaw" />
</typesystem>

shiboken_binding.txtはshibokenのコマンドラインオプションを指定するファイルです。先の2ファイルを指定しています。

> cat shiboken_binding.txt
[generator-project]
header-file = shiboken.h
typesystem-file = shiboken_typesystem.xml
output-directory = python
generator-set = /usr/local/lib/generatorrunner/shiboken_generator.dylib
enable-parent-ctor-heuristic
use-isnull-as-nb_nonzero

これでとりあえずバインディングを生成することができます。わからない型を含む関数などは無視されます。

> shiboken --project-file=shiboken_binding.txt
(中略)
Resolving typedefs...                        [WARNING]
Fixing class inheritance...                  [WARNING]
    skipping function 'LibRaw::gamma_lut', unmatched parameter type 'ushort[0x10000]'
    skipping function 'LibRaw::jpeg_thumb', unmatched parameter type 'FILE*'
    skipping function 'LibRaw::write_ppm_tiff', unmatched parameter type 'FILE*'
    skipping function 'LibRaw::dcraw_make_mem_thumb', unmatched return type 'libraw_processed_image_t*'
(中略)
Detecting inconsistencies in class model...  [OK]
Detecting inconsistencies in typesystem...   [OK]

Done, 29 warnings (0 known issues)
(後略)

> cd python/libraw
> ls   
libraw_abstract_datastream_wrapper.cpp    libraw_output_params_t_wrapper.h
libraw_abstract_datastream_wrapper.h    libraw_processed_image_t_wrapper.cpp
libraw_data_t_wrapper.cpp        libraw_processed_image_t_wrapper.h
libraw_data_t_wrapper.h            libraw_python.h
libraw_module_wrapper.cpp        libraw_wrapper.cpp
libraw_output_params_t_wrapper.cpp    libraw_wrapper.h

この出力されたソースを用いてPython拡張のための共有オブジェクトを作成します。

> g++ -fPIC -I/System/Library/Frameworks/Python.framework/Headers \
    -I/usr/local/include/shiboken -I../../libraw -bundle \
    -o libraw.so *.cpp -undefined dynamic_lookup \
    /usr/local/lib/libshiboken-python2.7.1.0.2.dylib ../../lib/libraw-lite.a

これで、Libraw-Liteの一部の機能は利用できるようになります。次の例ではRawファイルを読み込んでその中に含まれるサムネイルを取り出しています。

> file P5039940.ORF
P5039940.ORF: data
> python
Python 2.6.6 (r266:84292, Jan 22 2011, 22:32:56) 
[GCC 4.2.1 (Apple Inc. build 5664)] on darwin
Type "help", "copyright", "credits" or "license" for more information.
>>> import libraw
>>> dir(libraw)
['LibRaw', '_Cpp_Api', '__doc__', '__file__', '__name__', '__package__']
>>> r=libraw.LibRaw()
>>> dir(r)
['FC', '__class__', '__delattr__', '__dict__', '__doc__', '__format__', '__getattribute__', '__hash__', 
'__init__', '__new__', '__reduce__', '__reduce_ex__', '__repr__', '__setattr__', '__sizeof__', '__str__', 
'__subclasshook__', 'adjust_sizes_info_only', 'cameraCount', 'cameraList', 'dcraw_document_mode_processing', 
'dcraw_ppm_tiff_writer', 'dcraw_process', 'dcraw_thumb_writer', 'fc', 'open_buffer', 'open_file', 
'recycle', 'strerror', 'unpack', 'unpack_function_name', 'unpack_thumb', 'verbose', 'version', 'versionNumber']
>>> r.version()
'0.7.2-Release(Lite)'
>>> r.open_file('P5039940.ORF')
0
>>> r.unpack_thumb()
0
>>> r.dcraw_thumb_writer('thumb.jpg')
0
>>> exit()
> file thumb.jpg 
thumb.jpg:    JPEG image data, EXIF standard

実際には、このままでは実行すると落ちてしまう (LibRaw.cameraListなど) 場合も多く、修正が必要です。

ただし、Shibokenでは、型システムファイル(shiboken_typesystem.xml)にそれらのソースの修正を書くことができるため、メンテナンス性も高くなっています。

なお、コード修正の方法についてはShibokenのマニュアルやShibokenソース内にあるサンプルファイルなどを参照してください。

まとめ

Shibokenを用いて既存のC++ライブラリのバインディングを作成して利用する方法を説明しました。

CinderによるiPhoneアプリケーションの作成について

2011-05-22T15:48:00.007+09:00

CinderはThe Barbarian Groupが開発しているC++ライブラリで、Processing.orgのように画像、音声、動画、ネットワークなどを手軽に扱うことができます。CinderはMac OS X, Windows, iPad, iPhoneをサポートしており、修正BSDライセンスによって提供されています。

そこで、本記事ではCinderのiPhone向けのアプリケーションを作成する手順について簡単に説明します。環境はXcode 3.2.5, iOS SDK 4.2, Cinder 0.8.2です。

プロジェクトの作成と実行

CinderのDownloadページでCinder for Mac OS XをクリックしてZipファイルをダウンロードし、そのファイルを解凍すればよいです。

ダウンロードしたファイル内にコンパイル済みのライブラリファイルが含まれているのでコンパイルする必要はありません。

プロジェクトの作成と実行

次の手順でCinderのXcodeプロジェクトを作成します。

toolsにあるTinderBoxを実行する。

Cinderのトップレベルディレクトリを選択して[Open]をクリックする。

プロジェクトの名前と場所を指定する。ここではプロジェクト名はcinder_sampleにした。

[Target]を[Cocoa Touch]にして[Create]をクリックする。

Finderが開くのでディレクトリxcodeにあるxcodeのプロジェクトを開く。

(必要に応じて) プロジェクトの設定を変更する。手元の環境では、TinderBoxによってBase SDKの指定がiOS 4.1となっているプロジェクトが生成されましたが、Xcode内にはiOS 4.0とiOS 4.2のSDKしか入っていないためBase SDKをiOS 4.2に変更しました。

これで、[Build and Run]を行うと、シミュレータが起動して次のような立方体が回転するプログラムが実行されます。

なお、実機に落とすときはInfo.plistのBundle Identifierを適切なものに変更してください。

Cinderソース概要

生成されたソースファイルであるiphone_sampleApp.cppを見てみましょう。その中にクラスAppCocoaTouchを継承したクラスcinder_sampleAppが存在します。

class cinder_sampleApp : public AppCocoaTouch {
  public:
    virtual void    setup();
    virtual void    resize( ResizeEvent event );
    virtual void    update();
    virtual void    draw();
    virtual void    mouseDown( MouseEvent event );

    Matrix44f   mCubeRotation;
    gl::Texture mTex;
    CameraPersp mCam;
};

このクラス内には次の3つのメソッドが含まれています。

setup()はプログラム開始時に一度だけ呼ばれる。ここでプログラム中にある変数の初期化を行う。
update()はそれらの変数を変更する。
draw()はウィンドウへの描画を行う。

Cinderのプログラムが起動したら、まずsetupが呼ばれてそれ以後はupdateとdrawが繰り返し呼ばれます。サンプルプログラムでは、setupで立方体のテクスチャを作成し、updateで立方体を回転させ、drawで立方体を描画させています。

例えば、次のようにdrawを変更した場合には、背景色が変化しながら6個の立方体が出たり引っこんだりするようになります。

void cinder_sampleApp::draw()
{
    float v = sin( getElapsedSeconds() );
    gl::clear( Color( 0.2f + red, 0.2f, v * 0.7f + 0.3f ) );

    gl::enable( GL_TEXTURE_2D );
    gl::enableDepthRead();

    mTex.bind();
    gl::setMatrices( mCam );
    glPushMatrix();
        gl::multModelView( mCubeRotation );
        gl::drawCube( Vec3f(    -v,  0.0f,  0.0f ), Vec3f( 1.0f, 1.0f, 1.0f ) );
        gl::drawCube( Vec3f(    +v,  0.0f,  0.0f ), Vec3f( 1.0f, 1.0f, 1.0f ) );
        gl::drawCube( Vec3f(  0.0f,    -v,  0.0f ), Vec3f( 1.0f, 1.0f, 1.0f ) );
        gl::drawCube( Vec3f(  0.0f,    +v,  0.0f ), Vec3f( 1.0f, 1.0f, 1.0f ) );
        gl::drawCube( Vec3f(  0.0f,  0.0f,    -v ), Vec3f( 1.0f, 1.0f, 1.0f ) );
        gl::drawCube( Vec3f(  0.0f,  0.0f,    +v ), Vec3f( 1.0f, 1.0f, 1.0f ) );
    glPopMatrix();
}

画像ファイルの利用

画像ファイルをテクスチャとして利用するのは非常に簡単です。まず、いつも通りXcode上のResourcesに画像を追加しておきます。そして、それをloadResourceとloadImageによって読み込んでサーフェスを作成すればよいだけです。そのときのsetupのコードを次に示します。

#include "cinder/ImageIo.h"
void cinder_sampleApp::setup()
{
    mCubeRotation.setToIdentity();

    Surface sur( loadImage( loadResource( "texture.png" ) ) );
    mTex = gl::Texture( sur );
}

マルチタッチの利用

マルチタッチも可能で、次のようなコードで使うことができます (クラスcinder_sampleAppへ宣言追加も必要です)。

void cinder_sampleApp::touchesBegan( TouchEvent event )
{
    for ( int i = 0; i < event.getTouches().size(); ++i )
        console() << "Touch #" << i << " @ " << event.getTouches()[i].getPos() << std::endl;
}

これによって、タッチしたときにデバッグコンソールに次のように表示するようになります。

Touch #0 @ [281,317]
Touch #1 @ [39,163]

まとめ

CinderのiPhone向けのアプリケーションを作成する手順について簡単に説明しました。チュートリアルやサンプルプロジェクトもZipファイル内にたくさんあるので参考になると思います。デバイス向き検出ができなかったりとiPhoneとiPadへの対応はまだ十分ではないという印象を受けましたが、今後の発展が期待できるライブラリであると思います。

Mercurial拡張の書きかたについて

2011-05-01T23:37:00.005+09:00

MercurialがPythonで書かれていることもあり、単純なMercurial拡張を自分で書くのは意外と簡単です。この記事では簡単なMercurial拡張を作成してhgコマンドから呼び出す方法を簡単に説明します。

なお、Mercurialの内部APIを用いた場合には、そのコードはMercurialのライセンス (GPL) に従うことになるので注意してください。

スクリプトとしての起動

Mercurial拡張は単にMercurial APIを利用しているPythonのモジュールです。その出発点は次のようなスクリプトになります。

#!/usr/bin/python
# -*- coding: utf-8 -*-

from mercurial import ui, hg

def print_users(ui, repo, **opts):
    print repo

if __name__ == '__main__':
    ui   = ui.ui()
    repo = hg.repository(ui, ".") # カレントディレクトリのrepoオブジェクト
    print_users(ui, repo)

uiはユーザとのインタラクションを行うためのオブジェクトですが、単純な拡張であれば不要であるためここで説明しません。repoはリポジトリオブジェクトで、ここではカレントディレクトリのリポジトリを取得しています。また、後で拡張として呼び出せるようにするため、関数print_usersは3引数を取るようにしています。なお、optsはオプションのためのもので、この記事では使用しないため詳細は省略します。

このスクリプトを作業ディレクトリで実行すると次のようになります。

> python ~/src/print_users.py
<hgext.mq.mqrepo object at 0x101779890>

hgからの実行

先ほどのスクリプトをhgから実行できるようにしてみましょう。まず、.hgrc内のextensionsセクションに次のような行を追加します。

[extensions]
print_users=~/src/print_users.py

次に、先ほどのスクリプトの末尾に次のようにディクショナリcmdtableを書きます。これはコマンドラインオプションを解釈して適切に処理させるためのテーブルです。

cmdtable = {
    # "コマンド名": (関数, オプション, ヘルプ)
    "users":     (print_users, [], "print users")
}

これによって拡張をhgから呼び出すことができます。

> hg users 
<hgext.mq.mqrepo object at 0x1011db510>

コードの追加

さらに、関数print_usersを書き替えて、関数get_user_countを追加します。この関数はリビジョン0からtipまでの各リビジョンのユーザを調べていきます。関数print_usersではこれを利用して、コミット回数の多いユーザのトップ10を表示させます。

def print_users(ui, repo, **opts):
    user_count = get_user_count(repo)
    l = sorted(user_count, lambda i,j:user_count[j] - user_count[i])[:10]
    for i in l:
        print user_count[i], i

def get_user_count(repo):
    tip     = repo.changectx("tip")
    tip_rev = tip.rev()

    user_count = {}
    for i in range(tip_rev):
        ctx = repo.changectx(i)
        user = ctx.user()
        if user_count.has_key(user):
            user_count[user] += 1
        else:
            user_count[user]  = 1

    return user_count;

例えば、ある時点におけるMercurialリポジトリ上で実行すると次のような結果となりました (メールアドレス部は変更しています)。

> hg users
2324 Matt Mackall <mpm@example.com>
965 Thomas Arendsen Hein <thomas@example.com>
917 Benoit Boissinot <benoit.boissinot@example.com>
913 Martin Geisler <mg@example.com>
862 Patrick Mezard <pmezard@example.com>
768 mpm@example.com
617 Brendan Cully <brendan@example.com>
533 Alexis S. L. Carvalho <alexis@example.com>
498 Dirkjan Ochtman <dirkjan@example.com>
476 Vadim Gelfer <vadim.gelfer@example.com>

debugshell

拡張を書くときに便利なインタラクティブな環境としてdebugshell拡張が用意されています。これは、Mac portsの場合には.hgrcのextensionsセクションにdebugshell=/opt/local/share/mercurial/contrib/debugshell.pyと書くだけでよいです。

> hg debugshell
loaded repo : /Users/foobar/src/mysample
using source: /opt/local/Library/Frameworks/Python.framework/Versions/2.6/lib/python2.6/site-packages/mercurial
>>> repo
<hgext.mq.mqrepo object at 0x1011db5d0>
>>> cl
<mercurial.changelog.changelog object at 0x1011fa5d0>
>>> mercurial
<proxied module 'mercurial'>

まとめ

Mercurial拡張を作成する方法を説明しました。

Mercurialのリポジトリ内のデータについて

2011-03-26T19:07:00.008+09:00

Mercurialではリポジトリであるディレクトリ.hgの中に管理している全ファイルの履歴に関するデータが入っています。それがどのように保存されているのかを例を用いて簡単に紹介します。

概要

ディレクトリ.hg内にはいろいろファイルが含まれています。ほとんどのデータは.hg/store内にあり、その中にチェンジセット、マニフェスト、ファイルの履歴が含まれています。

changelog
- ファイル: .hg/store/00changelog.iと.hg/store/00changelog.d
- マニフェストIDとコミット者、コメント、変更したファイル一覧などの各チェンジセットの情報を持ちます。
manifest
- ファイル: .hg/store/00manifest.iと.hg/store/00manifest.d
- リポジトリで管理しているファイルの一覧です。
filelog
- ファイル: .hg/store/data内にある、.iと.dファイル。
- 1ファイルの履歴です。
- ある文字列をエンコードする方法に従ってパスをエンコードする。

例

次のようなリビジョングラフを持つリポジトリがあるとします。

この時点でのリポジトリの.hg/store内のファイルは次のようなものが含まれています。

チェンジログ 00changelog.i
マニフェスト 00manifest.i
ファイルログ data/readme.i
ファイルログ data/hello.c.i

まずチェンジログの情報を見てみましょう。これには、hg debugindexを用います。

> hg debugindex .hg/store/00changelog.i
   rev    offset  length   base linkrev nodeid       p1           p2
     0         0      93      0       0 534511281f45 000000000000 000000000000
     1        93     101      0       1 6292b118cc08 534511281f45 000000000000
     2       194      96      2       2 027b81ff6ac3 6292b118cc08 000000000000
     3       290      95      3       3 199d45709b22 534511281f45 000000000000
     4       385      90      4       4 f0df7b3fe2df 027b81ff6ac3 199d45709b22

この中で、revはリビジョン番号、nodeidはチェンジセットIDとなっています。そして、p1とp2は親のチェンジセットIDであり、rev 4では2つの親を持っており、全体としては上のリビジョングラフと同じ関係になっていることがわかります。

特定のリビジョンにおける、より詳しい情報を見るにはhg debugdataを用います。チェンジセットのリビジョン4の出力結果は次のようになります。出力結果は1行目からマニフェストID、メールアドレス、日時、変更のあったファイル(空行まで)、コミットメッセージになっています。

> hg debugdata .hg/store/00changelog.i 4
b6323997ef85fb93cb3dc645ae6ca7e2b8161cea
foobar@example.com
1300547811 -32400
hello.c

Merge

続いてマニフェストの情報を見ます。hg debugindexでチェンジログのときと同じような情報を見ることができます。マニフェストでもリビジョンごとにチェンジログとは異なるIDが振られていますが、リビジョンの親子関係が同じであることがわかります。また、先ほどチェンジセットのリビジョン4の情報にあったマニフェストIDのb6323997ef85がマニフェストのrev 4に対応していることがわかるでしょう。

> hg debugindex .hg/store/00manifest.i 
   rev    offset  length   base linkrev nodeid       p1           p2
     0         0      50      0       0 47eb6be8d357 000000000000 000000000000
     1        50      50      1       1 2f3afa09f4f8 47eb6be8d357 000000000000
     2       100      60      1       2 b0e834b727ad 2f3afa09f4f8 000000000000
     3       160      50      3       3 08b4087d6b4f 47eb6be8d357 000000000000
     4       210      96      3       4 b6323997ef85 b0e834b727ad 08b4087d6b4f

マニフェストの詳細情報を見るのにはhg debugindexを利用してもよいですが、hg --debug manifestのほうがより詳細な情報を見ることができます。次の例ではマニフェストのrev 4に含まれるファイルの情報を出力しています。

> hg --debug manifest 4
94e1e9804aa05b8a7874c4316c7eec59e87c9c36 644   README
600deb1ed703b78db22e5020acb13242430c5543 644   hello.c

ファイルhello.cに対するファイルログhello.c.iの概要は次の通りです。マニフェストに出現している600deb1ed703がrev 3にあるのがわかります。

> hg debugindex .hg/store/data/hello.c.i 
   rev    offset  length   base linkrev nodeid       p1           p2
     0         0      71      0       0 edb191afdd3d 000000000000 000000000000
     1        71      43      0       1 ec1d99d13de0 edb191afdd3d 000000000000
     2       114      26      0       3 8e675a97a9fe edb191afdd3d 000000000000
     3       140      43      0       4 600deb1ed703 ec1d99d13de0 8e675a97a9fe

hg debugdataを用いると指定したリビジョンのデータを取得することができます。

> hg debugdata .hg/store/data/hello.c.i 3
#include <stdio.h>

int main(int argc, char** argv) {
    printf("Hello, world!\n");
    return 1;
}

ファイルREADMEは追加したとき以外の変更がないのでリビジョン0のままです。

> hg debugindex .hg/store/data/_r_e_a_d_m_e.i
   rev    offset  length   base linkrev nodeid       p1           p2
     0         0      22      0       2 94e1e9804aa0 000000000000 000000000000

これらのファイルのリビジョン同士の関係を示したものが次の図です。黒矢印はファイルのリビジョン関係を、赤点線の矢印は(チェンジセットのリビジョン4における)参照可能な関係を示しています。hg updateなどではこの矢印を辿ることで特定リビジョンのファイルを取得しています。

Revlog形式

チェンジログ、マニフェスト、ファイルログはファイルの履歴を保存するためにRevlogと呼ばれるMercurial独自のフォーマットで記録されています。Revlogには次のような特徴があります。

データファイルとインデックスファイルに分かれており、それぞれ拡張子 .d と .i を持つ
データとインデックスはファイル末尾に追加されていく (トランザクション化が容易になる)
直前のバージョンからのバイナリでの差分 (difflibで用いられているRatcliff-Obershelpアルゴリズム) によるデータを圧縮したものを持つ。ただし、再構築に必要なデータ量がしきい値を超えたときは差分ではなくフルデータを取るようにする (リビジョン数によらない)
小さいサイズのファイルの場合.dはなく.iの中に.dのデータが含まれている (.iと.dが交互に出現する; データインタリーブ)

コマンドラインdebugindexでインデックスファイルを、debugdataでデータファイルを見ることができます。これらをRevlogのファイル構造のサンプルが次の図です。例えば、リビジョン12のデータを取得するためには、まずベースとなるリビジョン10からフルデータを取得し、そこからリビジョン11と12の差分データを順番に適用することで得られます。

なお、Revlogのインデックスファイルは次のようなフォーマットになっています。

6 bytes: 差分データ開始位置のオフセット
2 bytes: フラグ
4 bytes: 差分データの圧縮サイズ
4 bytes: オリジナルデータのサイズ
4 bytes: ベースリビジョン: どのリビジョンのフルデータから差分を適用すればよいか
4 bytes: リンクリビジョン: どのチェンジセットに対するデータなのかをチェンジセットのリビジョン番号で示す
4 bytes: 親1のリビジョン
4 bytes: 親2のリビジョン
32 bytes: ノードID: ユニーク識別子で改竄検知などにも用いられる (データと親ノードIDによるハッシュ値)

これを見ればわかる通り、各ファイルはそれぞれリビジョンごとにユニークなノードIDを持ち、最大2つまでの親を取ることができます。Mercurialではマージ操作では2つ以上のファイルからマージされることはないため、このようにシンプルなデータ構造となっています。

また、これによって各リビジョンごとのインデックスのサイズが固定長になるため、あるリビジョンのインデックスを得るためには決まった位置へファイルシークするだけで済みます (データインタリーブしている場合を除く)。

まとめ

Mercurialのリポジトリ内のデータについて簡単に紹介しました。

NSObjectを継承しないクラスをランタイムAPIで作成する方法について

2011-02-28T01:11:00.009+09:00

Objective-CにはランタイムAPIが用意されており、これを利用することでObjective-Cのクラスやオブジェクトを作成や操作を実行時に行うことができます。

本記事では新しいクラスをObjective-CランタイムAPIで作成して利用してみます。このとき、新しいクラスをNSObjectから継承せずに作成してみることで、どのような問題が起こるのかを述べます。

Objective-CランタイムAPIについてはAppleのリファレンス「Objective-C Runtime Reference」を参照してください。また、Objective-Cランタイムシステムに興味のある方は、マイコミジャーナルのコラム「ダイナミックObjective-C」の14〜31回を参照してください。

Objective-CランタイムAPIによるメソッドの列挙

まず、最初はObjective-CランタイムAPIを利用してクラスのメソッドを列挙してみましょう。ちょっと適当ですが次のような関数を作成してみます。

void listMethods(id cls) {
    unsigned int method_count = 0;
    Method* m = class_copyMethodList(cls, &method_count);
    for (unsigned int i = 0; i < method_count; ++i) {
        SEL sel = method_getName(m[i]);
        const char* enc = method_getTypeEncoding(m[i]);
        char ret[256];
        method_getReturnType(m[i], ret, sizeof(ret) - 1);

        NSLog(@"method: %s (%s)", (char*)sel, enc);
    }
    free(m);
}

これを利用してNSObjectのメソッドを一覧を表示してみましょう。

listMethods([NSObject class]);

結果は次のようになります (長いのでほんの一部だけ抜粋)。

    :
method: superclass (#8@0:4)
method: hash (I8@0:4)
method: isEqual: (c12@0:4@8)
method: init (@8@0:4)
method: description (@8@0:4)
method: isKindOfClass: (c12@0:4#8)
method: dealloc (v8@0:4)
    :

括弧内の文字列はタイプエンコーディングと呼ばれているもので、メソッドの引数や戻り値を示しているもので、例えば「@」はオブジェクト、「:」はセレクタを示しています (詳細は「Objective-C Runtime Programming Guide: Type Encodings」を参照してください)。メソッドdescriptionのタイプエンコーディングの数値を取り除いたものは「@@:」になり、これはオブジェクトとセレクタを引数に取り、オブジェクトを戻り値にするということを示しています。

Objective-CランタイムAPIによるメソッドの列挙

ランタイムでObjective-Cのクラスを作成する手順は次のようになります。

objc_allocateClassPairでクラスとメタクラスをアロケートします。
classaddMethodやclassaddIvarなどでメソッドなどを追加します。インスタンスメソッドとインスタンス変数はクラスに追加し、クラスメソッドはメタクラスに追加します。なお、メタクラスは次のようにして取得することができます。 Class metaClass = object_getClass(newClass);
objc_registerClassPairで登録することでlookup可能になります。

それでは実際にクラスを作成してみましょう。次のコードではメソッドdescriptionを持つだけの単純なクラスMyObjectを作成しています。なお、第1引数と第2引数はObjective-Cではselfと_cmdで参照できる隠し引数となっています。

NSString* MyObject_description(id self, SEL _cmd) {
     return @"MyObject_description is called.";
}

void MyObject_createClass() {
    Class cls = objc_allocateClassPair(nil, "MyObject", 0);
    class_addMethod(cls, @selector(description), (IMP) &MyObject_description, "@@:");
    objc_registerClassPair(cls);
}

これで、クラスMyObjectのインスタンスを作成して、メソッドdescriptionを実行することができます。

MyObject_createClass();

Class cls = objc_getClass("MyObject");
id obj = class_createInstance(cls, 0);
NSLog(@"%@", obj);

しかし、実行してみると、NSLogの行で落ちてしまいます。運がよければ、次のメッセージが表示されるでしょう。

*** NSInvocation: warning: object 0x9904960 of class 'MyObject' does not implement methodSignatureForSelector: -- trouble ahead
*** NSInvocation: warning: object 0x9904960 of class 'MyObject' does not implement doesNotRecognizeSelector: -- abort

メソッドmethodSignatureForSelector:は前回の記事「メソッドforwardInvocation:を利用したメッセージ転送について」でも少し出てきましたが、対処できないメッセージを受け取ったときに呼ばれます。このメソッドが呼ぶことができなかったため、メソッドdoesNotRecognizeSelector:を呼ぼうとし、これもないためにAbortしてしまっています。

(メソッドmethodSignatureForSelector:を作成してトレースしてみればわかりますが) なぜ、メソッドmethodSignatureForSelector:が呼ばれている理由は、クラスメソッドinitializeがないためです。クラスメソッドinitializeはクラス使用の初回時に1回だけ呼ばれるメソッドで、必ず実装する必要があります。

また、これ以外にもメソッドdescriptionを実行するにはもう少し作業が必要です。実は、日付などのロケールを考慮する必要のあるクラスには、メソッドdescriptionのロケール版であるdescriptionWithLocale:があり、NSLogを用いた場合にはdescriptionを呼ぶ前にdescriptionWithLocale:があるかどうかをチェックするためにrespondsToSelector:が呼ばれてしまいます。

これらを踏まえたコードは次のようになります。実行すると、メソッドdescriptionWithLocale:のために MyObject_respondsToSelectorが呼ばれますが、その場合はFALSEが返されるようにしています。なお、Cocoaの実装ではSEL型が文字列であるため、それを利用しています。

void MyObject_initialize(id self, SEL _cmd) {
     return;
}

BOOL MyObject_respondsToSelector(id self, SEL _cmd, SEL sel) {
    if (strcmp((char*) sel, "description") == 0) return TRUE;
    return FALSE;
}

void MyObject_createClass() {
    Class cls = objc_allocateClassPair(nil, "MyObject", 0);
    class_addMethod(cls, @selector(description), (IMP) &MyObject_description, "@@:");
    class_addMethod(cls, @selector(respondsToSelector:), (IMP) &MyObject_respondsToSelector, "b@::");

    Class meta = object_getClass(cls);
    class_addMethod(meta, @selector(initialize), (IMP) &MyObject_initialize, "v@:");
    objc_registerClassPair(cls);
}

これでめでたく表示することができました。 NSObjectから継承した場合はこのあたりの面倒さを回避することができます。

method: respondsToSelector: (b@::)
method: description (@@:)
MyObject_description is called.

methodSignatureForSelector:とforwardInvocation:を利用したメッセージ処理

前回の記事「メソッドforwardInvocation:を利用したメッセージ転送について
」のようにmethodSignatureForSelector:forwardInvocation:とを組み合わせることで適当に出されたメッセージに対して処理を行うことができます。

次のコードでは、まずメソッドMyObjectmethodSignatureForSelectorでセレクタに応じた適当なタイプエンコーディングをでっちあげています。それによって、メソッドMyObjectforwardInvocationでのNSInvocationの値が代わりますので、今回は引数によって適当な処理をして、戻り値をNSInvocationにセットしています。

NSMethodSignature* MyObject_methodSignatureForSelector(id self, SEL _cmd, SEL sel) {
    NSString* enc = @"@@:";
    for (char* i = (char*) sel; *i != 0; ++i) {
        if (*i == ':') {
            enc = [enc stringByAppendingString:@"@"];   
        }
    }
     return [NSMethodSignature signatureWithObjCTypes:[enc UTF8String]];
}

void MyObject_forwardInvocation(id self, SEL _cmd, NSInvocation* inv) {
    SEL sel = [inv selector];

    NSMethodSignature* sig = [inv methodSignature];
    NSUInteger         num = [sig numberOfArguments];

    NSLog(@"MyObject_forwardInvocation: %s (%d args)", sel, num);

    id ret = nil;

    if (num == 2) {
        ret = [NSString stringWithFormat:@"%s", sel];
    } else if (num == 3) {
        NSString* arg1;
        [inv getArgument:&arg1 atIndex:2];
        ret = [NSString stringWithFormat:@"%@%s", arg1, sel];
    } else if (num == 4) {
        int arg1;
        int arg2;
        [inv getArgument:&arg1 atIndex:2];
        [inv getArgument:&arg2 atIndex:3];
        ret = [NSNumber numberWithInt:arg1 * arg2];
    }
    [inv setReturnValue:&ret];
}

上のコードの利用例は次のようになります。

NSLog(@"%@", [obj foobar]);
NSLog(@"%@", [obj baz:@"some-string"]);
NSLog(@"%@", [obj x:12 y:3]);

結果は次のようになります。

MyObject_forwardInvocation: foobar (2 args)
foobar
MyObject_forwardInvocation: baz: (3 args)
some-stringbaz:
MyObject_forwardInvocation: x:y: (4 args)

まとめ

NSObjectを継承しないで新しいクラスをObjective-CランタイムAPIで作成する方法について述べました。

メソッドforwardInvocation:を利用したメッセージ転送について

2011-02-06T22:01:00.019+09:00

Objective-Cでは、定義していないメッセージをオブジェクトへ送信すると、通常は未定義なセレクタとして例外NSInvalidArgumentExceptionが発生します。しかし、クラスにメソッドforwardInvocation:を定義しておくと、エラー報告前にこのメソッドが呼ばれるようになります。そのため、メソッドforwardInvocation:の実装次第で、メッセージがなかったときのデフォルトの挙動を定義したり、エラー回避などを行えるようになります。

この記事では、forwardInvocation:を利用したメッセージ転送や多重継承について述べます。なお、詳細については、Appleの「Objective-C Runtime Programming Guide」の「Message Forwarding」の章や、サンプルコード「ForwardInvocation」を参照してください。

メッセージ転送の例

メソッドforwardInvocation:は名前の通りメッセージを他のオブジェクトに転送するのが一般的な使いかたです。例えば次のようにメソッドが複数あるオブジェクトのために転送メソッドを複数書く必要がある場合には、forwardInvocation:を使うとよいでしょう。

@interface Base : NSObject { }
- (void)foo;
- (void)bar;
- (void)baz;
@end

@implementation Base
- (void)foo {
    NSLog(@"%@: Foo", self);
}
- (void)bar {
    NSLog(@"%@: Bar", self);
}
- (void)baz {
    NSLog(@"%@: Baz", self);
}
@end

転送のためのクラスは次のように定義します。なお、methodSignatureForSelector:を定義しているのは、これがない場合とforwardInvocation:が呼ばれないからです。また、メッセージに対処できないときは通常はsuperのforwardInvocation:を呼び出すとよいみたいです。

@interface ForwardObject : NSObject {
    id _target;
}
@end

@implementation ForwardObject
- (id)initWithTarget:(id)target {
    if (self = [super init]) {
        _target = target;
    }
    return self;
}
- (void)forwardInvocation:(NSInvocation*)inv {
    if ([_target respondsToSelector:[inv selector]]) {
        [inv invokeWithTarget:_target];
    } else {
        [super doesNotRecognizeSelector:[inv selector]];
    }
}
- (NSMethodSignature*)methodSignatureForSelector:(SEL)sel {
    return [_target methodSignatureForSelector:sel];
}
@end

上記のクラスForwardObjectを用いて次のように呼び出すことにします。

Base* base = [[Base alloc] init];
[base foo];

ForwardObject* obj = [[ForwardObject alloc] initWithTarget:base];
[obj foo];
[obj bar];

その結果は次のようになります。ForwordObjectが持っていないメソッドが呼び出せていることがわかります。

<Base: 0x4e17d90>: Foo
<Base: 0x4e17d90>: Foo
<Base: 0x4e17d90>: Bar

また、次のようにNSTimerを利用することで、ターゲットへのすべてのメッセージを5秒遅延させることができます (意味があるかどうかわかりませんが)。

@interface LazyObject : ForwardObject {}
@end

@implementation LazyObject
- (void)forwardInvocation:(NSInvocation*)inv {
    if ([_target respondsToSelector:[inv selector]]) {
        [inv setTarget:_target];
        [NSTimer scheduledTimerWithTimeInterval:5 invocation:inv repeats:NO];
    } else {
        [super doesNotRecognizeSelector:[inv selector]];
    }
}
@end

多重継承

先ほどの例とほとんどコードは変わりませんが、メソッドforwardInvocation:を利用すると多重継承が実現できます。C++の多重継承と違うのは、ダイヤモンド継承などで同名のメソッドがある場合には継承が優先されることです。

さらに、respondsToSelector:、isKindOfClass:、conformsToProtocol:、instancesRespondToSelector:などのメソッドを定義するとより多重継承らしく見えるようになります。

@interface Derived : Base {
    SubBase* _subBase;
}
@end

@implementation Derived
- (id)init {
    if (self = [super init]) {
        _subBase = [[SubBase alloc] init];
    }
    return self;
}
- (void)forwardInvocation:(NSInvocation*)inv {
    if ([_subBase respondsToSelector:[inv selector]]) {
        [inv invokeWithTarget:_subBase];
    } else {
        [super doesNotRecognizeSelector:[inv selector]];
    }
}
- (NSMethodSignature*)methodSignatureForSelector:(SEL)sel {
    return [_subBase methodSignatureForSelector:sel];
}
- (void)dealloc {
    [_subBase release];
    [super dealloc];
}
@end

まとめ

forwardInvocation:を利用したメッセージ転送や多重継承について述べました。

LLVMのアセンブリコードによるプログラム

2011-01-31T23:24:00.003+09:00

LLVM [Wikipedia] はコンパイラのための基盤記述であり、clangなどに用いられています。

この記事では今さらですが、LLVMのアセンブリコードによるプログラムをいくつか試してみます。なお、LLVMのアセンブリコードの詳細については「LLVM Assembly Language Reference Manual」を参照してください。

次の例は単純なHello worldの例です (helloworld.ll)。

@HW = internal constant [14 x i8] c"Hello world!\0A\00"

declare i32 @puts(i8*)

define i32 @main() {
  %cast_hw = getelementptr [14 x i8]* @HW, i32 0, i32 0
  call i32 @puts(i8* %cast_hw)
  ret i32 0
}

ここで、@で始まる識別子はグローバル変数、 %で始まる識別子はローカル変数であり、「i+数値」はそのビット数の整数を表現しています。

また、declareでは@putsを外部関数として宣言しており、main内でそれを用いています。 getelementptrは配列や構造体からアドレスを取得するための命令であり、この例では単に文字列の先頭のアドレスを得ているだけです。具体的には、第1引数はベースとなるアドレス、第2引数以降はインデックスを指定します。この例では第2引数は[14 x i8]に、第3引数はi8に対するインデックスとなります。

ここから、実行ファイルを作成して、実行するには次のようにします。

> llc helloworld.ll && gcc helloworld.s && ./a.out
Hello world!

なお、.llからllvmのビットコード(bc)にして、それを用いて実行するには次のようにします。

> llvm-as helloworld.ll && lli helloworld.bc 
Hello world!

次の例ではループを利用して0から9までをprintfで表示します。

@MSG = internal constant [4 x i8] c"%d\0A\00"

declare i32 @printf(i8*, ...)

define i32 @main() {
head:
  %cast_msg = getelementptr [4 x i8]* @MSG, i32 0, i32 0
  %i = alloca i32
  store i32 0, i32* %i
  br label %loop

loop:
  %val = load i32* %i
  call i32 (i8*, ...)* @printf(i8* %cast_msg, i32 %val)
  %ival = add i32 %val, 1
  store i32 %ival, i32* %i
  %b = icmp sle i32 %ival, 9
  br i1 %b, label %loop, label %tail

tail:
  ret i32 0
}

LLVMのアセンブリコードは、「静的単一代入」と呼ばれる形式であり、各変数に再代入ができない形式になっています。そのため、alloc命令でスタック上に領域を確保し、 load命令とstore命令によって値を保存したり取り出したりしています。

なお、loop:ラベルの直前に無意味なbr命令がありますが、ラベルを付ける場所が関数の先頭かbr命令の直後だけのようなので、その制限回避のためです。

ちなみに、上のプログラムはphi命令を利用するとより簡単に書くことができます。

@MSG = internal constant [4 x i8] c"%d\0A\00"

declare i32 @printf(i8*, ...)

define i32 @main() {
head:
  %cast_msg = getelementptr [4 x i8]* @MSG, i32 0, i32 0
  br label %loop

loop:
  %val = phi i32 [ 0, %head ], [ %nextval, %loop ]
  %nextval = add i32 %val, 1
  call i32 (i8*, ...)* @printf(i8* %cast_msg, i32 %val)
  %b = icmp sle i32 %nextval, 9
  br i1 %b, label %loop, label %tail

tail:
  ret i32 0
}

phi命令は「現在のブロックの直前のブロック」によって結果の値を変えることができる命令です。上のプログラムでは、1回目にphi命令に来たときにはheadラベルから来ているので %valに0が代入され、それ以降はtailラベルの直前のbr命令から来ており結果的に直前のブロックがloopとなるため%valには%nextvalが代入されます。 phi命令の次の行では%valに1足した値を%nextvalに代入しているので、これによって値が変更されていきます。

また (当然でしょうが)、ループのプログラムの例は出力される結果が異なります。ふたつめの例では、スタックを一時変数に用いずにレジスタだけを利用していることがわかります。

> diff -u =(llc loop1.ll -o - -x86-asm-syntax=intel) =(llc loop2.ll -o - -x86-asm-syntax=intel)
--- /tmp/zshAjFUQG    2011-01-31 22:35:56.000000000 +0900
+++ /tmp/zshw9GEZr    2011-01-31 22:35:56.000000000 +0900
@@ -10,19 +10,17 @@
 Ltmp1:
     sub RSP, 8
 Ltmp2:
-    mov DWORD PTR [RSP + 4], 0
-    lea RBX, QWORD PTR [RIP + _MSG]
+    xor EBX, EBX
+    lea R14, QWORD PTR [RIP + _MSG]
     .align  4, 0x90
 LBB0_1:                                 ## %loop
                                         ## =>This Inner Loop Header: Depth=1
-    mov R14D, DWORD PTR [RSP + 4]
-    mov RDI, RBX
-    mov ESI, R14D
+    mov RDI, R14
+    mov ESI, EBX
     xor AL, AL
     call    _printf
-    inc R14D
-    mov DWORD PTR [RSP + 4], R14D
-    cmp R14D, 10
+    inc EBX
+    cmp EBX, 10
     jl  LBB0_1
 ## BB#2:                                ## %tail
     xor EAX, EAX

なお、llvm-gccにオプション--emit-llvmと-Sを付けることでC言語からLLVMのアセンブリコードを得ることができます。

llvm-gcc foobar.c -o foobar.ll -S --emit-llvm

まとめ

LLVMのアセンブリコードによるプログラムを試してみました。

Xcode 3.2.5にiOS 4.0 SDKを導入する方法について

2011-01-08T23:15:00.006+09:00

先日、Xcode 3.2.5をインストールしたところ、iOS 4.0のSDKが使用できなくなりました。いろいろ試したところ、古いXcodeのdmgからiOS 4.0のSDKを取ってきて利用することができましたので、その手順を紹介します。

Xcode 3.2.5のインストール

まず、以前のバージョンのXcodeを導入しているならアンインストールします。dmg内にインストールパッケージとともに存在しているドキュメント「About Xcode and iPhone SDK」にも書かれていますが、ターミナルから次のようなコマンドを入力します。

sudo /Developer/Library/uninstall-devtools --mode=all

そして、Xcode 3.2.5をインストールします。

古いiOS SDKのインストール

まず、「iPhone Software Development: Old versions of iPhone SDK」を参照して、Xcode 3.2.3のdmgを取得します。

次に、ダウンロードしたdmgをマウントします。Finderが起動するかもしれませんが、パッケージを直接参照できないので閉じてください。そして、dmgをマウントしたままでターミナルを起動して次のように入力します。なお、シングルクォート内の内容はお使いの環境やマウントするdmgによって異なる可能性があります。

open -a Finder '/Volumes/Xcode and iPhone SDK/Packages'

すると、次のように沢山のパッケージがファインダーで表示されます。この中からiPhoneSDK4_0.pkgをダブルクリックしてインストールします。

ただし、そのままだとインストール先が正しくないため次のようにしてインストール先を/Developerにします。まず、インストールウィザード中の[Installation Type]で[Change Install Location...]をクリック。

[Developer]を指定して[Choose]してください。

インストール先が"Developer"になっていることを確認して、[Continue]をクリック。

以上で、/Developer/Platforms/iPhoneOS.platform/Developer/SDKs/iPhoneOS4.0.sdkにiOS 4.0のSDKがインストールされます。なお、Xcode 3.2.5にもiPhoneSDK4_0.pkgが存在していますが、Xcode 3.2.3に付属のものとは内容が異なるらしく、上記の手順では使用することはできませんでした。

MD5 (/Volumes/Xcode and iOS SDK/Packages/iPhoneSDK4_0.pkg)    = a09986714b357dede884362997f76edf  # 3.2.5
MD5 (/Volumes/Xcode and iPhone SDK/Packages/iPhoneSDK4_0.pkg) = 1d4dd7957d932038e2f2b0b3e2a7f2f9  # 3.2.3

おまけ: iPhoneSDK4_0.pkgの中身

pkgファイルの中身は次のようになっています。

> xar -tvf /Volumes/Xcode\ and\ iOS\ SDK/Packages/iPhoneSDK4_0.pkg
-rw-r--r--      root/wheel        393048 2010-10-27 08:54:28 Bom
-rw-r--r--      root/wheel           536 2010-10-27 08:59:09 PackageInfo
-rw-r--r--      root/wheel     350292508 2010-10-27 08:54:14 Payload

これらのファイルは次のような形式のファイルです。

> file *
Bom:          Mac OS X bill of materials (BOM) file
PackageInfo:  XML document text
Payload:      gzip compressed data, from Unix

ファイルPackageInfoは次のようなXMLファイルで、内容はよくわかりません。

> lv PackageInfo # 3.2.5のiPhoneSDK4_0.pkg
<?xml version="1.0"?>
<pkg-info format-version="2" relocatable="true" deleteObsoleteLanguages="true" identifier="com.apple
.pkg.iPhoneSDK4_0" overwrite-permissions="yes" auth="root" postinstall-action="none" version="4.0.0.
9000000000.1.1206372128">
  <payload installKBytes="847139" numberOfFiles="1249"/>
  <scripts/>
  <groups>
    <group>com.apple.FindSystemFiles.pkg-group</group>
    <group>com.apple.DevToolsRelocatable.pkg-group</group>
    <group>com.apple.iPhoneSDK.pkg-group</group>
  </groups>
  <bundle-version/>
</pkg-info>

ファイルBomはファイル構成一覧を記述したファイルのようで、lsbomで内容を見ることができます。

> lsbom Bom # 3.2.5のiPhoneSDK4_0.pkg
    :
./Platforms/iPhoneOS.platform/DeviceSupport/4.0/Symbols/usr    40775   0/80
./Platforms/iPhoneOS.platform/DeviceSupport/4.0/Symbols/usr/lib    40775   0/80
./Platforms/iPhoneOS.platform/DeviceSupport/4.0/Symbols/usr/lib/dyld    100775  0/80    476320  2618116526
./Platforms/iPhoneOS.platform/DeviceSupport/4.0/Symbols/usr/lib/gcc    40775   0/80
./Platforms/iPhoneOS.platform/DeviceSupport/4.0/Symbols/usr/lib/gcc/arm-apple-darwin10
    :

Xcode 3.2.3に付属のiPhoneSDK4_0.pkgは3.2.3のものとディレクトリ構成が異なっていたりplistがなかったりします。

> lsbom Bom-3.2.3 | grep plist
./Platforms/iPhoneOS.platform/Developer/SDKs/iPhoneOS4.0.sdk/Entitlements.plist    100644  0/0 423 4179759460
./Platforms/iPhoneOS.platform/Developer/SDKs/iPhoneOS4.0.sdk/ResourceRules.plist    100644  0/0 485 3752781124
./Platforms/iPhoneOS.platform/Developer/SDKs/iPhoneOS4.0.sdk/SDKSettings.plist    100644  0/0 1489    979933569

> lsbom Bom-3.2.5 | grep plist
zsh: done       lsbom Bom-3.2.5 | 
zsh: exit 1     grep plist

まとめ

Xcode 3.2.5にiOS 4.0 SDKを導入する方法を述べました。

2010年の人気記事一覧と統計情報

2010-12-31T18:58:00.009+09:00

2010年も最後の日になりましたので、2010年で本ブログの記事の中で人気のあったページや統計情報をまとめてみました。これらはBloggerの統計タブによる情報に基づいており、評価基準はページビューによるものです。

人気のあったページは次の通りです。なお、1位の記事へのビュー数は全体の20%ほどを占めています。

ページビュー数の月ごとの遷移は次のようになりました。本格的に記事を書き始めたのが9月ごろで、それ以降は月間約2000ページビューくらいで推移しており、年間では約9000ページビュー程度でした。

ページビューのブラウザ別の割合は次のようになりました。1%未満のものにはOpera, OneRiot, Jakarta Commons-HttpClientなどがありました。

ブラウザ	割合
Firefox	31%
Safari	27%
Chrome	23%
Internet Explorer	12%
Mobile	2%

ページビューのOS別の割合は次の通りです。やはりMacが多いです。なお、1%未満のものにはiPad, iPod, Linuxなどがありました。

OS	割合
Macintosh	52%
Windows	37%
iPhone	6%
Other Unix	2%

今現在iOS開発関連で書くことがないため、来年はブログの更新頻度が落ちると思います。また、iOS以外の記事が増えていくかもしれませんが、引き続きプログラム関連の記事をメインにしていくつもりです。

UIDocumentInteractionControllerDelegateの処理の流れについて

2010-12-21T21:23:00.009+09:00

以前の記事「さふ開発日記: UIDocumentInteractionControllerを用いて別アプリケーションを開くメニューを表示する方法について」において、解放周りのコードが間違えていたようなので訂正を兼ねてDocumentInteractionControllerDelegateの処理の流れを調べてみました。

上図はUIDocumentInteractionControllerにおいて、presentOptionsMenuFromRect:inView:animated:を呼び出したときの処理の流れになります。丸四角が呼び出されるデリゲートメソッド、四角がウィジェット状態の変化を示しています。なお、メソッド名があまりにも長いため、最初のdocumentInteractionControllerを「DIC」と省略しています。また、緑文字はオプションメニューでタップしたボタンがどれかということを示しており、その個所がユーザの入力待ちになることを意味します。そして、点線はクイックルックが表示されていることを示しています。

ここで、オプションメニューとクイックルックとはそれぞれ次のようなものであるとします。

以前のコードだと、presentOptionsMenuFromRect:inView:animated:の直後にretainして、documentInteractionControllerDidEndPreview:内でautoreleaseをしていたのですが、これだとクイックビュー以外ではコントローラが解放されなくなってしまいます。

2010.12.30追記: 上図の「別アプリを選択」のフローが間違っていたので訂正しました (以前の図)。また、それに伴ない、次の記述は誤りになります。親クラスで管理するのが最良の方法のようです。

そのため、上図において+1の個所でretain、−1の個所でautoreleaseするのがよいようです (presentOptionsMenuFromRect:inView:animated:とDocumentInteractionControllerDidMismissOptionMenu:の組み合わせのみだとクイックルックを選択した場合Abortしてしまう)。

まとめ

DocumentInteractionControllerDelegateの処理の流れについて述べました。

Quick Look Frameworkを用いたプレビュー表示について

2010-12-14T20:10:00.008+09:00

以前の記事「UIDocumentInteractionControllerを用いて別アプリケーションを開くメニューを表示する方法について」ではアクションシートやクイックルックを表示する方法を紹介しました。クイックルックの実装クラスであるQLPreviewControllerはクイックルックと同じプレビューや他アプリケーションへの転送機能を持っており、さらにプレビュー対象を複数項目にすると、項目間のナビゲーションを行う矢印が付きます (ただし、モーダルビューのとき)。また、データソースがデリゲートになっているので、ナビゲーションによる移動後にオンデマンドでデータの作成や取得を行うことができます。

本記事ではiOS4.0上で、クイックルックのクラスQLPreviewControllerを利用したプレビューを表示する方法について紹介します。詳細はAppleのドキュメント「Document Interaction Programming Topics for iOS」のUsing the Quick Look Frameworkを参照してください。

クイックルックの表示

QLPreviewControllerはUIViewControllerのサブクラスであるため、ナビゲーションコントローラにpushすることもできますが、クイックルックのように、モーダルにして全画面表示にすると項目間のナビゲーションを行う矢印が付きます。具体的には次のコードのようになります。

QLPreviewController* ql = [[QLPreviewController alloc] init];
[self.navigationController presentModalViewController:ql animated:YES];
ql.dataSource = self;
[ql refreshCurrentPreviewItem];

なお、QuickLook/QuickLook.hをインポートして、フレームワークQuickLook.frameworkを追加する必要があります。また、delegateはQLPreviewControllerを閉じるときとプレビュー内でリンクをクリックしたときの挙動をカスタマイズするだけですので、今回は省略しています。

データソースの実装

データソースのためのプロトコルQLPreviewControllerDataSourceには2つの必須メソッドnumberOfPreviewItemsInPreviewController:とpreviewController:previewItemAtIndex:があります。前者は表示項目数、後者は表示項目のURLとタイトルを示すQLPreviewItemを返すメソッドであり、コードは次のようになります。

- (NSInteger)numberOfPreviewItemsInPreviewController:(QLPreviewController*)controller {
    return [previewItems count];
}

- (id<QLPreviewItem>)previewController:(QLPreviewController*)controller previewItemAtIndex:(NSInteger)index {
    FileInZipInfo* info = [previewItems objectAtIndex:index];
    NSString* path = [self extractFile:info];
    PreviewItem* item = [[PreviewItem alloc] initWithURL:[NSURL fileURLWithPath:path]];
    return [item autorelease];
}

上記のコードはZip内のファイルを必要になったときに解凍して表示させるコードになっています。ここで、extractFile:はZip内のファイルを解凍するメソッドとします。基本的には以前の記事「さふ開発日記: Objective-Zipを用いたZip書庫の操作について」を参照に実装可能ですので、ここでは省略しています。また、PreviewItemは単純にプロトコルQLPreviewItemを実装しているだけですので、これも省略しています。

QLPreviewControllerで表示可能な形式

QLPreviewControllerは次の形式を表示可能です。これは、おそらくクイックルックと同じでしょう。

iWork documents
Microsoft Office文書
リッチテキスト
PDF
画像
統一型識別子 (UTI) の public.text にあたるもの
CSV

まとめ

クイックルックのクラスQLPreviewControllerを利用したプレビューを表示する方法について紹介しました。

Objective-Zipを用いたZip書庫の操作について

2010-12-09T19:36:00.006+09:00

Objective-Zipは、現在最も普及しているであろう圧縮形式であるZipの圧縮と解凍を行うことができるObjective-Cのライブラリであり、ZLib
とMinizipという2つのライブラリを用いています。そのため、Objective-Zip自体は新BSDライセンスですが、ZLibとMiniZipはライセンスが異なる (zlibライセンス) ので注意してください。

Objective-Zipの現時点での最新バージョンである0.7.2は、iOSのバージョン3.1.2から4.2で利用可能です。この記事ではObjective-Zipを用いたZipファイルの操作を簡単に説明します。

事前準備

Xcodeで次の手順を行います。ちなみに、手元の環境ではzlibのライブラリは不要でした。なお、Minizipはzlibを利用してZipファイルの圧縮と解凍を行うライブラリです (zlibはgzipファイルを解凍できるが、zipファイルには対応していない)。

Objective-Zip-0.7.2.zipをダウンロード
Objective-Zip-0.7.2.zipを解凍し、MiniZipとObjective-ZipをDocumentsフォルダに移動
[Add]→[Existing Files...]でMiniZipとObjective-Zipを追加
[Add]→[Existing Frameworks...]でlibz*.dylibを追加 (libz.1.2.3.dylibのみを追加した)

ファイル一覧表示

Zipファイル内の一覧を表示するコードを次に示します。

ZipFile* zip = [[ZipFile alloc] initWithFileName:zipfilePath mode:ZipFileModeUnzip];
NSArray* array = [zip listFileInZipInfos];
for (FileInZipInfo* i in array) {
    NSLog(@"%@ %@", i.name, i.length);
}
[zip close];
[zip release];

ファイル解凍

Zipファイル内から指定したファイルをひとつ解凍するコードを次に示します。zipInfo.sizeは圧縮時のサイズなので間違えないようにしてください。また、全部解凍するときはgoToNextFileInZipを利用したほうがよいでしょう。

ZipFile* zip = [[ZipFile alloc] initWithFileName:zipfilePath mode:ZipFileModeUnzip];
if ([zip locateFileInZip:zipInfo.name]) {
    ZipReadStream* read = [zip readCurrentFileInZip];
    NSMutableData* data = [[NSMutableData alloc] initWithLength:zipInfo.length];
    if ([read readDataWithBuffer:data]) {
       [data writeToFile:outputPath atomically:YES];
    }
    [read finishedReading];
    [data release];
}
[zip close];
[zip release];

ファイル圧縮

Zipファイルを作成し、ファイルをひとつ追加するコードを次に示します。複数のファイルを追加する場合には余分にインデントしている4行の部分を繰り返します。なお、closeを忘れると書庫が壊れてしまうようですので注意してください。

ZipFile* zip = [[ZipFile alloc] initWithFileName:zipfilePath mode:ZipFileModeCreate];
    ZipWriteStream* write = [zip writeFileInZipWithName:[path lastPathComponent]
                                 compressionLevel:ZipCompressionLevelBest];
    NSData* data = [NSData dataWithContentsOfFile:path];
    [write writeData:data];
    [write finishedWriting];
[zip close];
[zip release];

おわりに

Objective-Zipを用いたZipファイルの操作を説明しました。

Objective-C上でブロックオブジェクトによる高階関数を用いてソートする方法について

2010-11-29T20:09:00.008+09:00

iOS 4.0以降 (Mac OS Xなら10.6以降) で利用可能になったブロックオブジェクトは他の言語でのクロージャに相当するものです。ブロックオブジェクトはC, C++, Objective-Cで利用可能であり、Appleの並列実行アーキテクチャGrand Central Dispatchにおける基盤要素にもなっています。

ブロックオブジェクトはスタック上に生成されるため、copyによってヒープに移動させて破棄されないようにする必要があります (そして、使用後に破棄されるようにするためにautoreleaseさせる必要があります)。しかし、その点に注意さえすれば戻り値をブロックオブジェクトにした高階関数を利用することができます。

この記事ではObjective-Cにおいて、ブロックオブジェクトで高階関数を用いることで比較用のブロックオブジェクトを作成し、それを用いてオブジェクトのソートを行う方法を紹介します。

ブロックオブジェクトの概要

次のインタフェースを持つクラスFileがあり、その配列Arrayがあるとします。

@interface File { /* ... */ }
@property NSString* name;
@property BOOL isDirectory;
@property long size
@end

この配列をnameでソートするときに、比較のためにブロックオブジェクト (以下、単にブロックとする) を利用するならsortedArrayUsingComparator:を使うことになります。ブロックはサーカムフレックス ^ で始まり、引数と本体がその後に続きます。

NSComparator comp = ^(id a, id b) {
    return [[a name] compare:[b name]];
}
NSArray* sortedArray = [array sortedArrayUsingComparator:comp];

ここで、NSComparatorは次のようにtypedefされています。

typedef NSComparisonResult (^NSComparator)(id obj1, id obj2);

高階関数

ここでは、高階関数を関数 (ブロック) を返す関数という意味で用いています。よくある単純な利用例としては次のようになります。

typedef int (^mulBlock)(int);

mulBlock makeMul(int x) {
    return [[ ^(int y) {
        return x * y;
    } copy] autorelease];
}

int main() {
    mulBlock mul5 = makeMul(5);
    printf("%d\n", mul5(4)); // 20
}

ファイルソートの問題

ファイルをソートする際に問題となるのは、そのソート種類の豊富さです。ソート基準としてファイル名、ファイルサイズ、拡張子、更新日などがあり、それ以外にも次のようなものも考慮する必要があります。

拡張子や更新日などが一致するときには別の基準 (ファイル名など) でソートする
ファイル名で、アルファベットの大文字と小文字を区別するのか
フォルダとファイルを一緒にしてソートするのかどうか
ソートの昇順、降順

安定なソートを用いて、これらの基準を用いて順番にソートする方法もありますが、複数回ソートする必要があります。

ファイルソートにおける高階関数の利用

ある基準で比較し、同値になった場合は下位の基準としてNSComparator型のブロックfを用いるようなブロックを作成する関数を用意します。ここでは、ファイル名の比較 (compByName, compByIName) はベースレベルとしており、ブロックを返す関数にはしていません。

NSComparisonResult (^compByName)(id, id) = ^(id a, id b) {
    return [[a name] compare:[b name]];
};

NSComparisonResult (^compByIName)(id, id) = ^(id a, id b) {
    return [[a name] caseInsensitiveCompare:[b name]];
};

NSComparator makeCompByDir(NSComparator f) {
     return [[ ^(id a, id b) {
        BOOL adir = [a isDirectory];
        BOOL bdir = [b isDirectory];
        if (adir == bdir) return f(a, b);
        return (adir && ! bdir)? NSOrderedAscending : NSOrderedDescending;
    } copy] autorelease];    
}

NSComparator makeCompBySize(NSComparator f) {
     return [[ ^(id a, id b) {
        long av = [a size];
        long bv = [b size];
        if (av == bv) return f(a, b);
        return av < bv? NSOrderedAscending : NSOrderedDescending;
    } copy] autorelease];
}

NSComparator makeCompByKind(NSComparator f) {
     return [[ ^(id a, id b) {
        NSComparisonResult res = [[a name].pathExtension 
           caseInsensitiveCompare:[b name].pathExtension];
        return res == NSOrderedSame? f(a, b) : res;
    } copy] autorelease];    
}

これらを用いて、(1) フォルダとファイルを別にして、(2) 拡張子でソートし、(3) 同一拡張子内はファイル名でソート (大文字と小文字を区別) する場合には次のように書くことができます。

sorted = [array sortedArrayUsingComparator:makeCompByDir(makeCompByKind(compByName))];

まとめ

Objective-Cにおいて、ブロックオブジェクトで高階関数を用いてオブジェクトのソートを行う方法を紹介しました。

Audio Queue Serviceを用いたネットワークストリーミングによるオーディオ再生

2010-11-26T22:33:00.005+09:00

以前の記事「CFNetworkフレームワークを用いた入力HTTPストリームの作成」でネットワークからデータを取得する方法について述べました。今回はここから、Audio File Stream ServicesとAudio Queue Servicesを用いてオーディオ再生を行う方法について説明します。なお、詳細はAppleのドキュメント「Audio Queue Services Programming Guide」を参照してください。

概要

ストリーミングオーディオを再生するには次の手順を踏みます。

CFNetworkを用いてストリームデータを取得
Audio File Stream Servicesを用いてネットワークパケットを解析
Audio Queue Servicesを用いてそのオーディオを再生

この流れを次に示します。矩形はオブジェクト、丸四角はコールバックを示し、実線はオブジェクトなどの生成、破線はオーディオデータの流れを示しています。そして、破線上の赤い文字は発生条件、黒い文字は呼び出し関数を示しています。

1. CFReadSream (CFNetwork)

CFNetworkのCFReadSreamを用いてネットワーク越しにデータを取得します。基本的な部分は以前の記事「CFNetworkフレームワークを用いた入力HTTPストリームの作成」と同様なので、ここでは詳細は述べません。

データを取得したときにイベントkCFStreamEventHasBytesAvailableが発生で、AudioFileStreamParseBytesによってAudioFileStreamにデータを渡すようにします。具体的には次のように書きます。

switch(event) {
    case kCFStreamEventHasBytesAvailable: {
        UInt8 buf[4096];
        CFIndex bytesRead = CFReadStreamRead(stream, buf, sizeof(buf));
        AudioFileStreamParseBytes(globalAudioFileStream, bytesRead, buf, 0);
    } break;

2. Audio File Stream Services

ネットワークから得られたデータはオーディオパケット単位で得られるわけではない上、オーディオパケット以外のデータとしてプロパティが混じっています。次の図はこれを概念化したものです。

オーディオデータは(上図の状態0)のようにオーディオパケット(青)とプロパティ(紫)が混じっています。さらに、ネットワークから得られるデータ場合はオーディオパケットなどの境界で適切に分割されていません(上図の状態1)。そのため、Audio File Stream Servicesによってオーディオデータをパケット単位で取得することと、ストリーム中のプロパティを取得することを行います(上図の状態2)。

Audio File Stream Servicesで行うべき処理について次に示します。

関数AudioFileStreamOpenによって新規オーディオストリーム解析器を作成
オーディオデータとメタデータ (プロパティ) のためにコールバック関数AudioFileStreamPacketsProcとAudioFileStreamPropertyListenerProcを渡す。
先ほどのCFReadSreamからストリームデータを取得
実際には可能な限りギャップなしでデータを解析器に継続的に渡すようにする必要があります。
ストリームの解析が終了時に関数AudioFileStreamCloseを呼び出して、解析器のクローズとデアロケートを行う

また、2つのコールバックでは次のような処理を行います。

プロパティコールバック
プロパティ値を取得することができます (関数AudioFileStreamGetPropertyInfoとAudioFileStreamGetPropertyを呼ぶ) 今回は再生可能な状態になった時点でAudio Queueを作成します。
オーディオデータコールバック
データの再生、ファイルへの保存といった処理を行うとよいです。
今回はバッファを作成して、それをオーディオキューに追加します。

次の2つのコード片はこれらコールバックの重要な部分だけの抜き出したものです。

// myAudioFileStream_PropertyListenerProc
switch(inPropertyID){
    case kAudioFileStreamProperty_ReadyToProducePackets: {
        AudioStreamBasicDescription asbd;
        UInt32 size = sizeof(asbd);
        AudioFileStreamGetProperty(inAudioFileStream, kAudioFileStreamProperty_DataFormat,
                     &size, (void*) &asbd);
        AudioQueueNewOutput(&asbd, &myAudioQueueOutputCallback,
                     NULL, CFRunLoopGetCurrent(), 
                     kCFRunLoopCommonModes, 0,
                     &globalAudioQueue);
        AudioQueueSetParameter(globalAudioQueue, kAudioQueueParam_Volume, 1.0);
        AudioQueueStart(globalAudioQueue, NULL);
        break;


// myAudioFileStream_PacketsProc
AudioQueueBufferRef aqbuf;
OSStatus err = AudioQueueAllocateBufferWithPacketDescriptions(globalAudioQueue, inNumberBytes,
                                                              inNumberPackets, &aqbuf);
memcpy(aqbuf->mAudioData, inInputData, inNumberBytes);
aqbuf->mAudioDataByteSize = inNumberBytes;    
AudioQueueEnqueueBuffer(globalAudioQueue, aqbuf, inNumberPackets, inPacketDescriptions);

3. Audio Queue Services

通常、オーディオキューコールバック関数ではバッファを再利用するようなコードを書きますが、今回の例では作成したバッファを削除しています。

AudioQueueFreeBuffer(inAQ, inBuffer);

まとめ

Audio FileStream ServicesとAudio Queue Servicesを用いてオーディオ再生を行う方法について説明しました。なお、この例ではコードを簡潔にするためにオーディオバッファを毎回作成、破棄を行っていますが、実際にはメモリ効率のため使い回す必要があります。

iOSアプリケーションを特定のファイル形式に対応させる方法について

2010-11-21T00:47:00.011+09:00

前回の記事「UIDocumentInteractionControllerを用いて別アプリケーションを開くメニューを表示する方法について」では選択したファイルからクイックビューや対応可能なアプリケーションを呼び出す方法について説明しました。今回は、アプリケーションを特定のファイル形式に対応させ、前回の記事で用いたUIDocumentInteractionControllerから利用可能にさせる方法を説明し、ここで利用する統一型識別子 (UTI) についても簡単に説明します。

詳細はAppleの公式ドキュメント「iOS Application Programming Guide」の「Implementing Standard Application Behaviors」を参照してください。なお、この文書はiOSの場合について言及しており、Mac OS Xの場合とは詳細が異なります。

Info.plist

アプリケーションが特定のドキュメントタイプ (ファイル形式) に対応するには、Info.plistでキーCFBundleDocumentTypesを設定する必要があります。CFBundleDocumentTypesはディクショナリ型の配列で、各ディクショナリがひとつのドキュメントタイプについて指定しています。

iOSにおけるCFBundleDocumentTypes内の各ディクショナリは次のキーを含んでいます。

CFBundleTypeName
(文字列) ドキュメントタイプの名前 (必須)
CFBundleTypeIconFiles
(配列) このドキュメントタイプに対応するアイコン画像リソースを示すファイル名の配列。22×29ピクセル (iPad用は64×64) のアイコンを用意する、らしいのですがどこで使用されているのかいまいちよくわかっていません。なければアプリケーションアイコンから生成されるようです
LSItemContentTypes
(配列) このドキュメントタイプがサポートする統一型識別子 (UTI; Uniform Type Identifier) 形式の文字列の配列
LSHandlerRank
(文字列) アプリケーションがこのドキュメントタイプをどの程度サポートしているかを示すランク。優先度が高いほうから順番に、 Owner (このタイプの作成可能) > Alternate (このタイプの閲覧可能) > None (扱えないがドロップは可能) > Default (ドロップの不可)

例えば、アプリケーションをHTMLを含むテキストファイル全般に対応させたい場合には、Info.plistで次のように指定します。テキストファイル全般に対応したUTI形式は「public.text」ですので、LSItemContentTypesではそれを指定しています。

URLリクエストの受け入れ

Info.plistを設定後、別のアプリケーションから与えられるファイルを扱えるようにします。これには「独自カスタムURLスキームを設定する方法」と同様に、application:handleOpenURL:もしくはapplication:didFinishLaunchingWithOptions:を利用します。コード例を次に示します。

- (BOOL)application:(UIApplication*)application handleOpenURL:(NSURL*)url {
    if ([url.scheme isEqualToString:@"file"]) {
        NSString* str = [NSString stringWithContentsOfURL:url
                           encoding:NSUTF8StringEncoding error:nil];
        viewController.textView.text = str;
        return YES;        
    } else if ([url.scheme isEqualToString:@"mySampleApp"]) {
        // カスタムURLスキームの処理 (省略)
    }
}

統一型識別子 (UTI) について

キーLSItemContentTypesで用いるUTI形式は同じファイル形式を意味する拡張子、OSType、MIMEタイプをまとめて扱えるようにするものです。例えば、OSTypeのJPEG、拡張子の.jpg、拡張子の.jpeg、MIMEタイプのimage/jpegなどはUTI形式では「public.jpeg」と表現できます。

UTIは階層構成で、ファイルについてはpublic.dataがルート
UTIの表記はDNS表記と似た形式で、英数字とドット(.)とハイフン(-)のみ使用可能
ドメインpublicは予約ドメイン
多重継承も可能

なお、画像やテキストなどの一般的な形式は既に定義されており、「System-Declared Uniform Type Identifiers」の表1にあるシステム定義のUTIをグラフ化したものは次のようになります。これはシステム定義済みのもの全てを示しておらず、WindowsビットマップやAdobe Reader形式などは別の表で示されているので、このグラフには存在しません。

上記画像のSVGファイル (最近のブラウザなら、リンク先の「Open」で表示することができます)

まとめ

アプリケーションを特定のファイル形式に対応させる方法と統一型識別子 (UTI) について説明しました。

UIDocumentInteractionControllerを用いて別アプリケーションを開くメニューを表示する方法について

2010-11-18T20:37:00.011+09:00

メール (Mail.app) などで添付ファイルを長押し (タップアンドホールド) すると、「クイックルック (Quick Look)」を含めた対応可能なアプリケーションを選択させるためのアクションシートが表示されます。今回はこのアクションシートの表示の方法を説明します。

このアクションシートの表示にはクラスUIDocumentInteractionControllerを利用します。その使用例を次に示します。このコントローラは命名規則からわかるように自動解放されるため、retainしておく必要があります。

  - (void)openMenuButtonClicked:(id)sender {
      UIDocumentInteractionController* diController = [UIDocumentInteractionController interactionControllerWithURL:url];
      diController.delegate = self;
  
      if ([diController presentOptionsMenuFromRect:self.view.frame inView:self.view animated:YES])
          [diController retain];
  }
  - (UIViewController*)documentInteractionControllerViewControllerForPreview:(UIDocumentInteractionController*)controller {
      return self; // プレビュー用に用いるビューコントローラ
  }
? - (void)documentInteractionControllerDidEndPreview:(UIDocumentInteractionController *)controller {
?     [controller autorelease];
? }

2010.12.21追記: コントローラの解放周りのコードが間違っており、正しく解放されない場合があります。詳細は次の記事を参照してください。
さふ開発日記: UIDocumentInteractionControllerDelegateの処理の流れについて

また、メールでのタップのようにいきなり対象ファイルをプレビュー表示させたいときはpresentPreviewAnimated:を用います。

ちなみに対応アプリケーションが増えると次のようになります。

Safx

フリーの国際化ツールLocalization Suiteを試す

インストール

ローカライズ前準備

ローカライズ手順

長所

問題点

まとめ

関連項目

Googleのバグ予測アルゴリズムのMercurial拡張を書いてみました

コード

インストール

使いかた

関連項目

2011年の人気記事一覧と統計情報

NSLoggerで手軽にログを取る方法について

ダウンロードとテスト

ログビューワの利用法

アプリケーションへの導入

基本API

NSLogger.appの自動起動

マクロの登録

まとめ

関連リンク

Xcode4.2でのDropbox SDK v1のサンプルアプリケーションのコンパイルについて

まとめ

関連項目

Dropbox API V1が正式版になりました

Dropbox API v1 Betaがアナウンスされました

関連項目

QuickDialogを用いて簡単にダイアログを作成・表示する

導入

利用法

まとめ

関連項目

2011年上半期の人気記事一覧と統計情報

Shibokenを用いたCPython用バインディングの生成について

Shibokenの概要

libraw-liteのPythonバインディング作成

まとめ

関連情報

CinderによるiPhoneアプリケーションの作成について

プロジェクトの作成と実行

プロジェクトの作成と実行

Cinderソース概要

画像ファイルの利用

マルチタッチの利用

まとめ

関連項目

Mercurial拡張の書きかたについて

スクリプトとしての起動

hgからの実行

コードの追加

debugshell

まとめ

関連記事

Mercurialのリポジトリ内のデータについて

概要

例

Revlog形式

まとめ

関連項目

NSObjectを継承しないクラスをランタイムAPIで作成する方法について

Objective-CランタイムAPIによるメソッドの列挙

Objective-CランタイムAPIによるメソッドの列挙

methodSignatureForSelector:とforwardInvocation:を利用したメッセージ処理

まとめ

関連項目

メソッドforwardInvocation:を利用したメッセージ転送について

メッセージ転送の例

多重継承

まとめ

関連項目

LLVMのアセンブリコードによるプログラム

まとめ

関連記事

Xcode 3.2.5にiOS 4.0 SDKを導入する方法について

Xcode 3.2.5のインストール

古いiOS SDKのインストール

おまけ: iPhoneSDK4_0.pkgの中身