情報の検索
アプリを開発する際、あなたが学んだ以上の情報を手元で欲しいでしょう。Xcode を離れることなく、必要なすべての情報を得ることができます。
Xcode は、一般的で概念的なガイド、フレームワークとクラス・リファレンス、および焦点を絞ったヘルプを含むさまざまな種類を含む大規模なドキュメントスイートが付属しています。コンテキスト・アウェア・コード・ヘルプをメイン・プロジェクト・ウィンドウにクイック・ヘルプ・ペインを開く、またはドキュメント・ビューアでガイドの検索と完全な API のリファレンスを見つけ、それらを使用する方法については、Xcode の UI 要素を Control-クリックしてこの資料にアクセスすることができます。
Xcode のガイドは文脈ヘルプ記事使用
Xcode 自体を使用する際にヘルプを表示するには、ヘルプの記事をちょっと見ましょう。ヘルプ記事は、インターフェースビルダーで新しいクラスを作成したり、カスタムクラスを設定したりする普通の仕事を完了する方法を示し、自動レイアウトでその問題を解決します。
あなたがやろうとしている事にもよりますが、Xcode で UI 要素上で Control-クリックすることにより、いくつかのヘルプ記事にアクセスできます。コンテキスト (文脈) メニューにある (この画像では、プロジェクト・ナビゲーター (Project Navigator) ヘルプ) 最後のエントリを探します。
一般的なヘルプ、または Control-クリックをサポートしていない要素に関連するタスクについての情報を探している場合は、Xcode の[ヘルプ(Help)]メニュー内のコンテキスト·ヘルプで検索できます。
一般・概念的概要でガイドを使用
新しい技術を学ぶため、また一緒にフレームワークで作業を進める際の異なるクラスのより深い理解を得るために、プログラミング・ガイドの一つを見てみましょう。ほとんどの Cocoa フレームワークと技術には、スプライトキット・プログラミングガイド、Objective-C でプログラム、ロケーションとマップのプログラミングガイド などに関連付けられたプログラムガイドがあります。
Xcode でこれらのドキュメントを表示するには、[ヘルプ(Help)] > [ドキュメントと API リファレンス](Shift +コマンド+O) を選択してアクセスできる ドキュメント・ビューア を使用して下さい。単純に Sprite Kit のように技術の名前を入力します。
結果は、コードを書いている時に最も有用である順に並んでいます。これは、トップヒットを見て、API リファレンスが続き、SDK とツールガイドが続きます。
適切な結果がポップアップリストに表示されない場合は、何も選ばないで [Return] を押して全ての結果を表示する事ができます。これはフィルターできる結果の完全なセットを表示します。
クラスの情報は API リファレンス使用
技術のさまざまな事を学ぶためのガイドを読んで、その技術を使用するコードを書き始めるときには、おそらく個々のクラスが何ができるかについてす知る必要があり、特定のメソッドを呼び出す正しい方法を知る必要があることがわかります。この情報は、API リファレンス ドキュメントによって提供されます。
たとえば、以前のチュートリアルで使用した NSString クラスの詳細については、ドキュメント・ビューアの検索フィールドに単にクラスの名前を入力して下さい。
トップヒットは通常、あなたが欲しいものです。Return キーを押して選択して、そのクラスの API リファレンスを参照してください。
API リファレンス・マニュアルは、個々のクラスの情報にすばやくアクセスする方法を与え、クラスが実行するメソッド、プロパティ、親クラス、採用したプロトコル、そしてタスクを含んだ情報を提供します。クラスの一般的な情報を見るには「さらに関連する項目(More related items)」をクリックしてください。
関連項目のポップオーバー(*)は、関連するガイドの一覧も示します。NSString では、例えば、参考資料を深く掘り下げるよりも、多くの概念的な概要が欲しい場合には、文字列プログラミングガイド をお読みください。
(*)訳注：プルダウンの反対語です。
コンテキストソースコードの情報は、クイックヘルプを使う
ソースエディタでコードを書くときは、クイックヘルプ・ペインの API リファレンス・マニュアルには、 ([表示(View)] > [ユーティリティ(Utilities)] > [クイックヘルプ・インスペクタを表示(Show Quick Help Inspector)]を選択) で簡単にアクセスできます。クイックヘルプ(Quick Help) は、現在入力しているシンボルに関する情報を表示し、コードを書くにつれて更新します。
または、クイックヘルプの情報をポップアップウィンドウに表示するには、ソースエディタでシンボルをOption-クリックします。
クイックヘルプペインまたはポップアップウィンドウから、ドキュメント・ビューア・ウィンドウで API リファレンスを開き、クリックしたシンボルの宣言を含む元のヘッダーファイルを表示することができます。
実際の世界の使用を見るには、サンプルコードを使用
書かれた資料に加えて、サンプルコード のライブラリにアクセスできます。クイックヘルプ、またはドキュメント・ビューア内のガイドとリファレンスを見るたびに、与えられた技術やクラスに関連するサンプルコード・プロジェクトを示すエントリが表示されます。
サンプルコードのエントリのいずれか一つをクリックしてダウンロードし、Xcode で開いてコードを調べることができます。
前の章：iOS テクノロジー
次の章：ここからどこへ行く