Eric Maxwell, profile picture
Uploaded byEric Maxwell
PDF, PPTX1,968 views

Going Deep w Navigation

The document details the implementation of navigation in an Android application, focusing on navigating to a detailed weather forecast with specific arguments such as zip code and temperature preference. It covers various methods to pass intent extras, create fragments, and handle navigation actions using Android's Navigation Component. The document also includes code snippets demonstrating the setup of navigation graphs and incorporating arguments safely through generated directions.

Embed presentation

Download as PDF, PPTX
1 / 142
2 / 142
3 / 142
4 / 142
5 / 142
6 / 142
7 / 142
8 / 142
9 / 142
10 / 142
11 / 142
12 / 142
13 / 142
14 / 142
15 / 142
16 / 142
17 / 142
18 / 142
19 / 142
20 / 142
21 / 142
22 / 142
23 / 142
24 / 142
25 / 142
26 / 142
27 / 142
28 / 142
29 / 142
30 / 142
31 / 142
32 / 142
33 / 142
34 / 142
35 / 142
36 / 142
37 / 142
38 / 142
39 / 142
40 / 142
41 / 142
42 / 142
43 / 142
44 / 142
45 / 142
46 / 142
47 / 142
48 / 142
49 / 142
50 / 142
51 / 142
52 / 142
53 / 142
54 / 142
55 / 142
56 / 142
57 / 142
58 / 142
59 / 142
60 / 142
61 / 142
62 / 142
63 / 142
64 / 142
65 / 142
66 / 142
67 / 142
68 / 142
69 / 142
70 / 142
71 / 142
72 / 142
73 / 142
74 / 142
75 / 142
76 / 142
77 / 142
78 / 142
79 / 142
80 / 142
81 / 142
82 / 142
83 / 142
84 / 142
85 / 142
86 / 142
87 / 142
88 / 142
89 / 142
90 / 142
91 / 142
92 / 142
93 / 142
94 / 142
95 / 142
96 / 142
97 / 142
98 / 142
99 / 142
100 / 142
101 / 142
102 / 142
103 / 142
104 / 142
105 / 142
106 / 142
107 / 142
108 / 142
109 / 142
110 / 142
111 / 142
112 / 142
113 / 142
114 / 142
115 / 142
116 / 142
117 / 142
118 / 142
119 / 142
120 / 142
121 / 142
122 / 142
123 / 142
124 / 142
125 / 142
126 / 142
127 / 142
128 / 142
129 / 142
130 / 142
131 / 142
132 / 142
133 / 142
134 / 142
135 / 142
136 / 142
137 / 142
138 / 142
139 / 142
140 / 142
141 / 142
142 / 142
Eric Maxwell
 @emmax Going Deep w/ Navigation
