Dart 튜토리얼 21편: 서버·CLI 입문(server·get started)

Why#

NOTE

설치 전에 “코드가 어떻게 생겼는지”부터 확인하면, 이후 단계에서 무엇을 하고 있는지 더 잘 이해할 수 있습니다.
또한 DartPad는 브라우저에서 바로 실행해볼 수 있어 진입 장벽이 낮습니다.

1
void main() {
2
  print('Hello, World!');
3
}

What#

NOTE

DartPad는 브라우저에서 Dart 코드를 실행해볼 수 있는 도구입니다.
다만 VM 라이브러리(dart:io⁴) 같은 일부 기능은 지원하지 않는다는 제한이 함께 안내됩니다.

How#

TIP

먼저 출력이 되는지 확인한 뒤, 문자열을 바꿔보며 “실행 → 결과” 흐름을 체험합니다.
이 단계에서 목표는 “학습”이 아니라 “실행 감각”을 얻는 것입니다.

Watch out#

WARNING

DartPad는 dart:io 같은 VM 라이브러리나, 모든 패키지를 자유롭게 import하는 환경이 아닙니다.
즉, 서버·CLI 코드는 결국 로컬 SDK 설치 단계로 넘어가야 합니다.

결론: 설치 전에 DartPad로 “실행 감각”을 먼저 잡고, 서버·CLI는 로컬 SDK로 진행합니다.

Why#

NOTE

프로젝트 구조를 수동으로 만들면 파일 위치(예: bin/, lib/)와 설정(pubspec.yaml)에서 실수가 생기기 쉽습니다.
템플릿으로 시작하면 “바로 실행되는 형태”가 보장됩니다.

What#

NOTE

dart create는 템플릿을 기반으로 프로젝트를 생성합니다.
서버·CLI 입문에서는 console 템플릿으로 시작하는 예시가 제시됩니다.

How#

TIP

다음 명령으로 콘솔 앱을 생성합니다.

1
$ dart create -t console cli

생성된 프로젝트에는 다음이 포함된다고 설명됩니다.
bin/cli.dart(진입점 main()), lib/cli.dart(기능 코드), pubspec.yaml(메타데이터/의존성).

Watch out#

WARNING

프로젝트 생성 과정에서 dart pub get이 함께 실행될 수 있다는 안내가 있습니다.
즉, 의존성을 바꾸면 다시 dart pub get을 실행하는 습관이 필요합니다.

결론: dart create로 “바로 실행되는 구조”를 먼저 만든 뒤, 그 위에 코드를 얹습니다.

Why#

NOTE

서버·CLI 개발은 “수정 → 실행 → 확인”의 반복이 핵심입니다.
이 반복이 빨라야 학습도 빨라집니다.

What#

NOTE

dart run은 Dart VM으로 프로그램을 실행합니다.
예시는 프로젝트 루트에서 dart run을 실행하는 방식으로 제시됩니다.

How#

TIP

프로젝트로 이동해 실행합니다.

1
$ cd cli
2
$ dart run
3
Hello world: 42!

그리고 lib/cli.dart를 수정한 뒤 다시 실행해 출력이 달라지는지 확인합니다.

1
int calculate() {
2
  return 6 * 7 ~/ 2;
3
}

1
$ dart run
2
Hello world: 21!

Watch out#

WARNING

서버·CLI 코드는 실행 환경(로컬 OS, 파일 경로 등)에 영향을 받습니다.
따라서 “재현 가능한 실행”을 위해 프로젝트 루트에서 명령을 실행하는 습관이 중요합니다.

결론: 개발 단계에서는 dart run으로 빠르게 실행하고 결과를 확인하는 반복을 만든다.

Why#

NOTE

개발 환경에서는 빠른 반복이 중요하지만, 배포 환경에서는 “즉시 시작”과 “최적화된 실행”이 중요해집니다.
그래서 완료된 앱은 AOT 컴파일로 네이티브 실행 파일로 만든다는 흐름이 제시됩니다.

What#

NOTE

dart compile exe는 Dart 코드를 네이티브 머신 코드 실행 파일로 컴파일합니다.
예시는 bin/cli.dart를 대상으로 컴파일합니다.

How#

TIP

컴파일 명령은 다음과 같습니다.

1
$ dart compile exe bin/cli.dart

Watch out#

WARNING

컴파일 결과물은 플랫폼/아키텍처의 영향을 받습니다.
따라서 배포 타깃이 바뀌면, 그 타깃에서 다시 빌드하는 흐름이 필요할 수 있습니다.

결론: 배포 전에는 dart compile exe로 실행 파일을 만들어 “배포 단위”를 고정합니다.