Buscar pacotes, repositórios e categorias de apps

Detalhes do pacotev1.4.0

device_region

Este plugin usa a API específica da plataforma para retornar o código do país do SIM

AndroidiOSWindowsLinux
Downloads em 30 dias
18,3 mil
Curtidas
26
Pontos Pub
150

Instalar pacote

flutter pub add device_region

Visão geral do pacote

Orientação gerada a partir de informações públicas. Apenas para referência.

O pacote device_region recupera o código do país da SIM usando APIs específicas da plataforma no Android, iOS, Windows e Linux. Ele fornece uma maneira simples e multiplataforma para determinar o país associado ao cartão SIM do dispositivo, útil para localização, entrega de conteúdo baseada em região ou verificações de conformidade. O plugin abstrai os detalhes da implementação nativa, oferecendo uma interface Dart consistente entre plataformas. Não requer acesso à internet e opera diretamente a partir dos dados do nível do dispositivo.

Casos de uso

  • Determinando o país do usuário com base no cartão SIM
  • Localizando o conteúdo do aplicativo por região
  • Aplicando restrições específicas por região
  • Definindo automaticamente o país padrão em formulários
  • Suporte a aplicativos multi-região

Principais recursos

  • Suporte multiplataforma (Android, iOS, Windows, Linux)
  • Usa APIs nativas de código de país do SIM
  • Sem necessidade de internet
  • API simples e leve
  • Retorna códigos de país ISO 3166-1 alpha-2

Indicado para

  • Aplicativos que precisam de detecção regional sem GPS
  • Aplicativos de viagem ou pagamento que exigem contexto de país
  • frameworks de localização
  • Aplicações com foco em offline
  • Desenvolvedores direcionados para múltiplas plataformas

Considerações

  • Depende da presença do cartão SIM; pode retornar nulo se não houver SIM
  • Não funciona em dispositivos sem SIM (por exemplo, tablets)
  • O código do país pode não refletir a localização atual do usuário
  • Limitado à identificação de país baseada em SIM
  • Pode exigir permissões em tempo de execução em algumas plataformas

README original

Snapshot do README original do repositório-fonte vinculado. Consulte o repositório para o conteúdo mais recente.

device_region

A Flutter plugin which uses platform-specific API to return a SIM country code. Supports iOS and Android.

Installation

In your Flutter project, in pubspec.yaml file add the dependency:

dependencies:
  device_region: ^1.4.0

Usage example

Import device_region.dart package.

import 'package:device_region/device_region.dart';
Get SIM country code

Call getSIMCountryCode method to receive SIM country code.

await DeviceRegion.getSIMCountryCode();
Android:

Using TelephonyManager class:

Returns simCountryIso if available. Otherwise, it should return networkCountryIso.

In case the value cannot be retrieved or an error occurs, null value will be returned

iOS:
iOS 16.0 and higher

Due to deprecated properties in CTTelephonyNetworkInfo class, plugin uses Locale class and returns Locale.current.region.identifier.

iOS up to 16.0

Using CTTelephonyNetworkInfo class:

Returns isoCountryCode if available.

In case the value cannot be retrieved or an error occurs, null value will be returned

Important notes

  • While call getSIMCountryCode on iOS (up to 16.0), it returns proper country code and can throw error log in debugger as below:
[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.}

It's well known bug on iOS and it does not affect the operation of the application.

  • Method returns null in case if for some reason it was not possible to retrieve the information from the SIM slot. So it will return null i.e on iOS simulators and devices without SIM card inserted.

  • On iOS, it only works from 12.0 and above. For lower versions it will return null.

Categorias

Repositório-fonte

Projetos que usam este pacote