첫 Dart 프로젝트

지난 수업에서 Dart 환경을 구축하고 Dart SDK 설치를 완료했습니다. 이번 시간에는 Dart 프로젝트를 생성해 보겠습니다.

Dart 프로젝트 새로 만들기

• 터미널(CMD)에서 프로젝트 폴더를 생성하고 진입합니다. Dart 프로젝트 전용 디렉터리 하위에 생성할 수 있습니다. 예시: C:\dartdemo

mkdir dartdemo
cd dartdemo

• 생성 명령어를 실행해 콘솔 템플릿 기반 firstdart 프로젝트를 생성합니다. 아래 명령어로 firstdart 콘솔 프로그램을 만들며 이름은 원하는 대로 수정 가능합니다.

dart create firstdart

명령어의 역할

dart create firstdart 는 firstdart 이름의 명령줄 프로젝트를 생성하고 표준 파일·디렉터리 전체를 자동 생성함과 동시에 pub get을 실행해 의존 패키지를 다운로드합니다.

최종 프로젝트 파일 구조는 다음과 같습니다.

자동 생성되는 핵심 파일

• .gitignore：Git 제외 설정 파일
• analysis_options.yaml：코드 정적 검사 규칙
• pubspec.yaml：프로젝트 설정 및 의존 목록(Dart 프로젝트 핵심 설정 파일)
• bin/firstdart.dart：프로그램 진입점 파일
• lib/firstdart.dart：비즈니스 로직 라이브러리
• test/firstdart_test.dart：단위 테스트 파일

첫 Dart 프로그램 실행하기

1. 프로젝트 하위 폴더로 진입

cd firstdart 

2. 실행 명령어 입력

dart run

3. 정상 실행 출력 결과

C:\dartdemo\firstdart>dart run
Building package executable...
Built firstdart:firstdart.
Hello world: 42!

C:\dartdemo\firstdart>

네트워크 문제로 정상 동작하지 않을 경우 프록시를 설정하세요

CMD를 열고 환경 변수를 설정합니다

set PUB_HOSTED_URL=https://mirrors.tuna.tsinghua.edu.cn/dart-pub

위 명령은 환경 변수를 임시로 설정하는 방식이며, 그래픽 환경에서 직접 설정할 수도 있습니다.

set PUB_HOSTED_URL=xxx는임시 세션 변수로 현재 CMD 창 메모리에만 존재하고시스템 레지스트리에 저장되지 않습니다. 그래서 시스템「환경 변수」그래픽 패널에서 보이지 않으며 CMD 창을 닫으면 변수가 사라집니다.

영구 적용하려면 set를 setx로 변경해 실행하세요

C:\dartdemo\firstdart>setx PUB_HOSTED_URL "https://mirrors.tuna.tsinghua.edu.cn/dart-pub"

SUCCESS: Specified value was saved.

C:\dartdemo\firstdart>

설정 후 환경 변수 패널에서 확인할 수 있습니다.

코드 수정 후 재실행

1. 파일 설명

bin/ 폴더에는 실행 가능한 진입 코드가 저장되며 bin/firstdart.dart가 전체 프로그램 시작 파일입니다.

모든 Dart 프로그램은 main() 함수부터 실행됩니다.

2. 코드 수정

import 'package:firstdart/firstdart.dart' as firstdart;

void main(List<String> arguments) {
  print('Hello world: ${firstdart.calculate()}!');
}

수정 후(import 구문 삭제, 출력 문자 변경):

void main(List<String> arguments) {
  print('Hello, Dart!');
}

3. 재실행 검증

파일 저장 후 다시 dart run을 실행하면 출력이 아래와 바뀝니다:

C:\dartdemo\firstdart>dart run
Building package executable...
Built firstdart:firstdart.
Hello, Dart!

이것으로 코드 수정이 적용되었음을 의미합니다.

핵심 지식 요약

1. dart create 프로젝트명：표준화된 Dart 프로젝트 템플릿 빠르게 생성；
2. dart run：프로그램 컴파일 및 실행；
3. bin/ 디렉터리는 프로그램 진입점, main() 함수는 Dart 프로그램 실행 시작점；
4. pubspec.yaml 은 Dart 프로젝트 핵심 설정 파일로 의존성과 프로젝트 정보를 관리합니다.