Flutter Firebase安装管理插件firebase_installations的使用

Flutter Firebase安装管理插件firebase_installations的使用

简介

firebase_installations 是一个用于在Flutter应用中集成Firebase安装管理服务（FIS）的插件。它为每个已安装的应用实例提供了一个唯一的Firebase安装ID（FID）。这个ID用于标识应用的安装及其相关数据。

Firebase安装ID（FID）生命周期

在应用的正常运行过程中，通常不需要特别监控Firebase安装ID。然而，如果应用显式地获取和使用FID，则需要添加逻辑来监控FID的删除或旋转。以下是一些可能导致FID被删除或旋转的情况：

• 应用被卸载或重新安装，例如用户在新设备上安装应用。
• 用户清除了应用或设备的缓存。
• 由于应用长时间未活动（目前阈值为270天），后端触发了FID的删除。

使用步骤

1. 添加依赖

在 pubspec.yaml 文件中添加 firebase_core 和 firebase_installations 依赖：

dependencies:
  flutter:
    sdk: flutter
  firebase_core: ^2.4.0
  firebase_installations: ^0.1.0

2. 初始化Firebase

在应用启动时初始化Firebase。确保在 main.dart 中调用 WidgetsFlutterBinding.ensureInitialized() 并初始化Firebase：

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

void main() async {
  WidgetsFlutterBinding.ensureInitialized();
  await Firebase.initializeApp();

  runApp(MyApp());
}

3. 获取和删除Firebase安装ID

创建一个简单的Flutter应用来演示如何获取和删除Firebase安装ID。以下是完整的示例代码：

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

void main() async {
  WidgetsFlutterBinding.ensureInitialized();
  await Firebase.initializeApp();

  runApp(MyApp());
}

class MyApp extends StatefulWidget {
  [@override](/user/override)
  _MyAppState createState() => _MyAppState();
}

class _MyAppState extends State<MyApp> {
  String _installationId = 'Unknown';

  // 获取Firebase安装ID
  Future<void> getInstallationId() async {
    try {
      // 获取安装ID
      final id = await FirebaseInstallations.id;
      setState(() {
        _installationId = id ?? 'Unknown installation id';
      });
    } on PlatformException catch (e) {
      setState(() {
        _installationId = 'Failed to get installation id: ${e.message}';
      });
    }
  }

  // 删除Firebase安装ID
  Future<void> deleteInstallationId() async {
    try {
      // 删除安装ID
      await FirebaseInstallations.deleteInstallationId();
      setState(() {
        _installationId = 'Deleted installation id';
      });
    } on PlatformException catch (e) {
      setState(() {
        _installationId = 'Failed to delete installation id: ${e.message}';
      });
    }
  }

  [@override](/user/override)
  Widget build(BuildContext context) {
    return MaterialApp(
      home: Scaffold(
        appBar: AppBar(
          title: const Text('Plugin Firebase Installation ID'),
        ),
        body: Center(
          child: Column(
            mainAxisAlignment: MainAxisAlignment.center,
            children: [
              Text('Firebase Installation ID: $_installationId\n'),
              ElevatedButton(
                child: Text("Get Installation ID"),
                onPressed: getInstallationId,
              ),
              SizedBox(height: 16),
              ElevatedButton(
                child: Text("Delete Installation ID"),
                onPressed: deleteInstallationId,
              ),
            ],
          ),
        ),
      ),
    );
  }
}