Trong số các tính năng mới được công bố trong Xcode 8 , chúng ta có thể thấy
"Tự động tạo tài liệu Trợ giúp Nhanh":
Đây có phải là phần cuối của tài liệu viết mã thủ công như chúng ta có thể tìm hiểu trên bài viết này từ NSHipster không?
Ai đó có thể phác thảo những ưu và nhược điểm của tính năng mới này không? Nó có thay thế các công cụ như Jazzy không?
Tôi không thể tìm thêm thông tin về tính năng mới.
Câu trả lời:
Điều này đề cập đến tính năng Xcode 8 (và mới hơn), nơi bạn có thể chọn một phương pháp như sau:
func foo(bar: Int) -> String { ... }
... và sau đó nhấn ⌘+ option+ /(hoặc chọn “Cấu trúc” »“ Thêm tài liệu ”từ menu“ Trình chỉnh sửa ”của Xcode) và nó sẽ tạo mẫu nhận xét sau cho bạn:
/// <#Description#>
///
/// - parameter bar: <#bar description#>
///
/// - returns: <#return value description#>
Nó chỉ tạo điều kiện cho việc viết tài liệu cho Trợ giúp Nhanh.
Lưu ý, mặc dù hành vi này đã thay đổi một chút theo thời gian, nhưng Xcode có thể nói rõ về vị trí phải đặt con trỏ khi bạn cố gắng thực hiện việc này. Ví dụ: con trỏ phải ở đâu đó trong tên hàm, footrong ví dụ trên của tôi, để điều này hoạt động. Hoặc chỉ cần nhấp đúp vào tên chức năng và sau đó nhấn ⌘+ option+/
@IBActioncác phương thức. Nhưng nó hoạt động tốt với cả Objective-C và Swift. Nếu bạn vẫn gặp sự cố và đã thử quy trình khập khiễng thông thường là khởi động lại Xcode và / hoặc khởi động lại máy, bạn có thể chỉ muốn đăng báo cáo lỗi về phần mềm beta này.
sudo /usr/libexec/xpccachectltrong Terminal và khởi động lại máy Mac của bạn trước khi nó hoặc bất kỳ Phần mở rộng Xcode nào khác sẽ công việc. Xem ghi chú phát hành Xcode 8.
Điều này rất có thể liên quan đến thực tế là TẤT CẢ các phím nóng có dấu '/' không hoạt động trong bản dựng XCode 8 hiện tại, nếu bàn phím của bạn yêu cầu nhấn shift để lấy nó.
Tức là trên bàn phím tiếng Đức, '/' là shift + 7, nhấn alt + cmd + shift-7 không làm được gì. Nếu bạn gán tức là cmd + shift + opt + d, nó hoạt động tốt.
Phím tắt '///', không may là hiện cũng không hoạt động, có thể là do plugin XCode cũ VVDocumenter, đã sử dụng chính xác phím tắt này.
Tính năng tuyệt vời, QA tệ hại ở phía Apple.