Pakete, Repositories und App-Kategorien suchen

Paketdetailsv1.4.0

device_region

Dieses Plugin verwendet plattformspezifische APIs, um den SIM-Ländercode zurückzugeben

AndroidiOSWindowsLinux
30-Tage-Downloads
18.300
Likes
26
Pub-Punkte
150

Paket installieren

flutter pub add device_region

Paketübersicht

Aus öffentlichen Paketdaten erstellte Orientierung.

Das device_region-Paket ruft den SIM-Landecode mithilfe plattformspezifischer APIs unter Android, iOS, Windows und Linux ab. Es bietet eine einfache, plattformübergreifende Möglichkeit, das Land zu bestimmen, das mit der SIM-Karte des Geräts verbunden ist, was nützlich für Lokalisierung, regionbasierte Inhaltsbereitstellung oder Compliance-Prüfungen ist. Der Plugin abstrahiert die nativen Implementierungsdetails und bietet eine konsistente Dart-Schnittstelle über alle Plattformen hinweg. Es erfordert keinen Internetzugang und arbeitet direkt aus gerätebezogenen Daten.

Anwendungsfälle

  • Bestimmung des Landes des Benutzers basierend auf der SIM-Karte
  • Lokalisierung von App-Inhalten nach Region
  • Regionale Beschränkungen durchsetzen
  • Standardland in Formularen automatisch festlegen
  • Unterstützung mehrerer Regionen für Anwendungen

Hauptmerkmale

  • Plattformübergreifende Unterstützung (Android, iOS, Windows, Linux)
  • Verwendet native SIM-Ländercodes-APIs
  • Keine Internetverbindung erforderlich
  • Einfaches, leichtgewichtiges API
  • Gibt ISO 3166-1 alpha-2-Ländercodes zurück

Geeignet für

  • Apps, die regionale Erkennung ohne GPS benötigen
  • Reise- oder Zahlungsanwendungen, die Landeskontext erfordern
  • Lokalisierungs-Frameworks
  • Offline-first-Anwendungen
  • Entwickler, die mehrere Plattformen ansprechen

Hinweise

  • Beruht auf Vorhandensein der SIM-Karte; kann null zurückgeben, wenn keine SIM vorhanden ist
  • Funktioniert nicht auf Geräten ohne SIM (z. B. Tablets)
  • Der Ländercode spiegelt möglicherweise die aktuelle Position des Benutzers nicht wider
  • Beschränkt auf SIM-basierte Länderidentifikation
  • Kann auf einigen Plattformen Laufzeitberechtigungen erfordern

Original-README

Originaler README-Schnappschuss aus dem verknüpften Quell-Repository. Aktuelle Inhalte finden Sie im Repository.

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.

Kategorien

Quell-Repository

Projekte, die dieses Paket verwenden