Xamarin.Forms - Share Data Using Xamarin Essentials

In this article you will learn how to share data like text and url Using Xamarin.Essentials in Xamarin forms.

Introduction
 
Xamarin.Forms - Share Data Using Xamarin Essentials
 
Xamarin.Forms code runs on multiple platforms - each of which has its own filesystem. This means that reading and writing files is most easily done using the native file APIs on each platform. Alternatively, embedded resources are a simpler solution to distribute data files with an app.
 
Xamarin.Essentials
Xamarin.Forms - Share Data Using Xamarin Essentials 
 
Xamarin.Essentials plugin provides 20+ cross-platform APIs for mobile application development. Xamarin.Essentials API works with all Xamarin.Forms, Xamarin.Android, Xamarin.iOS, or UWP application that can be accessed from shared code. We are developing Xamarin with Android, iOS and UWP apps but now Xamarin.Essentials overcomes the problem, and developers can access every native platform API using C#. This plugin provides many APIs so initially, there is no need for more plugins for Xamarin. Xamarin.Essentials plugin impacts your app's minimum size.
 
Platform Support
 
Xamarin.Essentials supports platforms and operating systems,
 
 Platform Version
 Android 4.4 (API 19) or earlier
 iOS 10.0 or higher
 UWP 10.0.16299.0 or earlier
 
Prerequisites
  • Visual Studio 2017(Windows or Mac)
Setting up a Xamarin.Forms Project
 
Start by creating a new Xamarin.Forms project. You’ll learn more by going through the steps yourself.
 
Choose the Xamarin.Forms App Project type under Cross-platform/App in the New Project dialog.
 
Xamarin.Forms - Share Data Using Xamarin Essentials 
 
Name your app, select “Use Portable Class Library” for shared code, and target both Android and iOS.
 
Xamarin.Forms - Share Data Using Xamarin Essentials 
 
You probably want your project and solution to use the same name as your app. Put it in your preferred folder for projects and click Create.
 
Xamarin.Forms - Share Data Using Xamarin Essentials 
 
You now have a basic Xamarin.Forms app. Click the play button to try it out.
 
Xamarin.Forms - Share Data Using Xamarin Essentials 
 
Setting up the User Interface
 
Go to MainPage.Xaml and write the following code.
 
MainPage.xaml
  1. <?xml version="1.0" encoding="utf-8" ?>  
  2. <ContentPage xmlns="http://xamarin.com/schemas/2014/forms"  
  3.              xmlns:x="http://schemas.microsoft.com/winfx/2009/xaml"  
  4.              xmlns:local="clr-namespace:XamarinEssentials"  
  5.              x:Class="XamarinEssentials.MainPage">  
  6.   
  7.     <StackLayout>  
  8.         <StackLayout HorizontalOptions="Center" VerticalOptions="Start">  
  9.          <Image Margin="0,50,0,0" x:Name="imgBanner" Source="banner.png" ></Image>  
  10.          <Image Margin="0,0,0,10" x:Name="imgXamarinEssential" Source="xamarinessential.png" ></Image>  
  11.          <Label Margin="0,0,0,10" Text="Share" FontAttributes="Bold" FontSize="Large" TextColor="#CA6F1E" HorizontalTextAlignment="Center" ></Label>  
  12.          <Entry x:Name="txtText" Placeholder="Type something..." ></Entry>  
  13.          <Entry x:Name="txtURl" Placeholder="Type url..." ></Entry>  
  14.          <Button x:Name="btnShare" Text="Share Text" Clicked="btnShare_Clicked"/>  
  15.          <Button x:Name="btnShareUrl" Text="Share URL" Clicked="btnShareURL_Clicked"/>  
  16.   
  17.         </StackLayout>  
  18.     </StackLayout>  
  19.   
  20. </ContentPage>  
Click the play button to try it out.
 
Xamarin.Forms - Share Data Using Xamarin Essentials 
 
Add Xamarin Essentials
 
In this step, add Xamarin.Essentials to your project. You can install Xamarin.Essentials via NuGet, or you can browse the source code on GitHub.
 
Go to Solution Explorer and select your solution. Right-click and select "Manage NuGet Packages for Solution". Search "Xamarin.Essentials" and add Package. Remember to install it for each project (PCL, Android, iO, and UWP).
 
