Swift Academy · 강의

독립형 표현식 매크로 작성하기

SwiftSyntax와 MacroExpansion을 사용해 간단한 #stringify 매크로를 구현합니다.

레슨 2/413개 단계

독립형 표현식 매크로 작성하기은(는) CoddyKit의 무료 Swift Academy 강의입니다. 이것은 4개 중 2번째 강의입니다. 아래에서 전체 강의를 무료로 읽을 수 있으며, 내장 코드 에디터와 24/7 AI 튜터와 함께 브라우저에서 직접 실습할 수 있습니다. 이 강의는 Swift Academy 학습 경로의 일부이며, 진행 상황이 웹과 CoddyKit 앱에 동기화됩니다. Swift Academy 강의에는 총 4개의 강의가 포함되어 있습니다.

프로젝트 설정

매크로는 SwiftSyntax를 사용하며 .macro 종류의 별도 Swift 패키지 대상에 포함됩니다.

// Package.swift (excerpt)
.macro(
  name: "MyMacros",
  dependencies: [
    .product(name: "SwiftSyntaxMacros", package: "swift-syntax"),
    .product(name: "SwiftCompilerPlugin", package: "swift-syntax")
  ]
)

매크로 선언

클라이언트가 매크로를 호출할 수 있도록 라이브러리 대상에서 매크로 시그니처를 선언하십시오.

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

매크로 타입 구현하기

ExpressionMacro를 준수하고 ExprSyntax를 반환하여 매크로를 구현하십시오.

import SwiftSyntaxMacros
import SwiftSyntax

struct StringifyMacro: ExpressionMacro {
  static func expansion(
    of node: some FreestandingMacroExpansionSyntax,
    in context: some MacroExpansionContext
  ) throws -> ExprSyntax {
    guard let arg = node.arguments.first?.expression else {
      throw MacroError.message("Need an argument")
    }
    return "(\(arg), \(literal: arg.description))"
  }
}

플러그인 등록하기

패키지의 모든 매크로를 나열하는 CompilerPlugin을 만드십시오.

import SwiftCompilerPlugin

@main
struct MyPlugin: CompilerPlugin {
  let providingMacros: [Macro.Type] = [
    StringifyMacro.self
  ]
}

매크로 사용하기

매크로 라이브러리를 가져온 다음 #stringify로 호출하십시오.

import MyMacros
let (value, source) = #stringify(2 + 3)
print(value)   // 5
print(source)  // "2 + 3"

ExprSyntax 구성

반환 값은 ExprSyntax에서 문자열 보간을 사용하여 만들며, SwiftSyntax의 타입 안전성을 활용합니다.

// The expansion returns a tuple literal
return "((\(arg)), \(literal: arg.description))"

매크로 인수에 접근하기

인수는 레이블이 지정된 표현식 목록인 node.arguments를 통해 접근합니다.

let args = node.arguments
for arg in args {
  print(arg.label?.text ?? "_", arg.expression)
}

진단 메시지 생성하기

확장 컨텍스트를 사용하여 매크로에서 컴파일러 경고나 오류를 생성하십시오.

context.diagnose(Diagnostic(
  node: node,
  message: MyDiagnostic.missingArgument
))

SwiftSyntax 구문 노드

SwiftSyntax는 모든 언어 구문을 검사하고 구성할 수 있는 형식이 지정된 구문 노드로 표현합니다.

import SwiftSyntax
let expr: ExprSyntax = "1 + 2"
print(type(of: expr)) // BinaryOperatorExprSyntax

매크로 위생성

Swift 매크로는 기본적으로 위생적이므로 생성된 이름이 호출 범위의 이름과 충돌하지 않습니다.

// Macro-generated variables get unique names internally
// preventing accidental shadowing in user code

Xcode에서 확장하기

Xcode에서 매크로 호출을 마우스 오른쪽 버튼으로 클릭하고 매크로 확장을 선택하면 생성된 소스를 확인할 수 있습니다.

#stringify(40 + 2)
// Xcode expands to: (40 + 2, "40 + 2")

빠른 확인

표현식 매크로 구현이 준수해야 하는 프로토콜은 무엇입니까?

수업 요약

@freestanding(expression)으로 선언하고, .macro 대상에서 ExpressionMacro를 구현하고, CompilerPlugin을 통해 등록한 후, #macroName()으로 호출하여 독립형 표현식 매크로를 작성할 수 있습니다.

무료로 시작

AI 튜터와 함께 Swift을(를) 배우세요 — 무료

브라우저에서 실제 코드를 작성하고 실행하며, 24/7 AI 튜터로부터 즉각적인 도움을 받고, 웹이나 앱에서 중단한 부분부터 계속 학습하세요.

코스
122
레슨
409

자주 묻는 질문

“독립형 표현식 매크로 작성하기” 강의는 무료인가요?

네 — “독립형 표현식 매크로 작성하기” 전체 내용을 이 웹사이트에서 무료로 읽을 수 있습니다. 인터랙티브하게 실습하려면(내장 코드 에디터와 24/7 AI 튜터), CoddyKit PRO로 업그레이드하면 Swift Academy 강의 전체를 잠금 해제할 수 있습니다. Swift Academy 강의에는 총 4개의 강의가 포함되어 있습니다.

“독립형 표현식 매크로 작성하기”에서 뭘 배우나요?

SwiftSyntax와 MacroExpansion을 사용해 간단한 #stringify 매크로를 구현합니다. 브라우저에서 직접 실행하는 실습 코드로 Swift Academy을(를) 배우며, 24/7 AI 튜터가 강의를 진행하면서 질문에 답변해줍니다.

Swift Academy을(를) 시작하는 데 경험이 필요한가요?

사전 경험은 필요하지 않습니다. CoddyKit의 Swift Academy은(는) 초급자부터 고급 학습자까지를 위해 구성되어 있으므로, 여기서 시작하거나 처음부터 시작할 수 있으며 자신의 속도대로 진행할 수 있습니다. 이것은 4개 중 2번째 강의입니다.

“독립형 표현식 매크로 작성하기” 강의는 얼마나 걸리나요?

대부분의 CoddyKit 강의는 약 5~10분이 소요됩니다. 각 강의는 간결하고 인터랙티브하여 꾸준한 진행이 가능하며, 웹과 앱에서 중단한 부분부터 바로 시작할 수 있습니다.

이 Swift Academy 강의에서 코드를 작성하고 실행할 수 있나요?

네. 모든 Swift Academy 강의에는 내장 코드 에디터가 포함되어 있으므로, 브라우저에서 바로 실제 코드를 작성하고 실행한 후 즉시 AI 피드백을 받을 수 있습니다 — 로컬 설정이 필요 없습니다.

이 강의의 모든 강의

  1. 매크로 역할: 독립형과 연결형
  2. 독립형 표현식 매크로 작성하기
  3. 상용구를 줄이는 연결형 멤버 매크로
  4. 매크로 테스트와 디버깅
← Swift Academy(으)로 돌아가기