사용자 지정 어노테이션 작성
선언에 메타데이터를 연결합니다
사용자 지정 어노테이션 작성은(는) CoddyKit의 무료 Dart Academy 강의입니다. 이것은 4개 중 2번째 강의입니다. 아래에서 전체 강의를 무료로 읽을 수 있으며, 내장 코드 에디터와 24/7 AI 튜터와 함께 브라우저에서 직접 실습할 수 있습니다. 이 강의는 Dart Academy 학습 경로의 일부이며, 진행 상황이 웹과 CoddyKit 앱에 동기화됩니다. Dart Academy 강의에는 총 4개의 강의가 포함되어 있습니다.
주석은 클래스입니다
사용자 정의 주석은 일반 클래스일 뿐입니다. @MyTag를 작성하면 해당 클래스의 인스턴스를 메타데이터로 참조하는 것입니다. 🏷️
클래스 정의하기
메타데이터를 담을 일반 클래스를 선언하는 것부터 시작하세요. 여기서는 간단한 Todo 주석이 나중에 메시지와 담당자를 담게 됩니다.
class Todo {
final String message;
const Todo(this.message);
}const 생성자 규칙
주석 값은 컴파일 시점 상수여야 하므로 생성자는 const여야 합니다. 그렇지 않으면 해당 클래스를 주석으로 사용할 수 없습니다.
주석 적용하기
const 생성과 함께 @ 접두사를 사용하세요. 이 @Todo 태그는 아래 메서드에 아직 해야 할 작업이 남아 있음을 문서화합니다.
@Todo('Add validation')
void saveForm() {}여러 필드 담기
주석에는 원하는 만큼 필드를 담을 수 있습니다. 더 명확하고 스스로 설명하는 태그를 원한다면 생성자에 이름이 있는 매개변수를 지정하세요.
class Todo {
final String task;
final String who;
const Todo(this.task, this.who);
}상수 인수만 사용하기
전달하는 모든 인수 자체가 상수여야 합니다. 리터럴, const 객체, 열거형 값은 사용할 수 있지만 실행 중 변수는 사용할 수 없습니다.
인수 없는 표시자
때로는 표시 하나만 필요합니다. 데이터가 없는 const 인스턴스는 선언에 붙이는 순수한 표시자로 사용할 수 있습니다.
class Experimental {
const Experimental();
}
const experimental = Experimental();소문자 편의 상수
소문자 const 인스턴스를 공개하면 매번 @Experimental()을 쓰는 대신 간단하게 @experimental이라고 작성할 수 있습니다.
@experimental
void betaFeature() {}그래도 스스로 동작하지는 않습니다
기본 제공 주석과 마찬가지로 사용자 정의 주석도 자체 동작을 갖지 않습니다. 유용하게 만들려면 무언가가 이를 읽어야 하며, 다음에 이를 다룹니다.
주석을 읽는 주체
중요한 읽기 주체는 두 가지입니다. 빌드 시점의 코드 생성기와 리플렉션 방식의 도구입니다. 둘 다 태그를 검사하고 찾은 메타데이터에 따라 동작합니다.
주석은 작게 유지하기
좋은 주석은 작고 선언적입니다. 로직이 아니라 단순한 데이터를 저장하면 어떤 도구든 예측 가능하고 안전하게 읽을 수 있습니다.
빠른 확인
클래스를 주석으로 사용하려면 무엇을 갖추어야 하나요?
복습
사용자 정의 주석은 const 생성자를 가진 클래스입니다. @로 적용하고, 상수 인수를 전달한 뒤, 나중에 도구가 메타데이터를 읽도록 하세요. 🎉
AI 튜터와 함께 Dart을(를) 배우세요 — 무료
브라우저에서 실제 코드를 작성하고 실행하며, 24/7 AI 튜터로부터 즉각적인 도움을 받고, 웹이나 앱에서 중단한 부분부터 계속 학습하세요.
- 코스
- 30
- 레슨
- 120
자주 묻는 질문
“사용자 지정 어노테이션 작성” 강의는 무료인가요?
네 — “사용자 지정 어노테이션 작성” 전체 내용을 이 웹사이트에서 무료로 읽을 수 있습니다. 인터랙티브하게 실습하려면(내장 코드 에디터와 24/7 AI 튜터), CoddyKit PRO로 업그레이드하면 Dart Academy 강의 전체를 잠금 해제할 수 있습니다. Dart Academy 강의에는 총 4개의 강의가 포함되어 있습니다.
“사용자 지정 어노테이션 작성”에서 뭘 배우나요?
선언에 메타데이터를 연결합니다 브라우저에서 직접 실행하는 실습 코드로 Dart Academy을(를) 배우며, 24/7 AI 튜터가 강의를 진행하면서 질문에 답변해줍니다.
Dart Academy을(를) 시작하는 데 경험이 필요한가요?
사전 경험은 필요하지 않습니다. CoddyKit의 Dart Academy은(는) 초급자부터 고급 학습자까지를 위해 구성되어 있으므로, 여기서 시작하거나 처음부터 시작할 수 있으며 자신의 속도대로 진행할 수 있습니다. 이것은 4개 중 2번째 강의입니다.
“사용자 지정 어노테이션 작성” 강의는 얼마나 걸리나요?
대부분의 CoddyKit 강의는 약 5~10분이 소요됩니다. 각 강의는 간결하고 인터랙티브하여 꾸준한 진행이 가능하며, 웹과 앱에서 중단한 부분부터 바로 시작할 수 있습니다.
이 Dart Academy 강의에서 코드를 작성하고 실행할 수 있나요?
네. 모든 Dart Academy 강의에는 내장 코드 에디터가 포함되어 있으므로, 브라우저에서 바로 실제 코드를 작성하고 실행한 후 즉시 AI 피드백을 받을 수 있습니다 — 로컬 설정이 필요 없습니다.