質問: Swift言語向けに静的ライブラリーを作成しようと考えています。 Swift2のコメントをドキュメント化して配布したいのですが、どのようにして配布するものなのかわからず困っています。 どういった方法がありますでしょうか。 イメージとしては、Javadocのようにmylib -1.0.0-javadoc.jar のような感じにしたいと考えています。そしてXcodeのユーティリティエリアに表示されるクイックヘルプとして表示されるようにしたいのです。 なお、ライブラリーにはソースを含めたくありません。 使用する Xcode は 7 で、コメントは Markdown 記法を採用しようと考えています。静的ライブラリーのプロジェクトは Cocoa touch Framework で作成します。
回答: 通常のドキュメントコメントの書式に則ってコメントを書けば、フレームワークでもXcodeのクイックヘルプに表示されるようになります。 ドキュメントコメントの書式については、以下のURLが参考になるかと思われます。 Swiftのドキュメントコメント - Qiita 以下、簡単に試してみました。 ・フレームワーク側のクラス ``` import UIKit /// テスト用のクラス public class JunkTestClass { /// テスト用のイニシャライザ public init() { } /// テスト用のプリント関数 public func testPrint() { print("testPrint: ") } } ``` ・フレームワークを読み込んで使用 !フレームワークのクイックヘルプが表示される ドキュメントを別に作成するのであれば、jazzyが有名でしょうか。 GitHub - realm/jazzy: Soulful docs for Swift & Objective-C Realmはもちろん、Parseなどでも使われています。 RealmSwift Reference Parse Reference