{"id":38742,"date":"2019-02-12T14:06:36","date_gmt":"2019-02-12T22:06:36","guid":{"rendered":"https:\/\/blog.xamarin.com\/?p=38742"},"modified":"2019-04-04T15:53:46","modified_gmt":"2019-04-04T22:53:46","slug":"easily-check-mobile-device-connectivity-with-xamarin-essentials","status":"publish","type":"post","link":"https:\/\/devblogs.microsoft.com\/xamarin\/easily-check-mobile-device-connectivity-with-xamarin-essentials\/","title":{"rendered":"Easily Check Mobile Device Connectivity with Xamarin.Essentials"},"content":{"rendered":"

\t\t\t\tOne of the best parts of a mobile device is their instant access to the internet. As a mobile app developer, it’s great to be able to pull data from the server to our apps to provide users with a delightful experience. Of course, until your user puts their device on airplane mode or hits a rough patch with no cell reception. To provide the best user experience we need access to the current network state of our users’ device. Better yet, be able to register for changes to that network state. Doing this will allow our mobile apps to react to different network conditions to provide users with instant feedback. With connectivity API in Xamarin.Essentials<\/a>, we can do just that with a few lines of code.<\/p>\n

Setup<\/h2>\n

To get started with Xamarin.Essentials simply install the NuGet package<\/a>. Use Xamarin.Essentials for your .NET Standard library if you are using one and your iOS, Android, and UWP app projects.<\/p>\n

\"\"<\/p>\n

After installing the NuGet, there is just a small amount of code on Android that is required to initialize Xamarin.Essentials.<\/p>\n

In the Android project’s `MainLauncher` or any `Activity` that is launched Xamarin.Essentials must be initialized in the `OnCreate` method:<\/p>\n

protected override void OnCreate(Bundle savedInstanceState) {\r\n  \/\/...\r\n  base.OnCreate(savedInstanceState);\r\n  Xamarin.Essentials.Platform.Init(this, savedInstanceState); \/\/ add this line to your code, it may also be called: bundle\r\n  \/\/...\r\n<\/pre>\n
To handle runtime permissions on Android, Xamarin.Essentials must receive any `OnRequestPermissionsResult`. Add the following code to all `Activity` classes:<\/p>\n
public override void OnRequestPermissionsResult(int requestCode, string[] permissions, [GeneratedEnum] Android.Content.PM.Permission[] grantResults)\r\n{\r\n  Xamarin.Essentials.Platform.OnRequestPermissionsResult(requestCode, permissions, grantResults);\r\n\r\n  base.OnRequestPermissionsResult(requestCode, permissions, grantResults);\r\n}\r\n<\/pre>\n
Android Permissions<\/h3>\n
In addition to Xamarin.Essentials standard initialization, we must also ensure that our application has the correct permissions to access the connectivity APIs. Android is the only platform that needs permissions added which can be accomplished by updating the AssemblyInfo.cs file or the AndroidManifest.xml file directly:<\/p>\n
Open the AssemblyInfo.cs file under the Properties folder and add:<\/p>\n
[assembly: UsesPermission(Android.Manifest.Permission.AccessNetworkState)]\r\n<\/pre>\n
You can also update the Android manifest by opening the AndroidManifest.xml file under the Properties folder. Then add the following inside of the manifest node:<\/p>\n
\r\n\r\n<\/pre>\n
Check Network Access<\/h2>\n
When getting or posting data for building mobile applications, it is important to check the current network access of the device. This enables us to handle situations where the user put the device into airplane mode or simply has no internet connection. Xamarin.Essentials provides a simple API to check the current network access state at any moment.<\/p>\n
var current = Connectivity.NetworkAccess;\r\n\r\nswitch(current)\r\n{\r\n  case NetworkAccess.Internet:\r\n    \/\/ Connected to internet\r\n    break;\r\n  case NetworkAccess.Local:\r\n    \/\/ Only local network access\r\n    break;\r\n  case NetworkAccess.ConstrainedInternet:\r\n    \/\/ Connected, but limited internet access such as behind a network login page\r\n    break;\r\n  case NetworkAccess.None:\r\n    \/\/ No internet available\r\n    break;\r\n  case NetworkAccess.Unknown:\r\n    \/\/ Internet access is unknown\r\n    break;\r\n}\r\n<\/pre>\n
\"\"<\/p>\n
Subscribe to Connectivity Changes<\/h2>\n
In addition to checking the current network access state, we can also register for events whenever the connectivity or the type of connection changes.<\/p>\n
public class ConnectivityTest\r\n{\r\n    public void StartListening()\r\n    {\r\n        \/\/ Register for connectivity changes\r\n        Connectivity.ConnectivityChanged += Connectivity_ConnectivityChanged;\r\n    }\r\n\r\n    public void StopListening()\r\n    {\r\n        \/\/ Un-register listener for changes\r\n        Connectivity.ConnectivityChanged -= Connectivity_ConnectivityChanged;\r\n    }\r\n\r\n    void Connectivity_ConnectivityChanged(object sender, ConnectivityChangedEventArgs  e)\r\n    {\r\n        var access = e.NetworkAccess;\r\n        \/\/ Update UI or notify the user\r\n    }\r\n}\r\n<\/pre>\n
\"\"<\/p>\n
There you have it. In just a few lines of code, we have checked our network access and registered for changes to the network state.<\/p>\n
See It In Action<\/h2>\n
Each week on The Xamarin Show on YouTube<\/a> and Channel 9<\/a>, we highlight how to set up, get started, and use the APIs in Xamarin.Essentials. Check out this episode on Connectivity:<\/p>\n