AppCode 2019.2ヘルプ

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

始める前に

AppCodeを使用する前に、macOSにサポートされているXcodeバージョンがインストールされていることを確認してください。

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

AppCodeでプロジェクトを開く/作成する

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

  1. ようこそ画面から、プロジェクトを開くをクリックします。

    The Welcome screen
    または、IDEメインウィンドウが開いているときに、メインメニューからファイル | 開くまたはファイル | 最近使用したファイルを開くを選択します。

  2. xcodeproj または xcworkspace ファイル、またはこれらのファイルを含むディレクトリーを選択します。

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

VCSストレージまたはリポジトリからソースをダウンロードできます。

  1. ようこそ画面から、バージョン管理からチェック・アウトをクリックします。または、IDEメインウィンドウが開いているときに、メインメニューからVCS | バージョン管理からチェックアウトを選択します。

  2. 開いたリストからバージョン管理システムを選択します。

  3. ソースへのパスを入力し、クローンをクリックします。

    Clone a repository

新規プロジェクトの作成

  1. ようこそ画面から、新規プロジェクトをクリックします。または、IDEメインウィンドウが開いているときに、メインメニューからファイル | 新規プロジェクトを選択します。

  2. 開いたダイアログで、ターゲットとプロジェクトテンプレートを選択します。AppCodeはすべてのXcodeテンプレートをサポートしているため、Xcodeで行うのと同じ方法で新しいプロジェクトを作成できます。

    Create New Project dialog page one

AppCodeでのプロジェクト作成の詳細については、新規プロジェクトの作成を参照してください。

見回す

プロジェクトを開くと、メインウィンドウがいくつかの論理領域に分割されていることがわかります。

The Main window
  • 左側のプロジェクトツールウィンドウは、Xcodeのように、プロジェクトを使い慣れた方法で表示します。

    右上隅のセレクタを使用して、さまざまなビューを切り替えることができます。

    Switch view
    プロジェクトビューはプロジェクトの論理構造を反映しますが、ファイルビューはファイルシステム内のプロジェクトの物理的表現を提供します。ファイルビューでは、プロジェクトの一部のディレクトリーを除外またはライブラリーファイルとしてマークして、インデックス作成から除外できます。
  • エディターには、現在開いているファイル間を簡単に移動できるタブがあります。エディターウィンドウを分割して、同時に複数のファイルを表示することもできます。エディターの詳細については、エディターの基本を参照してください。

  • ナビゲーションバーを使用すると、プロジェクト構造内を移動し、必要なファイルを開くことができます。

  • ツールバーから、実行 the Run buttonデバッグ the Debug buttonどこでも検索 the Search Everywhere buttonなんでも実行 the Run Anything buttonなど、頻繁に使用するコマンドにすばやくアクセスできます。

    実行/デバッグ構成セレクターから、構成を選択し、アプリを実行するデバイスまたはシミュレーターを選択できます。

    バージョン管理システムを使用している場合、最も一般的なVCS操作はツールバーから利用できます。

    ツールバーを無効にすると、すべてのボタンがナビゲーションバーの横に配置されます。

  • 左の余白にはブレークポイントが表示され、定義サブクラス、スーパークラスなどに移動するなど、コード階層をナビゲートできます。また、行番号(ガター領域を右クリックして行番号の表示を選択)および行ごとのVCS履歴を表示することもできます。

  • エディターの右側には、スクロールバーと、現在のファイルのエラーと警告を示す色の縞模様を示す右側のガターがあります。

  • ツール・ウィンドウは、ワークスペースの下部と側面に取り付けられた特殊なウィンドウです。プロジェクト管理、ソースコードの検索とナビゲーション、実行とデバッグ、バージョン管理システムとの統合などの一般的なタスクへのアクセスを提供します。ツールウィンドウの詳細については、ツール・ウィンドウを参照してください。

  • ステータスバーには、ファイルエンコーディング、行セパレーター、インスペクションプロファイルなどのさまざまな警告と情報メッセージが表示されます。さらに、デバッグコンテキストとリリースコンテキストを切り替えて、IDE内のコードを目的の定義で解決するための状況を解決するセレクターがあります。

