SwiftLint là công cụ tốt nhất để thực thi các tiêu chuẩn mã hóa và các phương pháp hay nhất. Nó đi kèm với các quy tắc được xác định trước có thể được tùy chỉnh để phù hợp với nhu cầu của từng dự án. Tuy nhiên, đôi khi các quy tắc tích hợp không đáp ứng được các yêu cầu của dự án. Trong những trường hợp như vậy, chúng tôi viết các biểu thức chính quy để lấp đầy khoảng trống.  Mặc dù regex là một công cụ mạnh mẽ, nhưng việc tạo các quy tắc phức tạp có thể khó khăn hoặc thậm chí là không thể. Đây là lúc các quy tắc SwiftLint gốc xuất hiện. Chúng giống như các quy tắc đi kèm với SwiftLint - chúng được viết bằng Swift, hiệu quả và có thể phát hiện nhiều vi phạm hơn so với regex.   https://twitter.com/simjp/status/1558168307756318720?s=20&embedable=true  Dự án cuối cùng có thể được tìm thấy tại  https://github.com/jpsim/swiftlint-bazel-example  Thiết lập dự án  Cài Bazel nếu chưa cài.   brew list --formula | grep -q "bazel" || brew install bazel  Bắt đầu bằng cách tạo một thư mục mới.   mkdir MySwiftLintRules && cd MySwiftLintRules  Tiếp theo, thiết lập một không gian làm việc Bazel mới. Điều này liên quan đến việc tạo một số tệp và bật bzlmod:   touch .bazelrc WORKSPACE MODULE.bazel BUILD && echo "common --enable_bzlmod" > .bazelrc  Thêm mã soạn sẵn vào  MODULE.bazel   module( name = "swiftlint-bazel-example", version = "0.0.0", compatibility_level = 1 ) bazel_dep(name = "swiftlint", version = "0.51.0", repo_name = "SwiftLint") extra_rules = use_extension("@SwiftLint//bazel:extensions.bzl", "extra_rules") extra_rules.setup(srcs = "@swiftlint-bazel-example//swiftlint_extra_rules:extra_rules") bazel_dep(name = "rules_xcodeproj", version = "1.4.0")  Thêm mã soạn sẵn vào tệp   . Điều này sẽ thêm hỗ trợ Xcode cho dự án Bazel của chúng tôi. BUILD   load("@rules_xcodeproj//xcodeproj:defs.bzl", "xcodeproj") xcodeproj( name = "swiftlint_xcodeproj", project_name = "SwiftLint", tags = ["manual"], top_level_targets = [ "@SwiftLint//:swiftlint", "@SwiftLint//Tests:ExtraRulesTests", ], )  Tạo một thư mục để lưu trữ mã nguồn cho các quy tắc của bạn.   mkdir swiftlint_extra_rules && touch swiftlint_extra_rules/Rules.swift && touch swiftlint_extra_rules/BUILD  Và lần cuối cùng, dán mã soạn sẵn vào tệp  swiftlint_extra_rules/BUILD   filegroup( name = "extra_rules", srcs = glob(["**/*.swift"]), visibility = ["//visibility:public"], )  Tại thời điểm này, bạn sẽ có thể xây dựng SwiftLint bằng cách sử dụng lệnh   . bazel build  Phát triển quy tắc với Xcode  Chúng tôi đã thêm phần phụ thuộc   vào dự án của mình để giúp việc phát triển các quy tắc tùy chỉnh của bạn dễ dàng hơn. Vì vậy, hãy tạo dự án của chúng tôi: rules_xcodeproj   bazel run swiftlint_xcodeproj && open SwiftLint.xcodeproj -a Xcode  Bây giờ, chúng ta có thể xây dựng và gỡ lỗi lược đồ   . Bạn có thể sử dụng ứng dụng này như bình thường với nhị phân swiftlint được cài đặt từ homebrew. swiftlint  Hãy thử chạy nó trên dự án của bạn: Nhấp vào tên lược đồ trên   , nhấp vào “Chỉnh sửa lược đồ…“, và đặt "Working Directory" trong tab "Tùy chọn" thành đường dẫn mà bạn muốn thực thi SwiftLint. thanh công cụ của cửa sổ dự án của bạn  Để biết thêm thông tin về cách phát triển các quy tắc SwiftLint gốc, hãy xem   của SwiftLint CONTRIBUTING.md  Thêm một quy tắc tùy chỉnh  Trong ví dụ này, chúng tôi đang tạo "quy tắc var bị cấm", như được hiển thị trong video hướng dẫn tại   . https://vimeo.com/819268038  Sao chép và dán mã này vào tệp   , sau đó chạy lược đồ   trong Xcode. Rules.swift swiftlint   import SwiftSyntax // This function should return an array containing all of your custom rules func extraRules() -> [Rule.Type] { [ForbiddenVarRule.self] } struct ForbiddenVarRule: ConfigurationProviderRule, SwiftSyntaxRule { var configuration = SeverityConfiguration(.error) init() {} static let description = RuleDescription( identifier: "forbidden_var", name: "Forbidden Var", description: "Variables should not be called 'forbidden'", kind: .idiomatic, nonTriggeringExamples: [ Example("let notForbidden = 0") ], triggeringExamples: [ Example("let ↓forbidden = 0") ] ) func makeVisitor(file: SwiftLintFile) -> ViolationsSyntaxVisitor { Visitor(viewMode: .sourceAccurate) } } private extension ForbiddenVarRule { final class Visitor: ViolationsSyntaxVisitor { override func visitPost(_ node: IdentifierPatternSyntax) { if node.identifier.text == "forbidden" { violations.append(node.identifier.positionAfterSkippingLeadingTrivia) } } } }  Và thế là xong! Bạn đã tạo một quy tắc SwiftLint tùy chỉnh và tích hợp nó vào dự án Swift của mình bằng Bazel. Với thiết lập này, bạn có thể tạo và thử nghiệm bao nhiêu quy tắc tùy chỉnh tùy ý, giúp đảm bảo rằng mã của bạn luôn nhất quán và tuân thủ các tiêu chuẩn viết mã của nhóm bạn.  Chúc mừng lint!

Read My Stories

Nghe bài viết này bằng Tiếng Anh, đọc bởi robot thông minh của HackerNoon

Nắm bắt sức mạnh của các quy tắc SwiftLint tùy chỉnh và nói lời tạm biệt với Regex

About Author

BÌNH LUẬN

chuyên mục

BÀI VIẾT NÀY CŨNG CÓ MẶT TẠI

Related Stories

147 Stories To Learn About Reading Books Online

145 Stories To Learn About Book

85 Stories To Learn About Travel

223 Stories To Learn About Science

147 Stories To Learn About Reading Books Online

145 Stories To Learn About Book

85 Stories To Learn About Travel

223 Stories To Learn About Science

Light-Mode

Classic

Newspaper

Dark-Mode

Neon Noir

Minty

HN StartUps