2012-08-29 10 views
10

多くのXcodeバインディング、アウトレット、IBActionバインディング、キー値バインディングなどを文書化するためのツールはありますか?私はDoxygenHeaderDocのスレッドを見てきましたが、これらのドキュメントプログラムファイルは、クラスなどを記述しますが、Xcodeのドラッグアンドドロップで可能な膨大な数の「隠れた」リンケージをカバーしていないようです。XcodeとXIBの自己文書

特定の例では、XIBエディタを使用して、ウィンドウ上のすべてのコントロール、1つ以上のファイルで定義された1つ以上のクラス/インスタンスのメソッドに対して、IBActionを作成できます。コントロールのタイプと名前、ソースファイル、クラスとメソッド、またはグラフィカルな表現を表示する方がより良いでしょう。次に、キー値パスの同様のリストがarrayControllersなどにリンクします。

私は新しいものなので、明らかに何かを忘れた場合は教えてください。

ありがとうございました。

答えて

4

いいえ、ファイル自体をドキュメントの一部と見なさない限り、.xibファイルをドキュメント化するためのツールはありません。 (あなたは "結局自己文書化"と言っていましたが).xibsはXMLとして保存されていますので、本当にデータを抽出したいのであれば、そこにあるはずです。

IBで作成したアクションは、ソースコードに表示されます。アクションを送信するオブジェクトを説明するコメントを追加することもできますが、最初はコントローラーからUIエレメントを切り離すことになる.xib(およびアクション)を使用する点がほとんどありません。

ドキュメントの目的は、他の開発者が理解しやすいようにプロジェクトを作成することである場合は、.xibドキュメント作成ツールを作成する前にObjective-Cをもっと使いたいことがあります。 .xibと関連するヘッダファイルがあれば、有能なObj-Cプログラマはどのコントロールがどのアクションに接続されているかを容易に知ることができ、その領域の問題をデバッグすることができます。人々は.xibと.nibファイルで20年以上働いています。別のドキュメンテーションツールがないと、そのようなことが当初のように有用でないかもしれないという良い指標になるかもしれません。