AppCode 2019.1ヘルプ

クイック・スタート・ガイド

このクイックスタートガイドは、主要なAppCodeの概念を紹介し、IDEをすばやく開始するのに役立つように設計されています。

ステップ 0:開始前

そもそも Xcode は必要ですか?

そうです。Xcodeが利用可能でなければ、AppCodeは実行されません。

どのバージョンのXcodeをインストールする必要がありますか?

上記のインストール要件セクションを確認してください。

AppCodeとXcodeの両方を同時に使用できますか?

AppCodeは同じプロジェクトモデルとプロジェクトファイルを使用し、すべての変更をXcodeと同期させます。両方のIDEで同時に作業したり、変更したり、前後にジャンプすることができます。AppCodeは、すべてが同期して最新であることを確認します。

AppCode macOSのみですか?

はい、AppCodeはXcodeを必要とし、XcodeはmacOS上で動作するためです。

AppCodeで編集した後、私のプロジェクトでXcodeで作業することはできますか?

はい、AppCodeはXcodeと同じプロジェクトモデルを使用します。

ステップ 1. AppCodeでプロジェクトを開く/作成する

既存のプロジェクトを開く

コンピューターに保存されている既存のプロジェクトの1つを開くことから始めます。Welcome画面からこれを行うことができます。プロジェクトを開くをクリックして、xcodeproj または xcworkspace ファイルを見つけます。

ac QSG Create

AppCodeはXcodeと完全に互換性があります:同じプロジェクトモデルとプロジェクトファイルを使用し、すべての変更をXcodeと同期させます。両方のIDEで同時に作業したり、変更したり、前後にジャンプすることができます。AppCodeは、すべてが同期され、最新のものになるようにします。

バージョン管理から既存のプロジェクトをチェックアウトする

VCSのストレージまたはリポジトリからソースをダウンロードすることもできます。Git、GitHub、CVS、Mercurial、Subversion、PerforceまたはTFSを選択してから、ストレージにアクセスするための認証情報を入力します。次に、ソースへのパスを入力し、リポジトリをローカルホストに複製します。

ac QSG CloneRepo

新規プロジェクトの作成

ac QSG CreateNew
AppCodeはすべてのXcodeテンプレートをサポートしているため、Xcodeと同じ方法で新しいプロジェクトを作成できます。

ステップ 2. 周囲を見る

プロジェクトを開くと、メインウィンドウがいくつかの論理領域に分割されて表示されます: ここで主要なUI要素を見てみましょう:

ac QSG UIelements
  1. 左側のプロジェクト・ビューは、Xcodeのようにおなじみの方法でプロジェクトを表示します。

  2. 右側のスマートコードエディター には、開いているファイル間を簡単に移動するためのタブがあります。

  3. エディターの上のナビゲーション・バーを使用すると、アプリケーションをすばやく実行、デバッグ、テスト、プロファイリングすることができます。

  4. 左ガター : エディターの横にあるこの垂直ストライプは、ブレークポイントを表示し、定義、サブクラス、スーパークラスなどのコード階層をナビゲートする便利な方法を提供します。行番号と行単位のVCS履歴も表示します。

  5. 右ガター : AppCodeは常にコードの品質を追跡し、コード分析の結果をエラーや警告などの右側のガターに即座に表示できます。右隅の四角はファイルのコード分析の全体的なステータスを示します。

  6. ツール・ウィンドウは、ワークスペースの底面と側面に取り付けられた特殊なウィンドウです。これらは、プロジェクト管理、ソースコードの検索とナビゲーション、実行とデバッグ、バージョン管理システムとの統合などの典型的なタスクへのアクセスを提供します。

  7. ステータスバーは、プロジェクトとIDE全体のステータスを示します。また、ファイルのエンコーディング、行セパレーター、インスペクションプロファイルなどのさまざまな警告と情報メッセージも表示されます。さらに、デバッグとリリースのコンテキスト(デバッグ情報の有無にかかわらず)を切り替えるためのコンテキスト・リゾルバを選択すると、IDE内のコードを目的の定義で解決できます。

ステップ 3. 環境をカスタマイズする

