Xcode4でShareKitを使う

twitter, facebook, Evernote, Flickrといった各種WebサービスへiOSアプリケーションからデータを流し込みたい場合、ShareKitを使うと便利だ。

Xcode4でShareKitを使うにあたって、日本語の解説があまりなかったようなので記事にした。結論を先に書くと、日本語のドキュメントを検索するより、公式ドキュメント(Installing sharekit)を参照した方が確実で早くて分かりやすい。

ちなみにググると出てくるhttp://getsharekit.com/のサイト上にリンクが貼られているShareKitはバージョンが0.2.1と極めて古い。最新の情報はすべてgithub上にあるのでそちらを参照するべき。

ShareKitの取得

アプリケーションのプロジェクトのディレクトリに移動して、もしgitのリポジトリが存在しないのであればgit initを実行後、以下をシェルに入力。

$ cd (プロジェクトのディレクトリ(.xcodeprojファイルの存在するディレクトリ))
$ git submodule add git://github.com/ShareKit/ShareKit.git Submodules/ShareKit
$ git commit -m 'ShareKit added as submodule'

Submodulesというディレクトリ内にShareKitというディレクトリ名でShareKitが追加されます。

$ cd Submodules/ShareKit
$ git submodule init
$ git submodule update

プロジェクトに追加

アプリケーションのプロジェクトにSubmodules/ShareKit/ShareKit.xcodeprojをドラッグ&ドロップする。

ShareKit.xcodeproj/Classes/ShareKitをドラッグ&ドロップしてアプリケーションのプロジェクト内にコピーする

「Create groups for any added folders」を選択してFinish

ShareKit.xcodeprojを削除する(Remove Referenceを選択)

フレームワークの追加

プロジェクトナビゲータ内の(プロジェクト名).xcodeprojの[Build Phases]タブの[Link Binary With Libraries]の[＋]ボタンをクリックして以下のフレームワークを追加する。

• SystemConfiguration.framework
• Security.framework
• MessageUI.framework
• CFNetwork.framework (Flickr共有したい場合)
• CoreLocation.framework (Foursquare共有したい場合)
• Twitter.framework(iOS5以上の場合)

いらないWebサービスのクラスを削除する

プロジェクトナビゲータ内の「ShareKit/Sharers/Services/」の中に、各Webサービスに必要なクラスがフォルダ分けされているので、使わないWebサービスのフォルダは削除する(Remove Referencesを選択)。

ビルドできるか確認

試しにビルドしてみる。ビルドに失敗する場合は公式ドキュメントの「Step 3: Smoke Test」を参照する。

Configuratorの作成

DefaultSHKConfiguratorを継承したクラスを作る。

MyShareKitConfigurator.h

#import "DefaultSHKConfigurator.h"
@interface MyShareKitConfigurator : DefaultSHKConfigurator
@end

MyShareKitConfigurator.m

#import "MyShareKitConfigurator.h"

@implementation MyShareKitConfigurator
- (NSString*)appName {
	return @"アプリケーション名";
}
- (NSString*)appURL {
	return @"http://example.com/";
}
/*
 ここから先は使うアプリケーションごとに
 DefaultSHKConfigurator.mから設定をコピーして書き換える
 例えばtwitter APIを使う場合は以下のように設定する。
 */
- (NSNumber*)forcePreIOS5TwitterAccess {
	return [NSNumber numberWithBool:false];
}
- (NSString*)twitterConsumerKey {
	return @"abcdefghijklmnopqrstuv";
}
- (NSString*)twitterSecret {
	return @"abcdefghijklmnopqrstuvwxyz01234567890ABC";
}
- (NSString*)twitterCallbackUrl {
	return @"http://example.com/";
}
- (NSNumber*)twitterUseXAuth {
	return [NSNumber numberWithInt:0];
}
- (NSString*)twitterUsername {
	return @"";
}
@end

Configuratorの適用

アプリケーションのデリゲートのapplication:didFinishLaunchingWithOptions:メソッド内にSHKConfigurationを使って設定を読み込む処理を追加する。

// (前略)

#import "SHKConfiguration.h"
#import "MyShareKitConfigurator.h"

@implementation
// (中略)

- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions
{
	MyShareKitConfigurator *configurator = [[[MyShareKitConfigurator alloc] init] autorelease];
	[SHKConfiguration sharedInstanceWithConfigurator:configurator];
	// (中略)
}

// (中略)

@end

一覧を表示

これでShareKitの導入は完了しているので、後は必要なコードを随時挿入するだけ。

例えばテキスト共有したい場合は以下のように書く

#import "SHK.h" //ShareKitをimportする

- (void)showShareKitActionSheet {
	SHKItem *item = [SHKItem text:@"これはテストです。"];
	[[SHKActionSheet actionSheetForItem:item] showInView:[[UIApplication sharedApplication] keyWindow]];
}

まとめ

ググる前に公式ドキュメントを読むべきだった。

Pocket

Tweet