インターフェース要素を非表示/表示

不要なUI要素を非表示にし、必要に応じて再度表示できます。

  • ツールウィンドウを非表示/表示するには、メインメニューから表示 | ツール・ウィンドウをクリックし、非表示または表示するツールウィンドウを選択します。

  • 他のインターフェース要素(ステータスバー、ナビゲーションバーなど)を非表示/表示するには、メインメニューから表示 | 外観をクリックし、表示されるリストからインターフェース要素を選択または選択解除します。

  • または、⇧⌘Aを押して、UI要素名を入力し、スイッチャーを使用して要素を表示または非表示にします。

    Hide or show UI elements via Find Action

環境をカスタマイズする

IDEを自由に調整してください。IDEがニーズに完全に適合し、できるだけ便利で快適です。AppCode | 環境設定に移動して、使用可能なカスタマイズオプションのリストを表示します。

外観

AppCode | 環境設定 | 外観および振る舞い | 外観に移動して、UIテーマを選択します:ライト、Darcula、またはハイコントラスト。

エディター

AppCode | 環境設定 | エディターに移動して、エディターの動作を調整します。ここでは、ドラッグアンドドロップの有効化、スクロール構成、使用可能な各言語の色構成、タブとコードの折りたたみ設定、コード補完の動作、後置テンプレートなど、多くのオプションを利用できます。エディター設定の詳細については、エディターの基本を参照してください。

コード・スタイル

コード・スタイル設定は、AppCode | 環境設定 | エディター | コード・スタイルの各言語に対して定義できます。設定を使用すると、追加のアクションなしで、入力時にコードを自動的にフォーマットできます。独自のコーディングスタイルスキームを作成して保存することもできます。

キーマップ

AppCodeはキーボード中心のアプローチを使用します。つまり、IDEで可能なほとんどすべてのアクションがキーボードショートカットにマップされます。

AppCodeはデフォルトのキーマップを提供します。メインメニューからキーマップ・リファレンスを選択して、事前定義されたショートカットのリスト全体を表示します。

ただし、AppCode | 環境設定 | 外観および振る舞い | キーマップでいつでも変更できます。Xcode、Emacs、Visual Studio、Eclipse、またはNetBeansなどのさまざまな定義済みキーマップがあり、既存のキーマップに基づいて独自のキーマップを作成することもできます。

スマートアシスタンスでコードを書く

次の機能を使用すると、コードを記述する際の時間を節約し、エラーを回避できます。

コード補完

AppCodeには、基本 ⌃Spaceスマート ⌃⇧Spaceの2種類のコード補完があります。基本補完は、入力時に機能し、シンボルを即座に補完します。スマート補完は、現在作業しているコンテキストを分析し、その分析に基づいてより正確な提案を提供します。式のタイプに一致するように関数と変数のリストをフィルタリングします。

Smart type completion

コード生成

AppCodeを使用すると、ループ、条件、列挙、初期化子、プロパティー、メソッドのオーバーライドなど、一般的な構成要素と頻繁に使用される要素のコードを簡単に生成できます。新しいファイルを作成すると、AppCodeはそれらの初期コンテンツも生成します。

ポップアップメニューの生成を使用

  • ⌘N を押すか、メインメニューからコード | 生成を選択して、初期化子、メソッドの実装、オーバーライドなどの構造を生成します。コンテキストとプログラミング言語に応じて、AppCodeは利用可能なコード構成の異なるセットを提案します。

    Generate menu

  • メソッドの実装またはオーバーライドにスタブコードをすばやく追加するには、それぞれ ⌃I または ⌃O を押して、開くリストでオーバーライドまたは実装するメソッドを見つけます。

