1. Các sản phẩm
  2.   Biểu đồ
  3.   Swift
  4.   SwiftPlantUML
 
  

Thư viện Swift mã nguồn mở để tạo sơ đồ lớp UML

Thư viện Swift mã nguồn mở mạnh mẽ cho phép các nhà phát triển phần mềm tạo sơ đồ lớp UML từ mã nguồn Swift. Các nhà phát triển có thể tùy chỉnh sơ đồ đầu ra và trực quan hoá kiến trúc mã.

SwiftPlantUML là gì?

Trong thế giới phát triển phần mềm nhanh chóng, việc duy trì hiểu biết rõ ràng về kiến trúc của ứng dụng là rất quan trọng. Khi các dự án ngày càng phức tạp, việc hình dung mối quan hệ giữa các lớp, giao thức và các thành phần khác trở nên thiết yếu. Các nhà phát triển phần mềm thường dựa vào các sơ đồ UML (Unified Modeling Language) để trực quan hoá và tài liệu hoá cấu trúc mã của họ. SwiftPlantUML là một thư viện mã nguồn mở tự động tạo ra các sơ đồ lớp UML từ mã Swift, làm cho nó trở thành công cụ thiết yếu cho các nhà phát triển Swift. Đây là một thư viện mạnh mẽ tạo ra các script PlantUML từ mã Swift. PlantUML là một công cụ dựa trên văn bản để tạo các sơ đồ UML, bao gồm sơ đồ lớp, sơ đồ tuần tự và nhiều hơn nữa.

Được phát triển bởi Marco Eidinger, SwiftPlantUML cho phép các nhà phát triển tạo ra các sơ đồ UML trực tiếp từ mã Swift, giúp dễ dàng hơn trong việc tài liệu hoá và hình dung cấu trúc của các dự án Swift. SwiftPlantUML cung cấp các tùy chọn tùy chỉnh để điều chỉnh các sơ đồ UML được tạo ra theo nhu cầu cụ thể. Các nhà phát triển có thể loại trừ một số lớp nhất định, điều chỉnh bố cục hoặc lọc các phần tử cụ thể. Nó trích xuất cấu trúc lớp và mối quan hệ từ mã Swift và tự động tạo ra các sơ đồ UML. Với sự hỗ trợ cho một loạt các kiểu Swift, đầu ra có thể tùy chỉnh và tích hợp liền mạch với Xcode, SwiftPlantUML là một bổ sung vô giá cho bất kỳ bộ công cụ của nhà phát triển Swift nào.

Previous Next

Bắt đầu với SwiftPlantUML

Cách khuyến nghị để sử dụng thư viện SwiftPlantUML là dùng Homebrew. Vui lòng sử dụng lệnh sau để cài đặt một cách suôn sẻ.

Cài đặt SwiftPlantUML qua Homebrew

brew install swiftplantuml

Cài đặt SwiftPlantUML qua Mint

$ mint install MarcoEidinger/SwiftPlantUML

Chuyển đổi mã Swift thành sơ đồ UML

Sau khi cài đặt, bạn có thể sử dụng SwiftPlantUML để tạo các script PlantUML từ mã Swift của mình. Thay vì tạo sơ đồ thủ công, thư viện SwiftPlantUML mã nguồn mở trích xuất cấu trúc lớp và các mối quan hệ từ mã Swift và tự động tạo các sơ đồ UML mà không cần bất kỳ phụ thuộc bên ngoài nào. Ví dụ sau đây cho thấy cách các nhà phát triển có thể tạo một script PlantUML từ đoạn mã đã cho, biểu diễn các mối quan hệ giữa các kiểu User, Admin và Authenticatable. Kết quả có thể được hiển thị thành một sơ đồ UML bằng trình chỉnh sửa PlantUML.

Làm thế nào để tạo script PlantUML từ mã đã cho thông qua Swift API?

import SwiftPlantUML

class User {
    var name: String
    var email: String

    init(name: String, email: String) {
        self.name = name
        self.email = email
    }
}

class Admin: User {
    func managePermissions() {
        print("Managing permissions...")
    }
}

protocol Authenticatable {
    func login()
    func logout()
}

extension Admin: Authenticatable {
    func login() {
        print("Admin logged in")
    }

    func logout() {
        print("Admin logged out")
    }
}

let generator = PlantUMLGenerator()
let plantUMLScript = generator.generate(from: User.self)
print(plantUMLScript)

Hỗ trợ đầu ra có thể tùy chỉnh

Thư viện SwiftPlantUML cho phép các nhà phát triển phần mềm tùy chỉnh các script PlantUML được tạo để phù hợp với nhu cầu của họ. Các nhà phát triển có thể bao gồm hoặc loại trừ các kiểu cụ thể, sửa đổi các mối quan hệ và điều chỉnh bố cục sơ đồ trong các ứng dụng Swift. Ví dụ sau đây cho thấy cách người dùng có thể loại bỏ lớp Animal khỏi sơ đồ được tạo bằng thư viện Swift.

Làm thế nào để loại trừ một lớp cụ thể khỏi sơ đồ được tạo bằng Swift API?

let options = PlantUMLOptions(exclude: ["Animal"])
let generator = PlantUMLGenerator(options: options)
let plantUMLScript = generator.generate(from: MySwiftClass.self)
Visualize Code Architecture

Trực quan hoá kiến trúc mã & hợp tác

Hiểu các mối quan hệ giữa lớp, giao thức và struct là rất quan trọng để xây dựng các ứng dụng có khả năng mở rộng. Thư viện mã nguồn mở SwiftPlantUML giúp dễ dàng tạo ra các sơ đồ UML cung cấp hình ảnh trực quan rõ ràng về kiến trúc của ứng dụng, giúp dễ dàng xác định các vấn đề tiềm ẩn và tối ưu thiết kế. Các sơ đồ trực quan giúp các nhóm giao tiếp và hợp tác dễ dàng hơn. Bằng cách chia sẻ các sơ đồ UML, các nhà phát triển có thể nhanh chóng đồng thuận về các quyết định thiết kế và xác định các khu vực cần cải thiện.

 Tiếng Việt