Integrating Huawei's AppGallery Connect Auth Service for iOS

Auth Service helps you quickly and easily develop account registration and sign-in functions for your app.

This service is offered completely free of charge and supports a range of platforms including Android and iOS!

Today we are going to take a look at how this can be quickly integrated into an iOS application.

Enabling Auth Service

To enable Auth Service, sign in to AppGallery Connect, click My projects, click your project card, and select an app for SDK integration from the app drop-down list at the top of the page. Then go to Build > Auth Service, and enable the service if you haven't already.

Integrating the Service SDK

If you are using Xcode, you need to integrate the service SDK into your Xcode project using CocoaPods.

1. Add the AppGallery Connect configuration file of the app to your Xcode project.
2. Sign in to AppGallery Connect and click My projects.
3. Click your project card and select an app for SDK integration from the app drop-down list at the top of the page.
4. Go to Project settings > General information and download agconnect-services.plist under App information.
5. Copy the agconnect-services.plist file to your app's module directory.

Create a PodFile

Open the CLI and navigate to the Xcode project. Then, create a Podfile. Skip this step if a Podfile already exists.

cd project-directory
pod init

Edit the PodFile

Integrate the service SDK.
Add the pod dependency AGConnectAuth to the Podfile.

target 'AGConnectAuthDemo' do
pod 'AGConnectAuth'
end

Install the pod and open the .xcworkspace file to view the project.

pod install

Designing the UI

You can create a layout page in the Xcode project and design the UI based on the following figure, to allow users to register an account on your app using a mobile number or email address.

Enabling Required Authentication Modes

1. Sign in to AppGallery Connect and click My projects.
2. Click your project card and select an app from the app drop-down list at the top of the page.
3. Go to Build > Auth Service. On the Authentication mode tab page, enable Mobile number and Email address in the Operation column.

Developing Functions

Associate Storyboard with ViewController so that you can obtain parameters required for sign-up and sign-in through text boxes

	@IBOutlet weak var phoneText: UITextField!// Text box for entering a mobile number.
	@IBOutlet weak var phoneVertifyText: UITextField!// Text box for entering a verification code sent to the mobile number.
	@IBOutlet weak var phonePassword: UITextField!// Text box for entering the account password.
	@IBOutlet weak var emailText: UITextField!// Text box for entering an email address.
	@IBOutlet weak var emailVertifyText: UITextField!// Text box for entering a verification code sent to the email address.
	@IBOutlet weak var emailPassword: UITextField!// Text box for entering the account password.

view raw uielements.swift hosted with ❤ by GitHub

Mobile Number

If the mobile number entered has not been used to register an account, you need to send a verification code to it to check whether it belongs to the user. Enter a mobile number and tap Send verification code. Then call the method for requesting a verification code and obtain the result in the callback.

	@IBAction func phoneSendVertifyCode(_ sender: Any) {
	let setting = AGCVerifyCodeSettings.init(action: AGCVerifyCodeAction.registerLogin, locale: nil, sendInterval: 30)
	AGCPhoneAuthProvider.requestVerifyCode(withCountryCode: "86", phoneNumber: phoneText.text ?? "", settings: setting).onSuccess { (results) in
	// A verification code is successfully sent to the mobile number.
	}.onFailure { (error) in
	// No verification code is sent to the mobile number.
	}
	}

view raw phoneSendVertifyCode.swift hosted with ❤ by GitHub

Enter the verification code you received and the password set for your account. Tap the register button, call the method for mobile number registration, and obtain the result in the block callback.

	@IBAction func register(_ sender: Any) {
	AGCAuth.instance().createUser(withCountryCode: "86", phoneNumber: phoneText.text ?? "", password: phonePassword.text ?? "", verifyCode: phoneVertifyText.text ?? "").onSuccess { (result) in
	// The mobile number is successfully registered.
	}.onFailure { (error) in
	// The mobile number fails to be used for sign-up.
	}
	}

view raw register.swift hosted with ❤ by GitHub

After successfully registering an account, enter the mobile number and password you set, and tap login to sign in to your app. Congratulations, you have now successfully enabled registration and sign-in with a mobile number for your app.

	@IBAction func login(_ sender: Any) {
	let credential = AGCPhoneAuthProvider.credential(withCountryCode: "86", phoneNumber: phoneText.text ?? "", password: phonePassword.text ?? "")
	AGCAuth.instance().signIn(credential: credential).onSuccess { (result) in
	// Sign-in success.
	}.onFailure { (error) in
	// Sign-in failed.
	}
	}

view raw login.swift hosted with ❤ by GitHub

Email

If the email address entered has not been used to register an account, you need to send a verification code to it. Enter the email address and tap Send verification code. Then call the method for requesting a verification code and obtain the result in the callback.

	@IBAction func emailSendVertifyCode(_ sender: Any) {
	let setting = AGCVerifyCodeSettings.init(action: AGCVerifyCodeAction.registerLogin, locale: nil, sendInterval: 30)
	AGCEmailAuthProvider.requestVerifyCode(withEmail: emailText.text ?? "", settings: setting).onSuccess { (result) in
	// A verification code is successfully sent to the email address.
	}.onFailure { (error) in
	// No verification code is sent to the email address.
	}
	}

view raw emailSendVertifyCode.swift hosted with ❤ by GitHub

Enter the verification code you received and the sign-in password, and tap register.

	@IBAction func register(_ sender: Any) {
	AGCAuth.instance().createUser(withEmail: emailText.text ?? "", password: emailPassword.text ?? "", verifyCode: emailVertifyText.text ?? "").onSuccess { (result) in
	// The email address is used for sign-up successfully.
	}.onFailure { (error) in
	// The email address failed to be used for registration.
	}
	}

view raw email-register.swift hosted with ❤ by GitHub

Enter the email address and the password you set and tap login to sign in to your app. Congratulations, you have now successfully enabled registration and sign-in with an email address for your app.

	@IBAction func login(_ sender: Any) {
	let credential = AGCEmailAuthProvider.credential(withEmail: emailText.text ?? "", password: emailPassword.text ?? "")
	AGCAuth.instance().signIn(credential: credential).onSuccess { (result) in
	// Sign-in success.
	}.onFailure { (error) in
	// Sign-in failed.
	}
	}

view raw email-login.swift hosted with ❤ by GitHub

Summary

Auth Service is a service that provides you with a quick and easy way to develop registration and sign-in functions for app. Its lightweight SDK also help you reduce your app’s size.

Reference

More information about Auth Service