【Xcode】設定しておくと便利なカスタマイズいろいろ

Posted by: daichi  /  Category: 開発補助

いろいろカスタマイズして便利にします。

外観

デバッグコンソールなどを1つのウィンドウに統合する

シミュレータでアプリを起動すると、デバッガコンソールがXcodeの後ろに隠れてしまい、いちいちフォーカスを切り替えるのが面倒。そんなときはこの設定を。
Xcode→環境設定→全般→レイアウト→オールインワン

アプリ実行時にデバッガを自動的に表示する

Xcode→環境設定→デバッグ→開始時→コンソールとデバッガを表示

__MY_COMPANYNAME__を変更する

ファイルを新規に作成する時にファイル作成者の情報等が自動生成されるが__MY_COMPANYNAME__が気持ち悪い。そんな時は、コンソールから以下のコマンドを叩く。YourNameHereを表示したい名前に置き換えて。

defaults write com.apple.Xcode PBXCustomTemplateMacroDefinitions
   '{ORGANIZATIONNAME="YourNameHere";}'



プリプロセッサ

デバッグ用マクロ

デバッグ時はNSLogメソッドをよく使うが、リリースビルドにはNSLogを使いたくない。そんな時はプリプロセッサでDebugモードの時だけ、NSLogを吐くマクロを定義すればいい。
Global.h

?View Code OBJECTIVE-C
#ifdef DEBUG 
#define LOG(...) NSLog(__VA_ARGS__)
#else
#define LOG(...) 
#endif



info.plistでDebug構成時のみ、GCC_PREPROCESSOR_DEFINITIONS項目にDEBUG文字列を設定する。

すると、LOG(@”hogehoge”)でDebug構成時のみ、NSLogを吐けるようになる。

テンプレート

IBを使わないテンプレートを作成する

Interface Builderは最近は使わなくなったので、新しいプロジェクトを作る場合に、いちいち削除したりするのが面倒。そんな時はプロジェクトテンプレートをカスタマイズする。

Xcodeのプロジェクトテンプレートは、以下の場所においてある。
/Developer/Platforms/iPhoneOS.platform/Developer/Library/Xcode/Project Templates/Application

ユーザ定義のテンプレートは以下の場所に置くとXcodeに認識される。
~/Library/Application Support/Developer/Shared/Xcode/Project Templates/Application/

Windowベースのアプリケーションをベースにカスタマイズする。オリジナルのWindow-based Applicationをユーザ定義の方にコピーしてWindow-based-non-IB Applicationにリネーム。

ディレクトリ内の___PROJECTNAME___はすべてプロジェクト名に置き換えられる。

変更するのは以下。
  • info.plistのMain nib file base name→空に
  • main.m内のUIApplicationMainメソッドの第4匹数に@”___PROJECTNAME___AppDelegateを”
  • MainWindow.xib→削除
  • ___PROJECTNAME___.xcodeproj/project.pbxproj→MainWindow.xibに関する部分をすべて削除
これでxibファイル抜きのテンプレートができあがり。

個人的に___PROJECTNAME___AppDelegateという名前が長ったらしくてあまり好きではないので、これをAppDelegateにした。
この時の変更箇所は以下。
  • main.m→@”___PROJECT_NAME___AppDelegate”を@”AppDelegate”へ
  • ___PROJECT_NAME___AppDelegate.h→ファイル名をAppDelegate.hへ。中身も該当箇所を修正
  • ___PROJECT_NAME___AppDelegate.m→ファイル名をAppDelegate.mへ。中身も該当箇所を修正
  • ___PROJECT_NAME___.xcodeproj/project.pbxproj→___PROJECT_NAME___AppDelegate部分をすべてAppDelegateへ修正

.gitignore、.gitattributeをテンプレートに含める

gitを使いだすとgitの設定ファイルである.gitignoreでXcode用ファイル達を除外したくなるが、これを毎回プロジェクトを作る度にコピーしてくるのは面倒なので、テンプレートに含めてしまう。やり方は上のテンプレートディレクトリに.gitignore、.gitattributeファイルを入れるだけ。
.gitignoreは

