Integrating Auth Service into a Xamarin Android App

Xamarin (Microsoft) is a multi-system development platform for mobile services that many developers use. Many AppGallery Connect services now support Xamarin, including Auth Service. Here I'll explain on how to integrate Auth Service into your Xamarin.Android app that requires mobile number sign-in support.

Install the Xamarin environment.

You'll need to first download and install Visual Studio 2019.
Open Visual Studio and select Mobile development with .NET to install the Xamarin environment.

Next make sure you have enabled the Auth Service in AppGallery Connect.

Open Visual Studio, click Create a new project in the start window, select Mobile App (Xamarin.Forms), and set the app name and other required information.

Right-click your project and choose Manage NuGet Packages.

Search for the Huawei.Agconnect.Auth package on the displayed page and install it.

Download the JSON service file from your AppGallery project and add it into the *Assets directory in your project.

Create a new class named HmsLazyInputStreams.cs, and implement the following code to read the JSON file.

	using System;
	using System.IO;
	using Android.Util;
	using Android.Content;
	using Huawei.Agconnect.Config;
	namespace XamarinAuthDemo
	{
	class HmsLazyInputStream : LazyInputStream
	{
	public HmsLazyInputStream(Context context) : base(context)
	{
	Get(context);
	}
	public override Stream Get(Context context)
	{
	try
	{
	return context.Assets.Open("agconnect-services.json");
	}
	catch (Exception e)
	{
	Log.Error(e.ToString(), "Failed to get input stream" + e.Message");
	return null;
	}
	}
	}
	}

view raw HmsLazyInputStreams.cs hosted with ❤ by GitHub

Then add the following code to AttachBaseContext under MainActivity.

	protected override void AttachBaseContext(Context context){
	base.AttachBaseContext(context);
	AGConnectServicesConfig config = AGConnectServicesConfig.FromContext(context);
	config.OverlayWith(new HmsLazyInputStream(context));
	}

view raw MainActivity.cs hosted with ❤ by GitHub

Right-click your project and choose Properties. Click Android Manifest on the displayed page, and set a package name.

Once you've completed all of these preparations, you'll be able to develop app functions.

If your app requires mobile number sign-in support, the Auth Service SDK can help you implement both sign-up and sign-in for this authentication mode. You'll need to send verification codes to your users for both stages. Auth Service can help you with that as well.

Setup Mobile Number verification

Create a VerifyCodeSettings object that contains the SMS messaging settings, including the action and language.

	VerifyCodeSettings settings = VerifyCodeSettings.NewBuilder()
	.Action(VerifyCodeSettings.ActionRegisterLogin)
	.SendInterval(30)
	.Locale(Locale.English)
	.Build();

view raw VerifyCodeSettings.cs hosted with ❤ by GitHub

Call the RequestVerifyCodeAsync method to send a request to the Auth Service server, and pass the country code and mobile number entered by a user, and the VerifyCodeSettings object you just created, for Auth Service to send a verification code SMS message to the user.

	string countryCode = edtCountryCode.Text.ToString().Trim();
	string phoneNumber = edtAccount.Text.ToString().Trim();
	try {
	var requestVerifyCode = AGConnectAuth.Instance.RequestVerifyCodeAsync(countryCode, phoneNumber, settings);
	VerifyCodeResult verifyCodeResult = await requestVerifyCode;
	if(requestVerifyCode.Status.Equals(System.Threading.Tasks.TaskStatus.RanToCompletion)) {
	Toast.MakeText(this, "The verification code is sent successfully! ", ToastLength.Short).Show();
	}
	} catch (Exception ex) {
	Toast.MakeText(this, ex.Message, ToastLength.Long).Show();
	}

view raw verifycode.cs hosted with ❤ by GitHub

Upon receiving the verification code, the user can start sign-up.
First, you'll need to create a PhoneUser object to store the user's inputs, including the mobile number, country code, verification code, and password. The user can choose whether to set a password. If so, they'll need to enter a password when signing in to your app.

	string countryCode = edtCountryCode.Text.ToString().Trim();
	string phoneNumber = edtAccount.Text.ToString().Trim();
	string password = edtPassword.Text.ToString().Trim();
	string verifyCode = edtVerifyCode.Text.ToString().Trim();
	// Create a PhoneUser object.
	PhoneUser phoneUser = new PhoneUser.Builder()
	.SetCountryCode(countryCode)
	.SetPhoneNumber(phoneNumber)
	.SetPassword(password)
	.SetVerifyCode(verifyCode)
	.Build();

view raw PhoneUser.cs hosted with ❤ by GitHub

Call the CreateUserAsync method to create a user.

	try {
	// Create a mobile number user.
	var phoneUserResult = AGConnectAuth.Instance.CreateUserAsync(phoneUser);
	ISignInResult signInResult = await phoneUserResult;
	if (phoneUserResult.Status.Equals(System.Threading.Tasks.TaskStatus.RanToCompletion)) {
	// After the user is created, they are automatically signed in to your app.
	StartActivity(new Intent(this, typeof(MainActivity)));
	}
	} catch (Exception ex) {
	Toast.MakeText(this, "Create User Fail:" + ex.Message, ToastLength.Long).Show();
	}

view raw signin.cs hosted with ❤ by GitHub

Once sign-up is complete, the Auth Service SDK will automatically sign the user in to your app, and you won't need to call the sign-in API again.

For an existing user, you need to implement the sign-in process, either via a verification code or a password.

	string countryCode = edtCountryCode.Text.ToString().Trim();
	string phoneNumber = edtAccount.Text.ToString().Trim();
	string password = edtPassword.Text.ToString().Trim();
	string verifyCode = edtVerifyCode.Text.ToString().Trim();
	IAGConnectAuthCredential credential;
	if (TextUtils.IsEmpty(verifyCode)) {
	credential = PhoneAuthProvider.CredentialWithPassword(countryCode, phoneNumber, password);
	} else {
	credential = PhoneAuthProvider.CredentialWithVerifyCode(countryCode, phoneNumber, password, verifyCode);
	}
	try {
	AGConnectAuth connectAuth = AGConnectAuth.Instance;
	var signInResult = AGConnectAuth.Instance.SignInAsync(credential);
	ISignInResult result = await signInResult;
	if (signInResult.Status.Equals(System.Threading.Tasks.TaskStatus.RanToCompletion)) {
	Log.Debug(TAG, signInResult.Result.ToString());
	StartActivity(new Intent(this, typeof(MainActivity)));
	Finish();
	}
	} catch (Exception ex) {
	Log.Error(TAG, ex.Message);
	Toast.MakeText(this, "SignIn failed: " + ex.Message, ToastLength.Long).Show();
	}

view raw login.cs hosted with ❤ by GitHub

You can call CredentialwithPassword or CredentialWithVerifyCode to generate a credential for a password sign-in or a verification code sign-in, respectively. Then call the SignInAsync method to pass the credential for sign-in.

And thats it! We now have a fully functional authentication system using the users mobile number to confirm they are who they say they are.