중급

라우팅

Navigator와 라우팅 패키지로 여러 화면을 연결합니다.

개념 먼저 보기

라우팅의 기본 개념부터 잡기

라우팅 문서는 먼저 용어의 뜻을 잡고, 그 다음 Flutter 코드에서 어디에 쓰이는지 연결해서 읽는 것이 좋습니다.

아래 항목들은 이 문서에서 다루는 내용을 작은 단위로 나눈 것입니다. 각 항목을 읽은 뒤 예제를 보면 코드가 훨씬 덜 추상적으로 느껴집니다.

종류별로 하나씩

라우팅에서 나눠 볼 핵심 요소

Navigator

Navigator는 화면을 스택처럼 push와 pop으로 관리합니다.

언제 쓰나: 간단한 앱은 MaterialPageRoute만으로도 충분합니다.

Flutter에서: 결과 값을 이전 화면으로 돌려보낼 수도 있습니다.

// 라우팅 예제입니다.
// 먼저 코드의 큰 흐름을 보고, 주석을 따라 각 줄의 역할을 확인하세요.
Navigator.of(context).push(
  MaterialPageRoute(builder: (_) => const DetailPage()),
);

선언형 라우팅

웹 URL, 딥링크, 인증 리다이렉트가 필요하면 go_router 같은 패키지를 검토합니다.

언제 쓰나: 경로 설계는 화면 구조와 사용자 흐름을 함께 반영해야 합니다.

Flutter에서: 라우트 이름과 파라미터는 문서화해 두면 화면 추가가 쉬워집니다.

// 라우팅 예제입니다.
// 먼저 코드의 큰 흐름을 보고, 주석을 따라 각 줄의 역할을 확인하세요.
Navigator.of(context).push(
  MaterialPageRoute(builder: (_) => const DetailPage()),
);

부연 설명

Navigator

  • Navigator는 화면을 스택처럼 push와 pop으로 관리합니다.
  • 간단한 앱은 MaterialPageRoute만으로도 충분합니다.
  • 결과 값을 이전 화면으로 돌려보낼 수도 있습니다.

부연 설명

선언형 라우팅

  • 웹 URL, 딥링크, 인증 리다이렉트가 필요하면 go_router 같은 패키지를 검토합니다.
  • 경로 설계는 화면 구조와 사용자 흐름을 함께 반영해야 합니다.
  • 라우트 이름과 파라미터는 문서화해 두면 화면 추가가 쉬워집니다.

깊게 이해하기

라우팅 문서는 Flutter 앱을 만들 때 반복해서 마주치는 개념을 독립적으로 정리한 페이지입니다. 먼저 용어의 의미를 잡고, 그 다음 실제 코드에서 어디에 배치되는지 연결해 보면 학습 속도가 빨라집니다.

이 주제는 단독으로 외우기보다 앞뒤 문서와 함께 보는 것이 좋습니다. 예를 들어 문법 주제는 위젯 코드에서 어떻게 드러나는지, 배포 주제는 실제 앱 운영 흐름에서 어떤 결정을 요구하는지 함께 확인하세요.

상세 예제

아래 예제는 이 문서의 핵심 개념을 실제 프로젝트에서 작은 단위로 적용하는 형태입니다.

Navigator.of(context).push(
  MaterialPageRoute(builder: (_) => const DetailPage()),
);

실무에서 주의할 점

  • 처음에는 가장 단순한 구현으로 시작하고, 반복되는 시점에 구조를 정리하세요.
  • 예제 코드를 그대로 외우기보다 입력, 출력, 책임을 나누어 읽어 보세요.
  • 새 문서를 추가할 때는 같은 형식으로 요약, 핵심 설명, 예제, 체크리스트를 유지하세요.

실습 체크리스트

push/pop 사용상세 화면 파라미터 전달URL 경로 설계