Flutter域名验证管理插件domain_verification_manager的使用

Flutter域名验证管理插件domain_verification_manager的使用

插件介绍

domain_verification_manager 插件暴露了一些方法来检查Android App Links验证状态，通过使用 DomainVerificationManager API。此插件仅适用于Android 12（S - API Level 31）及以上版本。较旧的版本会抛出 WRONG_SDK_VERSION 错误，而其他平台将返回 UnsupportedError。

你可以使用 await DomainVerificationManager.isSupported 来检查当前平台和API版本是否受支持。

以下是该插件的功能：

• 获取已通过Android App Links验证的域名 (domainStageVerified)
• 获取未通过Android App Links验证但用户手动关联的应用的域名 (domainStageSelected)
• 获取所有其他域名 (domainStageNone)
• 打开应用设置页面，用户可以在其中手动授予权限 (domainRequest)

完整示例Demo

以下是一个完整的Flutter应用程序示例，展示了如何使用 domain_verification_manager 插件：

import 'dart:async';
import 'package:after_layout/after_layout.dart';
import 'package:domain_verification_manager/domain_verification_manager.dart';
import 'package:flutter/material.dart';
import 'package:flutter/services.dart';

void main() {
  runApp(const MyApp());
}

class MyApp extends StatefulWidget {
  const MyApp({Key? key}) : super(key: key);

  [@override](/user/override)
  State<MyApp> createState() => _MyAppState();
}

class _MyAppState extends State<MyApp> with AfterLayoutMixin<MyApp> {
  String _isSupported = 'Unknown';
  String _domainStateVerified = 'Unknown';
  String _domainStateSelected = 'Unknown';
  String _domainStateNone = 'Unknown';

  // 在布局首次绘制后调用
  [@override](/user/override)
  FutureOr<void> afterFirstLayout(BuildContext context) async {
    if (await getIsSupported()) {
      getDomainStageVerified();  // 获取已验证的域名
      getDomainStateSelected();  // 获取用户手动关联的域名
      getDomainStateNone();      // 获取未验证且未关联的域名
    }
  }

  // 检查当前平台和API版本是否支持
  Future<bool> getIsSupported() async {
    String result;
    bool _supported = false;
    try {
      _supported = await DomainVerificationManager.isSupported;  // 检查支持性
      result = _supported.toString();
    } on PlatformException {
      result = 'Failed to get getIsSupported';  // 如果失败则显示错误信息
    }
    if (!mounted) {
      _isSupported = result;
      return _supported;
    }

    setState(() {
      _isSupported = result;  // 更新支持性状态
    });

    return _supported;
  }

  // 获取已验证的域名
  Future<void> getDomainStageVerified() async {
    String result;
    try {
      result = (await DomainVerificationManager.domainStageVerified).toString();  // 获取已验证的域名列表
    } on PlatformException {
      result = 'Failed to get domainStageVerified';  // 如果失败则显示错误信息
    }
    if (!mounted) {
      _domainStateVerified = result;
      return;
    }

    setState(() {
      _domainStateVerified = result;  // 更新已验证的域名状态
    });
  }

  // 获取用户手动关联的域名
  Future<void> getDomainStateSelected() async {
    String result;
    try {
      result = (await DomainVerificationManager.domainStageSelected).toString();  // 获取用户手动关联的域名列表
    } on PlatformException {
      result = 'Failed to get domainStageSelected';  // 如果失败则显示错误信息
    }
    if (!mounted) {
      _domainStateSelected = result;
      return;
    }

    setState(() {
      _domainStateSelected = result;  // 更新用户手动关联的域名状态
    });
  }

  // 获取未验证且未关联的域名
  Future<void> getDomainStateNone() async {
    String result;
    try {
      result = (await DomainVerificationManager.domainStageNone).toString();  // 获取未验证且未关联的域名列表
    } on PlatformException {
      result = 'Failed to get domainStageNone';  // 如果失败则显示错误信息
    }
    if (!mounted) {
      _domainStateNone = result;
      return;
    }

    setState(() {
      _domainStateNone = result;  // 更新未验证且未关联的域名状态
    });
  }

  // 打开应用设置页面，用户可以手动授予权限
  Future<void> domainRequest() async {
    await DomainVerificationManager.domainRequest();  // 打开应用设置页面
  }

  [@override](/user/override)
  Widget build(BuildContext context) {
    return MaterialApp(
      home: Scaffold(
        appBar: AppBar(
          title: const Text('域名验证管理器'),  // 设置AppBar标题
        ),
        body: Padding(
          padding: const EdgeInsets.only(top: 12.0),
          child: Center(
            child: Column(
              children: [
                Text(
                  '支持: $_isSupported\n\n',  // 显示支持性状态
                  textAlign: TextAlign.center,
                ),
                Text(
                  '已验证:\n$_domainStateVerified\n\n',  // 显示已验证的域名状态
                  textAlign: TextAlign.center,
                ),
                Text(
                  '未验证，但用户关联了链接:\n$_domainStateSelected\n\n',  // 显示用户手动关联的域名状态
                  textAlign: TextAlign.center,
                ),
                Text(
                  '未验证且未关联到应用:\n$_domainStateNone\n\n',  // 显示未验证且未关联的域名状态
                  textAlign: TextAlign.center,
                ),
                ElevatedButton(
                  onPressed: domainRequest,  // 点击按钮打开应用设置页面
                  child: const Text('请求'),
                ),
              ],
            ),
          ),
        ),
      ),
    );
  }
}