Kotlin Academy · 강의

KotlinPoet으로 Kotlin 소스 파일 생성하기

KSP 프로세서 안에서 KotlinPoet을 사용해 타입 안전한 Kotlin 코드를 생성해 보세요.

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

KotlinPoet이란?

KotlinPoet은 프로그래밍 방식으로 .kt 소스 파일을 생성하기 위한 Square의 Kotlin API입니다. 형식이 잘 갖춰지고 관용적인 Kotlin 코드를 생성하며 KSP의 CodeGenerator와 자연스럽게 통합됩니다.

의존성 추가하기

처리기 모듈에 KotlinPoet을 추가합니다:

dependencies {
    implementation("com.squareup:kotlinpoet:1.17.0")
    implementation("com.squareup:kotlinpoet-ksp:1.17.0") // KSP extensions
}

FileSpec: 생성된 파일의 루트

FileSpec.builder(packageName, fileName)이 시작점입니다. 여기에 타입, 함수, 프로퍼티를 추가한 다음 KSP의 CodeGenerator를 통해 결과를 기록합니다:

val file = FileSpec.builder("com.example.generated", "MyFactory")
    .addType( /* TypeSpec here */ )
    .build()

TypeSpec: 클래스 정의하기

클래스에는 TypeSpec.classBuilder(), 객체에는 objectBuilder(), 인터페이스에는 interfaceBuilder()를 사용합니다. 빌더 호출을 연결해 함수, 프로퍼티, 상위 인터페이스를 추가합니다:

val classSpec = TypeSpec.classBuilder("MyFactory")
    .addModifiers(KModifier.PUBLIC)
    .addFunction( /* FunSpec */ )
    .build()

FunSpec: 함수 생성하기

FunSpec.builder(name)은 함수를 생성합니다. addParameter(), returns(), addStatement()를 사용해 함수의 시그니처와 본문을 구성합니다:

val funSpec = FunSpec.builder("create")
    .addParameter("name", String::class)
    .returns(String::class)
    .addStatement("return "Hello, %L!", name")
    .build()

PropertySpec: 프로퍼티 생성하기

PropertySpec.builder(name, type)을 사용해 프로퍼티를 생성합니다. KModifier.PRIVATE 또는 KModifier.OVERRIDE를 지정하거나 mutable()을 사용해 var 프로퍼티로 만들 수 있습니다:

val propSpec = PropertySpec.builder("tag", String::class)
    .initializer("%S", "MyClass")
    .addModifiers(KModifier.PRIVATE)
    .build()

코드 형식 지정자

KotlinPoet은 addStatement()와 initializer()에서 형식 지정자를 사용합니다:

%L — 리터럴(따옴표 없음)
%S — 문자열 리터럴(따옴표 있음)
%T — 타입 이름(가져오기를 자동으로 처리함)
%N — 이름(사양 또는 문자열의 이름)

%T를 사용한 가져오기 자동 추가

ClassName과 함께 %T를 사용하면 KotlinPoet이 필요한 가져오기를 자동으로 추가합니다. 가져오기 문을 직접 작성할 필요가 없습니다:

val listType = ClassName("kotlin.collections", "List")
val funSpec = FunSpec.builder("items")
    .returns(listType.parameterizedBy(String::class.asTypeName()))
    .addStatement("return emptyList()")
    .build()

KSP CodeGenerator에 기록하기

kotlinpoet-ksp 연결 도구를 사용해 생성된 FileSpec을 KSP의 CodeGenerator를 통해 기록하면 증분 빌드 메타데이터가 보존됩니다:

file.writeTo(
    codeGenerator = codeGenerator,
    aggregating = false
)

확장 함수 생성하기

FunSpec.builder(name).receiver(type)을 사용해 확장 함수를 생성합니다:

val extFun = FunSpec.builder("toJson")
    .receiver(ClassName("com.example", "User"))
    .returns(String::class)
    .addStatement("return Gson().toJson(this)")
    .build()

실제 사용 사례: 팩토리 생성기

KSP 처리기는 데이터 클래스에 @AutoFactory를 적용하고 KotlinPoet을 사용해 각 클래스에 대한 동반 팩토리 객체를 생성합니다. 생성된 파일은 원본 클래스와 같은 패키지에 배치됩니다.

생성된 코드 테스트하기

단위 테스트에서 KotlinPoet의 FileSpec.toString()을 사용하면 디스크에 기록하지 않고 생성된 소스 텍스트를 검증할 수 있습니다. kotlin-compile-testing-ksp 라이브러리를 사용하면 테스트에서 생성된 코드를 컴파일하고 실행할 수 있습니다.

빠른 확인

KotlinPoet에서 참조한 클래스에 필요한 가져오기를 자동으로 추가하는 형식 지정자는 무엇인가요?

복습: KotlinPoet으로 Kotlin 소스 파일 생성하기

핵심 요점:

FileSpec → 최상위 파일; TypeSpec → 클래스/객체/인터페이스; FunSpec → 함수; PropertySpec → 속성
유형 참조에는 %T를 사용합니다 — 가져오기가 자동으로 처리됩니다
KSP 프로세서에서는 file.writeTo(codeGenerator)를 통해 작성합니다
생성된 출력을 단위 테스트하려면 FileSpec.toString()을 사용합니다

자주 묻는 질문

“KotlinPoet으로 Kotlin 소스 파일 생성하기” 강의는 무료인가요?

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

“KotlinPoet으로 Kotlin 소스 파일 생성하기”에서 뭘 배우나요?

KSP 프로세서 안에서 KotlinPoet을 사용해 타입 안전한 Kotlin 코드를 생성해 보세요. 브라우저에서 직접 실행하는 실습 코드로 Kotlin Academy을(를) 배우며, 24/7 AI 튜터가 강의를 진행하면서 질문에 답변해줍니다.

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

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

“KotlinPoet으로 Kotlin 소스 파일 생성하기” 강의는 얼마나 걸리나요?

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

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

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

이 강의의 모든 강의

← Kotlin Academy(으)로 돌아가기