# xcode noise
build/*
*.pbxuser
*.mode1v3
 
# old skool
.svn
 
# osx noise
.DS_Store
profile


.gitattributesは

*.pbxproj -crlf -diff -merge


ここまでのテンプレート設定ディレクトリをいちおのせておく。これをダウンロードして、ローカルの
~/Library/Application Support/Developer/Shared/Xcode/Project Templates/Application/
に置けば、使えると思う。
Window-based-non-IB Application
これには次のログマクロテンプレートも含まれている。

ログマクロをテンプレートに含める

さきほど作ったログマクロをテンプレートに含めるのは、テンプレートディレクトリ内にログマクロを記述したファイルを追加すればOKだが、ファイルを開発時にファイルを新規作成するたびに、
#import “Global.h”
とするのは面倒だ。

なので、ファイル作成時に既に#import “Global.h”を追記されているファイルテンプレートを作成する。

オリジナルのファイルテンプレートは以下に置いてある。
/Developer/Platforms/iPhoneOS.platform/Developer/Library/Xcode/File Templates/Cocoa Touch

このCocoa Touchディレクトリをユーザ定義用ファイルテンプレートディレクトリである
~/Library/Application Support/Developer/Shared/Xcode/File Templates/
へコピー。

あとはファイルを好きなように変更すればそれがテンプレートになる。

Cocoa Touchのすべてのファイル作成時にGlobal.hを含むように設定したファイルテンプレートはこれ。
Cocoa Touch Class
これを
~/Library/Application Support/Developer/Shared/Xcode/File Templates/
へ入れれば、ユーザ定義ファイルとして使える。


よく使うフレームワークをテンプレートに含める

例えば、Three20だったり、JSONフレームワークだったり、GTMだったり、こういうよく使うフレームワークはあらかじめ使える準備の整ったプロジェクトテンプレートが欲しくなる。これも上のやり方同様、コピーしたローカルのテンプレート周りをいじくり倒して設定できる。

マクロ

よく使うメソッドをマクロとして登録する

Xcodeでは、Ctrl+.でマクロを呼び出せる。
例えばinitと打って、Ctrl+.を押すと、NSObjectのinitメソッドが挿入される。他にもlog、deallocなどが予めマクロとして登録されている。
が、ViewController周りのメソッド達は登録されていないので、いちいちviewWillAppear〜などとよく使うメソッドを入力しなければならない。これは面倒だ。ということでマクロを登録する。

オリジナルのマクロ定義ファイルは以下にある。
/Developer/Applications/Xcode.app/Contents/PlugIns/TextMacros.xctxtmacro/Contents/Resources/ObjectiveC.xctxtmacro

これをユーザ定義のマクロファイル置き場である以下にコピーする。
~/Library/Application Support/Developer/Shared/Xcode/Specifications

マクロとして
- (void)tableView:(UITableView *)tableView didSelectRowAtIndexPath:(NSIndexPath *)indexPath
を追加する場合は、ファイル内に以下のような記述を追加する。

        {
            Identifier = objc.didselect;
            BasedOn = objc;
            IsMenuItem = NO;
            Name = "didSelectRowAtIndexPath";
            TextString = "- (void)tableView:(UITableView *)tableView didSelectRowAtIndexPath:(NSIndexPath *)indexPath {¥n¥t<#statements#>¥n}";
            CompletionPrefix = didselect;
        },


内容の説明
  • Identifier→ユニークな識別ID。
  • Name→Xcodeで編集→テキストマクロを挿入→Objective Cと行った時に表示される名称
  • TextString→マクロ実行時に挿入される文字列
  • CompletionPrefix→マクロ発動文字列。例の場合、didselectと入力してCtrl+.を押すとマクロが実行される
他の項目はおおむね上の例のままで問題ない様子。

ひとまず
viewWillAppear, viewDidAppear, viewDidLoad, viewWillDisappear, viewDidDisappear, cellForRowAtIndexPath, didSelectRowAtIndexPathなどを登録してみた。なかなか悪くない。

vwaと入力してCtrl+.でviewWillAppear発動。他もvda、vdl、vwd、vdd、cellfor、didselectで発動するのでいい感じ。

この設定済みマクロはこちらから。
ObjectiveC.xctxtmacro

参考

Three20とJSON-FrameworkでTwitterのタイムライン画面を作る

Posted by: daichi  /  Category: iphone開発

Three20 JSON datasource implementation – revetkn.com

Three20とjson-frameworkを使って簡単にタイムライン画面を作ってみる。

それぞれセットアップは以下を参考に

【Three20】をプロジェクトで使えるようにする手順 | iphoneアプリで稼げるのか
[iPhone] JSON Framework の使い方(準備編) | Sun Limited Mt.

※JSONFramework側の不具合で上記リンクの通り設定した場合でも、OS3.0で使うと実機転送時にcode signエラーが出た。そんな時は「他のリンカフラグ」等の設定はせずに、JSONディレクトリの中身のファイル達を直接プロジェクトに追加で回避できる。6月末に修正されたらしいので最新版を使えばだいじょぶかもしれない。
json-framework – Google Code

最低限のAPI仕様は

  1. http://twitter.com/statuses/friends_timeline.jsonへ
  2. ベーシック認証つきで
  3. GETメソッドでリクエストを投げる
上記3点が満たされていればOK。

例によってTwitter APIの詳細は公式wikiに譲る。
Twitter API Wiki / Twitter REST API Method: statuses friends_timeline

Three20の中でも今回は

を使う。

コードは以下。

コントローラ

FirstViewController.h

?View Code OBJECTIVE-C
#import
#import "Three20/Three20.h"
 
@interface FirstViewController : TTTableViewController {
 
}
 
@end


FirstViewController.m

?View Code OBJECTIVE-C
#import "FirstViewController.h"
#import "JSONDataSource.h"
 
@implementation FirstViewController
- (void)loadView {
	self.view = [[[UIView alloc] initWithFrame:[UIScreen mainScreen].applicationFrame] autorelease];
	self.view.backgroundColor = RGBCOLOR(240, 242, 245);
	self.variableHeightRows = YES;
       // STATUS_HEIGHTはTTGlobal.hで定義されてるステータスバーの高さを表す定数
	self.tableView = [[[UITableView alloc] initWithFrame:CGRectMake(0, 0, 320, 480 - STATUS_HEIGHT)
												   style:UITableViewStylePlain] autorelease];
	self.tableView.autoresizingMask =
    UIViewAutoresizingFlexibleWidth | UIViewAutoresizingFlexibleHeight;
	self.tableView.sectionIndexMinimumDisplayRowCount = 2;
	[self.view addSubview:self.tableView];
}
 
// この辺はTTTableViewControllerのdelegateメソッド
// ここで返したデータソースを使ってTTTableViewControllerが描画もろもろやってくれる
- (id)createDataSource {
	JSONDataSource *dataSource = [[[JSONDataSource alloc] init] autorelease];
	[dataSource load:TTURLRequestCachePolicyNoCache nextPage:NO];
	return dataSource;
}
 
- (UIImage*)imageForError:(NSError*)error {
	return [UIImage imageNamed:@"Three20.bundle/images/error.png"];
}
 
@end


データソース

JSONDataSource.h

?View Code OBJECTIVE-C
#import
#import "Three20/Three20.h"
 
@interface JSONDataSource : TTListDataSource {
@private
        // 読み込み中フラグ
	BOOL _isLoading;
       // 読み込み完了フラグ
	BOOL _isLoaded;
       // ここいらのフラグを見て読み込み中Activityとか出し分けしてる様子
}
 
@end


JSONDataSource.m

?View Code OBJECTIVE-C
#import "JSONDataSource.h"
 
static	NSString *username = @"username";
static	NSString *password = @"password";
 
@implementation JSONDataSource
 
- (id)init {
	if (self = [super init]) {
        	_isLoading = YES;
		_isLoaded = NO;
	}
	return self;
}
 
#pragma mark TTTableViewDataSource
 
- (void)load:(TTURLRequestCachePolicy)cachePolicy nextPage:(BOOL)nextPage {
       // この辺はTwitterポスト時とほぼ同じ
	static NSString *jsonUrl = @"http://%@:%@@twitter.com/statuses/friends_timeline.json";
	NSString *url = [NSString stringWithFormat:jsonUrl, username, password];
 
	TTURLRequest *request =
    [TTURLRequest requestWithURL:url delegate:self];
	request.cachePolicy = cachePolicy;
	request.response = [[[TTURLDataResponse alloc] init] autorelease];
	request.httpMethod = @"GET";
 
	BOOL cacheHit = [request send];
	NSLog((cacheHit ? @"Cache hit for %@" : @"Cache miss for %@"), jsonUrl);
}
 
#pragma mark TTLoadable
 
- (BOOL)isLoading {
	return _isLoading;
}
 
- (BOOL)isLoaded {
	return _isLoaded;
}
 
#pragma mark TTURLRequestDelegate
 
- (void)requestDidStartLoad:(TTURLRequest*)request {
	_isLoading = YES;
	_isLoaded = NO;
	[self dataSourceDidStartLoad];
}
 
- (void)requestDidFinishLoad:(TTURLRequest*)request {
        // 通常通りレスポンスゲット
	TTURLDataResponse *response = request.response;
	NSString *responseBody = [[NSString alloc] initWithData:response.data encoding:NSUTF8StringEncoding];
 
        // JSONFrameworkのメソッドでArrayとして受け取る。JSONの構造次第でNSDictionaryの可能性もあるのでAPI要確認
	NSArray *json =  [responseBody JSONValue];
 
	for(NSDictionary *result in json) {
                // JSON内のデータ構造はTwitter APIを参照
		NSDictionary *user = [result valueForKey:@"user"];
                // データソースの要素としてTTIconTableFieldをセット。これでアイコンとテキストがワンセットのテーブルになる。
		[self.items addObject:[[[TTIconTableField alloc]
                                                                // JSONからテキスト取得
								initWithText:[result objectForKey:@"text"]
								url:nil
                                                                // JSONから画像取得
								image:[user objectForKey:@"profile_image_url"]
                                                                // 画像読み込み前のデフォルト画像を指定。ここは自分で用意
								defaultImage:[UIImage imageNamed:@"DefaultAlbum.png"]] autorelease]];
	}
 
	_isLoading = NO;
	_isLoaded = YES;
	[self dataSourceDidFinishLoad];
}
 
// この辺はNSURLRequestでおなじみな感じ
- (void)request:(TTURLRequest*)request didFailLoadWithError:(NSError*)error {
	NSLog([error localizedDescription]);
	NSLog(@"didFailLoadWithError");
	_isLoading = NO;
	_isLoaded = YES;
	[self dataSourceDidFailLoadWithError:error];
}
 
- (void)requestDidCancelLoad:(TTURLRequest*)request {
	NSLog(@"requestDidCancelLoad");
	_isLoading = NO;
	_isLoaded = YES;
	[self dataSourceDidCancelLoad];
}
 
@end


以上で、こんな画面の出来上がり。

timeline

これだけで、ネットワーク接続エラー時の対応やデータキャッシュや読み込み中表示などをこちらが意識せずとも勝手にやってくれる。
※表示項目をよりtwitterクライアントにしたい場合は別途カスタマイズが必要。

JSONに関してはアクセス先のURLと取り出し方法の2つが外部APIに依存する部分なので、その辺をdelegateに任せるなりすればこのソースをうまいこと活用できると思う。

【UITableView】Groupedなテーブルのスクロールが重い

Posted by: daichi  /  Category: iphone開発

この件、前々から原因がわからずハマっていたのですが、暫定的な対処法がわかりました。

Groupedなテーブルというのは、テーブルのstyleがUITableViewStyleGroupedのテーブルのことで、こんな画面のことです。

総合画面

このようなGroupedな画面でスクロールさせると、アニメーションがコマ落ちしているような動きになっていました。

続きを読む

【UITableViewCell】カスタムCellが編集中に画面外にはみ出る

Posted by: daichi  /  Category: iphone開発

UITableViewで編集モードに入るとセルが右へスライドしますが
その時カスタムセルが画面外へはみだしたり、かぶってしまうという問題の対処法。

はみでる

かぶる

結論から言うと、自作したカスタムセルクラスのlayoutSubviewsメソッドでFrameを直書きで指定していたことが原因でした。

その時のコードはこちら。

続きを読む

【UITableView】UITableViewを使って詳細画面を作る-1【UITableViewDataSource】

Posted by: daichi  /  Category: iphone開発

前回まででUITableViewでリストを表示して、
行を選択すると別画面を表示するところまで
できました。

今回は行選択時にその行の詳細画面を表示する画面を
UITableViewを使って作ります。

学べること

  • コントローラ内でのデータをビューに表示する方法
  • UITableViewに必要なもの-datasource
続きを読む

【UITableView】選択行から別画面を呼び出す

Posted by: daichi  /  Category: iphone開発

今回はUITableVIewの行をタップした時に別画面を呼び出す
部分を作ります。

行をタップした時にプログラム内部ではUITableViewDelegateで定義されている
tableView:didSelectRowAtIndexPath:メソッドが呼ばれます。

なので、このメソッド内に別画面を呼び出す処理を書いていきます。

学べること

  • Interface Builderの基本的な使い方
  • UITableViewの行選択時の動作
  • navigation Controllerによる画面遷移
続きを読む

【UITableView】UITableViewにリストを表示する

Posted by: daichi  /  Category: iphone開発

今回はUITableViewにリストを表示します。
基本は前回の【UITableView】UITableViewに文字を表示すると同じで
表示内容をリスト化するといった内容です。

ゴールはこんな画面を表示することです。

配列の要素を表示
続きを読む

【UITableView】UITableViewに文字を表示する

Posted by: daichi  /  Category: iphone開発

iPhoneの設定画面等でおなじみの
UITableViewに文字を表示します。
UITableViewのHello Worldです。

ゴールはこんな画面を表示することです。
Helloを表示
続きを読む

Get Adobe Flash playerPlugin by wpburn.com wordpress themes