![\"DeepLinkFlow\"](\"https:\/\/devblogs.microsoft.com\/wp-content\/uploads\/sites\/44\/2019\/03\/DeepLinkFlow.png\")
<\/p>\n\t\t\t\tLeveraging mobile search ensures your mobile app stands out on your users’ devices. In addition to the powerful search built into each device, deep linking to your app from web content creates a fully connected experience to keep your users in your app and coming back for more. URL Navigation simplifies this entire process with just a few simple methods.<\/p>\n
<\/p>\n
The Xamarin Evolve conference application (source code available on GitHub<\/a>) utilized the new URL Navigation to deep link all of the sessions of the conference. If you search for a session in Google Search, Spotlight Search, or on the web, the app automatically launches the session details page!<\/p>\n In this post, we’ll take a look at exactly how this was implemented for both iOS and Android.<\/p>\n To try out URL Navigation, you’ll have to update your Xamarin.Forms NuGet Packages to the 2.3.X pre-release packages. <\/p>\n For Android, you’ll also need to install the Xamarin.Forms AppLinks NuGet<\/a> in your Android project.<\/p>\n Next, in the MainActivity underneath the Forms.Init(this); method call, add the following:<\/p>\n To get a full handle on using Google Search and App Indexing, be sure to read my blog post<\/a> and follow the same setup in the Search Console and Intent Filters on your MainActivity.<\/p>\n iOS 9 introduced several new search APIs that URL Navigation takes advantage of. There isn’t any additional set up unless you want to handle web links, but it’s a good idea to read our full documentation<\/a> on all of the wonderful search APIs.<\/p>\n The most common way of exposing a deep link to Google and Spotlight search is to create an AppLinkEntry in your application with metadata the system can use when a user navigates to a piece of content, such as the session details of the conference app. A good place to do this is on the OnAppearing method of a page.<\/p>\n The session’s Id<\/strong> is used as the core identifier that can be parsed out when handling the link. With our AppLinkEntry<\/strong> created, we just have to register it with the system.<\/p>\n When your app’s users click on a link through Google Search, Spotlight Search, or a web link, the Xamarin.Form’s application subclass will receive a request to handle the Uri<\/strong>. We’ll simply override the OnAppLinkRequestReceived<\/strong>\u00a0method and handle navigation:<\/p>\n Some frameworks, such as Prism<\/a>, have build in Uri navigation routing that could be utilized in this scenario.<\/p>\n Here’s our final URL Navigation with just a few lines of code:\nGetting Started with URL Navigation<\/h2>\n
Android<\/h3>\n
![\"AppLinksNuGet\"](\"https:\/\/devblogs.microsoft.com\/wp-content\/uploads\/sites\/44\/2019\/03\/AppLinksNuGet.png\")
<\/p>\n\r\nAndroidAppLinks.Init(this);\r\n<\/pre>\n
iOS<\/h3>\n
Creating Deep Links<\/h2>\n
\r\nvar url = $\"http:\/\/evolve.xamarin.com\/session\/{session.Id.ToString()}\";\r\n\r\nvar entry = new AppLinkEntry\r\n{\r\n Title = session.Title,\r\n Description = session.Abstract,\r\n AppLinkUri = new Uri(url, UriKind.RelativeOrAbsolute),\r\n IsLinkActive = true,\r\n Thumbnail = ImageSource.FromFile(\"Icon.png\")\r\n};\r\n\r\nentry.KeyValues.Add(\"contentType\", \"Session\");\r\nentry.KeyValues.Add(\"appName\", \"Evolve16\");\r\nentry.KeyValues.Add(\"companyName\", \"Xamarin\");\r\n<\/pre>\n\r\nApplication.Current.AppLinks.RegisterLink(entry);\r\n<\/pre>\n
Handling Links<\/h2>\n
\r\nprotected override void OnAppLinkRequestReceived(Uri uri)\r\n{\r\n var data = uri.ToString().ToLowerInvariant();\r\n \/\/only if deep linking\r\n if (!data.Contains(\"\/session\/\"))\r\n return;\r\n\r\n var id = data.Substring(data.LastIndexOf(\"\/\", StringComparison.Ordinal) + 1);\r\n\r\n \/\/Navigate based on id here.\r\n\r\n base.OnAppLinkRequestReceived(uri);\r\n}\r\n<\/pre>\n