多くの Xcode バインディング、アウトレットとIBActionバインディング、キー値バインディングなどを文書化するためのツールはありますか? 私はDoxygenとHeaderDocのスレッドを見てきましたが、これらはクラスなどを説明するためにプログラムファイルを文書化していますが、Xcode のドラッグアンドドロップが可能にする膨大な数の「隠された」リンケージをカバーしていないようです?
具体的な例として、XIB エディターを使用しIBActionて、ウィンドウ上のすべてのコントロールに対して、1 つまたは複数のファイルで定義された 1 つまたは複数のクラス/インスタンスのメソッドを作成できます。これらすべての 1 つのリストが必要で、コントロールの種類を示します。と名前、ソースファイル、クラス、およびメソッド-またはグラフィカルな表現がさらに優れています。次に、キーと値のパスの同様のリストが arrayControllers などにリンクされます。
私は新しいので、明らかなことを見逃している場合は教えてください。
ありがとう。
いいえ、ファイル自体をドキュメントの一部と見なさない限り、.xib ファイルをドキュメント化するためのツールはありません。(結局のところ、「自己文書化」と言いました。) ただし、.xibs は XML として保存されるため、本当にデータを抽出したい場合は、そこにある必要があります。
IB で作成したアクションは、ソース コードに表示されます。アクションを送信するオブジェクトを説明するコメントをそこに追加することもできますが、最初に .xib (およびアクション) を使用するポイント、つまりコントローラーから UI 要素を分離するポイントを大幅に見逃してしまいます。
ドキュメンテーションの目的が、他の開発者がプロジェクトを理解しやすくすることである場合は、.xib ドキュメンテーション ツールの作成に苦労する前に、Objective-C についてもう少し経験を積むことをお勧めします。.xib と関連するヘッダー ファイルがあれば、有能な Obj-C プログラマーは、どのコントロールがどのアクションに接続されているかを簡単に判断したり、その領域の問題をデバッグしたりできるはずです。人々は 20 年以上にわたって .xib および .nib ファイルを使用してきました。個別のドキュメント ツールがないことは、そのようなツールが最初に思われるほど有用ではないことを示している可能性があります。