IDEを自由に微調整して、ニーズに完全に合ったものになるようにしてください。また、できる限り便利で快適です。利用可能なカスタマイズオプションのリストを見るためにAppCode | 環境設定に行きなさい。

外観

最初に微調整するのは、一般的な「ルック・アンド・フィール」です。AppCode | 環境設定 | 外観および振る舞い | 外観に移動して、IDE テーマを選択します:デフォルトのライトテーマ、より暗い設定を希望する場合はDarcula、またはXcodeテーマ。

エディター

AppCode | 環境設定 | エディターで利用可能な多くの画面は、エディターの動作のあらゆる面を調整できます。ここでは、一般的な設定(Drag'n' Dropの有効化やスクロール設定など)、使用可能な言語とユースケース、タブとコードの折りたたみ設定、コード補完の動作、さらには後置テンプレートの色設定など、さまざまなオプションがあります。

コード・スタイル

コード・スタイルの設定は、AppCode | 環境設定 | エディター | コード・スタイルの各言語で定義できます。これらを使用すると、コードを記述するときに、追加の操作を行うことなくコードを自動的にフォーマットすることができます。独自のコーディングスタイルスキームを作成して保存することもできます。

ac QSG Preferences

キーマップ

AppCodeはキーボード中心のアプローチを採用しています。つまり、IDEで可能なすべてのアクションがキーボードショートカットにマッピングされています。キーボードショートカットのセットはあなたの最も親密な習慣の1つです。あなたの指は特定のキーの組み合わせを「覚えて」います。この習慣を変えるのは簡単です。

AppCodeは素晴らしいデフォルトのキーマップ(メインメニューでヘルプ | デフォルトのキーマップ参照を選択)を提供するため、コーディングは非常に生産的で便利です。ただし、AppCode | 環境設定 | 外観および振る舞い | キーマップを使用していつでも変更することができます。あらかじめ定義されたキーマップ(Xcode、Emacs、Visual Studio、Eclipse、NetBeansなど)もあり、既存のキーマップを作成することもできます。

ステップ 4. スマートアシスタンスによるコード

AppCodeは重要なことに集中できるようにルーチンを処理します。貴重な時間を無駄にすることなく、エラーのないアプリケーションを作成するには、次のコーディング機能を使用します。

コード補完

コード補完は、作業しているファイルの種類に関係なく、時間を節約してくれます。AppCodeには、basic(⌃Space)とsmart(⌃⇧Space)という2種類のコード補完があります。基本補完機能は、名前を入力して即座に名前を入力するときに機能します。スマート補完は現在作業中のコンテキストを分析し、その分析に基づいてより正確な提案を提供します。式の型に合わせて関数と変数のリストをフィルタリングします:

ac QSG CodeCompletion

インテンション・アクション

AppCodeは現在何をしているかに注目し、あなたの時間をより節約するためにインテンションアクションと呼ばれるスマートな提案をします。電球で示されるインテンションアクションは、正しいコードに自動的な変更を適用することを可能にします(コードインスペクションが間違っている可能性があるコードのクイックフィックスを提供するのとは対照的に)。文字列をすばやくローカライズしますか、それともフォーマット文字列として使用しますか。AppCodeでは問題ありません。電球をクリックして(または ⌥⏎を押して)推奨されるオプションの1つを選択します。

ac QSG IntentionAction
利用可能なインテンションアクションの全リストはAppCode | 環境設定 | エディター | インテンションにあります。

ステップ 5. コードをきれいに保つ

AppCodeは常にコードの品質を追跡し、潜在的なエラーや問題を検出し、それらに対する迅速な修正を提案します。未使用のコード、未解決のメソッド、ローカライズされていない文字列、または関数内の無効なパラメータなど、潜在的な問題が見つかるたびに、左のガターに電球が表示されます。それをクリックするか、修正を適用するために ⌥⏎ を押してください

ac QSG KeepCode

また、コード解析を一括モードで実行して、プロジェクトの潜在的な問題をすべて確認し、直ちに修正することもできます。これを行うには、メインメニューからコード | コードのインスペクションを選択します。

