9

現在のクラスのみを表示し、ジャンプバーをクリックしたかのように #pragma マークを表示することにより、XCode 5 がシンボルナビゲーターをより便利にするプラグインまたはその他の方法はありますか?

このすべてのポイントは、ジャンプ バーをクリックする必要がないことです。ナビゲーターは常に右側のパネルにタブとして表示されます。

私の意見では、左パネルのデフォルトのシンボルナビゲーターは弱いです。

添付画像を参照してください。

編集:プラグインを自分で作成することになりました。https://github.com/zolomatok/ZMDocItemInspectorからダウンロードできます。

独自のプラグインの作成に興味がある場合は、こちらの詳細なチュートリアルを参考にしてください: https://github.com/zolomatok/Creating-an-Xcode-plugin

ここに画像の説明を入力

4

1 に答える 1

18

私が知っていることではありませんが、あなたの人生を楽にするかもしれないいくつかのテクニック:

  1. control+を押す6と、ドキュメント項目がポップアップ表示されます (メソッド名とプラグマ マークのリスト)。

  2. ところで、それが終わったら、多くの人は入力を開始するだけで、そのポップアップで検索を行い、入力したものと一致しない項目を除外することを知りません.

  3. command+を押す2か、ナビゲーション パネルの 2 番目のタブをタップすると、シンボル ナビゲーターを表示できます。

    ここに画像の説明を入力

  4. もう 1 つの優れたツールは、Quick Open ( shift+ command+ O(文字「おお」)) です。

  5. コードの折りたたみは、特定のルーチンにすばやく移動できるように、コードをすばやく折りたたむ方法でもあります。shift+ option+ command+を押すleft arrowと、すべてのコードをすばやく折りたたみ、必要なものまでスクロールして展開できます (すべてまたはそのルーチンのみ)。

  6. もう少し複雑ですが、ドキュメンテーション システムを採用することができます。私はアップルドックを使用しています。HeaderDocまたはDoxygen形式に準拠するコードにコメントを入れることができます。したがって、次のメソッド宣言を検討してください。

    /** Initialize `Download` operation, downloading from `url`, saving the file to `path`.
 *
 * The operation starts when this operation is added to an operation queue.
 *
 * @param url The remote URL of the file being downloaded.
 *
 * @param path The local filename of the file being downloaded. This should be the full path of the file (both the path and filename) and should be in a directory that the user has permission.
 *
 * If this `nil`, the filename will be taken from the `lastPathComponent` of the URL, and will be stored in the `Documents` folder.
 *
 * @return Download operation
 *
 * @see initWithURL:
 */

- (id)initWithURL:(NSURL *)url path:(NSString *)path;

    このコメントの構造は、(a)/**だけでなく で始まり/*ます。(b) 指定@paramおよび@return説明。これを行うと、コードをこれらのドキュメンテーション エンジンの 1 つにフィードすることができ、優れたドキュメンテーション セットが得られます。これには、クラス階層も含まれます。

    しかし、コードを文書化する必要があることは誰もが知っていますが、Xcode 5 では、コメントが Xcode のネイティブ ヘルプ システムにリアルタイムで自動的に統合されるため、文書化するより説得力のある理由があります。これらのコメントをコードに挿入することにより、Xcode 5 は、Cocoa クラスの場合と同様に、メソッドのドキュメントを [クイック ヘルプ] ウィンドウに自動的に表示するようになりました。

    クラス階層全体を表示できるという質問への回答として、appledocを使用して、Xcode のドキュメント ブラウザー (Xcode 4.x のオーガナイザー、 Xcode 5) をプロジェクトのフォルダーに移動し、ターミナル コマンド ラインで次のコマンドを実行します。

    appledoc --project-name MyApp --install-docset --output ../MyAppDocumentation .

    これらのドキュメンテーション システムでは、Xcode で表示できるドキュメントセットを構築するだけでなく、サード パーティと共有する可能性のあるドキュメントを構築することもできます (必要な場合)。特に Appledoc は、非常に Apple に似た HTML ドキュメント サイトを生成します。たとえば、上記のメソッド宣言のドキュメントは次のとおりです。

    この別個の「コマンド ラインからドキュメントセットをビルドする」は、あなたが想定している「アドイン」ほど洗練されたものではありませんが、Xcode 5 に組み込まれているドキュメントの解析により、私は自分のドキュメントのドキュメントを個人的に統合しました。私の開発プロセスのコード。(開発プロセスの最後まで延期したことの 1 つであったと言うのは恥ずかしいことです。)

Xcode とのやり取りを効率化するその他のテクニックについては、WWDC 2012 ビデオWorking Efficiently with Xcodeまたは WWDC 2013 ビデオXcode Core Conceptsを参照してください。

于 2013-10-11T13:35:46.960 に答える