ماكروهات الأعضاء الملحقة لتقليل الشيفرة المتكررة

نظرة عامة على ماكرو العضو

@AddID
struct User { var name: String }
// After expansion:
// struct User { var name: String; var id = UUID() }

المطابقة مع MemberMacro

import SwiftSyntaxMacros

struct AddIDMacro: MemberMacro {
  static func expansion(
    of node: AttributeSyntax,
    providingMembersOf decl: some DeclGroupSyntax,
    in context: some MacroExpansionContext
  ) throws -> [DeclSyntax] {
    return ["var id = UUID()"]
  }
}

إنشاء init

// Macro expansion returns:
[
  "init(name: String) { self.name = name; self.id = UUID() }"
]

الآليات الداخلية لماكرو @Observable

@Observable
class Counter {
  var count = 0
  // macro adds: _$observationRegistrar, access(), withMutation()
}

قراءة النوع الذي طُبّق عليه الماكرو

if let structDecl = decl.as(StructDeclSyntax.self) {
  let members = structDecl.memberBlock.members
  // iterate to inspect stored properties
}

استخراج الخصائص المخزنة

let storedProps = members.compactMap { member -> VariableDeclSyntax? in
  guard let varDecl = member.decl.as(VariableDeclSyntax.self),
        varDecl.bindingSpecifier.tokenKind == .keyword(.var)
  else { return nil }
  return varDecl
}

توليد Equatable من الأعضاء

// Generated code:
static func == (lhs: User, rhs: User) -> Bool {
  lhs.name == rhs.name && lhs.id == rhs.id
}

الجمع بين ماكرو العضو وماكرو التوافق

struct AutoEquatableMacro: MemberMacro, ConformanceMacro { ... }

وسيطات السمة

@Clamped(range: 0...100)
var score: Int = 50
// macro reads range from attribute node and generates clamping accessors

الإبلاغ عن أخطاء الماكرو

guard decl.is(StructDeclSyntax.self) else {
  throw MacroError.message("@AddID can only be applied to structs")
}

أداء البناء

// All generated members are emitted as source code
// and compiled normally — no reflection at runtime

اختبار سريع

مراجعة الدرس