如何在Flutter中整合華為認證服務

最近發現華為AGC認證服務支援Flutter框架了，期待這個平臺的支援已經很久了，所以迫不及待接入了，關聯了自己的郵箱等賬號。

整合步驟

1. 安裝flutter環境
   a) 下載Flutter sdk包，地址：flutter.dev/docs/get-started/install/windows

將壓縮包解壓到任意資料夾，例如D:Flutter

b) 將flutter命令檔案新增到環境變數中，此處我新增的Path為D:Flutterflutter_windows_1.22.2-stableflutterbin。

c) 在Android Studio中點選“File-Settings-Plugins”，下載Flutter和Dart外掛，重啟Android Studio使外掛生效。

2. 開通服務&建立工程

a) 在AGC建立Android應用並開通認證服務

b) 開啟認證服務中的匿名帳號，手機帳號，郵箱帳號

c) 在Android Studio中新建Flutter工程

d) 將agconnect-services.json檔案放入Android/app目錄下

e) 配置Maven倉地址和AGC外掛地址。

a. 開啟Flutter專案android資料夾下的build.gradle檔案。

b. 在allprojects ->repositories裡面配置maven倉地址。

c. 在buildscript->repositories中配置maven倉地址。

d. 在buildscript->dependencies中配置AppGallery Connect外掛地址。

1. 新增編譯依賴和AGC外掛地址。
   a. 開啟Flutter專案android/app資料夾下的build.gradle檔案。
   b. 在檔案中新增如下配置。

3. 整合SDK
   在Flutter專案的pubspec.yaml檔案中新增依賴：

dependencies:
    flutter:
    sdk: flutter
# Add the following line:
    agconnect_auth: ^1.1.0

然後點選Pub get進行同步

4. 接入功能
5. 匿名帳號登入
   匿名帳號只需要呼叫signInAnonymously介面進行登入

_signIn() async {
  AGCAuth.instance.signInAnonymously().then((value) {
    setState(() {
      _log =
          'signInAnonymously = ${value.user.uid} , ${value.user.providerId}';
    });
  });
}

透過value，我們可以獲取到使用者資訊，例如這裡我們獲取到了user的id。

2. 手機號&郵箱認證

手機號郵箱賬號認證首先需要傳送驗證碼，

手機號請求驗證碼，即呼叫requestVerifyCode方法，傳入手機號、國家碼、設定項作為引數：

_requestPhoneVerifyCode(VerifyCodeAction action) {
  String countryCode = _countryCodeController.text;
  String phoneNumber = _phoneNumberController.text;
  VerifyCodeSettings settings = VerifyCodeSettings(action, sendInterval: 30);
  PhoneAuthProvider.requestVerifyCode(countryCode, phoneNumber, settings).then((value) => print(value.validityPeriod));
}

郵箱請求驗證碼，即呼叫requestVerifyCode方法，傳入郵箱、設定項作為引數：

_requestEmailVerifyCode(VerifyCodeAction action) {
  String email = _emailController.text;
  VerifyCodeSettings settings = VerifyCodeSettings(action, sendInterval: 30);
  EmailAuthProvider.requestVerifyCode(email, settings)
      .then((value) => print(value.validityPeriod));
}

而後是建立使用者的操作：

建立手機賬號使用者，需要呼叫createPhoneUser方法，傳入封裝好的PhoneUser物件

_createPhoneUser() async {
   bool result = await _showPhoneDialog(VerifyCodeAction.registerLogin);
   if (result == null) {
     print("cancel");
     return;
   }
   String countryCode = _countryCodeController.text;
   String phoneNumber = _phoneNumberController.text;
   String verifyCode = _verifyCodeController.text;
   String password = _passwordController.text;
   AGCAuth.instance.createPhoneUser(PhoneUser(countryCode, phoneNumber, verifyCode, password: password)) .then((value) {
     setState(() {
       _log = 'createPhoneUser = ${value.user.uid} , ${value.user.providerId}';
     });
   }).catchError((error)=>print(error));
 }

建立郵箱賬號使用者，需要呼叫createEmailUser方法，傳入封裝好的EmailUser物件。

