【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

参考

【UIVIewController】iPhoneを横向きにした時に別画面を表示する方法

Posted by: daichi  /  Category: iphone開発

これだいぶやられました。
こんな風にただ横向きに画面を表示したいだけなのですが、ハマり倒しました。

横向き画面

二度とやられないためにもここに残します。

続きを読む

【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による画面遷移
続きを読む

Get Adobe Flash playerPlugin by wpburn.com wordpress themes