利用可能なインスペクションの全リストについては、環境設定 | エディター | インスペクションを選択してください。それらのいくつかを無効にしたり、他のものを有効にしたり、各インスペクションの重大度を調整することができます。それをエラーとみなすべきか、それとも単に警告するのかを決定します。

ステップ 6. いくつかのコードを生成する

AppCodeを使用すると、使い方から新しいクラス、メソッド、カテゴリを作成することができます: コードに定義を書いたり、パラメータを使ってメソッド名を入力したり、⌥⏎ を押してメソッドやクラス定義を自動的に作成してください:

ac QSG GenerateCode

AppCodeの追加新しいクラス、プロトコル、カテゴリ、Xcodeテンプレートのファイルなどは簡単です。メインメニューからファイル | 新規...を選択するか、または ⌘Nを押します。リストから要素を選択してその名前を入力します。

AppCodeには、幅広いコード生成オプションがあります。ループ、NSLog呼び出し、プロパティー宣言が必要ですか? XZコードスニペットの代わりになるライブ・テンプレートを使用してください。頭字語を入力して を押します。

⌥⌘T のショートカットで利用できる囲むテンプレートもあります。コードブロックを選択し、ifelse@try@catch@autoreleasepool、または環境設定 | エディター | ライブ・テンプレートで定義できる独自の構造で ⌥⌘T を囲むようにヒットします。

メインメニューのコードには、さまざまなコード生成オプションがあります。

  • オーバーライド/実装メソッド(⌃O / ⌃I) - 単一のショートカットで複数のメソッドをオーバーライドまたは実装します。

  • メンバーの宣言 - どこかをナビゲートする必要なしに、インターフェースまたはプライベートカテゴリでメンバーを宣言するか、または実装内で1秒で保持します。

  • 生成⌘N) - -initWith メソッド、-isEqual: または -hash, アクセサーメソッドなど、さまざまな構造を自動的に作成する強力なコード生成ツールです。

ステップ 7. あなたの方法を見つける

プロジェクトが成長し、他の人のコードを扱うときには、関心のある要素を素早く見つけてコードを詳しく調べることが重要です。AppCodeには、どのようなコードを使っても、どのように絡まっていても自分の道を見つけるのに役立つ一連のナビゲーション機能が備わっています。

基本的な検索

プロジェクトのソースコードを調べるときには、実際にこのシンボルが使用されている場所を知ることが重要です。それを見つけるには、シンボルの名前にキャレットを置き、⌥F7を押します。

ac QSG FindUsages
AppCodeは、テキストマッチだけでなく、実際の使用箇所を見つけます。さらに、ローカライゼーション、コアデータ、xib ファイルを理解し、使用することができます。

通常の全文検索が必要な場合は、⌘F を押して現在のファイルを検索するか、⇧⌘F を押して任意のスコープ、ディレクトリー、またはプロジェクト全体を検索してください。

プロジェクトのナビゲーション

ファイル構造をインポートや呼び出しの階層で見るだけで、多くのことを知ることができます。

左側のガターのアイコンは、ナビゲーションにも役立ちます。

クイック定義とドキュメント

クイック定義⌥Space)は、メソッドの内容をジャンプすることなく表示できます。 ⌘P (パラメーター情報)を押すと、このメソッドで使用できるパラメータのリストが表示されます。

ドキュメントについては、F1を押してください。AppCodeは、環境設定 | エディター | 外部ドキュメントを選択することで有効にできる2つの外部ドキュメントブラウザダッシュ材料もサポートしています。

タイムラインをナビゲートする

プロジェクト内のすべてのアクティビティを覚えておくと、AppCodeは最近使ったファイル⌘E)または最近変更したファイル⌥⇧C)に簡単にナビゲートできます。変更の履歴を確認するには、戻る/進むナビゲーション(⌘[ ⌘])を使用するか、最後の編集場所(⇧⌘⌫)に移動してください。

アクションの検索

AppCodeで可能な多くのスマートアクションを活用しましょう。例:アクションの検索検索(⇧⌘A)を使用します:アクション名の一部を入力するだけで、利用可能なすべてのオプションのリストが表示されます。次に、必要なアクションを選択します。

ac QSG FindAction

どこでも検索

