Xcode評論自動完成（appledoc風格）

Question

我發現記錄我的界面特別痛苦，因為我需要自己輸入一切。 所以我認為我不應該是唯一一個這樣的人，並開始尋找一種方法來減輕我的痛苦，但沒有找到太多。

我的問題是，是否有一個快捷方式或方法讓Xcode自動完成我的評論？ 例如，我非常喜歡輸入/** + [tab]它自動填充到：

/**
 * [cursor here]
 * 
 * (maybe some pre-populate a list of arguments for the method below)
 */
- (void)test:(NSString *)testString another:(NSString *)another;

謝謝！

Answer 1

使用Xcode的代碼段功能。 您可以創建包含所需文本的代碼段，並在要填寫的文本中添加項目。要創建代碼段，只需在Xcode編輯器中選擇一些文本並將其拖到代碼段庫中。 您可以設置完成快捷方式，因此m-comment可能是您的標准方法注釋：

鍵入m-comment的第一位然后顯示整個快捷方式（以及任何其他完成），並接受完成添加注釋，參數化部分等待填寫。像往常一樣，您可以從一個選項卡到下一個：

您指示文本的給定部分是要填寫的字段，方法是將其<#method name#>在<#和#> ，例如： <#method name#> 。

當然，Objective-C的優勢之一是方法名稱通常會告訴您參數是什么。 在評論中重復這一點似乎是不必要的額外工作。 Xcode 3更好地支持包含腳本的腳本，這些腳本會自動生成帶參數的HeaderDoc注釋。 但是，它們並沒有被廣泛使用，可能是因為這些評論並沒有真正有用。