🔎 네비게이션

사용자가 앱 내에서 서로 다른 콘텐츠 화면들 사이를 이동하고 탐색할 수 있게 하는 상호작용을 나타냄.

📝 네비게이션 컴포넌트 주요 구성

1. Navigation graph
   모든 네비게이션 관련 정보를 한 곳에 집중시킨 xml 리소스. 앱 내 각각의 목적지뿐만 아니라 사용자가 앱을 통해 이동가능한 경로도 포함됨.

2. NavHost
   네비게이션 그래프에서 목적지를 표시하는 빈 컨테이너. 네비게이션 컴포넌트에는 fragment 목적지를 표시하는 기본 NavHost를 구현한 NavHostFragment가 포함되어 있음.

3. NavController
   NavHost 내에서 앱 네비게이션을 관리하는 객체. NavController는 사용자가 앱을 통해 이동할 때 NavHost에서 목적지 컨텐츠를 교체하는 역할을 담당.

앱을 통해 이동하는 동안 NavController에게 내비게이션 그래프의 특정 경로를 따라 이동하거나 특정 목적지로 직접 이동하고 싶다고 알리면 NavController는 NavHost에서 적절한 목적지를 표시함.

• 장점

1. Fragment 트랙잭션 처리
2. 올바른 Up and Back 액션 처리
3. 애니메이션 및 전환에 대한 표준화된 리소스 제공
4. 딥링크 구현 및 처리
5. 최소한의 추가 작업으로 내비게이션 드로어 및 bottom navigation과 같은 내비게이션 UI 패턴 포함.
6. Safe Args를 포함한 데이터 전달 및 안전성을 제공하는 Gradle 플러그인.
7. ViewModel 지원 제공 - 내비게이션 그래프에 ViewModel을 지정하여 그래프 목적지 간에 UI 관련 데이터를 공유할 수 있음.

⭐ 참고
Android 13에서는 Android 기기용 Navigation 컴포넌트와 함께 작동하는 predictive back navigation이 발표되었음. 향후 릴리스에서 예상치 못한 오류가 발생할 수 있으므로 가능한 빨리 predictive back navigation을 구현하는 것이 권장됨.

---

📝 네비게이션 그래프 생성

네비게이션은 사용자가 이동할 수 있는 앱의 목적지 사이에 발생함. 목적지는 액션을 통해 연결되어 있음.

Navigation graph는 모든 목적지와 액션을 포함하는 리소스 파일. 이 그래프는 앱의 모든 내비게이션 경로를 나타냄.

위의 그림에서
1. 목적지는 앱 내의 서로 다른 컨텐츠 영역을 나타냄.
2. 액션은 사용자가 따를 수 있는 경로를 나타내는 목적지 간의 논리적인 연결.

💡 네비게이션 그래프를 프로젝트에 추가하기 위한 단계
1. 프로젝트 창에서 res 디렉토리를 우클릭한 후 New > Android Resource File을 선택.
2. File name 필드에 "nav_graph"와 같은 이름을 입력.
3. Resource type 드롭다운 목록에서 Navigation을 선택한 후 OK 클릭.

📝 네비게이션 에디터

네비게이션 에디터에서 시각적으로 내비게이션 그래프를 편집하거나 기본 XML을 편집.

위 그림에서
1. Destinations panel: 내비게이션 호스트 및 현재 그래프 에디터에 있는 목적지를 나열.
2. Graph Editor: 네비게이션 그래프의 시각적 표현이 있는 곳.
3. Attributes: 네비게이션 그래프에서 현재 선택된 항목에 대한 속성 표시.

Text 탭을 클릭하면 XML이 보임.

<?xml version="1.0" encoding="utf-8"?>
<navigation xmlns:android="http://schemas.android.com/apk/res/android"
            xmlns:app="http://schemas.android.com/apk/res-auto"
            android:id="@+id/nav_graph">

</navigation>

<navigation> element는 내비게이션 그래프의 root.
목적지 및 액션을 추가할 때의 element인 <destination>과 <action>이 자식 요소가 됨.
중첩된 그래프가 있는 경우 해당 그래프는 자식 <navigation>이 됨.

📝 액티비티에 NavHost 추가

네비게이션 호스트는 사용자가 앱을 통해 이동하는 동안 목적지가 교체되는 빈 컨테이너.
네비게이션 호스트는 NavHost에서 파생되어야 함. 네비게이션 컴포넌트의 기본 NavHost 구현인 NavHostFragment는 프래그먼트 목적지를 교체하는 작업을 처리함.