_createEmailUser() async {
   bool result = await _showEmailDialog(VerifyCodeAction.registerLogin);
   if (result == null) {
     print("cancel");
     return;
   }
   String email = _emailController.text;
   String verifyCode = _verifyCodeController.text;
   String password = _passwordController.text;
   AGCAuth.instance
       .createEmailUser(EmailUser(email, verifyCode, password: password))
       .then((value) {
     setState(() {
       _log = 'createEmailUser = ${value.user.uid} , ${value.user.providerId}';
     });
   }).catchError((error) => print(error));
 }

最後是登入功能，有兩種登入模式，一種是密碼登入方式：

• 手機賬號，呼叫signIn方法，傳入使用手機號等生成的認證憑據。

_signInWithPassword() async {
   bool result = await _showPhoneDialog(VerifyCodeAction.registerLogin);
   if (result == null) {
     print("cancel");
     return;
   }
   String countryCode = _countryCodeController.text;
   String phoneNumber = _phoneNumberController.text;
   String password = _passwordController.text;
   AGCAuthCredential credential = PhoneAuthProvider.credentialWithPassword(countryCode, phoneNumber, password);
   AGCAuth.instance.signIn(credential).then((value) {
     setState(() {
       _log = 'signInWithPassword = ${value.user.uid} , ${value.user.providerId}';
     });
   });
 }

• 郵箱賬號：呼叫signIn方法，傳入透過郵箱和密碼生成的認證憑據。

_signInWithPassword() async {
   bool result = await _showEmailDialog(VerifyCodeAction.registerLogin);
   if (result == null) {
     print("cancel");
     return;
   }
   String email = _emailController.text;
   String password = _passwordController.text;
   AGCAuthCredential credential =
       EmailAuthProvider.credentialWithPassword(email, password);
   AGCAuth.instance.signIn(credential).then((value) {
     setState(() {
       _log =
           'signInWithPassword = ${value.user.uid} , ${value.user.providerId}';
     });
   });
 }

另一種是驗證碼登入方式：

• 手機賬號：呼叫signIn方法，傳入透過手機、驗證碼和密碼生成的認證憑據。

_signInWithVerifyCode() async {
   bool result = await _showPhoneDialog(VerifyCodeAction.registerLogin);
   if (result == null) {
     print("cancel");
     return;
   }
   String countryCode = _countryCodeController.text;
   String phoneNumber = _phoneNumberController.text;
   String verifyCode = _verifyCodeController.text;
   String password = _passwordController.text;
   AGCAuthCredential credential = PhoneAuthProvider.credentialWithVerifyCode(countryCode, phoneNumber, verifyCode, password: password);
   AGCAuth.instance.signIn(credential).then((value) {
     setState(() {
       _log = 'signInWithVerifyCode = ${value.user.uid} , ${value.user.providerId}';
     });
   });
 }

• 郵箱賬號：呼叫signIn方法，傳入透過郵箱、驗證碼和密碼生成的認證憑據。

_signInWithVerifyCode() async {
   bool result = await _showEmailDialog(VerifyCodeAction.registerLogin);
   if (result == null) {
     print("cancel");
     return;
   }
   String email = _emailController.text;
   String verifyCode = _verifyCodeController.text;
   String password = _passwordController.text;
   AGCAuthCredential credential = EmailAuthProvider.credentialWithVerifyCode(
       email, verifyCode,
       password: password);
   AGCAuth.instance.signIn(credential).then((value) {
     setState(() {
       _log =
           'signInWithVerifyCode = ${value.user.uid} , ${value.user.providerId}';
     });
   });
 }

3. 自有賬號
   自有賬號建立jwt獲取token等步驟為server端步驟，端側只需要取到token進行登入即可。

_signIn() async {
   bool result = await _showSelfBuildDialog(VerifyCodeAction.registerLogin);
   if (result == null) {
     print("cancel");
     return;
   }
   String token = _selfBuildController.text;
   AGCAuthCredential credential = SelfBuildAuthProvider.credentialWithToken(token);
   AGCAuth.instance.signIn(credential).then((value) {
     setState(() {
       _log = 'signIn = ${value.user.uid} , ${value.user.providerId}';
     });
   });
 }

5. 打包
   與Android相同，只需要在Android Studio中點選執行即可

原作者：Mayism