Dart 튜토리얼 29편: Dart SDK & 기본 CLI(dart tool·create·run·test)

Why#

NOTE

도구가 분리되어 있으면 “어떤 도구를 써야 하는지”부터 막힙니다.
그래서 Dart는 dart 하나로 프로젝트 작업을 묶는 흐름이 제시됩니다.

What#

NOTE

dart 도구는 Dart SDK의 커맨드라인 인터페이스이며, create, run, test 같은 작업을 서브커맨드로 제공합니다.
예시로 “create → analyze → test → run” 흐름이 제시됩니다.

How#

TIP

기본 루틴은 다음처럼 잡습니다.

1
$ dart create -t console my_app
2
$ cd my_app
3
$ dart analyze
4
$ dart test
5
$ dart run bin/my_app.dart

Watch out#

WARNING

dart에는 pub도 서브커맨드로 포함됩니다.
즉, 의존성 관련 작업은 dart pub ... 형태로 통일하는 것이 기준입니다.

결론: 입문자는 dart 하나로 “create→run→test” 흐름을 먼저 고정하면 됩니다.

Why#

NOTE

템플릿은 “파일 위치/기본 설정/실행 엔트리”를 표준화해 줍니다.
따라서 프로젝트 종류(콘솔/웹/패키지)에 맞는 템플릿을 선택하는 것이 중요합니다.

What#

NOTE

dart create는 디렉터리를 만들고 프로젝트 파일을 만든 뒤, 기본적으로 의존성 받기(pub get)를 수행한다고 설명합니다.
또한 -t 옵션으로 템플릿을 고를 수 있다고 설명합니다.

How#

TIP

예시는 다음과 같습니다.

1
$ dart create my_cli

웹 템플릿을 고르는 예시는 다음과 같습니다.

1
$ dart create -t web my_web_app

Watch out#

WARNING

기본적으로 의존성을 받는 과정이 포함되므로, 네트워크/프록시 환경에서는 생성 단계부터 실패할 수 있습니다.
즉, 생성이 실패하면 템플릿이 아니라 “의존성 받기 환경”을 먼저 의심해야 합니다.

결론: dart create는 템플릿으로 구조를 만들고 의존성까지 준비하므로, “시작점”으로 쓰기에 적합합니다.

Why#

NOTE

dart run은 실행 대상이 여러 형태(파일 경로/현재 패키지/의존 패키지 프로그램)로 올 수 있습니다.
규칙을 모르고 쓰면 “왜 이게 실행되지?”에서 막힙니다.

What#

NOTE

dart run은 (1) 경로로 파일을 실행하거나, (2) 현재 패키지의 bin/ 엔트리포인트를 실행하거나, (3) 의존 패키지의 bin/ 프로그램을 실행할 수 있다고 설명합니다.
또한 <package>:<program> 형태도 제시됩니다.

How#

TIP

파일 경로 실행:

1
$ dart run tool/debug.dart

현재 패키지의 메인 프로그램 실행(패키지 루트에서):

1
$ dart run

의존 패키지의 프로그램 실행:

1
$ dart run bar
2
$ dart run bar:baz

Watch out#

WARNING

bin 디렉터리만 “보이는 프로그램”이라는 설명이 제시됩니다.
즉, 의존 패키지의 다른 디렉터리는 실행 대상으로 취급되지 않으므로, 실행 가능한 엔트리포인트는 bin/에 두는 규칙이 필요합니다.

결론: dart run은 실행 대상 규칙을 이해하면, 파일/패키지/의존 패키지 실행을 깔끔하게 구분할 수 있습니다.

Why#

NOTE

테스트가 늘어나면 전체 실행은 시간이 오래 걸립니다.
따라서 원하는 테스트만 실행하는 방식이 필요합니다.

What#

NOTE

dart test는 현재 프로젝트의 test 디렉터리 아래 테스트를 실행한다고 설명합니다.
또한 특정 파일 경로를 지정하거나 --name 같은 필터 옵션을 사용할 수 있다고 설명합니다.

How#

TIP

전체 실행:

1
$ dart test

특정 파일 실행:

1
$ dart test test/library_tour/io_test.dart

이름 필터 실행:

1
$ dart test --name String

Watch out#

WARNING

Flutter 코드는 dart test가 아니라 flutter test를 사용하라는 안내가 있습니다.
즉, 프로젝트 종류에 따라 테스트 명령이 달라질 수 있습니다.

결론: 테스트는 dart test로 실행하고, 범위가 커지면 파일/이름 필터로 좁혀서 빠르게 반복합니다.