Generate iOS document cho dự án của bạn
Bài đăng này đã không được cập nhật trong 4 năm
Bạn có muốn dự án iOS của bạn có một tài liệu như thế này không?
Đối với một lập trình viên, bạn phải chịu trách nhiệm với mã code của bạn. Vì vậy các lập trình viên sẽ thường đặc tả lại các đoạn code. Và Jazzy sẽ giúp lập trình viên, tạo ra bộ tài liệu hữu ích này.
Jazzy là gì?
Jazzy là một ứng dụng dòng lệnh có thể tạo tài liệu cho Swift và Object-C. Ứng dụng này sẽ giúp lập trình viên tạo ra tài liệu một cách nhanh chóng. Và người lập trình viên có thể chia sẻ tài liệu này cho bất kì ai. Thậm chí bạn có thể deploy lên website của bạn.
Tuy nhiên để được tài liệu chuẩn, bạn cần viết các mã lệnh theo đúng chuẩn của Apple. Bạn có thể tham khảo một số nguồn dưới đây:
https://ericasadun.com/2015/06/14/swift-header-documentation-in-xcode-7/
Cài đặt Jazzy
Cài đặt Xcode Command Line Tools
xcode-select —-install
Cài đặt Jazzy
[sudo] gem install jazzy
Kiểm tra phiên bản
jazzy --version
Tạo tài liệu
Đây là dự án của mình.
Để bắt đầu, hãy mở terminal và cd đến folder đó.
jazzy --min-acl internal --no-hide-documentation-coverage --theme fullwidth --output ./docs -x CODE_SIGNING_ALLOWED=NO
Và đây là kết quả
Giờ mở folder dự án bạn sẽ thấy folder docs.
1. --min-acl internal
Thuộc tính min-acl để kiểm soát cấp độ truy cập được tạo ra trong tài liệu. Vì vậy các hàm hay biến được set là public, sẽ được tạo ra trong tài liệu, còn Private thì không tạo ra. Nếu bạn vẫn muốn tạo tài liệu bao gồm mọi thứ, thì sửa internal thành private.
2. --no-hide-documentation-coverage
Số phần trăm tài liệu được cover.
3. --theme fullwidth
Tuỳ biến giao diện của tài liệu
4. --output ./docs
Đường dẫn để chứa tài liệu sau khi được tạo ra.
Tạo Makefile để dễ dàng tạo tài liệu
Thay vì mọi lần bạn đều phải gõ lại dòng lệnh jazzy --min-acl internal --no-hide-documentation-coverage --theme fullwidth --output ./docs -x CODE_SIGNING_ALLOWED=NO
để tạo tài liệu. Thì giờ bạn đơn giản là sử dụng bất kì text editor để tạo môt file mới và đặt tên là Makefile. Sau đó copy đoạn code như sau:
documentation:
@jazzy \
--min-acl internal \
--no-hide-documentation-coverage \
--theme fullwidth \
--output ./docs \
-x CODE_SIGNING_ALLOWED=NO
@rm -rf ./build
Bây giờ bạn chỉ cần mở terminal
make documentation
Bạn hãy làm thử xem, việc tạo document chưa bao giờ dễ dàng như vậy. Chúc bạn thành công.
**Nguồn: **
All rights reserved