使用箇所からコードを生成する

  • 使用したいがまだ定義していないプロパティーの使用箇所からコードを生成することもできます。これを行うには、⌥⏎ を押してプロパティー '<名前>'を作成するを選択します。

ライブテンプレートを使用する

ライブ・テンプレートは、コード構造全体を生成するツールです。環境設定 | エディター | ライブ・テンプレートですぐに使用できるテンプレートのリストを見つけます。

  • コードにテンプレートを貼り付けるには、コード | ライブ・テンプレートの挿入を呼び出すか、⌘Jを押します。

  • ループと if , whileforなどの条件ステートメントでコードをすばやく囲むには、メインメニューからコード | 囲むをクリックするか、⌥⌘Tを押します。

追加するコードコンストラクトの定義済みテンプレートがない場合は、独自のライブテンプレートを作成できます

リファクタリング

リファクタリングは、新しい機能を追加せずにコードを改善できます。リファクタリングを使用すると、コードをよりクリーンにし、読みやすく保守しやすくすることができます。

メインメニューからリファクタリングを選択するか、リファクタリングポップアップ ⌃T を呼び出して、現在の場所で利用可能なリファクタリングのリストを取得します。SwiftとObjective-Cでは、さまざまなリファクタリングのセットが利用可能です。

Refactor This popup

名前変更⇧F6

要素とその使用箇所の名前を変更します。

シグネチャーの変更⌘F6

メソッドのシグネチャーを変更します。

移動してコピーする

F6 / F5

要素を移動/コピーします。

安全な削除⌘⌦

ソースコードで参照されているファイルを削除しないようにしてください。

メソッドの抽出⌥⌘M

コードフラグメントをメソッドに抽出し、コードの重複を減らします。

定数の抽出⌥⌘C

新しい定数を宣言し、それを選択された式で初期化します。

パラメーターの導入⌥⌘P

メソッド宣言に新しいパラメータを追加し、それに応じてメソッド呼び出しを更新します。

変数の導入⌥⌘V

新しい変数を宣言し、選択した式で初期化します。

インライン化⌥⌘N

要素をインライン化します。抽出の反対の行為。

コードをきれいに保つ

コード・インスペクション

AppCodeは、常にコードの品質を追跡し、未使用のコード、未解決のメソッド、ローカライズされていない文字列、関数内の無効なパラメーターなどの潜在的なエラーと課題を検出します。この目的のために、AppCodeはコードインスペクションのセットを提供します。検出された課題は、右側のガターにカラーストライプでマークされます。

問題コード文字列にキャレットを配置すると、電球が表示されます。警告の場合は黄色の the Yellow bulb icon、エラーの場合は赤色の the Red bulb icon です。電球アイコンをクリックするか、⌥⏎ を押して、提案されたクイックフィックスのリストを呼び出します。

インスペクションを手動で実行して、プロジェクト内の潜在的な問題を見つけて、一度に修正することもできます。これを行うには、メインメニューからコード | コードのインスペクションを選択します。

インスペクションのリスト全体を表示し、それらの重大度レベルを変更し、AppCode | 環境設定 | エディター | インスペクションで有効/無効にすることができます。

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

コードインスペクションによって提供されるクイックフィックスとは別に、AppCodeは、変更および最適化できるコードフラグメントのインテンションアクションを提案します。例:Swiftの変数宣言から明示的な型を削除できます。

インテンションアクションのリスト全体を表示し、AppCode | 環境設定 | エディター | インテンションで有効/無効にすることができます。

コードを調べる

プロジェクトが大きい場合、または他の人のコードを操作する必要がある場合、探しているものをすばやく見つけてコードを掘り下げることが重要です。そのため、AppCodeには、コードがどのように絡み合っていても、コード内の道を見つけるのに役立つ一連のナビゲーションおよび検索機能が付属しています。