探しているものについて一般的な考えがある場合は、既存のナビゲーション機能のいずれかを使用して、対応する要素を見つけることができます。しかし、本当にあらゆる面で何かを探したいと思ったらどうしますか?答えはどこでも検索を使用することです! それを試すには、ウィンドウの右上隅にある虫めがねをクリックするか、Shiftキーを2回押します。

ステップ 8. リファクタリング

コードデザインは時間とともに進化するため、コードデザインを簡単に改善できることが重要です。AppCodeの最も際立った特徴の1つはそのリファクタリング機能です:常に手元にあり、安全で正確。これらは、名前の変更、移動、抽出、インライン、シグネチャーの変更、メンバーのプルアップ、メンバーのプッシュダウンなど、重要なものを含め、本当に信頼できるリファクタリングです。

安全に名前を変更する

名前変更を使用する場合は、すべての変更が安全に適用されていることを確認する必要があります。心配する必要はありません - それはAppCodeの正確な方法です。任意の要素(変数、クラス、メソッド、プロパティー)にキャレットを置き、名前を付けて ⇧F6を押します。名前の変更は、xib、ストーリーボードファイル、ローカライゼーションファイルなどのコード以外のアプリケーションでも機能します。

抽出/インライン

たくさんのリファクタリングでコードを素早く動かすには、変数をインライン展開するか、式を変数に抽出することを検討してください。完全なコードブロックを新しいメソッドに抽出し、パラメーターの導入リファクタリングを使用してそれにパラメータを追加することもできます。

リファクタリング

ソースコードをリファクタリングするのは簡単なはずです。そのため、AppCodeでは、⌃T を押すだけで、現在のコンテキストに適したリファクタリングを確認できます。

ステップ 9. 実行とデバッグ

コードを操作して、それを使って何ができるのかを発見したら、今度はあなたのアプリを実行しましょう。AppCodeでは、これはいわゆる実行/デバッグ構成によって行われます。利用可能なすべてのオプションを表示するには実行 | 構成の編集を開きます。

AppCodeの実行構成は、Xcodeスキームを反映し、それらと同期します。実行⌃Rデバッグ(AppCodeの⌃D は2つの異なるアクションです)。アプリケーションをデバッグモードで起動すると操作が重くなり、問題を特定するのが難しくなることがあります。ブレークポイントで停止せずに、あなたのユーザーと同じ方法で使用してみてください。

デバッグ

AppCodeのデバッガは、アプリケーションの完璧なランタイムビューを提供します。ブレークポイントを停止すると、使用可能なすべての変数、コレクションおよび辞書の内容、さらにはCore Dataオブジェクトのプロパティーの実際の値の説明が表示されます。時間を無駄にしないでください。代わりに問題を調査してください。

ac QSG Debug

任意の式の値を評価する必要がある場合は、式の評価機能を強くお勧めします。評価が必要な式を選択し、⌥F8 を押して、デバッガウィンドウに表示されているのと同じ方法で結果を確認します。

ac QSG EvaluateCode

ステップ 10. テストの作成と実行

テスト駆動開発をお楽しみの場合、AppCodeはそのままCatch、Boost.Test、Google Test、およびXCTestベースのテストフレームワーク(QuickおよびKiwiを含む)を完全にサポートするため、使用するのに適したツールです。

テストを作成するには、ファイル | 新規 | Xcodeテンプレートからのファイルに進み、AppCodeがテンプレートから標準のXCTestテストを生成します。テスト用または環境設定 | エディター | ファイルおよびコード・テンプレートの他のファイル用に独自のテンプレートを作成することもできます。

AppCodeでは、一度にすべてのテストを実行することも、単一のテストを実行することもできます。ニーズに合わせてさまざまなテスト構成を作成します。実行構成でテストターゲットを指定します。テスト設定を実行するには、実行ポップアップ(⌃⌥R)を呼び出して必要なものを選択するだけです。
ac QSG run

テストランナーは、テスト結果を専用のテストビューに表示します。テストビューでは、テスト結果を表示したり、問題にナビゲートしたり、テスト実行統計を表示したり、失敗したテストを再実行したりすることができます。

ac QSG testRunner

ステップ 11. ソースコードをバージョン管理に置く

