Flutter设备区域信息获取插件device_region的使用

device_region 是一个Flutter插件，它利用平台特定的API返回SIM卡国家代码。该插件支持iOS和Android。

安装Installation

在你的Flutter项目中，在pubspec.yaml文件添加依赖：

dependencies:
  device_region: ^1.3.0

然后执行flutter pub get来安装插件。

使用示例Usage example

导入包Import Package

首先需要导入device_region.dart包。

import 'package:device_region/device_region.dart';

获取SIM卡国家代码Get SIM country code

通过调用getSIMCountryCode方法来接收SIM卡国家代码。

await DeviceRegion.getSIMCountryCode();

Android:

• 使用TelephonyManager类：
  • 如果可用则返回simCountryIso。否则，应该返回networkCountryIso。
  • 如果无法获取值或发生错误，则将返回null值。

iOS:

iOS 16.0及以上版本

由于CTTelephonyNetworkInfo类中的属性已弃用，插件使用Locale类并返回Locale.current.region.identifier。

iOS 12.0至16.0

• 使用CTTelephonyNetworkInfo类：
  • 如果可用则返回isoCountryCode。
  • 如果无法获取值或发生错误，则将返回null值。

重要说明Important notes

• 在iOS（12.0及以上）上调用getSIMCountryCode时，可能会出现调试器中的错误日志，但这不会影响应用程序的操作。

  [Client] Updating selectors after delegate addition failed with: Error Domain=NSCocoaErrorDomain Code=4099 "The connection to service with pid 91 named com.apple.commcenter.coretelephony.xpc was invalidated from this process." UserInfo={NSDebugDescription=The connection to service with pid 91 named com.apple.commcenter.coretelephony.xpc was invalidated from this process.}
  

• 如果由于某种原因无法从SIM卡槽检索到信息，该方法将返回null。例如，在iOS模拟器和未插入SIM卡的设备上，它将返回null。

• 在iOS上，它仅适用于12.0及更高版本。对于较低版本，它将返回null。

示例Demo

下面是一个完整的示例应用，演示了如何使用device_region插件来获取SIM卡国家代码。

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

import 'package:device_region/device_region.dart';

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

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

  @override
  State<MyApp> createState() => _MyAppState();
}

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

  Future<void> askForSIMCountryCode() async {
    final result = await DeviceRegion.getSIMCountryCode();

    setState(() => _simRegion = result ?? 'Can\'t receive country code');
  }

  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      debugShowCheckedModeBanner: false,
      home: Scaffold(
        appBar: AppBar(
          title: const Text('Device_region example app'),
        ),
        body: Center(
          child: Column(
            mainAxisAlignment: MainAxisAlignment.center,
            children: [
              ElevatedButton(
                onPressed: askForSIMCountryCode,
                child: const Text('Get SIM country code'),
              ),
              const SizedBox(height: 15),
              Text('Your SIM country code is: $_simRegion\n'),
            ],
          ),
        ),
      ),
    );
  }
}

在这个例子中，我们创建了一个简单的Flutter应用程序，其中包含一个按钮，当点击时，它会尝试获取设备的SIM卡国家代码，并显示结果。如果无法获取国家代码，则显示“Can’t receive country code”。