検索と置換

コードフラグメントを見つけて置き換えるには、次の手順を実行します。

使用箇所の検索

キャレットでのシンボルのすべての使用箇所を見つけるには、⌥F7を押して使用箇所の検索検索を実行します。

Find usages

どこでも検索

  • AppCodeで何かを検索するには、それがコードベース、アクション、またはUI要素のアイテムである場合、 を2回押して、探しているものを入力し始めます。

    Search Everywhere popup

  • アクションの検索検索 ⇧⌘A を使用して、IDEコマンドまたは設定を名前で検索します。設定を検索するとき、/と入力して、すばやくアクセスできるすべての設定のリストを表示します。

ソースコードナビゲーション

ジャンプ

アクション

名前でファイル

⇧⌘O

名前でクラス

⌘O

名前でシンボル

⌥⌘O
シンボルの宣言

左ガターの⌘B または the Go to definition icon アイコン (Objective-C用)

型宣言

⇧⌘B
クラス/メソッドの実装

左のガターの⌥⌘B または the Implemented method icon / the Implementing method icon アイコン

構造ポップアップ ⌘F12 または構造ツールウィンドウ ⌘7から現在開いているファイルの構造をナビゲートすることもできます。

Structure View popup

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

クイック定義 ⌥Space は、クラスやメソッドの内容にジャンプすることなく表示できます。

Quick Definition popup

メソッドが使用できるパラメーターのリストを表示するには、⌘Pを押します。

キャレットでシンボルのドキュメントを表示するには、F1を押します。AppleDoc / HeaderDoc / Doxygenマークアップに従って作成されたドキュメントコメント、またはSDKのドキュメントでシンボルを提供する必要があることに注意してください。

また、AppCodeはFoundation フレームワーククラス(英語)の外部ドキュメントを示しています。外部ドキュメントを開くには、⇧F1を押します。

プロジェクトでのすべてのアクティビティを記憶して、AppCodeは最近のファイル ⌘E または最近変更されたファイル ⌥⇧Cに簡単にナビゲートできます。

変更履歴を確認するには、戻る/進むナビゲーション ⌘[ ⌘] を使用するか、最後の編集場所 ⇧⌘⌫に移動します。

アプリの実行、デバッグ、テスト

実行

アプリを実行するには、ツールバーの実行/デバッグ構成セレクターから実行/デバッグ構成とデバイスまたはシミュレーターを選択し、the Run button をクリックするか、⌃Rを押します。

Run Menu

実行/デバッグ設定は、ターゲット、実行可能ファイル、アプリに渡す引数、およびその他のオプションを含む名前付きの実行/デバッグセットアップです。

AppCodeの実行構成はXcodeスキーム(英語)と同等であり、Xcodeスキームと同期が保たれます。

AppCodeは、各ターゲットに対してデフォルトの実行/デバッグ構成を作成し、プロジェクトの名前を付けます。利用可能なテンプレートに基づいて独自の構成を追加することもできます。メインメニューから実行 | 構成の編集を選択して、使用可能な構成をすべて表示し、編集して、新しい構成を追加します。

デバッグ

デバッグは、プログラムの実行を中断するブレークポイントを配置することから始まります。これにより、プログラムデータを調べることができます。ブレークポイントを表示する行の左の余白をクリックします。

Set a breakpoint

デバッグセッションを開始するには、the Debug icon をクリックするか、⌃Dを押します。デバッグツールウィンドウが開きます。

Debug tool window

ステップ実行アクションを使用してプログラム実行を実行します。the Step Over iconをステップオーバーし、the Step Into iconにステップインし、the Step Out buttonをステップアウトします。

変数値の設定式の評価ウォッチの追加、逆アセンブルされたコードへのステップ実行、ローカルおよびリモートプロセスへのアタッチなどができます。AppCodeのデバッグ機能の詳細については、デバッグセクションを参照してください。

テスト