⭐️ 네비게이션 컴포넌트는 주로 여러 프래그먼트 목적지를 가진 하나의 메인 액티비티를 가진 앱을 대상으로 설계되었음. 메인 액티비티는 내비게이션 그래프와 관련있으며 필요에 따라 목적지를 교체하는 책임이 있는 NavHostFragment를 포함함.
여러 액티비티 목적지를 가진 앱의 경우 각 액티비티는 자체 내비게이션 그래프를 가지게 됨.

📕 XML을 통해 NavHostFragment 추가

<?xml version="1.0" encoding="utf-8"?>
<androidx.constraintlayout.widget.ConstraintLayout
    xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:app="http://schemas.android.com/apk/res-auto"
    xmlns:tools="http://schemas.android.com/tools"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    tools:context=".MainActivity">

    <androidx.appcompat.widget.Toolbar
        .../>

    <androidx.fragment.app.FragmentContainerView
        android:id="@+id/nav_host_fragment"
        android:name="androidx.navigation.fragment.NavHostFragment"
        android:layout_width="0dp"
        android:layout_height="0dp"
        app:layout_constraintLeft_toLeftOf="parent"
        app:layout_constraintRight_toRightOf="parent"
        app:layout_constraintTop_toTopOf="parent"
        app:layout_constraintBottom_toBottomOf="parent"

        app:defaultNavHost="true"
        app:navGraph="@navigation/nav_graph" />

    <com.google.android.material.bottomnavigation.BottomNavigationView
        .../>

</androidx.constraintlayout.widget.ConstraintLayout>

1. android:name 속성엔 NavHost 구현 클래스 이름 포함
2. app:navGraph 속성엔 NavHostFragment를 내비게이션 그래프에 연결. 내비게이션 그래프는 사용자가 이 NavHostFragment에서 탐색할 수 있는 모든 목적지를 지정
3. app:defaultNavHost="true" 속성은 NavHostFragment가 시스템 Back 버튼을 가로채도록 함.

📝 네비게이션 그래프에 목적지 추가

기존 프래그먼트나 액티비티에서 목적지 생성 가능. 또한 내비게이션 에디터를 사용하여 새 목적지를 만들거나 나중에 프래그먼트나 액티비티로 대체할 수 있는 플레이스홀더를 만들 수 있음.

1. 내비게이션 에디터에서 New Destination 아이콘을 클릭한 후 Create new destination을 클릭.
2. 나타나는 New Android Component 대화상자에서 프래그먼트를 만듦.

📝 목적지로 이동

목적지로 이동하는 것은 NavController를 사용하여 수행되며, NavController는 NavHost 내에서 앱 네비게이션을 관리하는 객체.

각 NavHost에는 고유한 NavController가 있음.

Kotlin:
Fragment.findNavController()
View.findNavController()
Activity.findNavController(viewId: Int)

Java:
NavHostFragment.findNavController(Fragment)
Navigation.findNavController(Activity, @IdRes int viewId)
Navigation.findNavController(View)

위의 메소드들 중 하나를 사용하여 NavController를 가져올 수 있음.

FragmentContainerView를 사용하여 NavHostFragment를 만들거나 FragmentTransaction을 통해 수동으로 NavHostFragment를 액티비티에 추가할 때, 액티비티의 onCreate()에서 Navigation.findNavController(Activity, @IdRes int)를 사용하여 NavController를 가져오려고 하면 실패할 수 있음.

대신 직접 NavController를 NavHostFragment에서 가져와야 함.

val navHostFragment =
        supportFragmentManager.findFragmentById(R.id.nav_host_fragment) as NavHostFragment
val navController = navHostFragment.navController

📕 Safe Args를 사용하여 타입 안전성 보장

목적지 사이를 이동할때 권장되는 방법은 Safe Args Gradle 플러그인을 사용하는 것. 이 플러그인은 간단한 객체 및 빌더 클래스를 생성하여 목적지 간 안전한 형식의 내비게이션과 인자 전달을 가능하게 함.

Safe Args를 활성화하면 해당 플러그인이 정의한 각 액션에 대한 클래스 및 메서드를 생성.
Safe Args는 목적지에 대한 클래스도 생성. 생성된 클래스 이름은 목적지클래스 이름 + Directions라는 단어의 조합.
(예: SpecifyAmountFragment 가 목적지일 경우 SpecifyAmountFragmentDirections가 생성됨.)

생성된 클래스엔 목적지에 정의된 각 액션에 대한 정적 메서드 포함. 이 메서드는 정의된 액션 매개변수를 인수로 사용하고 navigate()에 전달할 수 있는 NavDirections 객체 반환.

override fun onClick(view: View) {
    val action =
        SpecifyAmountFragmentDirections
            .actionSpecifyAmountFragmentToConfirmationFragment()
    view.findNavController().navigate(action)
}