Flutter eSIM安装管理插件esim_installer_flutter的使用

eSim Installer Flutter 插件

esim_installer_flutter 插件为 Flutter 提供了一个接口来与原生平台（目前仅限 Android）上的 eSIM 安装和管理功能进行交互。该插件允许 Flutter 应用程序安装 eSIM 配置文件、检查设备是否支持 eSIM 功能，并提供 eSIM 设置的说明。

The esim_installer_flutter plugin provides a Flutter interface to interact with eSIM installation and management functionality on the native platform (currently Android). This plugin allows Flutter applications to install eSIM profiles, check if the device supports eSIM, and provide instructions for eSIM setup.

特性

• 获取平台版本：检索底层 Android 平台的版本。
• 检查 eSIM 支持：确定设备是否支持 eSIM 功能。
• 安装 eSIM 配置文件：使用指定的 SMDP 地址和激活令牌启动 eSIM 配置文件的安装。
• 启动意图：直接启动一个意图以处理 eSIM 配置文件的安装。
• 获取安装说明：获取手动安装 eSIM 配置文件的逐步说明。

Get Platform Version: Retrieve the version of the underlying Android platform.
Check eSIM Support: Determine whether the device supports eSIM functionality.
Install eSIM Profile: Initiate the installation of an eSIM profile using a specified SMDP address and activation token.
Launch Intent: Directly launch an intent to handle eSIM profile installation.
Get Installation Instructions: Obtain step-by-step instructions for manually installing an eSIM profile.

安装

要使用此插件，在 pubspec.yaml 文件中添加 esim_installer_flutter 作为依赖项：

dependencies:
  esim_installer_flutter:
    git:
      url: https://github.com/rai-ms/esim_installer_flutter.git

使用

在 Dart 代码中导入 esim_installer_flutter 插件：

import 'package:esim_installer_flutter/esim_installer_flutter.dart';

示例

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

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

class MyApp extends StatelessWidget {
  [@override](/user/override)
  Widget build(BuildContext context) {
    return MaterialApp(
      home: EsimInstallerHome(),
    );
  }
}

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

class _EsimInstallerHomeState extends State<EsimInstallerHome> {
  String _platformVersion = 'Unknown';
  bool _isEsimSupported = false;
  String _installationResult = '';
  String _instructions = '';

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

  Future<void> _initPlatformState() async {
    String platformVersion;
    bool isEsimSupported;
    String instructions;

    try {
      platformVersion = await EsimInstallerFlutter().getPlatformVersion() ?? 'Unknown platform version';
      isEsimSupported = await EsimInstallerFlutter().isSupportESim() ?? false;
      instructions = await EsimInstallerFlutter().instructions() ?? 'No instructions available';
    } catch (e) {
      platformVersion = 'Failed to get platform version.';
      isEsimSupported = false;
      instructions = 'Failed to get instructions.';
    }

    if (!mounted) return;

    setState(() {
      _platformVersion = platformVersion;
      _isEsimSupported = isEsimSupported;
      _instructions = instructions;
    });
  }

  Future<void> _installEsimProfile() async {
    String result;
    try {
      result = await EsimInstallerFlutter().installESimProfile(
        smdpAddress: 'your.smdp.address',
        activationToken: 'your_activation_token',
      );
    } catch (e) {
      result = 'Failed to install eSIM profile.';
    }

    setState(() {
      _installationResult = result;
    });
  }

  [@override](/user/override)
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(
        title: Text('eSIM Installer Example'),
      ),
      body: Center(
        child: Column(
          mainAxisAlignment: MainAxisAlignment.center,
          children: [
            Text('Running on: $_platformVersion\n'),
            Text('eSIM Supported: $_isEsimSupported\n'),
            ElevatedButton(
              onPressed: _isEsimSupported ? _installEsimProfile : null,
              child: Text('Install eSIM Profile'),
            ),
            Text('Installation Result: $_installationResult\n'),
            ElevatedButton(
              onPressed: () {
                showDialog(
                  context: context,
                  builder: (context) => AlertDialog(
                    title: Text('eSIM Installation Instructions'),
                    content: Text(_instructions),
                    actions: [
                      TextButton(
                        onPressed: () => Navigator.pop(context),
                        child: Text('OK'),
                      ),
                    ],
                  ),
                );
              },
              child: Text('Show Instructions'),
            ),
          ],
        ),
      ),
    );
  }
}