Flutter国家检测插件 country_detector 的使用

country_detector 是一个简单的插件，用于在 Android 和 iOS 平台上检测用户的国家代码。它基于 SIM 卡、网络和本地设置来获取用户的 ISO 国家代码，并以字符串形式返回结果。

插件功能

• 该插件根据 SIM 卡、网络和本地设置（Locale）来检测用户的 ISO 国家代码。
• 返回的国家代码全部为大写。例如，“kr”将返回为“KR”。
• 对于某些移动虚拟网络运营商（MVNO），SIM 和网络的 isoCountryCode 可能返回“–”，在这种情况下，插件会回退到从 Locale 获取的国家代码。

示例代码

调用插件

final _countryDetector = CountryDetector();

isoCountryCode 方法

isoCountryCode 方法会返回一个 ISO 国家代码。它首先检查 SIM 卡，如果为空，则检查网络。如果仍然为空，则返回用户 Locale 中的国家代码。

try {
  final cc = await _countryDetector.isoCountryCode();
  print('ISO Country Code: $cc');
} catch (e) {
  print('Error fetching ISO country code: $e');
}

detectAll 方法

detectAll 方法会返回所有检测到的 ISO 国家代码，并将其封装在 AllCountries 类中。你可以通过 sim、network 和 locale 属性来获取对应的值。

try {
  final allCodes = await _countryDetector.detectAll();
  print('SIM Code: ${allCodes.sim}');
  print('Network Code: ${allCodes.network}');
  print('Locale Code: ${allCodes.locale}');
} catch (e) {
  print('Error fetching all country codes: $e');
}

完整示例 Demo

以下是一个完整的 Flutter 示例应用，展示了如何使用 country_detector 插件：

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

void main() {
  WidgetsFlutterBinding.ensureInitialized();
  runApp(const MyApp());
}

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

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

class _MyAppState extends State<MyApp> {
  final _countryDetector = CountryDetector();

  [@override](/user/override)
  Widget build(BuildContext context) {
    return MaterialApp(
      home: Scaffold(
        appBar: AppBar(
          title: const Text('Country Code Detector Example'),
        ),
        body: Center(
          child: Column(mainAxisSize: MainAxisSize.min, children: [
            FutureBuilder<String?>(
              future: _countryDetector.isoCountryCode(),
              builder: (_, future) {
                if (future.connectionState == ConnectionState.done) {
                  return Text('ISO Country Code: ${future.data ?? ''}\n');
                }
                if (future.hasError) {
                  return const Text('Fetching ISO country code failed\n');
                }
                return const Text('Fetching ISO country code...\n');
              },
            ),
            FutureBuilder<AllCountries>(
              future: _countryDetector.detectAll(),
              builder: (_, future) {
                if (future.connectionState == ConnectionState.done) {
                  final allCodes = future.data ?? AllCountries();
                  String resultStr = '';
                  for (final code in allCodes.toMap().entries) {
                    resultStr += '${code.key}: ${code.value}\n';
                  }
                  return Text('$resultStr\n');
                }
                if (future.hasError) {
                  return const Text('Fetching all country codes failed\n');
                }
                return const Text('Fetching all country codes...\n');
              },
            ),
          ]),
        ),
      ),
    );
  }
}