HelloWorldサンプルアプリ作成を通じてiOSアプリの作り方を知るためのドキュメント。(名前を入れてボタンを押すとgreetingを表示するアプリ)
注：2014/10/22 iOS7以降、およびXcode5以降では最初のサンプルが変わりました。こちらを参照→Start Developing iOS Apps Today。上にある原文のリンクもこちらにリダイレクトされます。当ページの説明はすでに古い内容になります。
注：iOS5およびXcode4.2になったことで、Interface Builderの使い方が大きく変わって、このサンプルも最新版(2011/10/12版）ではStory Boardを使う例に変わってます。従って、現時点では以下の記載は「動くけどiOS5の標準パターンではない」開発スタイルになってます。
2010-07-01版に従って記載
日本語訳もあるので、全体は訳さず肝心なところだけメモ
このドキュメントでわかること
目次
一般的なMVCの記述なので割愛。
1.main関数が呼ばれるとUIAplicationMainクラスが呼ばれる(main関数で約束のように呼んでいる）
int retVal = UIApplicationMain(argc, argv, nil, nil);
2.UIAplicationMainはUIAplicationクラスが生成されたのち、info.plistから<NSMainNibFile>の情報を検索する。この場合plistのエントリには"MainWindow"と書かれているので、"MainWindow"というnibファイル(.xib)がロードされる。
(IBを詳細表示することはあまりないがファイル名などわかりやすいように表示)
3.セットアップが終わるとDelegateに対して application:didFinishLaunchingWithOptions: メッセージを送信する。（この後でアプリ固有の初期処理が始まる）Delegateはそれを受けると通常はアプリを生成するのではなく、
※詳細は後述。この流れについては「」でも説明があった。
アプリケーションDelegateはテンプレートで作成されるが、ViewController はないのでこれから作成する。
アプリが起動している間、View Controllerを存続させるために、Delegateのインスタンス変数に View Controller を追加する（※Delegateからの参照カウントが残っている限り解放されないようにするため）
HelloWorldDelegateのinterfaceは以下のような感じになる。なお、MyViewControllerの前方参照のために @classを指定してプロトタイプ宣言している。
→"MyViewController.h"をimportしてもよい。
@propertyディレクティブを使っているので、getter/setterが自動的に生成される。またretain(保持)を指定している。
HelloWorldAppDelegate.hの内容
#import <UIKit/UIKit.h>
@class MyViewController;
@interface HelloWorldAppDelegate :NSObject <UIApplicationDelegate> {
UIWindow *window;
MyViewController *myViewController;
}
@property (nonatomic, retain) IBOutlet UIWindow *window;
@property (nonatomic, retain) MyViewController *myViewController;
@end
①
MyViewController *aViewController =
[[MyViewController alloc]
initWithNibName:@"MyViewController" bundle:[NSBundle mainBundle]];
②
[self setMyViewController:aViewController];
③
[aViewController release];
※initWithNibName:bundle:でnibファイル名を間違えていてもそのタイミングではエラーにならない(少なくともシミュレータでは）。
前の処理でallocしたView Controllerはrelaseされているが、インスタンス変数の方に対してViewを依頼する。
UIView *controllersView = [myViewController view]; [window addSubview:controllersView];
※ここでviewを取り出しているが、allocなどMemory Management Rulesで指定されている手段で生成しているわけではないので、インスタンスは個別に保持されないためreleaseも不要。
上の処理が終わってから以下の処理を呼ぶ。
[window makeKeyAndVisible];
この処理を呼ぶと画面が描画されてしまうので、アプリの準備（Viewの登録を含む)が終わるまで呼んではいけない。
deallocメソッドでインスタンスの解放を行う。
- (void)dealloc {
[myViewController release]; //インスタンス変数に保持していたのでreleaseする
[window release]; // windowもreleaseする
[super dealloc];
}
interfaceで@property宣言していたものについて、sette/getterを宣言通り生成させるために @synthesizeを行う。
interface @property (nonatomic, retain) IBOutlet UIWindow *window; @property (nonatomic, retain) MyViewController *myViewController;
↑↓
implements @synthesize window; @synthesize myViewController;
MyViewController.xibファイルを開いたところ。(ソースを作るときにInterfaceBuilderを使うとチェックしたので作成されている）。MainWindow.xibとは構成要素が違う。viewはこのViewControllerが表示するViewとして独立している。
File's Ownerを選択してControl+クリックすると接続状態を表示できる。
OutletとしてViewControllerのviewが確認できる。ViewControllerのview(ここではインスタンス変数）がViewオブジェクトに接続されているので、UIViewインスタンス(View)がロードされたときにはViewControllerのview変数の内容がViewに設定されることになる。
ここまでDelegateと、テンプレートで生成したViewControllerしかつくっていないが、正しく動くかどうかを確認するために、Viewの背景色を変えてみる。Interface Builder でViewオブジェクトのattributeからBackgroundを変更して動かしてみる。シミュレータの画面にも反映されてるのがわかったら元に戻しておく。
View(の画面）に部品を配置する。
Interface Builder でテキスト(UITextField)、ラベル(UILabel)、ボタン(UIButton)を配置する。最初にするのは
テキストフィールドは他にもいくつか設定しておくことがある。
※今回は入力方法が決まっているのでInterface Bulderの作業だけでよい(プログラムが動的に制御する必要がない）
上の設定によって、テキストフィールドでタップするとキーボードがでるようになる。ただし今は閉じる処理がない。
※なお、地域設定もまだいじってないのでキーボードは日本語モードに切り替えることができない。
MyViewController.hのソース
#import <UIKit/UIKit.h>
@interface MyViewController : UIViewController <UITextFieldDelegate> {
UITextField*textField;
UILabel*label;
NSString*string;
}
@property (nonatomic, retain) IBOutlet UITextField *textField;
@property (nonatomic, retain) IBOutlet UILabel *label;
@property (nonatomic, copy) NSString *string;
- (IBAction)changeGreeting:(id)sender;
@end
ポイント
Interface Builder でつくったViewの画面とクラスを接続させる。 「File's Owner」を選択してControl+クリックすると接続の一覧がでるので、それぞれ接続する。
※nibファイル側の画面部品に名前がついていてその名前で画面項目にアクセスするのではなく、画面部品には名前がないけどもViewControllerのOutlet(インスタンス変数）と画面部品をひも付けているので、アプリはインスタンス変数を読み書きするだけでよい。
ちなみに一覧を出さなくても、「File's Owner」から線を延ばして「テキストフィールド」で選択すると、オブジェクトの型が一致している「textField」しか選択肢に出てこないので、こっちからでもよい。(一覧を出した方が、接続状況がわかりやすいけど）(図はテキストフィールドに対して、ViewControllerのOutletのどの項目を接続するかを選択している場面）
ボタンからアクションにつなぐには、ボタンを選択してからControl+クリックで接続一覧をだして「Touch Up Inside Events」から「File's Owner」に接続させる(ボタン→File's Owner）(ボタンから手を離したときに発生するイベント）
※ガイドでは上の説明になっていたが、ボタンイベントであれば（ボタン側の接続一覧を出さなくても）ボタンから「File's Owner」に線を延ばして、「Events」の選択肢からメソッド名(changeGreeting)を選べば早いはず。
なおキーボードで Retun を押すと(タップすると）、Delegateにそのイベントが来るのでそのタイミングでキーボードを閉じればよい(その処理は後述）。 ここでは、テキストフィールドのOutlet「delegate」を「File's Owner(つまりMyViewController)」に接続することでDelegateを設定しておく。
インターフェースで@property宣言をしていた変数を実装する。つまり@synthesizeして、アクセッサを生成させる。
@synthesize textField; @synthesize label; @synthesize string;
また、@propety宣言の際にいずれも retainまたはcopyの所有権を持つ指定にしていたため、最後にメモリを解放する必要がある。deallocメソッドに処理を追加する。
- (void)dealloc {
[textField release];
[label release];
[string release];
[super dealloc];
}
ボタンをタップするとView Controllerに changeGreeting:メソッドを送ってくるので(Interface Builderでそう設定したから）、メソッドの中身を実装する。テキストフィールドに入力された文字列を使ってラベルを更新する。
テキスト入力があれば「Hello, + 入力 + !」を、なければ「Hello, World!」を表示する。
- (IBAction)changeGreeting:(id)sender {
// テキストフィールドに入力文字列をコピーする
self.string = textField.text;
NSString *nameString = string;
if ([nameString length] == 0) {
nameString = @"World";
}
// initWithFormat:を使って書式整形する。空のallocがいるのはちょっと面倒くさい
NSString *greeting = [[NSString alloc] initWithFormat:@"Hello, %@!", nameString];
label.text = greeting;
[greeting release];
}
テキストフィールドの内容は必ず自分のインスタンス変数にコピーすること。「一般に、コントローラは、アプリケーショ ンデータを、固有のModelオブジェクト内に保持しなければなりません。アプリケーションデー タをユーザインターフェイス要素内に格納してはいけません。」とのこと。
いまのままではchangeGreeting:が呼ばれてもキーボードを閉じることが出来ない。
iOSでは、テキストフィールドが「ファーストレスポンダ(first responder)」になっているときにキーボードが表示され、そうでなくなると閉じられるようになっている。キーボードと直接通信する方法はないが、ファーストレスポンダ状態を変えればキーボードを閉じることはできる。
ファーストレスポンダについてはiOS Application Programming Guideの"「The Event-Handling System」"参照。
UITextFieldDelegateプロトコルは、「Done」が押されたときにテキストフィールド（のDelegate)を呼び出すtextFieldShouldReturn:を用意している。MyViewControllerは UITextFieldDelegateに対応させているしInterface Builderでもテキストフィールドのdelegateとして接続してあるので、呼んでもらえる。
textFieldShouldReturn:メソッドが呼ばれたら、テキストフィールドにresignFirstResponderメッセージを送ることによって、ファーストレスポンダでは無くなるようにできる。
- (BOOL)textFieldShouldReturn:(UITextField *)theTextField {
if (theTextField == textField) {
[textField resignFirstResponder];
}
return YES;
}
このアプリではテキストフィールドは１つしかないのでイベント送信元をチェックする必要はないが、一般的には処理対象オブジェクトか確認する必要がある。
※サンプル自身はここで完成。
上の例ではユーザーインターフェース要素をすべてInterface Builderで作成したが、実際にはプログラム内で制御することも多い。 うえのテキストボックスを仮にプログラムで生成した場合を示す。
viewDidLoadメソッドをオーバーライドして、nibファイルからのview(ラベルとボタンは残っている）のロード後にテキストを追加する。
以下のような処理。
- (void)viewDidLoad {
// テキストフィールドサイズを指定して生成
CGRect frame = CGRectMake(20.0, 68.0, 280.0, 31.0);
UITextField *aTextField = [[UITextField alloc] initWithFrame:frame];
self.textField = aTextField;
[aTextField release];
textField.textAlignment = UITextAlignmentCenter; //Textアライメント設定
textField.borderStyle = UITextBorderStyleRoundedRect; //テキストフィールドのかどを丸く(IBで選んだときと同じにする）
textField.autocapitalizationType = UITextAutocapitalizationTypeWords; // IBで設定したCapitalize属性
textField.keyboardType = UIKeyboardTypeDefault; // IBで設定したKeybord type属性
textField.returnKeyType = UIReturnKeyDone; // IBで設定したReturn Key属性
textField.delegate = self; // 前はTextFiedのDelegateをViewControllerに接続していたので同様に自分を指定。
[self.view addSubview:textField]; // サブビューとしてテキストフィールドを追加
}
本文です
]]>