Flutter手机号码获取插件fetch_mobile_numbers的使用

A Flutter package to fetch mobile numbers and SIM card information from a device. This package uses platform-specific code to access SIM card details, providing an easy way to retrieve this information within your Flutter applications。

功能

• 获取手机号码和SIM卡详细信息。
• 支持多张SIM卡。
• 提供插槽索引、运营商名称、国家ISO代码和电话号码等信息。

安装

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

dependencies:
  fetch_mobile_numbers: ^0.0.1

然后运行flutter pub get以安装该包。

使用方法

导入包

import 'package:fetch_mobile_numbers/fetch_mobile_numbers.dart';

获取手机号码

要获取手机号码和SIM卡详细信息，请使用FetchMobileNumbers类：

import 'package:fetch_mobile_numbers/fetch_mobile_numbers.dart';

void main() async {
  final fetchMobileNumbers = FetchMobileNumbers();

  // 获取手机号码
  List<SimCard>? simCards = await fetchMobileNumbers.getMobileNumbers();

  // 检查列表是否不为空
  if (simCards != null && simCards.isNotEmpty) {
    for (var simCard in simCards) {
      print(simCard);
    }
  } else {
    print('No SIM cards found.');
  }
}

类

FetchMobileNumbers

用于与SIM卡信息进行交互的主要类。

方法

• Future<List<SimCard>> getMobileNumbers()：获取设备上可用的SIM卡详情列表。

SimCard

表示SIM卡信息的类。

属性

• String slotIndex：SIM卡的插槽索引。
• String carrierName：SIM卡的运营商名称。
• String countryISO：国家的ISO代码。
• String number：与SIM卡关联的电话号码。

方法

• Map<String, dynamic> toJson()：将SimCard实例转换为JSON序列化的映射。
• factory SimCard.fromJson(Map<String, dynamic> json)：从映射创建SimCard实例。
• [@override](/user/override) String toString()：提供SimCard实例的字符串表示形式。

平台支持

此包当前支持以下平台：

• Android 请注意，iOS或其他平台的支持尚未实现。

贡献

如果您希望为该项目贡献，请在存储库中fork并创建一个包含您的更改的pull请求。确保遵循编码风格并为您的修改编写测试。

许可证

此包在MIT许可证下发布。有关更多信息，请参阅LICENSE文件。

联系

如有任何问题或问题，请在GitHub存储库中打开一个问题或联系维护者。

### 完整示例Demo

```dart
import 'package:flutter/material.dart';
import 'dart:async';
import 'package:fetch_mobile_numbers/fetch_mobile_numbers.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> {
  List<SimCard> _mobileNumbers = [];
  final _fetchMobileNumbersPlugin = FetchMobileNumbers();

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

  Future<void> initPlatformState() async {
    List<SimCard>? mobileNumbers;
    try {
      mobileNumbers = await _fetchMobileNumbersPlugin.getMobileNumbers();
    } on PlatformException {
      mobileNumbers = [];
    }

    if (!mounted) return;

    setState(() {
      _mobileNumbers = mobileNumbers ?? [];
    });
  }

  [@override](/user/override)
  Widget build(BuildContext context) {
    return MaterialApp(
      home: Scaffold(
        appBar: AppBar(
          title: const Text('插件示例应用'),
        ),
        body: Center(
          child: Column(
            mainAxisAlignment: MainAxisAlignment.center,
            crossAxisAlignment: CrossAxisAlignment.center,
            children: [
              if (_mobileNumbers.isNotEmpty && _mobileNumbers.length == 1)
                Text('${_mobileNumbers[0].toString()}\n'),
              if (_mobileNumbers.isNotEmpty && _mobileNumbers.length == 2)
                Text('${_mobileNumbers[0].toString()}\n'),
              if (_mobileNumbers.isNotEmpty && _mobileNumbers.length == 2)
                Text('${_mobileNumbers[1].toString()}\n'),
              if (_mobileNumbers.isEmpty)
                const Text('无法检测到SIM卡号码\n'),
            ],
          ),
        ),
      ),
    );
  }
}