VCS

ソースコードをバージョン管理下に置いている場合は、AppCodeが多くの一般的なバージョン管理システム(Git(またはGitHub)、Mercurial、Perforce、TFS、Subversion、およびCVS)と統合されていることを知って喜んでいただけるでしょう。

資格情報と特定のVCS固有の設定を指定するには、環境設定 | バージョン管理に移動します。VCSメニューは、使用可能なコマンドについてのヒントを提供します。例:変更点を確認し、コミットしたり、変更リストを作成したりできます。変更点を表示します(または単に N/Aを押してください)。いくつかの基本的なコマンドは、エディター上のナビゲーションバーで簡単に見つけることができます:

ac QSG VCS

ローカル・ヒストリー

従来のバージョン管理に加えて、ローカル・ヒストリーを使用することができます。ローカル・ヒストリーを使用すると、AppCodeはソースコードの変更、リファクタリング結果などを自動的に追跡します。ローカル・ヒストリーは常に有効です。ファイルまたはフォルダーを表示するには、VCS | ローカル・ヒストリー | ヒストリーの表示を選択します。変更内容を確認したり、元に戻したり、パッチを作成したりできます。

以上です! 喜んで開発してください!

AppCodeの基本的な機能の概要を紹介していただければ幸いです。開発者の生活をより簡単で楽しくするための重要な機能がたくさんあり、ソースコードはより洗練されたものになります。最初のいくつかのステップを今すぐ行い、ちょうどいいタイミングだと感じたら深く掘り下げてみてください。AppCodeを楽しみましょう!

ご質問がある場合は、アプリケーションコードディスカッションフォーラム(英語)Twitter(英語)ブログ(英語)を参照してください。ニュース、アップデート、便利なヒントやテクニックを見つけることができます。また、サポートチームまたはAppCode issue tracker(英語)に問題を報告してください。

最終更新日: 2019年4月18日

関連ページ:

AppCodeのインストールとセットアップ

インストール要件ハードウェア要件4 GBのRAMを推奨1024x768の最小画面解像度ソフトウェア要件Xcode 9.4 - 10.2JRE 1.8はAppCodeディストリビューションにバンドルされています。AppCodeを実行するには、コンピューターにJavaをインストールする必要はありませ...

プロジェクトのオープン、再オープン、クローズ

AppCodeは、Xcodeと同じプロジェクトモデルと構造を使用します。AppCodeで作成されたプロジェクトはXcodeで開くことができ、その逆も可能です。AppCodeでは、複数のプロジェクトを異なるウィンドウで同時に開くことができます。デフォルトでは、別のプロジェクトを開いている間にプロジェク...

AppCodeによるバージョン管理

VCS 操作のポップアップ(⌃VまたはVCS | VCS 操作のポップアップ)を使用すると、VCS関連のコマンドをすばやく呼び出すことができます。ポップアップ内のアクションのリストは、現在有効になっているVCSによって異なります。VCS 操作ポップアップコマンドのリストは設定可能です - AppC...

プロジェクトツールウィンドウ

このツールウィンドウを使用すると、プロジェクトをさまざまな観点から見て、新しい項目(ディレクトリー、ファイル、クラスなど)の作成、エディターでのファイルの開き、目的のコードフラグメントへの移動などのタスクを実行できます。このツールウィンドウ内のほとんどの機能は、コンテンツペインおよび関連するショート...

AppCodeエディター: ガイド付きツアー

基本AppCodeエディターは、ソース・コードを作成および変更するための強力なツールです。ほかのIDEエディターと同様に、ブックマーク、ブレークポイント、構文の強調表示、コード補完、ズーム、コードブロックの折りたたみなどの基本機能をサポートします。それだけでなく、マクロ、強調表示されたTODO項目、...

ナビゲーション・バー

ナビゲーションバーはプロジェクトツールウィンドウの簡単な代替品です。バーの左側で、プロジェクトと編集用のファイルを開くを通してナビゲートすることができます。右側には、実行/デバッグ構成セレクタにアクセスし、を実行し、ボタン、バージョン管理ボタン(バージョン管理の統合が有効な場合)、およびどこからでも...