Xamarin.Forms - Share Data Using Xamarin Essentials
 
Xamarin.Essentials requires platform-specific setup

Android

The following steps are necessary for Android.
  1. Xamarin.Essentials supports a minimum Android version of 4.4
  2. Target Android version for compiling must be 8.1, API level 27.
In the Android project's MainActivity that is launched Xamarin.Essentials must be initialized in the OnCreate method.
 
MainActivity.cs
  1. Xamarin.Essentials.Platform.Init(this, bundle);  
Xamarin.Essentials must receive any OnRequestPermissionsResult. Write the following code for runtime permission.
 
MainActivity.cs
  1. public override void OnRequestPermissionsResult(int requestCode, string[] permissions, [GeneratedEnum] Android.Content.PM.Permission[] grantResults)  
  2. {  
  3.     Xamarin.Essentials.Platform.OnRequestPermissionsResult(requestCode, permissions, grantResults);  
  4.   
  5.     base.OnRequestPermissionsResult(requestCode, permissions, grantResults);  
  6. }  
iOS
 
No additional setup required.
 
UWP
 
No additional setup required.
 
Share Text
 
In this step, write the following code for share text
 
MainPage.xaml.cs
  1. async void btnShare_Clicked(object sender, System.EventArgs e)  
  2.         {  
  3.             await ShareText(txtText.Text);  
  4.         }  
  5.   
  6. public async Task ShareText(string text)  
  7.         {  
  8.             await DataTransfer.RequestAsync(new ShareTextRequest  
  9.             {  
  10.                 Text = text,  
  11.                 Title = "Share Text"  
  12.             });  
  13.         } 
Click the play button to try it out.
 
Xamarin.Forms - Share Data Using Xamarin Essentials Xamarin.Forms - Share Data Using Xamarin Essentials
 
Share URL
 
In this step, write the following code for share URL
 
MainPage.xaml.cs
  1. async void btnShareURL_Clicked(object sender, System.EventArgs e)  
  2.         {  
  3.             await ShareUri(txtURl.Text);  
  4.         }  
  5.   
  6. public async Task ShareUri(string uri)  
  7.         {  
  8.             await DataTransfer.RequestAsync(new ShareTextRequest  
  9.             {  
  10.                 Uri = uri,  
  11.                 Title = "Share Link"  
  12.             });  
  13.         }  
Click the play button to try it out.
 
 Xamarin.Forms - Share Data Using Xamarin EssentialsXamarin.Forms - Share Data Using Xamarin Essentials
 
Full code
 
MainPage.xaml.cs
  1. using System.Threading.Tasks;  
  2. using Xamarin.Forms;  
  3. using Xamarin.Essentials;  
  4. namespace XamarinEssentials  
  5. {  
  6.     public partial class MainPage : ContentPage  
  7.     {  
  8.         public MainPage()  
  9.         {  
  10.             InitializeComponent();  
  11.         }  
  12.         protected override void OnAppearing()  
  13.         {  
  14.             base.OnAppearing();  
  15.         }  
  16.   
  17.   
  18.         async void btnShare_Clicked(object sender, System.EventArgs e)  
  19.         {  
  20.             await ShareText(txtText.Text);  
  21.         }  
  22.         async void btnShareURL_Clicked(object sender, System.EventArgs e)  
  23.         {  
  24.             await ShareUri(txtURl.Text);  
  25.         }  
  26.         public async Task ShareText(string text)  
  27.         {  
  28.             await DataTransfer.RequestAsync(new ShareTextRequest  
  29.             {  
  30.                 Text = text,  
  31.                 Title = "Share Text"  
  32.             });  
  33.         }  
  34.         public async Task ShareUri(string uri)  
  35.         {  
  36.             await DataTransfer.RequestAsync(new ShareTextRequest  
  37.             {  
  38.                 Uri = uri,  
  39.                 Title = "Share Link"  
  40.             });  
  41.         }  
  42.     }  
  43. }  
I hope you have understood how to share data like text and url Using Xamarin Essentials in Xamarin.Forms.
 
Thanks for reading. Please share comments and feedback.