독립형 표현식 매크로 작성하기
SwiftSyntax와 MacroExpansion을 사용해 간단한 #stringify 매크로를 구현합니다.
독립형 표현식 매크로 작성하기은(는) 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 codeXcode에서 확장하기
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 피드백을 받을 수 있습니다 — 로컬 설정이 필요 없습니다.
이 강의의 모든 강의
- 매크로 역할: 독립형과 연결형
- 독립형 표현식 매크로 작성하기
- 상용구를 줄이는 연결형 멤버 매크로
- 매크로 테스트와 디버깅