アプリケーションコード2018.2 Help

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

このクイックスタートガイドは、主要な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つである開けるから始めます。これは、プロジェクトを開くをクリックして、 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の有効化やスクロール設定など)、使用可能な言語とユースケース、タブとコードの折り畳み設定、コード補完の動作、さらにはPostfixテンプレートの色設定など、さまざまなオプションがあります。

コード・スタイル

コード・スタイルの設定は、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

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

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

⌥⌘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 (Parameter Info)を押すと、このメソッドで使用できるパラメータのリストが表示されます。

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

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

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

アクションの検索

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

ac QSG FindAction

どこでも検索

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

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

時間とともに進化するにつれてコード設計を容易に改善できることが重要です。 AppCodeの最も顕著な機能の1つはリファクタリング (refactoring)の能力です。常に手元にあり、安全で正確です。リネーム、移動、抽出、インライン、署名の変更、メンバーの引き上げ、メンバーの引き下げなど、本当に信頼できるリファクタリングです。

安全に名前を変更する

名前変更を使用する場合は、すべての変更が安全に適用されていることを確認する必要があります。心配する必要はありません - それは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はOCUnitとKiwiのテストフレームワークを完全にサポートするので、使用するのに適したツールです。

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

AppCodeでは、すべてのテストを一度に実行することも、単一のテストを実行することもできます。必要に応じて異なるテスト構成を作成します。実行コンフィギュレーションでテストターゲットを指定するだけです。テスト設定を実行するには、Runポップアップ(⌃⌥R)を呼び出して必要なものを選択してください。
ac QSG run

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

ac QSG testRunner

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

VCS

ソースコードをバージョン管理下に置いておけば、Git(またはGitHub)、Mercurial、Perforce、TFS、Subversion、CVSなど多くの一般的なバージョン管理システムとAppCodeが統合されていることを知ることができます。

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

ac QSG VCS

ローカル・ヒストリー

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

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

AppCodeの重要な機能を簡単に紹介していただければ幸いです。開発者の生活をより簡単で楽しくし、ソースコードをきれいにする重要な機能はたくさんあります。これらの最初のいくつかのステップを今すぐ行い、次に時間が正しいと感じると深く掘り下げてください。 AppCodeをお楽しみください!

ご不明な点がございましたら、アプリケーションコードディスカッションフォーラム(英語)ツイッター(英語)ブログ(英語)をご覧ください。ニュース、最新情報、便利なヒントをご覧いただけます。また、サポートチームに問題を報告することを躊躇しないでください)またはAppCode 課題トラッカー(英語)

最終変更日: 2018年8月16日