مكتبة سويفت مفتوحة المصدر لإنشاء مخطط فئة UML

البدء مع SwiftPlantUML

الطريقة الموصى بها لاستخدام مكتبة SwiftPlantUML هي عبر Homebrew. يرجى استخدام الأمر التالي لتثبيت سلس.

brew install swiftplantuml

$ mint install MarcoEidinger/SwiftPlantUML

تحويل شفرة سويفت إلى مخططات UML

بمجرد التثبيت، يمكنك استخدام SwiftPlantUML لتوليد سكريبتات PlantUML من شفرة Swift الخاصة بك. بدلاً من إنشاء المخططات يدويًا، تقوم مكتبة SwiftPlantUML المفتوحة المصدر باستخراج هياكل الفئات والعلاقات من شفرة Swift وتوليد مخططات UML تلقائيًا دون أي تبعيات خارجية. يوضح المثال التالي كيف يمكن للمطورين توليد سكريبت PlantUML من الشفرة المعطاة التي تمثل العلاقات بين الأنواع User و Admin و Authenticatable. يمكن عرض الناتج كمخطط UML باستخدام محرر PlantUML.

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)

دعم مخرجات قابل للتخصيص

تتيح مكتبة SwiftPlantUML لمطوري البرمجيات تخصيص سكريبتات PlantUML المولدة لتناسب احتياجاتهم. يمكن للمطورين تضمين أو استبعاد أنواع محددة، تعديل العلاقات، وضبط تخطيط المخطط داخل تطبيقات Swift. يوضح المثال التالي كيف يمكن للمستخدمين استبعاد فئة Animal من المخطط المولد باستخدام مكتبة Swift.

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

تصور بنية الشفرة والتعاون

فهم العلاقات بين الفئات والبروتوكولات والهياكل أمر حاسم لبناء تطبيقات قابلة للتوسع. تجعل مكتبة SwiftPlantUML المفتوحة المصدر من السهل إنشاء مخططات UML التي توفر تمثيلًا بصريًا واضحًا لهندسة تطبيقك، مما يسهل تحديد المشكلات المحتملة وتحسين التصميم. تجعل المخططات البصرية التواصل والتعاون بين الفرق أسهل. من خلال مشاركة مخططات UML، يمكن للمطورين بسرعة التوافق على قرارات التصميم وتحديد مجالات التحسين.