AppCodeは、そのままでCatchBoost.Test、Google Test、およびXCTestベースのテストフレームワーク(QuickおよびKiwiを含む)をサポートします。

テストを作成するには、プロジェクトツールウィンドウでノードを右クリックし、ファイル | 新規 | Xcode テンプレートからファイルを選択します。AppCodeは、テンプレートから標準のXCTestテストを生成します。また、テスト用または環境設定 | エディター | ファイルおよびコード・テンプレートにある他のファイル用に独自のテンプレートを作成することもできます。

テストの実行/デバッグ構成を作成し、実行/デバッグ構成セレクターから選択して、the Run button をクリックするか、⌃Rを押します。

Run the test

一度に複数のテストを実行できます。そのためには、テスト構成を含む複合実行/デバッグ構成を作成します。

テスト結果は、実行ツールウィンドウの専用ビューに表示されます。ここで、問題にナビゲートし、テスト実行統計を確認し、失敗したテストを再実行できます。

Tests in the Run tool window

カバレッジを使用してユニットテストを実行し、テスト中に実行されているコードの量を確認します。

ソースコードをバージョン管理下に置く

VCS

AppCodeは、Git(またはGitHub)、Mercurial、Perforce、およびSubversionのバージョン管理システムと統合されています。

特定のVCSに固有の資格情報と設定を指定するには、環境設定 | バージョン管理に進みます。VCSメニューから、変更をコミットおよびプッシュしたり、プロジェクトを更新したりできます。バージョン管理ツールウィンドウ ⌘9から、変更リストを管理することができます。

一部の基本的なコマンドは、ツールバーから簡単にアクセスできます。

VCS toolbar

ローカル・ヒストリー

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

Local History

詳細とヘルプの取得

質問がある場合は、当社のアプリケーションコードディスカッションフォーラム(英語)ツイッター(英語)ブログ(英語)にアクセスして、ニュース、更新、役立つヒントやコツを見つけてください。また、サポートチーム(英語)またはAppCode 課題追跡(英語)システムに課題を報告することをheしないでください。

最終更新日: 2019年10月10日

関連ページ:

AppCodeをインストールする

AppCodeは、IntelliJ IDEAプラットフォームをベースにした、iOS / macOS開発者向けのIDEです。AppCodeはデフォルトでは英語です。日本語化したい場合は、インストール後、初めて起動する前に日本語化マニュアルを参照してください。システム要件:AppCodeは、Xcodeな...

ようこそ画面

プロジェクトが開かれていない場合、AppCodeはようこそ画面を表示します。例:AppCodeを初めて実行したとき、またはプロジェクトの唯一開いているインスタンスを閉じたとき。この画面から、新しいプロジェクトを作成したり、バージョン管理から既存のプロジェクトをインポート、開いたり、チェックアウトした...

バージョン管理

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

ターゲットの管理

ターゲットでは、同じコードベースを使用してプロジェクトの複数のバージョンを作成できます。ターゲットを使用すると、iPhone / iPad、フリー / Proなど、さまざまなバージョンのアプリを作成できます。ターゲットは、複数のアプリケーション間でメンテナンスとコードの更新を大幅に簡素化します。どの...

プロジェクトを管理する

プロジェクトは、完全なソフトウェアソリューションを表す組織単位です。これは、コーディング支援、一括リファクタリング、コーディングスタイルの一貫性などの基盤として機能します。AppCodeはXcodeプロジェクトフォーマットを使用します。これにより、AppCodeで既存のXcodeプロジェクトを開き、...

ファイルとディレクトリーを管理する

AppCodeは、プロジェクトファイルにインデックスを付けて、検索、ナビゲーション、コード補完、コード生成、リファクタリングなどの機能を有効にします。ただし、プロジェクトには、これらの機能を必要としないファイル(ログ、バイナリ、インポートされたライブラリーなど)が含まれている場合があります。また、A...