■ Xcode Version 14.3.1 (14E300c)
■ Swift Version 5.8.1
■質問内容
モジュールのインターフェースに記載された構造体,クラス,メソッド,プロパティなどに説明書きを追加したいのですが,可能でしょうか.
■詳細・手続き
友人に Protocol
とDelegate
について説明するためにマルチプラットフォームのDelegateStudy
というパッケージを作成しました.
次にMacOSのコマンドラインツールプロジェクトDelegateStudyProject
を作成しそこからDelegateStudy
パッケージをPackage Dependencies
に追加しました.
DelegateStudyProject
のmain.swiftファイルにてimport DelegateStudy
を記載しました.
下図がmain.swiftの内容です.
DelegateStudy
パッケージの仕様を見るためにDelegateStudy
にカーソルを合わせてJump to Definition
を押したところ次のような画像となりました.
これではインターフェースしかわからず,どのように実装すれば良いのか伝えられません.
パッケージ側を修正してこれにコメントを追加することはできないのでしょうか.
例えば次のような記載にしたいです.
// デリゲートのためのプロトコル
public protocol GameDelegate {
// ゲームの名称
var gameName: String { get set }
// ゲームの準備をするメソッド
func setUp()
// ゲームの処理を開始するメソッド
func start()
// ゲームの処理を終了するメソッド
func end()
}
■意図
ソースコードを見れば良いというのはわかりつつ,友人が本質的に理解できているか試すために,具体的な処理内容は伏せた形でこちらのモジュールインターフェースに実装のための最低限のコメントを記し,それだけを見て実装してもらうことを実施したい次第です.