Flutter用户证书管理插件flutter_user_certificates_android的使用

本指南将向你展示如何在Flutter应用中使用flutter_user_certificates_android插件来获取设备上已安装的用户证书。

获取开始

以下是一个示例，该示例列出了设备上所有已安装的用户证书。

import 'package:flutter/material.dart';
import 'dart:async';

import 'package:flutter/services.dart';
import 'package:flutter_user_certificates_android/flutter_user_certificates_android.dart';

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

class MyApp extends StatefulWidget {
  const MyApp({super.key});

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

class _MyAppState extends State<MyApp> {
  Map<String, Uint8List> _certs = {}; // 存储证书的Map
  String? error; // 存储错误信息
  final _flutterUserCertificatesAndroidPlugin = FlutterUserCertificatesAndroid(); // 初始化插件实例

  [@override](/user/override)
  void initState() {
    super.initState();
    initPlatformState(); // 初始化平台状态
  }

  // 异步方法，用于初始化平台状态
  Future<void> initPlatformState() async {
    Map<String, Uint8List>? certs;
    
    // 使用try-catch处理可能出现的异常
    try {
      // 调用插件方法获取用户证书
      certs = await _flutterUserCertificatesAndroidPlugin.getUserCertificates();
    } on PlatformException {
      // 如果获取失败，设置错误信息
      error = 'Failed to get user certificates from device.';
    }

    // 如果组件已经从树中移除，则不更新UI
    if (!mounted) return;

    // 如果获取到的证书为null，则返回
    if (certs == null) return;

    // 更新UI
    setState(() {
      _certs = certs!;
    });
  }

  [@override](/user/override)
  Widget build(BuildContext context) {
    return MaterialApp(
      home: Scaffold(
        appBar: AppBar(
          title: const Text('插件示例应用'),
        ),
        body: error != null
            ? Center(
                child: Text(error!), // 显示错误信息
              )
            : ListView.builder(
                itemCount: _certs.length,
                itemBuilder: (c, i) => ListTile(
                  title: Text(_certs.keys.elementAt(i)), // 显示证书名称
                ),
              ),
      ),
    );
  }
}

完整示例Demo

以下是完整的示例代码，你可以直接复制并在你的Flutter项目中运行。

import 'package:flutter/material.dart';
import 'dart:async';

import 'package:flutter/services.dart';
import 'package:flutter_user_certificates_android/flutter_user_certificates_android.dart';

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

class MyApp extends StatefulWidget {
  const MyApp({super.key});

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

class _MyAppState extends State<MyApp> {
  Map<String, Uint8List> _certs = {};
  String? error;
  final _flutterUserCertificatesAndroidPlugin = FlutterUserCertificatesAndroid();

  [@override](/user/override)
  void initState() {
    super.initState();
    initPlatformState();
  }

  Future<void> initPlatformState() async {
    Map<String, Uint8List>? certs;
    try {
      certs = await _flutterUserCertificatesAndroidPlugin.getUserCertificates();
    } on PlatformException {
      error = 'Failed to get user certificates from device.';
    }

    if (!mounted) return;

    if (certs == null) return;

    setState(() {
      _certs = certs!;
    });
  }

  [@override](/user/override)
  Widget build(BuildContext context) {
    return MaterialApp(
      home: Scaffold(
        appBar: AppBar(
          title: const Text('插件示例应用'),
        ),
        body: error != null
            ? Center(
                child: Text(error!),
              )
            : ListView.builder(
                itemCount: _certs.length,
                itemBuilder: (c, i) => ListTile(
                  title: Text(_certs.keys.elementAt(i)),
                ),
              ),
      ),
    );
  }
}