أدوار الماكرو: مستقل مقابل ملحق

ما المقصود بماكرو Swift؟

// Macros are invoked with # (freestanding) or @ (attached)
#warning("Fix this later")
@Observable class Counter { var count = 0 }

ماكروات التعبيرات المستقلة

// #stringify expands to a tuple of the value and its source string
let (val, src) = #stringify(1 + 2)
print(val, src) // 3, "1 + 2"

ماكروات التعريفات المستقلة

// #makePair emits two variables
#makePair("point", x: 1, y: 2)
// expands to: let pointX = 1; let pointY = 2

ماكروات الأعضاء المرفقة

@AddID
struct User { var name: String }
// Expands to: var id = UUID()

ماكروات الموصّلات المرفقة

struct Point {
  @Clamped(0...100)
  var x: Int = 0
  // accessor macro generates get/set with clamping
}

ماكروات النظراء المرفقة

class Service {
  @AddAsync
  func fetchSync(completion: @escaping (Data)->Void) { ... }
  // peer macro adds: func fetch() async -> Data
}

ماكروات التوافق المرفقة

@EquatableByID
struct Product { var id: Int; var name: String }
// adds: extension Product: Equatable { ... }

ماكروات التوسعة المرفقة

@CustomCodable
struct Config { var host: String; var port: Int }
// adds: extension Config: Codable { custom encode/decode }

توسعة الماكرو وقت الترجمة

// Right-click macro usage in Xcode → "Expand Macro"
// to see the generated source code

إعلان ماكرو

@freestanding(expression)
public macro stringify<T>(_ value: T) -> (T, String)
  = #externalMacro(module: "MyMacros", type: "StringifyMacro")

ملخص أدوار الماكرو

// Freestanding
let result = #stringify(40 + 2)
// Attached
@Observable class Model { var count = 0 }

اختبار سريع

مراجعة الدرس