Tự động hoàn thành nhận xét Xcode (phong cách appledoc)

Question

Tôi thấy việc làm tài liệu giao diện của mình đặc biệt đau đớn vì tôi cần phải tự mình nhập mọi thứ. Vì vậy, tôi nghĩ rằng tôi không phải là người duy nhất như thế này và bắt đầu tìm kiếm một cách để giảm đau của tôi nhưng không tìm thấy nhiều.

Câu hỏi của tôi là, có lối tắt hoặc cách nào để Xcode tự động hoàn thành nhận xét của tôi không? Ví dụ: tôi rất thích nếu tôi nhập /** + [tab] rằng nó tự động hoàn thành:

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

Cảm ơn!

Answer 1

Sử dụng tính năng trích đoạn nội dung của Xcode. Bạn có thể tạo đoạn mã với bất kỳ văn bản nào bạn muốn và thêm các mục trong văn bản cần điền. Để tạo đoạn mã, chỉ cần chọn một số văn bản trong trình chỉnh sửa Xcode và kéo nó vào thư viện đoạn mã. Bạn có thể thiết lập phím tắt hoàn, vì vậy cái gì đó như m-comment có thể là phương pháp bình luận tiêu chuẩn của bạn:

Gõ bit đầu tiên của m-comment sau đó hiển thị toàn bộ phím tắt (và bất kỳ hoàn khác), và chấp nhận hoàn thành thêm một bình luận với các bộ phận tham số chờ đợi để được điền vào Như thường lệ, bạn có thể tab từ một đến tiếp theo:.

bạn chỉ ra rằng một phần nhất định của văn bản là một lĩnh vực được điền i n bằng cách đính kèm nó trong <# và #>, như: <#method name#>.

Tất nhiên, một trong những điểm mạnh của Mục tiêu-C là tên phương pháp thường cho bạn biết các tham số là gì. Lặp đi lặp lại rằng trong một bình luận có vẻ như công việc phụ không cần thiết. Xcode 3 đã hỗ trợ tốt hơn cho các tập lệnh bao gồm các tập lệnh sẽ tự động tạo ra các chú thích HeaderDoc với các tham số. Tuy nhiên, chúng không được sử dụng rộng rãi, có lẽ vì những loại bình luận đó không thực sự hữu ích.