Motivations
@emmax
@emmax Pre Navigation val intent = Intent(this, DetailedWeatherForecast::class.java) intent.putExtra("zip_code", city.zipCode) intent.putExtra("use_fahrenheit", true) startActivity(intent) // .. inside DetailedWeatherForecast val zipCode = intent .getStringExtra("zip_code") val useFahrenheit = intent .getBooleanExtra(“use_fahrenheit", true) val fragment = DetailedWeatherForecast() fragment.arguments = Bundle().apply { putString("zip_code", city.zipCode) putBoolean("use_fahrenheit", true) } requireFragmentManager().beginTransaction() .addToBackStack(createTag(city.id)) .replace(R.id.main_content, fragment) .commit() // .. inside DetailedWeatherForecast val zipCode = requireArguments() .getString(“zip_code”) val useFahrenheit = requireArguments() .getBoolean("use_fahrenheit", true) Navigate to Activity Navigate to Fragment
@emmax Pre Navigation val intent = Intent(this, DetailedWeatherForecast::class.java) intent.putExtra("zip_code", city.zipCode) intent.putExtra("use_fahrenheit", true) startActivity(intent) // .. inside DetailedWeatherForecast val zipCode = intent .getStringExtra("zip_code") val useFahrenheit = intent .getBooleanExtra(“use_fahrenheit", true) val fragment = DetailedWeatherForecast() fragment.arguments = Bundle().apply { putString("zip_code", city.zipCode) putBoolean("use_fahrenheit", true) } requireFragmentManager().beginTransaction() .addToBackStack(createTag(city.id)) .replace(R.id.main_content, fragment) .commit() // .. inside DetailedWeatherForecast val zipCode = requireArguments() .getString(“zip_code”) val useFahrenheit = requireArguments() .getBoolean("use_fahrenheit", true) Navigate to Activity Navigate to Fragment
@emmax Navigation val intent = Intent(this, DetailedWeatherForecast::class.java) intent.putExtra("zip_code", city.zipCode) intent.putExtra(“use_fahrenheit", true) startActivity(intent) // .. inside DetailedWeatherForecast val zipCode = intent .getStringExtra(“zip_code”) val useFahrenheit = intent .getBooleanExtra(“use_fahrenheit”, true) // .. do stuff. Navigate to Activity val fragment = DetailedWeatherForecast() fragment.arguments = Bundle().apply { putString("zip_code", city.zipCode) putBoolean(“use_fahrenheit”, true) } requireFragmentManager().beginTransaction() .addToBackStack("WeatherDetails_${1}") .replace(R.id.main_content, fragment) .commit() // .. inside DetailedWeatherForecast val zipCode = requireArguments() .getString(“zip_code”) val useCelsius = requireArguments() .getBoolean("use_fahrenheit", true) // .. do stuff Navigate to Fragment findNavController().navigate( toDetailForecast(city.zipCode) .setUseFahrenheit(true))
@emmax Navigation Navigate to Activity val args : WeatherDetailFragmentArgs by navArgs() val zipCode = args.zipCode val shouldShowFahrenheit = args.useFahrenheit val intent = Intent(this, DetailedWeatherForecast::class.java) intent.putExtra("zip_code", city.zipCode) intent.putExtra(“use_fahrenheit", true) startActivity(intent) // .. inside DetailedWeatherForecast val zipCode = intent .getStringExtra(“zip_code”) val useFahrenheit = intent .getBooleanExtra(“use_fahrenheit”, true) // .. do stuff. val fragment = DetailedWeatherForecast() fragment.arguments = Bundle().apply { putString("zip_code", city.zipCode) putBoolean(“use_fahrenheit”, true) } requireFragmentManager().beginTransaction() .addToBackStack("WeatherDetails_${1}") .replace(R.id.main_content, fragment) .commit() // .. inside DetailedWeatherForecast val zipCode = requireArguments() .getString(“zip_code”) val useCelsius = requireArguments() .getBoolean("celsius", true) // .. do stuff Navigate to Fragment
How Does it Work?
@emmax Minimal Dependencies Navigation dependencies { ... implementation "androidx.navigation:navigation-runtime-ktx:$version" /* Navigation Runtime */
 }
@emmax Minimal Dependencies Navigation dependencies { ... implementation "androidx.navigation:navigation-runtime-ktx:$version" /* Navigation Runtime */
 implementation "androidx.navigation:navigation-fragment-ktx:$version" /* Fragment Destinations */ }
@emmax https://github.com/googlesamples/android-architecture-components/tree/master/NavigationBasicSample
@emmax https://github.com/googlesamples/android-architecture-components/tree/master/NavigationBasicSample
@emmax https://github.com/googlesamples/android-architecture-components/tree/master/NavigationBasicSample
@emmax https://github.com/googlesamples/android-architecture-components/tree/master/NavigationBasicSample
@emmax https://github.com/googlesamples/android-architecture-components/tree/master/NavigationBasicSample
@emmax https://github.com/googlesamples/android-architecture-components/tree/master/NavigationBasicSample Destinations
@emmax https://github.com/googlesamples/android-architecture-components/tree/master/NavigationBasicSample Actions
Destinations • Arguments • Deep Links • Actions
Destinations • Arguments • Deep Links • Actions
Destinations • Arguments • Deep Links • Actions
Destinations • Arguments • Deep Links • Actions
Destinations • Arguments • Deep Links • Actions
Destinations • Arguments • Deep Links • Actions
Destinations • Arguments • Deep Links • Actions <deepLink app:uri="www.example.com/match/{player_one_name}/{player_two_name} " />
Destinations • Arguments • Deep Links • Actions
• Destination • Argument Default Values • Pop Behavior • Launch Options • Animations Actions
• Destination • Argument Default Values • Pop Behavior • Launch Options • Animations Actions
Actions • Destination • Argument Default Values • Pop Behavior • Launch Options • Animations
Actions • Destination • Argument Default Values • Pop Behavior • Launch Options • Animations
CUSTOM ANIMATIONS
Actions • Destination • Argument Default Values • Pop Behavior • Launch Options • Animations
Actions • Destination • Argument Default Values • Pop Behavior • Launch Options • Animations Intent.FLAG_ACTIVITY_CLEAR_TOP Intent.FLAG_ACTIVITY_SINGLE_TOP
Stack Based Navigation UNDERSTANDING POP BEHAVIOR Navigation Graph
Stack Based Navigation UNDERSTANDING POP BEHAVIOR Navigation Graph Stack
Stack Based Navigation UNDERSTANDING POP BEHAVIOR Navigation Graph Stack
Stack Based Navigation UNDERSTANDING POP BEHAVIOR Navigation Graph Stack
Stack Based Navigation UNDERSTANDING POP BEHAVIOR Navigation Graph Stack
<fragment android:id="@+id/match" ...> <fragment android:id=“@+id/in_game" ...> <action android:id="@+id/action_in_game_to_results_winner" app:destination="@id/results_winner" app:popUpTo="@id/match" /> <action android:id="@+id/action_in_game_to_game_over" app:destination="@id/game_over" app:popUpTo="@id/match" /> </fragment> <fragment android:id="@+id/results_winner" android:name="com.example.android.navigationsample.ResultsWinner"/> <fragment android:id="@+id/game_over" android:name=“com.example.android.navigationsample.GameOver" /> Popping Back to Match UNDERSTANDING POP BEHAVIOR
<fragment android:id="@+id/match" ...> <fragment android:id=“@+id/in_game" ...> <action android:id="@+id/action_in_game_to_results_winner" app:destination="@id/results_winner" app:popUpTo="@id/match" /> <action android:id="@+id/action_in_game_to_game_over" app:destination="@id/game_over" app:popUpTo=“@id/in_game” app:popUpToInclusive="true" /> </fragment> <fragment android:id="@+id/results_winner" android:name="com.example.android.navigationsample.ResultsWinner"/> <fragment android:id="@+id/game_over" android:name=“com.example.android.navigationsample.GameOver" /> With Inclusive UNDERSTANDING POP BEHAVIOR
Hosting Navigation
Inside Activity HOSTING NAVIGATION <FrameLayout xmlns:android="http://schemas.android.com/apk/res/android" xmlns:app="http://schemas.android.com/apk/res-auto" android:layout_width="match_parent" android:layout_height="match_parent"> <fragment android:id=“@+id/nav_host_fragment” android:layout_width="match_parent" android:layout_height="match_parent" android:name="androidx.navigation.fragment.NavHostFragment" app:defaultNavHost="true" app:navGraph=“@navigation/navigation_graph”/> </FrameLayout>
Include NavHostFragment HOSTING NAVIGATION <FrameLayout xmlns:android="http://schemas.android.com/apk/res/android" xmlns:app="http://schemas.android.com/apk/res-auto" android:layout_width="match_parent" android:layout_height="match_parent"> <fragment android:id=“@+id/nav_host_fragment” android:layout_width="match_parent" android:layout_height="match_parent" android:name="androidx.navigation.fragment.NavHostFragment" app:defaultNavHost="true" app:navGraph=“@navigation/navigation_graph”/> </FrameLayout>
HOSTING NAVIGATION Navigation Graph NavHostFragment NavHostFragment Initialization 1. Create NavController 2. Registers Fragment as a Destination Type 3. Restore Navigation State 4. Set Graph on NavController 5. Navigate to first Destination
HOSTING NAVIGATION Navigation Graph NavHostFragment NavHostFragment Initialization 1. Create NavController 2. Registers Fragment as a Destination Type 3. Restore Navigation State 4. Set Graph on NavController 5. Navigate to first Destination
HOSTING NAVIGATION Navigation Graph NavHostFragment NavHostFragment Initialization 1. Create NavController 2. Registers Fragment as a Destination Type 3. Restore Navigation State 4. Set Graph on NavController 5. Navigate to first Destination
HOSTING NAVIGATION Navigation Graph NavHostFragment NavHostFragment Initialization 1. Create NavController 2. Registers Fragment as a Destination Type 3. Restore Navigation State 4. Set Graph on NavController 5. Navigate to first Destination
HOSTING NAVIGATION Navigation Graph Destination NavHostFragment NavHostFragment Initialization 1. Create NavController 2. Registers Fragment as a Destination Type 3. Restore Navigation State 4. Set Graph on NavController 5. Navigate to first Destination <navigation xmlns:android="..." xmlns:app="..." xmlns:tools=..." android:id="@+id/weather_graph" app:startDestination="@id/weather_list"> <fragment android:id="@+id/weather_list" android:name=".WeatherListFragment" android:label="Weather Now" tools:layout="@layout/weather_list_fragment">
HOSTING NAVIGATION Navigation Graph Destination Destination NavHostFragment navController.navigate(...) NavHostFragment Initialization 1. Create NavController 2. Registers Fragment as a Destination Type 3. Restore Navigation State 4. Set Graph on NavController 5. Navigate to first Destination NavController
HOSTING NAVIGATION Navigation Graph Destination Destination NavHostFragment navController.popBackStack() NavHostFragment Initialization 1. Create NavController 2. Registers Fragment as a Destination Type 3. Restore Navigation State 4. Set Graph on NavController 5. Navigate to first Destination NavController
Accessing NavController NAVIGATING class MyDestinationFragment : Fragment() override fun onViewCreated(view: View, savedInstanceState: Bundle?) { val controller: NavController = findNavController() } } Fragment class MainActivity : AppCompatActivity() { private lateinit var navController: NavController override fun onCreate(savedInstanceState: Bundle?) { super.onCreate(savedInstanceState) setContentView(R.layout.activity_main) val controller: NavController = findNavController(R.id.nav_host_fragment) } Activity
Navigate to Another Destination NAVIGATING class MyDestinationFragment : Fragment() override fun onViewCreated(view: View, savedInstanceState: Bundle?) { val controller: NavController = findNavController() view.findViewById<Button>(R.id.next)).setOnClickListener { controller.navigate(R.id.action_id) } } }
Safe Args
@emmax Safe Args Dependencies Safe Args Project build.gradle: dependencies { ... classpath “android.arch.navigation:navigation-safe-args-gradle-plugin:$version" } Module build.gradle: apply plugin: 'androidx.navigation.safeargs'
Generated Directions + Arguments PASSING ARGUMENTS SAFELY Destination Requires •Zip Code •Use Fahrenheit Flag https://github.com/ericmaxwell2003/Weather
Generated Arguments + Directions PASSING ARGUMENTS SAFELY <navigation android:id="@+id/weather_nav" app:startDestination="@id/weather_list"> <fragment android:id="@+id/weather_list" android:name=".WeatherListFragment"> <action android:id="@+id/navigate_to_weather_details" app:destination="@id/weather_detail" > <argument android:defaultValue="true" android:name="use_fahrenheit" /> </action> </fragment> <fragment android:id=“@+id/weather_detail" android:name="com.acme.weather.view.WeatherDetailFragment"> <argument android:name=“zip_code” app:argType=“string" /> <argument android:name="use_fahrenheit" app:argType="boolean" /> </fragment> </navigation>
Generated Arguments PASSING ARGUMENTS SAFELY public class WeatherDetailFragmentArgs implements NavArgs { // Create Args from Bundle or output to Bundle public static WeatherDetailFragmentArgs fromBundle(@NonNull Bundle bundle) {} public Bundle toBundle() {} // Type Safe Property Access public String getZipCode() public boolean getUseFahrenheit() // Builder for type safe argument creation public static class Builder {} } <fragment android:id=“@+id/weather_detail" android:name="com.acme.weather.view.WeatherDetailFragment"> <argument android:name=“zip_code” app:argType=“string" /> <argument android:name="use_fahrenheit" app:argType="boolean" /> </fragment> Navigation Graph
Generated Arguments PASSING ARGUMENTS SAFELY <fragment android:id=“@+id/weather_detail" android:name="com.acme.weather.view.WeatherDetailFragment"> <argument android:name=“zip_code” app:argType=“string" /> <argument android:name="use_fahrenheit" app:argType="boolean" /> </fragment> Navigation Graph Construct from android.os.Bundle public class WeatherDetailFragmentArgs implements NavArgs { // Create Args from Bundle or output to Bundle public static WeatherDetailFragmentArgs fromBundle(@NonNull Bundle bundle) {} public Bundle toBundle() {} // Type Safe Property Access public String getZipCode() public boolean getUseFahrenheit() // Builder for type safe argument creation public static class Builder {} }
Generated Arguments PASSING ARGUMENTS SAFELY <fragment android:id=“@+id/weather_detail" android:name="com.acme.weather.view.WeatherDetailFragment"> <argument android:name=“zip_code” app:argType=“string" /> <argument android:name="use_fahrenheit" app:argType="boolean" /> </fragment> Navigation Graph Access args as properties by type public class WeatherDetailFragmentArgs implements NavArgs { // Create Args from Bundle or output to Bundle public static WeatherDetailFragmentArgs fromBundle(@NonNull Bundle bundle) {} public Bundle toBundle() {} // Type Safe Property Access public String getZipCode() public boolean getUseFahrenheit() // Builder for type safe argument creation public static class Builder {} }
Accessing Args in Destination PASSING ARGUMENTS SAFELY public class WeatherDetailFragmentArgs implements NavArgs { // Create Args from Bundle or output to Bundle public static WeatherDetailFragmentArgs fromBundle(@NonNull Bundle bundle) {} public Bundle toBundle() {} // Type Safe Property Access public String getZipCode() public boolean getUseFahrenheit() // Builder for type safe argument creation public static class Builder {} } <fragment android:id=“@+id/weather_detail" android:name="com.acme.weather.view.WeatherDetailFragment"> <argument android:name=“zip_code” app:argType=“string" /> <argument android:name="use_fahrenheit" app:argType="boolean" /> </fragment> val args = WeatherDetailFragmentArgs.fromBundle(arguments) — or — val args: WeatherDetailFragmentArgs by navArgs() Args Navigation Graph
Generated Arguments + Directions PASSING ARGUMENTS SAFELY <navigation android:id="@+id/weather_nav" app:startDestination="@id/weather_list"> <fragment android:id="@+id/weather_list" android:name=".WeatherListFragment"> <action android:id="@+id/navigate_to_weather_details" app:destination="@id/weather_detail" > <argument android:defaultValue="true" android:name="use_fahrenheit" /> </action> </fragment> <fragment android:id=“@+id/weather_detail" android:name="com.acme.weather.view.WeatherDetailFragment"> <argument android:name=“zip_code” app:argType=“string" /> <argument android:name="use_fahrenheit" app:argType="boolean" /> </fragment> </navigation>
<navigation android:id="@+id/weather_nav" app:startDestination="@id/weather_list"> <fragment android:id="@+id/weather_list" android:name=".WeatherListFragment"> <action android:id="@+id/navigate_to_weather_details" app:destination="@id/weather_detail" > <argument android:defaultValue="true" android:name="use_fahrenheit" /> </action> </fragment> <fragment android:id=“@+id/weather_detail" android:name="com.acme.weather.view.WeatherDetailFragment"> <argument android:name=“zip_code” app:argType=“string" /> <argument android:name="use_fahrenheit" app:argType="boolean" /> </fragment> </navigation> Generated Arguments + Directions PASSING ARGUMENTS SAFELY
public class WeatherListFragmentDirections { // Static factory for each Action tied to this destination public static NavigateToWeatherDetails navigateToWeatherDetails(@NonNull String zipCode) {} public static class NavigateToWeatherDetails implements NavDirections { // Setters to override default argument values public NavigateToWeatherDetails setUseFahrenheit(boolean useFahrenheit) {} // Accessors for Bundle arguments, Action (…and NavOptions) public Bundle getArguments() {} public int getActionId() {} } Generated Directions PASSING ARGUMENTS SAFELY <action android:id="@+id/navigate_to_weather_details" app:destination="@id/weather_detail" > <argument android:defaultValue="true" android:name="use_fahrenheit" /> </action> Navigation Graph
public class WeatherListFragmentDirections { // Static factory for each Action tied to this destination public static NavigateToWeatherDetails navigateToWeatherDetails(@NonNull String zipCode) {} public static class NavigateToWeatherDetails implements NavDirections { // Setters to override default argument values public NavigateToWeatherDetails setUseFahrenheit(boolean useFahrenheit) {} // Accessors for Bundle arguments, Action (…and NavOptions) public Bundle getArguments() {} public int getActionId() {} } Generated Directions PASSING ARGUMENTS SAFELY <action android:id="@+id/navigate_to_weather_details" app:destination="@id/weather_detail" > <argument android:defaultValue="true" android:name="use_fahrenheit" /> </action> navigate_to_weather_details Navigation Graph
public class WeatherListFragmentDirections { // Static factory for each Action tied to this destination public static NavigateToWeatherDetails navigateToWeatherDetails(@NonNull String zipCode) {} public static class NavigateToWeatherDetails implements NavDirections { // Setters to override default argument values public NavigateToWeatherDetails setUseFahrenheit(boolean useFahrenheit) {} // Accessors for Bundle arguments, Action (…and NavOptions) public Bundle getArguments() {} public int getActionId() {} } Generated Directions PASSING ARGUMENTS SAFELY <action android:id="@+id/navigate_to_weather_details" app:destination="@id/weather_detail" > <argument android:defaultValue="true" android:name="use_fahrenheit" /> </action> zipCode String required Navigation Graph
public class WeatherListFragmentDirections { // Static factory for each Action tied to this destination public static NavigateToWeatherDetails navigateToWeatherDetails(@NonNull String zipCode) {} public static class NavigateToWeatherDetails implements NavDirections { // Setters to override default argument values public NavigateToWeatherDetails setUseFahrenheit(boolean useFahrenheit) {} // Accessors for Bundle arguments, Action (…and NavOptions) public Bundle getArguments() {} public int getActionId() {} } Generated Directions PASSING ARGUMENTS SAFELY <action android:id="@+id/navigate_to_weather_details" app:destination="@id/weather_detail" > <argument android:defaultValue="true" android:name="use_fahrenheit" /> </action> useFahrenheit can be overridden Navigation Graph
public class WeatherListFragmentDirections { // Static factory for each Action tied to this destination public static NavigateToWeatherDetails navigateToWeatherDetails(@NonNull String zipCode) {} public static class NavigateToWeatherDetails implements NavDirections { // Setters to override default argument values public NavigateToWeatherDetails setUseFahrenheit(boolean useFahrenheit) {} // Accessors for Bundle arguments, Action (…and NavOptions) public Bundle getArguments() {} public int getActionId() {} } Generated Directions PASSING ARGUMENTS SAFELY <action android:id="@+id/navigate_to_weather_details" app:destination="@id/weather_detail" > <argument android:defaultValue="true" android:name="use_fahrenheit" /> </action> All navigate(...) details Navigation Graph
Navigating with Directions PASSING ARGUMENTS SAFELY <action android:id="@+id/navigate_to_weather_details" app:destination="@id/weather_detail" > <argument android:defaultValue="true" android:name="use_fahrenheit" /> </action> val directions = WeatherListFragmentDirections
 .navigateToWeatherDetails(zipCode) .setUseFahrenheit(true) findNavController().navigate(directions) public class WeatherListFragmentDirections { // Static factory for each Action tied to this destination public static NavigateToWeatherDetails navigateToWeatherDetails(...) {} public static class NavigateToWeatherDetails implements NavDirections { // Setters to override default argument values public NavigateToWeatherDetails setUseFahrenheit(boolean useFahrenheit) {} // Accessors for Bundle arguments, Action (…and NavOptions) public Bundle getArguments() {} public int getActionId() {} } Navigation Graph
Navigating with Directions PASSING ARGUMENTS SAFELY <action android:id="@+id/navigate_to_weather_details" app:destination="@id/weather_detail" > <argument android:defaultValue="true" android:name="use_fahrenheit" /> </action> public class WeatherListFragmentDirections { // Static factory for each Action tied to this destination public static NavigateToWeatherDetails navigateToWeatherDetails(...) {} public static class NavigateToWeatherDetails implements NavDirections { // Setters to override default argument values public NavigateToWeatherDetails setUseFahrenheit(boolean useFahrenheit) {} // Accessors for Bundle arguments, Action (…and NavOptions) public Bundle getArguments() {} public int getActionId() {} } Navigation Graph findNavController().navigate( toWeatherDetails(zipCode) .setUseFahrenheit(true))
Navigating with Directions PASSING ARGUMENTS SAFELY <action android:id="@+id/navigate_to_weather_details" app:destination="@id/weather_detail" > <argument android:defaultValue="true" android:name="use_fahrenheit" /> </action> val directions = WeatherListFragmentDirections
 .navigateToWeatherDetails(zipCode) .setUseFahrenheit(true) findNavController().navigate(directions) public class WeatherListFragmentDirections { // Static factory for each Action tied to this destination public static NavigateToWeatherDetails navigateToWeatherDetails(...) {} public static class NavigateToWeatherDetails implements NavDirections { // Setters to override default argument values public NavigateToWeatherDetails setUseFahrenheit(boolean useFahrenheit) {} // Accessors for Bundle arguments, Action (…and NavOptions) public Bundle getArguments() {} public int getActionId() {} } Navigation Graph
Navigating with Directions PASSING ARGUMENTS SAFELY <action android:id="@+id/navigate_to_weather_details" app:destination="@id/weather_detail" > <argument android:defaultValue="true" android:name="use_fahrenheit" /> </action> val directions = WeatherListFragmentDirections
 .navigateToWeatherDetails(zipCode) .setUseFahrenheit(true) findNavController().navigate(directions) public class WeatherListFragmentDirections { // Static factory for each Action tied to this destination public static NavigateToWeatherDetails navigateToWeatherDetails(...) {} public static class NavigateToWeatherDetails implements NavDirections { // Setters to override default argument values public NavigateToWeatherDetails setUseFahrenheit(boolean useFahrenheit) {} // Accessors for Bundle arguments, Action (…and NavOptions) public Bundle getArguments() {} public int getActionId() {} } Navigation Graph Static import of NavDirections class
Navigating with Directions PASSING ARGUMENTS SAFELY <action android:id="@+id/navigate_to_weather_details" app:destination="@id/weather_detail" > <argument android:defaultValue="true" android:name="use_fahrenheit" /> </action> val directions = WeatherListFragmentDirections
 .navigatetoWeatherDetails(zipCode) .setUseFahrenheit(true) findNavController().navigate(directions) public class WeatherListFragmentDirections { // Static factory for each Action tied to this destination public static NavigateToWeatherDetails navigateToWeatherDetails(...) {} public static class NavigateToWeatherDetails implements NavDirections { // Setters to override default argument values public NavigateToWeatherDetails setUseFahrenheit(boolean useFahrenheit) {} // Accessors for Bundle arguments, Action (…and NavOptions) public Bundle getArguments() {} public int getActionId() {} } Navigation Graph Static import of NavDirections class Change name of action to "to_weather_details"
Navigating with Directions PASSING ARGUMENTS SAFELY <action android:id="@+id/to_weather_details" app:destination="@id/weather_detail" > <argument android:defaultValue="true" android:name="use_fahrenheit" /> </action> findNavController().navigate( toWeatherDetails(zipCode) .setUseFahrenheit(true)) public class WeatherListFragmentDirections { // Static factory for each Action tied to this destination public static NavigateToWeatherDetails navigateToWeatherDetails(...) {} public static class NavigateToWeatherDetails implements NavDirections { // Setters to override default argument values public NavigateToWeatherDetails setUseFahrenheit(boolean useFahrenheit) {} // Accessors for Bundle arguments, Action (…and NavOptions) public Bundle getArguments() {} public int getActionId() {} } Navigation Graph
Conditional Navigation
CONDITIONAL NAVIGATION
CONDITIONAL NAVIGATION Fixed Starting 
 Destination
CONDITIONAL NAVIGATION
Conditional Starting Destination CONDITIONAL NAVIGATION
First Time User Experience CONDITIONAL NAVIGATION
First Time User Experiences CONDITIONAL NAVIGATION Login GraphMain Navigation Graph
First Time User Experiences CONDITIONAL NAVIGATION <navigation ... android:id="@+id/weather_graph" app:startDestination="@id/weather_list"> <fragment android:id=“@+id/weather_list">...</fragment> <fragment android:id="@+id/weather_detail">...</fragment> <navigation android:id="@+id/login_graph" android:label="Login" app:startDestination="@id/login"> <fragment android:id="@+id/login" android:name="com.acme.weather.security.view.Login" android:label="Log In" /> </navigation> </navigation> Nested Graph
First Time User Experiences CONDITIONAL NAVIGATION <navigation ... android:id="@+id/weather_graph" app:startDestination="@id/weather_list"> <fragment android:id=“@+id/weather_list">...</fragment> <fragment android:id="@+id/weather_detail">...</fragment> <include app:graph="@navigation/login_graph" /> </navigation> Include as Separate Graph
Login GraphMain Navigation Graph First Time User Experiences CONDITIONAL NAVIGATION Global Action
Global Action CONDITIONAL NAVIGATION <navigation ... android:id="@+id/weather_graph" app:startDestination="@id/weather_list"> <fragment android:id=“@+id/weather_list">...</fragment> <fragment android:id="@+id/weather_detail">...</fragment> <include app:graph="@navigation/login_graph" /> <action android:id="@+id/action_global_login" app:destination="@id/login_graph" /> </navigation> Global Action is Global because
 it is not tied to a destination
 
 It is a peer to destinations in this
 navigation graph and accessible by
 any destination inside this graph
CONDITIONAL NAVIGATION 1. If user is unauthenticated, redirect to login 2. Return to secured area
 once authenticated First Time User Experiences
Global Navigation CONDITIONAL NAVIGATION class WeatherDetailFragment : SecureFragment() { override fun onViewCreated(view: View, savedInstanceState: Bundle?) { super.onViewCreated(view, savedInstanceState) } }
Global Navigation CONDITIONAL NAVIGATION abstract class SecureFragment : Fragment() { val authenticationViewModel by activityViewModels<AuthenticationViewModel>() override fun onViewCreated(view: View, savedInstanceState: Bundle?) { ... } private fun popBackStackOrExit() { ... } }
Global Navigation CONDITIONAL NAVIGATION abstract class SecureFragment : Fragment() { val authenticationViewModel by activityViewModels<AuthenticationViewModel>() override fun onViewCreated(view: View, savedInstanceState: Bundle?) { super.onViewCreated(view, savedInstanceState) authenticationViewModel.authenticationStatus.observe(viewLifecycleOwner, Observer { authStatus -> when(authStatus) { UNAUTHENTICATED -> navController.navigate(actionGlobalLogin()) USER_DECLINED -> popBackStackOrExit() else -> Unit } }) } private fun popBackStackOrExit() { ... } }
Global Navigation CONDITIONAL NAVIGATION abstract class SecureFragment : Fragment() { val authenticationViewModel by activityViewModels<AuthenticationViewModel>() override fun onViewCreated(view: View, savedInstanceState: Bundle?) { super.onViewCreated(view, savedInstanceState) authenticationViewModel.authenticationStatus.observe(viewLifecycleOwner, Observer { authStatus -> when(authStatus) { UNAUTHENTICATED -> navController.navigate(actionGlobalLogin()) USER_DECLINED -> popBackStackOrExit() else -> Unit } }) } private fun popBackStackOrExit() { ... } }
Global Navigation CONDITIONAL NAVIGATION abstract class SecureFragment : Fragment() { val authenticationViewModel by activityViewModels<AuthenticationViewModel>() override fun onViewCreated(view: View, savedInstanceState: Bundle?) { super.onViewCreated(view, savedInstanceState) authenticationViewModel.authenticationStatus.observe(viewLifecycleOwner, Observer { authStatus -> when(authStatus) { UNAUTHENTICATED -> navController.navigate(actionGlobalLogin()) USER_DECLINED -> popBackStackOrExit() else -> Unit } }) } private fun popBackStackOrExit() { if(!navController.popBackStack()) { requireActivity().finish() } } }
CONDITIONAL NAVIGATION DEMO
Deep Link
Implicit DEEP LINK URI
 weather.acme.com/{zip_code} https://github.com/ericmaxwell2003/Weather
Implicit DEEP LINK <fragment android:id="@+id/weather_detail" android:name="com.acme.weather.app.view.WeatherDetailFragment" android:label="Today's Forecast" tools:layout="@layout/weather_detail_fragment"> <argument android:name="zip_code" app:argType="string" /> <argument android:name="use_fahrenheit" app:argType="boolean" android:defaultValue="true" /> <deepLink android:id="@+id/deepLink" app:uri="weather.acme.com/{zip_code}" /> </fragment>
Implicit DEEP LINK <manifest xmlns:android="http://schemas.android.com/apk/res/android" xmlns:tools="http://schemas.android.com/tools" package="com.acme.weather"> <application ... <activity android:name=".app.view.MainActivity"> <nav-graph android:value="@navigation/weather_graph" /> <intent-filter> <action android:name="android.intent.action.MAIN" /> <category android:name="android.intent.category.LAUNCHER" /> </intent-filter> </activity> </application> </manifest>
Implicit DEEP LINK <manifest xmlns:android="http://schemas.android.com/apk/res/android" xmlns:tools="http://schemas.android.com/tools" package="com.acme.weather"> <application ... <activity android:name=".app.view.MainActivity"> <intent-filter> <action android:name="android.intent.action.VIEW" /> <category android:name="android.intent.category.DEFAULT" /> <category android:name="android.intent.category.BROWSABLE" /> <data android:scheme="http" /> <data android:scheme="https" /> <data android:host="weather.acme.com" /> <data android:pathPrefix="/" /> </intent-filter> ... </activity> </application> </manifest>
On SetGraph LAUNCH VIA IMPLICIT DEEP LINK 1. Search Graph for best matching deep link • URI exact matches preferred • By matching arguments NavHostFragment Initialization 1. Create NavController 2. Registers ??? as a Destination Type 3. Restore Navigation State 4. Set Graph on NavController 5. Navigate to first Destination
On SetGraph LAUNCH VIA IMPLICIT DEEP LINK 1. Search Graph for best matching deep link • URI exact matches preferred • By matching arguments 2. Build array of destination IDs leading to this Destination • R.id.weather_list • R.id.weather_detail NavHostFragment Initialization 1. Create NavController 2. Registers ??? as a Destination Type 3. Restore Navigation State 4. Set Graph on NavController 5. Navigate to first Destination
On SetGraph LAUNCH VIA IMPLICIT DEEP LINK 1. Search Graph for best matching deep link • URI exact matches preferred • By matching arguments 2. Build array of destination IDs leading to this Destination • R.id.weather_list • R.id.weather_detail 3. Push each destination on the stack • (If new task) NavHostFragment Initialization 1. Create NavController 2. Registers ??? as a Destination Type 3. Restore Navigation State 4. Set Graph on NavController 5. Navigate to first Destination
On SetGraph LAUNCH VIA IMPLICIT DEEP LINK 1. Search Graph for best matching deep link • URI exact matches preferred • By matching arguments 2. Build array of destination IDs leading to this Destination • R.id.weather_list • R.id.weather_detail 3. Push last destination on the stack • (If part of an existing task) NavHostFragment Initialization 1. Create NavController 2. Registers ??? as a Destination Type 3. Restore Navigation State 4. Set Graph on NavController 5. Navigate to first Destination
Explicit DEEP LINK Launch via PendingIntent https://github.com/ericmaxwell2003/Weather
Create Pending Intent LAUNCH VIA EXPLICIT DEEP LINK fun scheduleNotificationForZip() { /* Create a deep link and pending intent */ val pendingIntent = navController.createDeepLink() .setDestination(R.id.weather_detail) .setArguments(arguments) .createPendingIntent() /* Build the Notification */ createNotificationChannel() val builder = NotificationCompat.Builder(requireContext(), CHANNEL_ID) .setSmallIcon(R.drawable.notification_icon) .setContentTitle("Weather Report") .setContentText("Weather now in ${args.zipCode}") .setPriority(NotificationCompat.PRIORITY_DEFAULT) .setContentIntent(pendingIntent) .setAutoCancel(true) notificationManager.notify(1, builder.build()) }
Explicit Deep Link Intent LAUNCH VIA EXPLICIT DEEP LINK 1. android-support-nav:controller:deepLinkIds • R.id.weather_list • R.id.weather_detail 2. android-support-nav:controller:deepLinkExtras • zip_code • use_fahrenheit 3. android-support-nav:controller:deepLinkIntent • Intent that triggered the deep link
Testing Navigation
Mock NavController TESTING NAVIGATION @Test fun testNavigationToInGameScreen() { val mockNavController = mock(NavController::class.java) val bundle = WeatherDetailFragmentArgs.Builder("43231") .build() .toBundle() val fragmentScenario = launchFragmentInContainer<WeatherDetailFragment>(bundle) fragmentScenario.onFragment { fragment -> // Access to set after onResume() Navigation.setViewNavController( fragment.requireView(), mockNavController) } // Drive view with Espresso and verify navigation interactions onView(...) verify(mockNavController).navigate(...) }
@emmax @Test fun testNavigationToInGameScreen() { val mockNavController = mock(NavController::class.java) val bundle = WeatherDetailFragmentArgs.Builder("43231") .build() .toBundle() val fragmentScenario = launchFragmentInContainer<WeatherDetailFragment>(bundle) fragmentScenario.onFragment { fragment -> // Access to set after onResume() Navigation.setViewNavController( fragment.requireView(), mockNavController) } // Drive view with Espresso and verify navigation interactions onView(...) verify(mockNavController).navigate(...) } FragmentScenario Requires : 'androidx.fragment:fragment-testing:1.1.0-alpha06' FragmentScenario TESTING NAVIGATION
FragmentScenario TESTING NAVIGATION @Test fun testNavigationToInGameScreen() { val mockNavController = mock(NavController::class.java) val bundle = WeatherDetailFragmentArgs.Builder("43231") .build() .toBundle() val fragmentScenario = launchFragmentInContainer<WeatherDetailFragment>(bundle) fragmentScenario.onFragment { fragment -> // Access to set after onResume() Navigation.setViewNavController( fragment.requireView(), mockNavController) } // Drive view with Espresso and verify navigation interactions onView(...) verify(mockNavController).navigate(...) }
FragmentScenario TESTING NAVIGATION @Test fun testNavigationToInGameScreen() { val mockNavController = mock(NavController::class.java) val bundle = WeatherDetailFragmentArgs.Builder("43231") .build() .toBundle() val fragmentScenario = launchFragmentInContainer<WeatherDetailFragment>(bundle) fragmentScenario.onFragment { fragment -> // Access to set after onResume() Navigation.setViewNavController( fragment.requireView(), mockNavController) } // Drive view with Espresso and verify navigation interactions onView(...) verify(mockNavController).navigate(...) }
FragmentScenario TESTING NAVIGATION @Test fun testNavigationToInGameScreen() { val mockNavController = mock(NavController::class.java) val bundle = WeatherDetailFragmentArgs.Builder("43231") .build() .toBundle() val fragmentScenario = launchFragmentInContainer<WeatherDetailFragment>(bundle) fragmentScenario.onFragment { fragment -> // Access to set after onResume() Navigation.setViewNavController( fragment.requireView(), mockNavController) } // Drive view with Espresso and verify navigation interactions onView(...) verify(mockNavController).navigate(...) } Called after Fragment.onResume()
@Test fun testNavigationToInGameScreen() { val mockNavController = mock(NavController::class.java) val bundle = WeatherDetailFragmentArgs.Builder("43231") .build() .toBundle() val fragmentScenario = launchFragmentInContainer(bundle) { WeatherDetailFragment().also { fragment -> fragment.viewLifecycleOwnerLiveData.observeForever { viewLifecycleOwner -> // Observe after onCreateView before onViewCreated if (viewLifecycleOwner != null) { Navigation.setViewNavController(
 fragment.requireView(), mockNavController) } } } ... } FragmentScenario TESTING NAVIGATION
FragmentScenario TESTING NAVIGATION @Test fun testNavigationToInGameScreen() { val mockNavController = mock(NavController::class.java) val bundle = WeatherDetailFragmentArgs.Builder("43231") .build() .toBundle() val fragmentScenario = launchFragmentInContainer(bundle) { WeatherDetailFragment().also { fragment -> fragment.viewLifecycleOwnerLiveData.observeForever { viewLifecycleOwner -> // Observe after onCreateView before onViewCreated if (viewLifecycleOwner != null) { Navigation.setViewNavController(
 fragment.requireView(), mockNavController) } } } ... } Construct the Fragment
FragmentScenario TESTING NAVIGATION @Test fun testNavigationToInGameScreen() { val mockNavController = mock(NavController::class.java) val bundle = WeatherDetailFragmentArgs.Builder("43231") .build() .toBundle() val fragmentScenario = launchFragmentInContainer(bundle) { WeatherDetailFragment().also { fragment -> fragment.viewLifecycleOwnerLiveData.observeForever { viewLifecycleOwner -> // Observe after onCreateView before onViewCreated if (viewLifecycleOwner != null) { Navigation.setViewNavController(
 fragment.requireView(), mockNavController) } } } ... } Observe its view lifecycle
 (Starting after onCreateView(...))
Custom Destination Types
NAVIGATION ARCHITECTURE navigate(R.id.destination_2) NavController Destination 2Destination 1
NAVIGATION ARCHITECTURE NavControllerDestination 1 Navigation
 Provider Navigator Destination 2
NAVIGATION ARCHITECTURE NavControllerDestination 1 Navigation
 Provider Navigator Destination 2 navigate(R.id.destination_2) Find Dest 2
NAVIGATION ARCHITECTURE NavControllerDestination 1 Navigation
 Provider Navigator Destination 2 navigate(R.id.destination_2) What is your navigator name? Navigator Name Find Dest 2
NAVIGATION ARCHITECTURE NavControllerDestination 1 Navigation
 Provider Navigator Destination 2 navigate(R.id.destination_2) What is your navigator name? Navigator Name Lookup Navigator(name) Navigator Find Dest 2
NAVIGATION ARCHITECTURE NavControllerDestination 1 Navigation
 Provider Navigator Destination 2 navigate(R.id.destination_2) What is your navigator name? Navigator Name Lookup Navigator(name) Navigator Navigate
 (destination info) Find Dest 2
NAVIGATION ARCHITECTURE NavControllerDestination 1 Navigation
 Provider Navigator Destination 2 navigate(R.id.destination_2) What is your navigator name? Navigator Name Lookup Navigator(name) Navigator Navigate
 (destination info) Actual Navigation Echo Dest Back
 (or null) Find Dest 2
NAVIGATION ARCHITECTURE NavControllerDestination 1 Navigation
 Provider Navigator Destination 2 navigate(R.id.destination_2) What is your navigator name? Navigator Name Lookup Navigator(name) Navigator Navigate
 (destination info) Actual Navigation Echo Dest Back
 (or null) Find Dest 2 Add Dest 2
 NavBackStack Dispatch OnDestinationChanged
NAVIGATION ARCHITECTURE NavControllerDestination 1 Navigation
 Provider Custom
 Navigator CustomNavigator. Destination navigate(R.id.destination_2) What is your navigator name? Navigator Name Lookup Navigator(name) Navigator Navigate
 (destination info) Actual Navigation Echo Dest Back
 (or null) Find Dest 2 Add Dest 2
 NavBackStack Dispatch OnDestinationChanged
HOSTING NAVIGATION Navigation Graph NavHostCustom NavHostFragment Initialization 1. Create NavController 2. Registers ??? as a Destination Type 3. Restore Navigation State 4. Set Graph on NavController 5. Navigate to first Destination class NavHostCustom : NavHost { init { ... navigationController.navigationProvider += createControllerNavigator() ... } override fun getNavController(): NavController = navigationController }
HOSTING NAVIGATION Navigation Graph NavHostCustom NavHostFragment Initialization 1. Create NavController 2. Registers ??? as a Destination Type 3. Restore Navigation State 4. Set Graph on NavController 5. Navigate to first Destination class NavHostCustom : NavHostFragment() { override fun createFragmentNavigator(): Navigator<out FragmentNavigator.Destination> { navController.navigatorProvider += DialogNavigator(requireContext(), childFragmentManager) return super.createFragmentNavigator() } }
• Conductor POC - View Based Destinations • Navigating Conductor and the Navigation Architecture Component -- Tevin Jeffrey -- (https://bit.ly/2MD9LSn) • DialogFragmentDestination • https://gist.github.com/fbarthelery/ad0062a88875b46e0065137ff03807a0 COMMON QUESTIONS Custom Nav Samples
NAVIGATION ARCHITECTURE Responsibilities Reference Implementation(s) Notes NavHost • Container for navigation • Provide NavController • Manage Navigation State • Register • NavHostFragment • Usually registers additional Navigator types (e.g. FragmentNavigator) NavController • Navigate to action or destination • Pop back to previous destination • Generate bundle for saveState • Restore itself from a previously saved bundle -- • Calls to navigate() and popBack(), delegated to the navigator of the next or current destination type. Navigator
 <NavDestination> • Delegate class used by the NavController to do the work of pushing/popping. • Has intimate knowledge of the given destination type • NavGraphNavigator • ActivityNavigator • FragmentNavigator • NoOpNavigator • Navigators can be registered
 
 navController .navigatorProvider += someNavigator NavDestination • Represents a node within the nav graph • Usually a nested class of a corresponding Navigator of this type. • Encapsulate the configured actions, arg declarations, default values, etc. • NavGraph • ActivityNavigator.Destination • FragmentNavigator.Destination • These define the elements you see in the nav graph too:
 <navigation>
 <activity>
 <fragment>
Single Activity?
@emmax Nav Graph Scoped to Activity WHY SINGLE ACTIVITY
@emmax (N) Activities == (N) NavGraphs WHY SINGLE ACTIVITY
@emmax Convenient ViewModel Scoping WHY SINGLE ACTIVITY Fragment A Fragment B Fragment C Graph A Graph B Shared
 ViewModel Activity
@emmax Convenient ViewModel Scoping WHY SINGLE ACTIVITY Graph A Graph B Shared
 ViewModel Activity Shared
 ViewModel Fragment A Fragment B Fragment C 2.1.0-alpha02
When Multiple Activities?
@emmax Multi Module App FeatureB FeatureA FeatureC App Library Library MULTI MODULE Direction of Dependencies
@emmax FeatureB FeatureA FeatureC App Library Library Feature A App Feature CFeature B MULTI MODULE Activity Destination Activity Per Feature • No Dependencies
 Features host their own UI • Testing
 Standard Activity Test Rule / Espresso Test
@emmax How to Navigate Across Modules? FeatureB FeatureA FeatureC App Library Library Feature A App Feature CFeature B MULTI MODULE ? ? Activity Destination • No Dependencies
 Features host their own UI • Testing
 Standard Activity Test Rule / Espresso Test
@emmax Intent How to Navigate Across Modules? FeatureB FeatureA FeatureC App Library Library Feature A App Feature CFeature B MULTI MODULE Activity Destination • NavController within Feature • Implicit Intent Across Features Intent
@emmax Add Intent Filters MULTIPLE ACTIVITIES FOR MULTI MODULE Jeroen Mols Android GDE & Lead Android developer at Philips Hue
 https://jeroenmols.com/blog/2019/04/02/modularizationexample/ FeatureB FeatureA FeatureC App Library Library <activity android:name="..FeatureA" > <intent-filter> <action android:name="com.acme.featureA" /> <category android:name="..DEFAULT" /> </intent-filter> </activity> Each Feature Defines Intent Filter
@emmax Add Intent Filters MULTIPLE ACTIVITIES FOR MULTI MODULE Jeroen Mols Android GDE & Lead Android developer at Philips Hue
 https://jeroenmols.com/blog/2019/04/02/modularizationexample/ FeatureB FeatureA FeatureC App Library Library <activity android:name="..FeatureA" > <intent-filter> <action android:name="com.acme.featureA" /> <category android:name="..DEFAULT" /> </intent-filter> </activity> <activity android:name="..FeatureB" > <intent-filter> <action android:name="com.acme.featureB" /> <category android:name="..DEFAULT" /> </intent-filter> </activity> Merged Manifest Has All
@emmax Feature A App Feature CFeature B MULTIPLE ACTIVITIES FOR MULTI MODULE Jeroen Mols Android GDE & Lead Android developer at Philips Hue
 https://jeroenmols.com/blog/2019/04/02/modularizationexample/ Intent Intent FeatureB FeatureA FeatureC App Library Library Intent Intent("com.acme.featureX")
 .setPackage(context.packageName) Navigate between Features using Intent
@emmax Define a Common Module to Encapsulate Feature A App Feature CFeature B MULTIPLE ACTIVITIES FOR MULTI MODULE Jeroen Mols Android GDE & Lead Android developer at Philips Hue
 https://jeroenmols.com/blog/2019/04/02/modularizationexample/ Actions Actions FeatureB FeatureA FeatureC App Actions Actions Actions.navToFeatureA(context)

Official • Navigation Documentation (https://developer.android.com/guide/navigation) 💪 • Source (AOSP) (https://android.googlesource.com/platform/frameworks/support/) • Issue Tracker (https://issuetracker.google.com/issues?q=componentid:409828%20type:process%20status:open&p=1 • Code Lab https://codelabs.developers.google.com/codelabs/android-navigation/#0 Other Talks • Adventures in Navigation -- DroidCon SF '18 -- Lyla Fujiwara -- (https://www.youtube.com/watch?v=ELGShpd17wc) • Single Activity: Why, When, How -- DevSummit '18 -- Ian Lake -- (https://www.youtube.com/watch?v=2k8x8V77CrU) Posts • Using Navigation in a large banking app -- David Vávra -- (https://bit.ly/2JbT2Yy) • Master-Detail views with Navigation Components --Lara Martín -- (https://bit.ly/2JqEKU7) • Navigating Conductor and the Navigation Architecture Component -- Tevin Jeffrey -- (https://bit.ly/2MD9LSn) • Modularization : Real Life Example -- Jeroen Mols -- (https://buff.ly/2I8mtZj) Sample Projects • Getting Started Sample - https://github.com/googlesamples/android-architecture-components/tree/master/NavigationBasicSample • Advanced Navigation - https://github.com/googlesamples/android-architecture-components/tree/master/NavigationAdvancedSample • DialogNavigator Gist - https://gist.github.com/fbarthelery/ad0062a88875b46e0065137ff03807a0 ADDITIONAL RESOURCES
@emmaxhttps://developer.android.com/guide/navigation/navigation-migrate
Thanks! Eric Maxwell
 twitter @emmax
 www.bignerdranch.com

More Related Content

PDF
Image Manipulation in WordPress 3.5 - WordCamp Phoenix 2013
byGetSource
 
KEY
Sherlock Markup and Sammy Semantic - drupal theming forensic analysis
byAndreas Sahle
 
PDF
Moving from Django Apps to Services
byCraig Kerstiens
 
PDF
Django - 次の一歩 gumiStudy#3
bymakoto tsuyuki
 
PDF
The effective use of Django ORM
byYaroslav Muravskyi
 
PDF
With a Mighty Hammer
byBen Scofield
 
PDF
Testing with Ruby
byJoseph Wilk
 
PDF
A Little Backbone For Your App
byLuca Mearelli
 
Image Manipulation in WordPress 3.5 - WordCamp Phoenix 2013
byGetSource
 
Sherlock Markup and Sammy Semantic - drupal theming forensic analysis
byAndreas Sahle
 
Moving from Django Apps to Services
byCraig Kerstiens
 
Django - 次の一歩 gumiStudy#3
bymakoto tsuyuki
 
The effective use of Django ORM
byYaroslav Muravskyi
 
With a Mighty Hammer
byBen Scofield
 
Testing with Ruby
byJoseph Wilk
 
A Little Backbone For Your App
byLuca Mearelli
 

What's hot

PPT
Writing Apps the Google-y Way
byPamela Fox
 
PDF
An introduction to Ember.js
bycodeofficer
 
PDF
OSCON Google App Engine Codelab - July 2010
byikailan
 
PDF
New Symfony Tips & Tricks (SymfonyCon Paris 2015)
byJavier Eguiluz
 
PPTX
Intro to Ember.JS 2016
bySandino Núñez
 
PDF
Intro to Ember.js
byJay Phelps
 
PDF
WIRED and the WP REST API
bykvignos
 
KEY
Google I/O 2011, Android Honeycomb Highlights
byRomain Guy
 
PDF
How I started to love design patterns
bySamuel ROZE
 
PDF
前端MVC 豆瓣说
byTing Lv
 
Writing Apps the Google-y Way
byPamela Fox
 
An introduction to Ember.js
bycodeofficer
 
OSCON Google App Engine Codelab - July 2010
byikailan
 
New Symfony Tips & Tricks (SymfonyCon Paris 2015)
byJavier Eguiluz
 
Intro to Ember.JS 2016
bySandino Núñez
 
Intro to Ember.js
byJay Phelps
 
WIRED and the WP REST API
bykvignos
 
Google I/O 2011, Android Honeycomb Highlights
byRomain Guy
 
How I started to love design patterns
bySamuel ROZE
 
前端MVC 豆瓣说
byTing Lv
 

Similar to Going Deep w Navigation

PDF
Simplified Android Development with Simple-Stack
byGabor Varadi
 
PPTX
A Single activity app with Jetpack's Navigation Component
byBoonya Kitpitak
 
PDF
Jetpack Navigation Component
byJames Shvarts
 
PDF
Vlad Nedomovniy "Navigation with less pain"
byProvectus
 
PPT
Android Bootcamp Tanzania:intents
byDenis Minja
 
PDF
An Introduction to Deep Linking and App Indexing Codelab
byJarek Wilkiewicz
 
PPTX
Android 3
byRobert Cooper
 
PPTX
User experience and interactions design
byRakesh Jha
 
PPTX
Android Navigation Component
byŁukasz Ciupa
 
PDF
Android design patterns
byPlatty Soft
 
PPTX
What's New in Android
byRobert Cooper
 
PDF
Android Basic Development Day 1 Introduction & ADT
byEakapong Kattiya
 
PPTX
Make Android development easier
byLucas de Almeida Marciano
 
PPTX
Pertemuan 03 - Activities and intents.pptx
byMUHAMMADRIFKIPERMANA2
 
PDF
Android Basic Components
byJussi Pohjolainen
 
PDF
Designing native android apps
byRyan Harter
 
PDF
Mobile App Navigation Patterns and Examples.pdf
byLaura Miller
 
PPTX
Android Application managing activites.pptx
byPoornima E.G.
 
PPTX
Prism Navigation
byEyal Vardi
 
PPT
Android Support Library
byAlexey Ustenko
 
Simplified Android Development with Simple-Stack
byGabor Varadi
 
A Single activity app with Jetpack's Navigation Component
byBoonya Kitpitak
 
Jetpack Navigation Component
byJames Shvarts
 
Vlad Nedomovniy "Navigation with less pain"
byProvectus
 
Android Bootcamp Tanzania:intents
byDenis Minja
 
An Introduction to Deep Linking and App Indexing Codelab
byJarek Wilkiewicz
 
Android 3
byRobert Cooper
 
User experience and interactions design
byRakesh Jha
 
Android Navigation Component
byŁukasz Ciupa
 
Android design patterns
byPlatty Soft
 
What's New in Android
byRobert Cooper
 
Android Basic Development Day 1 Introduction & ADT
byEakapong Kattiya
 
Make Android development easier
byLucas de Almeida Marciano
 
Pertemuan 03 - Activities and intents.pptx
byMUHAMMADRIFKIPERMANA2
 
Android Basic Components
byJussi Pohjolainen
 
Designing native android apps
byRyan Harter
 
Mobile App Navigation Patterns and Examples.pdf
byLaura Miller
 
Android Application managing activites.pptx
byPoornima E.G.
 
Prism Navigation
byEyal Vardi
 
Android Support Library
byAlexey Ustenko
 

Recently uploaded

PDF
Jira, Powered by Enterprise-Grade Intelligence from NeoroTalks.pdf
byNeoro Talks
 
PPTX
Prime Teams – Real-Time Employee Monitoring & Project Management Software
byPrime Teams
 
PDF
The Modern Architect's Codex: Design Patterns in .NET 9
byVineet Sharma
 
PDF
Versnel innovatie met GitHub Enterprise - Rick Smit GitHub
byDelta-N
 
PPTX
Connecting to MCP Servers in OutSystems Platform
byOzanCali
 
PDF
Taxi App UIUX Design for Seamless Ride Booking
byV3CUBE TECHNOLABS
 
PPTX
Pitch Deck for MEVIA OS - No Apps, Infinite, Decentralized Operating System
byDr. Edwin Hernandez
 
PDF
MySQL Routing Guidelines: Designing Smarter Query Routing Together
byMiguel Araújo
 
PDF
Routing Guidelines: Unlocking Smarter Query Routing in MySQL Architectures
byMiguel Araújo
 
PDF
HuemanAI Platform Overview.pptx (1) (2).pdf
byAnkur Handoo
 
PDF
Ecommerce Website Development Services - Web Panel Solutions.pdf
byWEB PANEL SOLUTIONS
 
PDF
Build Modern Applications with Amazon Aurora DSQL- AWS User Group Bonn 2026
byVadym Kazulkin
 
PDF
Clean Architecture with Vertical Slice Architecture in .NET 8
byVineet Sharma
 
PDF
Mastering Zero-Allocation Parsers: A Deep Dive into High-Performance C#
byVineet Sharma
 
PDF
Metrics, Logs, Traces, and Mayhem_ Introducing an observability adventure gam...
byImma Valls Bernaus
 
PDF
Ontwikkel sneller en veiliger met GitHub Copilot
byDelta-N
 
PPTX
How CFD Simulations Support Sustainable Data Center Design Optimization
byWeb Synergies
 
PPTX
40m_wAIred_DigitalPlatformRabobank_10022026.pptx
bySimonedeGijt
 
PDF
Introduction to Modern Artificial Intelligence.pdf
byAI n Dot Net
 
PDF
The Ultimate Guide to Real Estate Tokenization Platforms
byDaniel Smith
 
Jira, Powered by Enterprise-Grade Intelligence from NeoroTalks.pdf
byNeoro Talks
 
Prime Teams – Real-Time Employee Monitoring & Project Management Software
byPrime Teams
 
The Modern Architect's Codex: Design Patterns in .NET 9
byVineet Sharma
 
Versnel innovatie met GitHub Enterprise - Rick Smit GitHub
byDelta-N
 
Connecting to MCP Servers in OutSystems Platform
byOzanCali
 
Taxi App UIUX Design for Seamless Ride Booking
byV3CUBE TECHNOLABS
 
Pitch Deck for MEVIA OS - No Apps, Infinite, Decentralized Operating System
byDr. Edwin Hernandez
 
MySQL Routing Guidelines: Designing Smarter Query Routing Together
byMiguel Araújo
 
Routing Guidelines: Unlocking Smarter Query Routing in MySQL Architectures
byMiguel Araújo
 
HuemanAI Platform Overview.pptx (1) (2).pdf
byAnkur Handoo
 
Ecommerce Website Development Services - Web Panel Solutions.pdf
byWEB PANEL SOLUTIONS
 
Build Modern Applications with Amazon Aurora DSQL- AWS User Group Bonn 2026
byVadym Kazulkin
 
Clean Architecture with Vertical Slice Architecture in .NET 8
byVineet Sharma
 
Mastering Zero-Allocation Parsers: A Deep Dive into High-Performance C#
byVineet Sharma
 
Metrics, Logs, Traces, and Mayhem_ Introducing an observability adventure gam...
byImma Valls Bernaus
 
Ontwikkel sneller en veiliger met GitHub Copilot
byDelta-N
 
How CFD Simulations Support Sustainable Data Center Design Optimization
byWeb Synergies
 
40m_wAIred_DigitalPlatformRabobank_10022026.pptx
bySimonedeGijt
 
Introduction to Modern Artificial Intelligence.pdf
byAI n Dot Net
 
The Ultimate Guide to Real Estate Tokenization Platforms
byDaniel Smith
 

Going Deep w Navigation

  • 1.
  • 2.
  • 3.
  • 4.
    @emmax Pre Navigation val intent= Intent(this, DetailedWeatherForecast::class.java) intent.putExtra("zip_code", city.zipCode) intent.putExtra("use_fahrenheit", true) startActivity(intent) // .. inside DetailedWeatherForecast val zipCode = intent .getStringExtra("zip_code") val useFahrenheit = intent .getBooleanExtra(“use_fahrenheit", true) val fragment = DetailedWeatherForecast() fragment.arguments = Bundle().apply { putString("zip_code", city.zipCode) putBoolean("use_fahrenheit", true) } requireFragmentManager().beginTransaction() .addToBackStack(createTag(city.id)) .replace(R.id.main_content, fragment) .commit() // .. inside DetailedWeatherForecast val zipCode = requireArguments() .getString(“zip_code”) val useFahrenheit = requireArguments() .getBoolean("use_fahrenheit", true) Navigate to Activity Navigate to Fragment
  • 5.
    @emmax Pre Navigation val intent= Intent(this, DetailedWeatherForecast::class.java) intent.putExtra("zip_code", city.zipCode) intent.putExtra("use_fahrenheit", true) startActivity(intent) // .. inside DetailedWeatherForecast val zipCode = intent .getStringExtra("zip_code") val useFahrenheit = intent .getBooleanExtra(“use_fahrenheit", true) val fragment = DetailedWeatherForecast() fragment.arguments = Bundle().apply { putString("zip_code", city.zipCode) putBoolean("use_fahrenheit", true) } requireFragmentManager().beginTransaction() .addToBackStack(createTag(city.id)) .replace(R.id.main_content, fragment) .commit() // .. inside DetailedWeatherForecast val zipCode = requireArguments() .getString(“zip_code”) val useFahrenheit = requireArguments() .getBoolean("use_fahrenheit", true) Navigate to Activity Navigate to Fragment
  • 6.
    @emmax Navigation val intent =Intent(this, DetailedWeatherForecast::class.java) intent.putExtra("zip_code", city.zipCode) intent.putExtra(“use_fahrenheit", true) startActivity(intent) // .. inside DetailedWeatherForecast val zipCode = intent .getStringExtra(“zip_code”) val useFahrenheit = intent .getBooleanExtra(“use_fahrenheit”, true) // .. do stuff. Navigate to Activity val fragment = DetailedWeatherForecast() fragment.arguments = Bundle().apply { putString("zip_code", city.zipCode) putBoolean(“use_fahrenheit”, true) } requireFragmentManager().beginTransaction() .addToBackStack("WeatherDetails_${1}") .replace(R.id.main_content, fragment) .commit() // .. inside DetailedWeatherForecast val zipCode = requireArguments() .getString(“zip_code”) val useCelsius = requireArguments() .getBoolean("use_fahrenheit", true) // .. do stuff Navigate to Fragment findNavController().navigate( toDetailForecast(city.zipCode) .setUseFahrenheit(true))
  • 7.
    @emmax Navigation Navigate to Activity valargs : WeatherDetailFragmentArgs by navArgs() val zipCode = args.zipCode val shouldShowFahrenheit = args.useFahrenheit val intent = Intent(this, DetailedWeatherForecast::class.java) intent.putExtra("zip_code", city.zipCode) intent.putExtra(“use_fahrenheit", true) startActivity(intent) // .. inside DetailedWeatherForecast val zipCode = intent .getStringExtra(“zip_code”) val useFahrenheit = intent .getBooleanExtra(“use_fahrenheit”, true) // .. do stuff. val fragment = DetailedWeatherForecast() fragment.arguments = Bundle().apply { putString("zip_code", city.zipCode) putBoolean(“use_fahrenheit”, true) } requireFragmentManager().beginTransaction() .addToBackStack("WeatherDetails_${1}") .replace(R.id.main_content, fragment) .commit() // .. inside DetailedWeatherForecast val zipCode = requireArguments() .getString(“zip_code”) val useCelsius = requireArguments() .getBoolean("celsius", true) // .. do stuff Navigate to Fragment
  • 8.
  • 9.
    @emmax Minimal Dependencies Navigation dependencies { ... implementation"androidx.navigation:navigation-runtime-ktx:$version" /* Navigation Runtime */
 }
  • 10.
    @emmax Minimal Dependencies Navigation dependencies { ... implementation"androidx.navigation:navigation-runtime-ktx:$version" /* Navigation Runtime */
 implementation "androidx.navigation:navigation-fragment-ktx:$version" /* Fragment Destinations */ }
  • 11.
  • 12.
  • 13.
  • 14.
  • 15.
  • 16.
  • 17.
  • 18.
  • 19.
  • 20.
  • 21.
  • 22.
  • 23.
  • 24.
    Destinations • Arguments • DeepLinks • Actions <deepLink app:uri="www.example.com/match/{player_one_name}/{player_two_name} " />
  • 25.
  • 26.
    • Destination • ArgumentDefault Values • Pop Behavior • Launch Options • Animations Actions
  • 27.
    • Destination • ArgumentDefault Values • Pop Behavior • Launch Options • Animations Actions
  • 28.
    Actions • Destination • ArgumentDefault Values • Pop Behavior • Launch Options • Animations
  • 29.
    Actions • Destination • ArgumentDefault Values • Pop Behavior • Launch Options • Animations
  • 30.
  • 31.
    Actions • Destination • ArgumentDefault Values • Pop Behavior • Launch Options • Animations
  • 32.
    Actions • Destination • ArgumentDefault Values • Pop Behavior • Launch Options • Animations Intent.FLAG_ACTIVITY_CLEAR_TOP Intent.FLAG_ACTIVITY_SINGLE_TOP
  • 33.
    Stack Based Navigation UNDERSTANDINGPOP BEHAVIOR Navigation Graph
  • 34.
    Stack Based Navigation UNDERSTANDINGPOP BEHAVIOR Navigation Graph Stack
  • 35.
    Stack Based Navigation UNDERSTANDINGPOP BEHAVIOR Navigation Graph Stack
  • 36.
    Stack Based Navigation UNDERSTANDINGPOP BEHAVIOR Navigation Graph Stack
  • 37.
    Stack Based Navigation UNDERSTANDINGPOP BEHAVIOR Navigation Graph Stack
  • 38.
    <fragment android:id="@+id/match" ...> <fragmentandroid:id=“@+id/in_game" ...> <action android:id="@+id/action_in_game_to_results_winner" app:destination="@id/results_winner" app:popUpTo="@id/match" /> <action android:id="@+id/action_in_game_to_game_over" app:destination="@id/game_over" app:popUpTo="@id/match" /> </fragment> <fragment android:id="@+id/results_winner" android:name="com.example.android.navigationsample.ResultsWinner"/> <fragment android:id="@+id/game_over" android:name=“com.example.android.navigationsample.GameOver" /> Popping Back to Match UNDERSTANDING POP BEHAVIOR
  • 39.
    <fragment android:id="@+id/match" ...> <fragmentandroid:id=“@+id/in_game" ...> <action android:id="@+id/action_in_game_to_results_winner" app:destination="@id/results_winner" app:popUpTo="@id/match" /> <action android:id="@+id/action_in_game_to_game_over" app:destination="@id/game_over" app:popUpTo=“@id/in_game” app:popUpToInclusive="true" /> </fragment> <fragment android:id="@+id/results_winner" android:name="com.example.android.navigationsample.ResultsWinner"/> <fragment android:id="@+id/game_over" android:name=“com.example.android.navigationsample.GameOver" /> With Inclusive UNDERSTANDING POP BEHAVIOR
  • 40.
  • 41.
    Inside Activity HOSTING NAVIGATION <FrameLayoutxmlns:android="http://schemas.android.com/apk/res/android" xmlns:app="http://schemas.android.com/apk/res-auto" android:layout_width="match_parent" android:layout_height="match_parent"> <fragment android:id=“@+id/nav_host_fragment” android:layout_width="match_parent" android:layout_height="match_parent" android:name="androidx.navigation.fragment.NavHostFragment" app:defaultNavHost="true" app:navGraph=“@navigation/navigation_graph”/> </FrameLayout>
  • 42.
    Include NavHostFragment HOSTING NAVIGATION <FrameLayoutxmlns:android="http://schemas.android.com/apk/res/android" xmlns:app="http://schemas.android.com/apk/res-auto" android:layout_width="match_parent" android:layout_height="match_parent"> <fragment android:id=“@+id/nav_host_fragment” android:layout_width="match_parent" android:layout_height="match_parent" android:name="androidx.navigation.fragment.NavHostFragment" app:defaultNavHost="true" app:navGraph=“@navigation/navigation_graph”/> </FrameLayout>
  • 43.
    HOSTING NAVIGATION Navigation Graph NavHostFragment NavHostFragmentInitialization 1. Create NavController 2. Registers Fragment as a Destination Type 3. Restore Navigation State 4. Set Graph on NavController 5. Navigate to first Destination
  • 44.
    HOSTING NAVIGATION Navigation Graph NavHostFragment NavHostFragmentInitialization 1. Create NavController 2. Registers Fragment as a Destination Type 3. Restore Navigation State 4. Set Graph on NavController 5. Navigate to first Destination
  • 45.
    HOSTING NAVIGATION Navigation Graph NavHostFragment NavHostFragmentInitialization 1. Create NavController 2. Registers Fragment as a Destination Type 3. Restore Navigation State 4. Set Graph on NavController 5. Navigate to first Destination
  • 46.
    HOSTING NAVIGATION Navigation Graph NavHostFragment NavHostFragmentInitialization 1. Create NavController 2. Registers Fragment as a Destination Type 3. Restore Navigation State 4. Set Graph on NavController 5. Navigate to first Destination
  • 47.
    HOSTING NAVIGATION Navigation Graph Destination NavHostFragment NavHostFragmentInitialization 1. Create NavController 2. Registers Fragment as a Destination Type 3. Restore Navigation State 4. Set Graph on NavController 5. Navigate to first Destination <navigation xmlns:android="..." xmlns:app="..." xmlns:tools=..." android:id="@+id/weather_graph" app:startDestination="@id/weather_list"> <fragment android:id="@+id/weather_list" android:name=".WeatherListFragment" android:label="Weather Now" tools:layout="@layout/weather_list_fragment">
  • 48.
    HOSTING NAVIGATION Navigation Graph DestinationDestination NavHostFragment navController.navigate(...) NavHostFragment Initialization 1. Create NavController 2. Registers Fragment as a Destination Type 3. Restore Navigation State 4. Set Graph on NavController 5. Navigate to first Destination NavController
  • 49.
    HOSTING NAVIGATION Navigation Graph DestinationDestination NavHostFragment navController.popBackStack() NavHostFragment Initialization 1. Create NavController 2. Registers Fragment as a Destination Type 3. Restore Navigation State 4. Set Graph on NavController 5. Navigate to first Destination NavController
  • 50.
    Accessing NavController NAVIGATING class MyDestinationFragment: Fragment() override fun onViewCreated(view: View, savedInstanceState: Bundle?) { val controller: NavController = findNavController() } } Fragment class MainActivity : AppCompatActivity() { private lateinit var navController: NavController override fun onCreate(savedInstanceState: Bundle?) { super.onCreate(savedInstanceState) setContentView(R.layout.activity_main) val controller: NavController = findNavController(R.id.nav_host_fragment) } Activity
  • 51.
    Navigate to AnotherDestination NAVIGATING class MyDestinationFragment : Fragment() override fun onViewCreated(view: View, savedInstanceState: Bundle?) { val controller: NavController = findNavController() view.findViewById<Button>(R.id.next)).setOnClickListener { controller.navigate(R.id.action_id) } } }
  • 52.
  • 53.
    @emmax Safe Args Dependencies SafeArgs Project build.gradle: dependencies { ... classpath “android.arch.navigation:navigation-safe-args-gradle-plugin:$version" } Module build.gradle: apply plugin: 'androidx.navigation.safeargs'
  • 54.
    Generated Directions +Arguments PASSING ARGUMENTS SAFELY Destination Requires •Zip Code •Use Fahrenheit Flag https://github.com/ericmaxwell2003/Weather
  • 55.
    Generated Arguments +Directions PASSING ARGUMENTS SAFELY <navigation android:id="@+id/weather_nav" app:startDestination="@id/weather_list"> <fragment android:id="@+id/weather_list" android:name=".WeatherListFragment"> <action android:id="@+id/navigate_to_weather_details" app:destination="@id/weather_detail" > <argument android:defaultValue="true" android:name="use_fahrenheit" /> </action> </fragment> <fragment android:id=“@+id/weather_detail" android:name="com.acme.weather.view.WeatherDetailFragment"> <argument android:name=“zip_code” app:argType=“string" /> <argument android:name="use_fahrenheit" app:argType="boolean" /> </fragment> </navigation>
  • 56.
    Generated Arguments PASSING ARGUMENTSSAFELY public class WeatherDetailFragmentArgs implements NavArgs { // Create Args from Bundle or output to Bundle public static WeatherDetailFragmentArgs fromBundle(@NonNull Bundle bundle) {} public Bundle toBundle() {} // Type Safe Property Access public String getZipCode() public boolean getUseFahrenheit() // Builder for type safe argument creation public static class Builder {} } <fragment android:id=“@+id/weather_detail" android:name="com.acme.weather.view.WeatherDetailFragment"> <argument android:name=“zip_code” app:argType=“string" /> <argument android:name="use_fahrenheit" app:argType="boolean" /> </fragment> Navigation Graph
  • 57.
    Generated Arguments PASSING ARGUMENTSSAFELY <fragment android:id=“@+id/weather_detail" android:name="com.acme.weather.view.WeatherDetailFragment"> <argument android:name=“zip_code” app:argType=“string" /> <argument android:name="use_fahrenheit" app:argType="boolean" /> </fragment> Navigation Graph Construct from android.os.Bundle public class WeatherDetailFragmentArgs implements NavArgs { // Create Args from Bundle or output to Bundle public static WeatherDetailFragmentArgs fromBundle(@NonNull Bundle bundle) {} public Bundle toBundle() {} // Type Safe Property Access public String getZipCode() public boolean getUseFahrenheit() // Builder for type safe argument creation public static class Builder {} }
  • 58.
    Generated Arguments PASSING ARGUMENTSSAFELY <fragment android:id=“@+id/weather_detail" android:name="com.acme.weather.view.WeatherDetailFragment"> <argument android:name=“zip_code” app:argType=“string" /> <argument android:name="use_fahrenheit" app:argType="boolean" /> </fragment> Navigation Graph Access args as properties by type public class WeatherDetailFragmentArgs implements NavArgs { // Create Args from Bundle or output to Bundle public static WeatherDetailFragmentArgs fromBundle(@NonNull Bundle bundle) {} public Bundle toBundle() {} // Type Safe Property Access public String getZipCode() public boolean getUseFahrenheit() // Builder for type safe argument creation public static class Builder {} }
  • 59.
    Accessing Args inDestination PASSING ARGUMENTS SAFELY public class WeatherDetailFragmentArgs implements NavArgs { // Create Args from Bundle or output to Bundle public static WeatherDetailFragmentArgs fromBundle(@NonNull Bundle bundle) {} public Bundle toBundle() {} // Type Safe Property Access public String getZipCode() public boolean getUseFahrenheit() // Builder for type safe argument creation public static class Builder {} } <fragment android:id=“@+id/weather_detail" android:name="com.acme.weather.view.WeatherDetailFragment"> <argument android:name=“zip_code” app:argType=“string" /> <argument android:name="use_fahrenheit" app:argType="boolean" /> </fragment> val args = WeatherDetailFragmentArgs.fromBundle(arguments) — or — val args: WeatherDetailFragmentArgs by navArgs() Args Navigation Graph
  • 60.
    Generated Arguments +Directions PASSING ARGUMENTS SAFELY <navigation android:id="@+id/weather_nav" app:startDestination="@id/weather_list"> <fragment android:id="@+id/weather_list" android:name=".WeatherListFragment"> <action android:id="@+id/navigate_to_weather_details" app:destination="@id/weather_detail" > <argument android:defaultValue="true" android:name="use_fahrenheit" /> </action> </fragment> <fragment android:id=“@+id/weather_detail" android:name="com.acme.weather.view.WeatherDetailFragment"> <argument android:name=“zip_code” app:argType=“string" /> <argument android:name="use_fahrenheit" app:argType="boolean" /> </fragment> </navigation>
  • 61.
    <navigation android:id="@+id/weather_nav" app:startDestination="@id/weather_list"> <fragment android:id="@+id/weather_list" android:name=".WeatherListFragment"> <action android:id="@+id/navigate_to_weather_details" app:destination="@id/weather_detail"> <argument android:defaultValue="true" android:name="use_fahrenheit" /> </action> </fragment> <fragment android:id=“@+id/weather_detail" android:name="com.acme.weather.view.WeatherDetailFragment"> <argument android:name=“zip_code” app:argType=“string" /> <argument android:name="use_fahrenheit" app:argType="boolean" /> </fragment> </navigation> Generated Arguments + Directions PASSING ARGUMENTS SAFELY
  • 62.
    public class WeatherListFragmentDirections{ // Static factory for each Action tied to this destination public static NavigateToWeatherDetails navigateToWeatherDetails(@NonNull String zipCode) {} public static class NavigateToWeatherDetails implements NavDirections { // Setters to override default argument values public NavigateToWeatherDetails setUseFahrenheit(boolean useFahrenheit) {} // Accessors for Bundle arguments, Action (…and NavOptions) public Bundle getArguments() {} public int getActionId() {} } Generated Directions PASSING ARGUMENTS SAFELY <action android:id="@+id/navigate_to_weather_details" app:destination="@id/weather_detail" > <argument android:defaultValue="true" android:name="use_fahrenheit" /> </action> Navigation Graph
  • 63.
    public class WeatherListFragmentDirections{ // Static factory for each Action tied to this destination public static NavigateToWeatherDetails navigateToWeatherDetails(@NonNull String zipCode) {} public static class NavigateToWeatherDetails implements NavDirections { // Setters to override default argument values public NavigateToWeatherDetails setUseFahrenheit(boolean useFahrenheit) {} // Accessors for Bundle arguments, Action (…and NavOptions) public Bundle getArguments() {} public int getActionId() {} } Generated Directions PASSING ARGUMENTS SAFELY <action android:id="@+id/navigate_to_weather_details" app:destination="@id/weather_detail" > <argument android:defaultValue="true" android:name="use_fahrenheit" /> </action> navigate_to_weather_details Navigation Graph
  • 64.
    public class WeatherListFragmentDirections{ // Static factory for each Action tied to this destination public static NavigateToWeatherDetails navigateToWeatherDetails(@NonNull String zipCode) {} public static class NavigateToWeatherDetails implements NavDirections { // Setters to override default argument values public NavigateToWeatherDetails setUseFahrenheit(boolean useFahrenheit) {} // Accessors for Bundle arguments, Action (…and NavOptions) public Bundle getArguments() {} public int getActionId() {} } Generated Directions PASSING ARGUMENTS SAFELY <action android:id="@+id/navigate_to_weather_details" app:destination="@id/weather_detail" > <argument android:defaultValue="true" android:name="use_fahrenheit" /> </action> zipCode String required Navigation Graph
  • 65.
    public class WeatherListFragmentDirections{ // Static factory for each Action tied to this destination public static NavigateToWeatherDetails navigateToWeatherDetails(@NonNull String zipCode) {} public static class NavigateToWeatherDetails implements NavDirections { // Setters to override default argument values public NavigateToWeatherDetails setUseFahrenheit(boolean useFahrenheit) {} // Accessors for Bundle arguments, Action (…and NavOptions) public Bundle getArguments() {} public int getActionId() {} } Generated Directions PASSING ARGUMENTS SAFELY <action android:id="@+id/navigate_to_weather_details" app:destination="@id/weather_detail" > <argument android:defaultValue="true" android:name="use_fahrenheit" /> </action> useFahrenheit can be overridden Navigation Graph
  • 66.
    public class WeatherListFragmentDirections{ // Static factory for each Action tied to this destination public static NavigateToWeatherDetails navigateToWeatherDetails(@NonNull String zipCode) {} public static class NavigateToWeatherDetails implements NavDirections { // Setters to override default argument values public NavigateToWeatherDetails setUseFahrenheit(boolean useFahrenheit) {} // Accessors for Bundle arguments, Action (…and NavOptions) public Bundle getArguments() {} public int getActionId() {} } Generated Directions PASSING ARGUMENTS SAFELY <action android:id="@+id/navigate_to_weather_details" app:destination="@id/weather_detail" > <argument android:defaultValue="true" android:name="use_fahrenheit" /> </action> All navigate(...) details Navigation Graph
  • 67.
    Navigating with Directions PASSINGARGUMENTS SAFELY <action android:id="@+id/navigate_to_weather_details" app:destination="@id/weather_detail" > <argument android:defaultValue="true" android:name="use_fahrenheit" /> </action> val directions = WeatherListFragmentDirections
 .navigateToWeatherDetails(zipCode) .setUseFahrenheit(true) findNavController().navigate(directions) public class WeatherListFragmentDirections { // Static factory for each Action tied to this destination public static NavigateToWeatherDetails navigateToWeatherDetails(...) {} public static class NavigateToWeatherDetails implements NavDirections { // Setters to override default argument values public NavigateToWeatherDetails setUseFahrenheit(boolean useFahrenheit) {} // Accessors for Bundle arguments, Action (…and NavOptions) public Bundle getArguments() {} public int getActionId() {} } Navigation Graph
  • 68.
    Navigating with Directions PASSINGARGUMENTS SAFELY <action android:id="@+id/navigate_to_weather_details" app:destination="@id/weather_detail" > <argument android:defaultValue="true" android:name="use_fahrenheit" /> </action> public class WeatherListFragmentDirections { // Static factory for each Action tied to this destination public static NavigateToWeatherDetails navigateToWeatherDetails(...) {} public static class NavigateToWeatherDetails implements NavDirections { // Setters to override default argument values public NavigateToWeatherDetails setUseFahrenheit(boolean useFahrenheit) {} // Accessors for Bundle arguments, Action (…and NavOptions) public Bundle getArguments() {} public int getActionId() {} } Navigation Graph findNavController().navigate( toWeatherDetails(zipCode) .setUseFahrenheit(true))
  • 69.
    Navigating with Directions PASSINGARGUMENTS SAFELY <action android:id="@+id/navigate_to_weather_details" app:destination="@id/weather_detail" > <argument android:defaultValue="true" android:name="use_fahrenheit" /> </action> val directions = WeatherListFragmentDirections
 .navigateToWeatherDetails(zipCode) .setUseFahrenheit(true) findNavController().navigate(directions) public class WeatherListFragmentDirections { // Static factory for each Action tied to this destination public static NavigateToWeatherDetails navigateToWeatherDetails(...) {} public static class NavigateToWeatherDetails implements NavDirections { // Setters to override default argument values public NavigateToWeatherDetails setUseFahrenheit(boolean useFahrenheit) {} // Accessors for Bundle arguments, Action (…and NavOptions) public Bundle getArguments() {} public int getActionId() {} } Navigation Graph
  • 70.
    Navigating with Directions PASSINGARGUMENTS SAFELY <action android:id="@+id/navigate_to_weather_details" app:destination="@id/weather_detail" > <argument android:defaultValue="true" android:name="use_fahrenheit" /> </action> val directions = WeatherListFragmentDirections
 .navigateToWeatherDetails(zipCode) .setUseFahrenheit(true) findNavController().navigate(directions) public class WeatherListFragmentDirections { // Static factory for each Action tied to this destination public static NavigateToWeatherDetails navigateToWeatherDetails(...) {} public static class NavigateToWeatherDetails implements NavDirections { // Setters to override default argument values public NavigateToWeatherDetails setUseFahrenheit(boolean useFahrenheit) {} // Accessors for Bundle arguments, Action (…and NavOptions) public Bundle getArguments() {} public int getActionId() {} } Navigation Graph Static import of NavDirections class
  • 71.
    Navigating with Directions PASSINGARGUMENTS SAFELY <action android:id="@+id/navigate_to_weather_details" app:destination="@id/weather_detail" > <argument android:defaultValue="true" android:name="use_fahrenheit" /> </action> val directions = WeatherListFragmentDirections
 .navigatetoWeatherDetails(zipCode) .setUseFahrenheit(true) findNavController().navigate(directions) public class WeatherListFragmentDirections { // Static factory for each Action tied to this destination public static NavigateToWeatherDetails navigateToWeatherDetails(...) {} public static class NavigateToWeatherDetails implements NavDirections { // Setters to override default argument values public NavigateToWeatherDetails setUseFahrenheit(boolean useFahrenheit) {} // Accessors for Bundle arguments, Action (…and NavOptions) public Bundle getArguments() {} public int getActionId() {} } Navigation Graph Static import of NavDirections class Change name of action to "to_weather_details"
  • 72.
    Navigating with Directions PASSINGARGUMENTS SAFELY <action android:id="@+id/to_weather_details" app:destination="@id/weather_detail" > <argument android:defaultValue="true" android:name="use_fahrenheit" /> </action> findNavController().navigate( toWeatherDetails(zipCode) .setUseFahrenheit(true)) public class WeatherListFragmentDirections { // Static factory for each Action tied to this destination public static NavigateToWeatherDetails navigateToWeatherDetails(...) {} public static class NavigateToWeatherDetails implements NavDirections { // Setters to override default argument values public NavigateToWeatherDetails setUseFahrenheit(boolean useFahrenheit) {} // Accessors for Bundle arguments, Action (…and NavOptions) public Bundle getArguments() {} public int getActionId() {} } Navigation Graph
  • 73.
  • 74.
  • 75.
  • 76.
  • 77.
  • 78.
    First Time UserExperience CONDITIONAL NAVIGATION
  • 79.
    First Time UserExperiences CONDITIONAL NAVIGATION Login GraphMain Navigation Graph
  • 80.
    First Time UserExperiences CONDITIONAL NAVIGATION <navigation ... android:id="@+id/weather_graph" app:startDestination="@id/weather_list"> <fragment android:id=“@+id/weather_list">...</fragment> <fragment android:id="@+id/weather_detail">...</fragment> <navigation android:id="@+id/login_graph" android:label="Login" app:startDestination="@id/login"> <fragment android:id="@+id/login" android:name="com.acme.weather.security.view.Login" android:label="Log In" /> </navigation> </navigation> Nested Graph
  • 81.
    First Time UserExperiences CONDITIONAL NAVIGATION <navigation ... android:id="@+id/weather_graph" app:startDestination="@id/weather_list"> <fragment android:id=“@+id/weather_list">...</fragment> <fragment android:id="@+id/weather_detail">...</fragment> <include app:graph="@navigation/login_graph" /> </navigation> Include as Separate Graph
  • 82.
    Login GraphMain NavigationGraph First Time User Experiences CONDITIONAL NAVIGATION Global Action
  • 83.
    Global Action CONDITIONAL NAVIGATION <navigation... android:id="@+id/weather_graph" app:startDestination="@id/weather_list"> <fragment android:id=“@+id/weather_list">...</fragment> <fragment android:id="@+id/weather_detail">...</fragment> <include app:graph="@navigation/login_graph" /> <action android:id="@+id/action_global_login" app:destination="@id/login_graph" /> </navigation> Global Action is Global because
 it is not tied to a destination
 
 It is a peer to destinations in this
 navigation graph and accessible by
 any destination inside this graph
  • 84.
    CONDITIONAL NAVIGATION 1. Ifuser is unauthenticated, redirect to login 2. Return to secured area
 once authenticated First Time User Experiences
  • 85.
    Global Navigation CONDITIONAL NAVIGATION classWeatherDetailFragment : SecureFragment() { override fun onViewCreated(view: View, savedInstanceState: Bundle?) { super.onViewCreated(view, savedInstanceState) } }
  • 86.
    Global Navigation CONDITIONAL NAVIGATION abstractclass SecureFragment : Fragment() { val authenticationViewModel by activityViewModels<AuthenticationViewModel>() override fun onViewCreated(view: View, savedInstanceState: Bundle?) { ... } private fun popBackStackOrExit() { ... } }
  • 87.
    Global Navigation CONDITIONAL NAVIGATION abstractclass SecureFragment : Fragment() { val authenticationViewModel by activityViewModels<AuthenticationViewModel>() override fun onViewCreated(view: View, savedInstanceState: Bundle?) { super.onViewCreated(view, savedInstanceState) authenticationViewModel.authenticationStatus.observe(viewLifecycleOwner, Observer { authStatus -> when(authStatus) { UNAUTHENTICATED -> navController.navigate(actionGlobalLogin()) USER_DECLINED -> popBackStackOrExit() else -> Unit } }) } private fun popBackStackOrExit() { ... } }
  • 88.
    Global Navigation CONDITIONAL NAVIGATION abstractclass SecureFragment : Fragment() { val authenticationViewModel by activityViewModels<AuthenticationViewModel>() override fun onViewCreated(view: View, savedInstanceState: Bundle?) { super.onViewCreated(view, savedInstanceState) authenticationViewModel.authenticationStatus.observe(viewLifecycleOwner, Observer { authStatus -> when(authStatus) { UNAUTHENTICATED -> navController.navigate(actionGlobalLogin()) USER_DECLINED -> popBackStackOrExit() else -> Unit } }) } private fun popBackStackOrExit() { ... } }
  • 89.
    Global Navigation CONDITIONAL NAVIGATION abstractclass SecureFragment : Fragment() { val authenticationViewModel by activityViewModels<AuthenticationViewModel>() override fun onViewCreated(view: View, savedInstanceState: Bundle?) { super.onViewCreated(view, savedInstanceState) authenticationViewModel.authenticationStatus.observe(viewLifecycleOwner, Observer { authStatus -> when(authStatus) { UNAUTHENTICATED -> navController.navigate(actionGlobalLogin()) USER_DECLINED -> popBackStackOrExit() else -> Unit } }) } private fun popBackStackOrExit() { if(!navController.popBackStack()) { requireActivity().finish() } } }
  • 90.
  • 91.
  • 92.
  • 93.
    Implicit DEEP LINK <fragment android:id="@+id/weather_detail" android:name="com.acme.weather.app.view.WeatherDetailFragment" android:label="Today's Forecast" tools:layout="@layout/weather_detail_fragment"> <argument android:name="zip_code" app:argType="string"/> <argument android:name="use_fahrenheit" app:argType="boolean" android:defaultValue="true" /> <deepLink android:id="@+id/deepLink" app:uri="weather.acme.com/{zip_code}" /> </fragment>
  • 94.
    Implicit DEEP LINK <manifest xmlns:android="http://schemas.android.com/apk/res/android" xmlns:tools="http://schemas.android.com/tools" package="com.acme.weather"> <application ... <activityandroid:name=".app.view.MainActivity"> <nav-graph android:value="@navigation/weather_graph" /> <intent-filter> <action android:name="android.intent.action.MAIN" /> <category android:name="android.intent.category.LAUNCHER" /> </intent-filter> </activity> </application> </manifest>
  • 95.
    Implicit DEEP LINK <manifest xmlns:android="http://schemas.android.com/apk/res/android" xmlns:tools="http://schemas.android.com/tools" package="com.acme.weather"> <application ... <activityandroid:name=".app.view.MainActivity"> <intent-filter> <action android:name="android.intent.action.VIEW" /> <category android:name="android.intent.category.DEFAULT" /> <category android:name="android.intent.category.BROWSABLE" /> <data android:scheme="http" /> <data android:scheme="https" /> <data android:host="weather.acme.com" /> <data android:pathPrefix="/" /> </intent-filter> ... </activity> </application> </manifest>
  • 96.
    On SetGraph LAUNCH VIAIMPLICIT DEEP LINK 1. Search Graph for best matching deep link • URI exact matches preferred • By matching arguments NavHostFragment Initialization 1. Create NavController 2. Registers ??? as a Destination Type 3. Restore Navigation State 4. Set Graph on NavController 5. Navigate to first Destination
  • 97.
    On SetGraph LAUNCH VIAIMPLICIT DEEP LINK 1. Search Graph for best matching deep link • URI exact matches preferred • By matching arguments 2. Build array of destination IDs leading to this Destination • R.id.weather_list • R.id.weather_detail NavHostFragment Initialization 1. Create NavController 2. Registers ??? as a Destination Type 3. Restore Navigation State 4. Set Graph on NavController 5. Navigate to first Destination
  • 98.
    On SetGraph LAUNCH VIAIMPLICIT DEEP LINK 1. Search Graph for best matching deep link • URI exact matches preferred • By matching arguments 2. Build array of destination IDs leading to this Destination • R.id.weather_list • R.id.weather_detail 3. Push each destination on the stack • (If new task) NavHostFragment Initialization 1. Create NavController 2. Registers ??? as a Destination Type 3. Restore Navigation State 4. Set Graph on NavController 5. Navigate to first Destination
  • 99.
    On SetGraph LAUNCH VIAIMPLICIT DEEP LINK 1. Search Graph for best matching deep link • URI exact matches preferred • By matching arguments 2. Build array of destination IDs leading to this Destination • R.id.weather_list • R.id.weather_detail 3. Push last destination on the stack • (If part of an existing task) NavHostFragment Initialization 1. Create NavController 2. Registers ??? as a Destination Type 3. Restore Navigation State 4. Set Graph on NavController 5. Navigate to first Destination
  • 100.
    Explicit DEEP LINK Launch viaPendingIntent https://github.com/ericmaxwell2003/Weather
  • 101.
    Create Pending Intent LAUNCHVIA EXPLICIT DEEP LINK fun scheduleNotificationForZip() { /* Create a deep link and pending intent */ val pendingIntent = navController.createDeepLink() .setDestination(R.id.weather_detail) .setArguments(arguments) .createPendingIntent() /* Build the Notification */ createNotificationChannel() val builder = NotificationCompat.Builder(requireContext(), CHANNEL_ID) .setSmallIcon(R.drawable.notification_icon) .setContentTitle("Weather Report") .setContentText("Weather now in ${args.zipCode}") .setPriority(NotificationCompat.PRIORITY_DEFAULT) .setContentIntent(pendingIntent) .setAutoCancel(true) notificationManager.notify(1, builder.build()) }
  • 102.
    Explicit Deep LinkIntent LAUNCH VIA EXPLICIT DEEP LINK 1. android-support-nav:controller:deepLinkIds • R.id.weather_list • R.id.weather_detail 2. android-support-nav:controller:deepLinkExtras • zip_code • use_fahrenheit 3. android-support-nav:controller:deepLinkIntent • Intent that triggered the deep link
  • 103.
  • 104.
    Mock NavController TESTING NAVIGATION @Test funtestNavigationToInGameScreen() { val mockNavController = mock(NavController::class.java) val bundle = WeatherDetailFragmentArgs.Builder("43231") .build() .toBundle() val fragmentScenario = launchFragmentInContainer<WeatherDetailFragment>(bundle) fragmentScenario.onFragment { fragment -> // Access to set after onResume() Navigation.setViewNavController( fragment.requireView(), mockNavController) } // Drive view with Espresso and verify navigation interactions onView(...) verify(mockNavController).navigate(...) }
  • 105.
    @emmax @Test fun testNavigationToInGameScreen() { valmockNavController = mock(NavController::class.java) val bundle = WeatherDetailFragmentArgs.Builder("43231") .build() .toBundle() val fragmentScenario = launchFragmentInContainer<WeatherDetailFragment>(bundle) fragmentScenario.onFragment { fragment -> // Access to set after onResume() Navigation.setViewNavController( fragment.requireView(), mockNavController) } // Drive view with Espresso and verify navigation interactions onView(...) verify(mockNavController).navigate(...) } FragmentScenario Requires : 'androidx.fragment:fragment-testing:1.1.0-alpha06' FragmentScenario TESTING NAVIGATION
  • 106.
    FragmentScenario TESTING NAVIGATION @Test fun testNavigationToInGameScreen(){ val mockNavController = mock(NavController::class.java) val bundle = WeatherDetailFragmentArgs.Builder("43231") .build() .toBundle() val fragmentScenario = launchFragmentInContainer<WeatherDetailFragment>(bundle) fragmentScenario.onFragment { fragment -> // Access to set after onResume() Navigation.setViewNavController( fragment.requireView(), mockNavController) } // Drive view with Espresso and verify navigation interactions onView(...) verify(mockNavController).navigate(...) }
  • 107.
    FragmentScenario TESTING NAVIGATION @Test fun testNavigationToInGameScreen(){ val mockNavController = mock(NavController::class.java) val bundle = WeatherDetailFragmentArgs.Builder("43231") .build() .toBundle() val fragmentScenario = launchFragmentInContainer<WeatherDetailFragment>(bundle) fragmentScenario.onFragment { fragment -> // Access to set after onResume() Navigation.setViewNavController( fragment.requireView(), mockNavController) } // Drive view with Espresso and verify navigation interactions onView(...) verify(mockNavController).navigate(...) }
  • 108.
    FragmentScenario TESTING NAVIGATION @Test fun testNavigationToInGameScreen(){ val mockNavController = mock(NavController::class.java) val bundle = WeatherDetailFragmentArgs.Builder("43231") .build() .toBundle() val fragmentScenario = launchFragmentInContainer<WeatherDetailFragment>(bundle) fragmentScenario.onFragment { fragment -> // Access to set after onResume() Navigation.setViewNavController( fragment.requireView(), mockNavController) } // Drive view with Espresso and verify navigation interactions onView(...) verify(mockNavController).navigate(...) } Called after Fragment.onResume()
  • 109.
    @Test fun testNavigationToInGameScreen() { valmockNavController = mock(NavController::class.java) val bundle = WeatherDetailFragmentArgs.Builder("43231") .build() .toBundle() val fragmentScenario = launchFragmentInContainer(bundle) { WeatherDetailFragment().also { fragment -> fragment.viewLifecycleOwnerLiveData.observeForever { viewLifecycleOwner -> // Observe after onCreateView before onViewCreated if (viewLifecycleOwner != null) { Navigation.setViewNavController(
 fragment.requireView(), mockNavController) } } } ... } FragmentScenario TESTING NAVIGATION
  • 110.
    FragmentScenario TESTING NAVIGATION @Test fun testNavigationToInGameScreen(){ val mockNavController = mock(NavController::class.java) val bundle = WeatherDetailFragmentArgs.Builder("43231") .build() .toBundle() val fragmentScenario = launchFragmentInContainer(bundle) { WeatherDetailFragment().also { fragment -> fragment.viewLifecycleOwnerLiveData.observeForever { viewLifecycleOwner -> // Observe after onCreateView before onViewCreated if (viewLifecycleOwner != null) { Navigation.setViewNavController(
 fragment.requireView(), mockNavController) } } } ... } Construct the Fragment
  • 111.
    FragmentScenario TESTING NAVIGATION @Test fun testNavigationToInGameScreen(){ val mockNavController = mock(NavController::class.java) val bundle = WeatherDetailFragmentArgs.Builder("43231") .build() .toBundle() val fragmentScenario = launchFragmentInContainer(bundle) { WeatherDetailFragment().also { fragment -> fragment.viewLifecycleOwnerLiveData.observeForever { viewLifecycleOwner -> // Observe after onCreateView before onViewCreated if (viewLifecycleOwner != null) { Navigation.setViewNavController(
 fragment.requireView(), mockNavController) } } } ... } Observe its view lifecycle
 (Starting after onCreateView(...))
  • 112.
  • 113.
  • 114.
  • 115.
  • 116.
    NAVIGATION ARCHITECTURE NavControllerDestination 1 Navigation
 Provider NavigatorDestination 2 navigate(R.id.destination_2) What is your navigator name? Navigator Name Find Dest 2
  • 117.
    NAVIGATION ARCHITECTURE NavControllerDestination 1 Navigation
 Provider NavigatorDestination 2 navigate(R.id.destination_2) What is your navigator name? Navigator Name Lookup Navigator(name) Navigator Find Dest 2
  • 118.
    NAVIGATION ARCHITECTURE NavControllerDestination 1 Navigation
 Provider NavigatorDestination 2 navigate(R.id.destination_2) What is your navigator name? Navigator Name Lookup Navigator(name) Navigator Navigate
 (destination info) Find Dest 2
  • 119.
    NAVIGATION ARCHITECTURE NavControllerDestination 1 Navigation
 Provider NavigatorDestination 2 navigate(R.id.destination_2) What is your navigator name? Navigator Name Lookup Navigator(name) Navigator Navigate
 (destination info) Actual Navigation Echo Dest Back
 (or null) Find Dest 2
  • 120.
    NAVIGATION ARCHITECTURE NavControllerDestination 1 Navigation
 Provider NavigatorDestination 2 navigate(R.id.destination_2) What is your navigator name? Navigator Name Lookup Navigator(name) Navigator Navigate
 (destination info) Actual Navigation Echo Dest Back
 (or null) Find Dest 2 Add Dest 2
 NavBackStack Dispatch OnDestinationChanged
  • 121.
    NAVIGATION ARCHITECTURE NavControllerDestination 1 Navigation
 Provider Custom
 Navigator CustomNavigator. Destination navigate(R.id.destination_2) Whatis your navigator name? Navigator Name Lookup Navigator(name) Navigator Navigate
 (destination info) Actual Navigation Echo Dest Back
 (or null) Find Dest 2 Add Dest 2
 NavBackStack Dispatch OnDestinationChanged
  • 122.
    HOSTING NAVIGATION Navigation Graph NavHostCustom NavHostFragmentInitialization 1. Create NavController 2. Registers ??? as a Destination Type 3. Restore Navigation State 4. Set Graph on NavController 5. Navigate to first Destination class NavHostCustom : NavHost { init { ... navigationController.navigationProvider += createControllerNavigator() ... } override fun getNavController(): NavController = navigationController }
  • 123.
    HOSTING NAVIGATION Navigation Graph NavHostCustom NavHostFragmentInitialization 1. Create NavController 2. Registers ??? as a Destination Type 3. Restore Navigation State 4. Set Graph on NavController 5. Navigate to first Destination class NavHostCustom : NavHostFragment() { override fun createFragmentNavigator(): Navigator<out FragmentNavigator.Destination> { navController.navigatorProvider += DialogNavigator(requireContext(), childFragmentManager) return super.createFragmentNavigator() } }
  • 124.
    • Conductor POC- View Based Destinations • Navigating Conductor and the Navigation Architecture Component -- Tevin Jeffrey -- (https://bit.ly/2MD9LSn) • DialogFragmentDestination • https://gist.github.com/fbarthelery/ad0062a88875b46e0065137ff03807a0 COMMON QUESTIONS Custom Nav Samples
  • 125.
    NAVIGATION ARCHITECTURE Responsibilities ReferenceImplementation(s) Notes NavHost • Container for navigation • Provide NavController • Manage Navigation State • Register • NavHostFragment • Usually registers additional Navigator types (e.g. FragmentNavigator) NavController • Navigate to action or destination • Pop back to previous destination • Generate bundle for saveState • Restore itself from a previously saved bundle -- • Calls to navigate() and popBack(), delegated to the navigator of the next or current destination type. Navigator
 <NavDestination> • Delegate class used by the NavController to do the work of pushing/popping. • Has intimate knowledge of the given destination type • NavGraphNavigator • ActivityNavigator • FragmentNavigator • NoOpNavigator • Navigators can be registered
 
 navController .navigatorProvider += someNavigator NavDestination • Represents a node within the nav graph • Usually a nested class of a corresponding Navigator of this type. • Encapsulate the configured actions, arg declarations, default values, etc. • NavGraph • ActivityNavigator.Destination • FragmentNavigator.Destination • These define the elements you see in the nav graph too:
 <navigation>
 <activity>
 <fragment>
  • 126.
  • 127.
    @emmax Nav Graph Scopedto Activity WHY SINGLE ACTIVITY
  • 128.
    @emmax (N) Activities ==(N) NavGraphs WHY SINGLE ACTIVITY
  • 129.
    @emmax Convenient ViewModel Scoping WHYSINGLE ACTIVITY Fragment A Fragment B Fragment C Graph A Graph B Shared
 ViewModel Activity
  • 130.
    @emmax Convenient ViewModel Scoping WHYSINGLE ACTIVITY Graph A Graph B Shared
 ViewModel Activity Shared
 ViewModel Fragment A Fragment B Fragment C 2.1.0-alpha02
  • 131.
  • 132.
    @emmax Multi Module App FeatureB FeatureA FeatureC App LibraryLibrary MULTI MODULE Direction of Dependencies
  • 133.
    @emmax FeatureB FeatureA FeatureC App Library Library Feature A App FeatureCFeature B MULTI MODULE Activity Destination Activity Per Feature • No Dependencies
 Features host their own UI • Testing
 Standard Activity Test Rule / Espresso Test
  • 134.
    @emmax How to NavigateAcross Modules? FeatureB FeatureA FeatureC App Library Library Feature A App Feature CFeature B MULTI MODULE ? ? Activity Destination • No Dependencies
 Features host their own UI • Testing
 Standard Activity Test Rule / Espresso Test
  • 135.
    @emmax Intent How to NavigateAcross Modules? FeatureB FeatureA FeatureC App Library Library Feature A App Feature CFeature B MULTI MODULE Activity Destination • NavController within Feature • Implicit Intent Across Features Intent
  • 136.
    @emmax Add Intent Filters MULTIPLEACTIVITIES FOR MULTI MODULE Jeroen Mols Android GDE & Lead Android developer at Philips Hue
 https://jeroenmols.com/blog/2019/04/02/modularizationexample/ FeatureB FeatureA FeatureC App Library Library <activity android:name="..FeatureA" > <intent-filter> <action android:name="com.acme.featureA" /> <category android:name="..DEFAULT" /> </intent-filter> </activity> Each Feature Defines Intent Filter
  • 137.
    @emmax Add Intent Filters MULTIPLEACTIVITIES FOR MULTI MODULE Jeroen Mols Android GDE & Lead Android developer at Philips Hue
 https://jeroenmols.com/blog/2019/04/02/modularizationexample/ FeatureB FeatureA FeatureC App Library Library <activity android:name="..FeatureA" > <intent-filter> <action android:name="com.acme.featureA" /> <category android:name="..DEFAULT" /> </intent-filter> </activity> <activity android:name="..FeatureB" > <intent-filter> <action android:name="com.acme.featureB" /> <category android:name="..DEFAULT" /> </intent-filter> </activity> Merged Manifest Has All
  • 138.
    @emmax Feature A App Feature CFeatureB MULTIPLE ACTIVITIES FOR MULTI MODULE Jeroen Mols Android GDE & Lead Android developer at Philips Hue
 https://jeroenmols.com/blog/2019/04/02/modularizationexample/ Intent Intent FeatureB FeatureA FeatureC App Library Library Intent Intent("com.acme.featureX")
 .setPackage(context.packageName) Navigate between Features using Intent
  • 139.
    @emmax Define a CommonModule to Encapsulate Feature A App Feature CFeature B MULTIPLE ACTIVITIES FOR MULTI MODULE Jeroen Mols Android GDE & Lead Android developer at Philips Hue
 https://jeroenmols.com/blog/2019/04/02/modularizationexample/ Actions Actions FeatureB FeatureA FeatureC App Actions Actions Actions.navToFeatureA(context)

  • 140.
    Official • Navigation Documentation(https://developer.android.com/guide/navigation) 💪 • Source (AOSP) (https://android.googlesource.com/platform/frameworks/support/) • Issue Tracker (https://issuetracker.google.com/issues?q=componentid:409828%20type:process%20status:open&p=1 • Code Lab https://codelabs.developers.google.com/codelabs/android-navigation/#0 Other Talks • Adventures in Navigation -- DroidCon SF '18 -- Lyla Fujiwara -- (https://www.youtube.com/watch?v=ELGShpd17wc) • Single Activity: Why, When, How -- DevSummit '18 -- Ian Lake -- (https://www.youtube.com/watch?v=2k8x8V77CrU) Posts • Using Navigation in a large banking app -- David Vávra -- (https://bit.ly/2JbT2Yy) • Master-Detail views with Navigation Components --Lara Martín -- (https://bit.ly/2JqEKU7) • Navigating Conductor and the Navigation Architecture Component -- Tevin Jeffrey -- (https://bit.ly/2MD9LSn) • Modularization : Real Life Example -- Jeroen Mols -- (https://buff.ly/2I8mtZj) Sample Projects • Getting Started Sample - https://github.com/googlesamples/android-architecture-components/tree/master/NavigationBasicSample • Advanced Navigation - https://github.com/googlesamples/android-architecture-components/tree/master/NavigationAdvancedSample • DialogNavigator Gist - https://gist.github.com/fbarthelery/ad0062a88875b46e0065137ff03807a0 ADDITIONAL RESOURCES
  • 141.
  • 142.