sim_card_code 0.0.9

A Flutter plugin for accessing SIM card and getting Phone number Country Code.

Sim Card Info Plugin

A comprehensive Flutter plugin that provides extensive access to SIM card and network information across iOS and Android platforms. Get detailed information about SIM cards, network operators, device identifiers, and dual SIM support.

📋 Features

SIM Card Information

• Country Code: Retrieve SIM card country code in ISO format (e.g., "US", "UK", "IN")
• Operator Details: Get SIM operator name and operator code
• Serial Number: Access SIM card serial number (ICCID)
• Phone Number: Retrieve the phone number associated with the SIM
• SIM State: Check current SIM card state (READY, ABSENT, PIN_REQUIRED, etc.)
• SIM Presence: Detect if a SIM card is present in the device

Network Information

• Network Operator: Get current network operator name
• Network Country: Retrieve network country code
• Network Type: Identify network technology (LTE, 5G, HSPA, EDGE, etc.)
• Roaming Status: Check if device is currently roaming

Dual SIM Support

• SIM Count: Get total number of SIM slots
• Dual SIM Detection: Check if device supports dual SIM
• All SIM Info: Retrieve detailed information for all active SIM cards
• Multi-SIM Management: Handle multiple subscriptions and SIM slots

Device Information

• Device ID: Get device IMEI/MEID identifier

🔧 Installation

Add sim_card_code to your pubspec.yaml:

dependencies:
  sim_card_code: ^latest_version

Then run:

flutter pub get

📱 Platform Support

Platform	Support
Android	✅
iOS (9.0+)	✅
Web	❌
macOS	❌
Windows	❌
Linux	❌

🔐 Permissions

Android

Add the following permission to your android/app/src/main/AndroidManifest.xml:

<uses-permission android:name="android.permission.READ_PHONE_STATE" />

iOS

No additional setup required for iOS 9.0 - 13.x.

🚀 Usage

Import the package:

import 'package:sim_card_code/sim_card_code.dart';

Basic SIM Information

// Get SIM country code
try {
  final countryCode = await SimCardManager.simCountryCode;
  print('SIM Country Code: $countryCode'); // Output: "US", "UK", "IN"
} catch (e) {
  print('Error getting country code: $e');
}

// Get SIM operator name
try {
  final operatorName = await SimCardManager.simOperatorName;
  print('SIM Operator: $operatorName'); // Output: "Verizon", "Vodafone", etc.
} catch (e) {
  print('Error getting operator name: $e');
}

// Get SIM operator code
try {
  final operatorCode = await SimCardManager.simOperatorCode;
  print('Operator Code: $operatorCode'); // Output: "310260", etc.
} catch (e) {
  print('Error getting operator code: $e');
}

SIM State and Presence

// Check if SIM card is present
try {
  final hasSimCard = await SimCardManager.hasSimCard;
  print('Has SIM Card: $hasSimCard');
} catch (e) {
  print('Error checking SIM presence: $e');
}

// Get SIM state
try {
  final simState = await SimCardManager.simState;
  print('SIM State: $simState'); // READY, ABSENT, PIN_REQUIRED, etc.
} catch (e) {
  print('Error getting SIM state: $e');
}

Network Information

// Get network operator name
try {
  final networkOperator = await SimCardManager.networkOperatorName;
  print('Network Operator: $networkOperator');
} catch (e) {
  print('Error getting network operator: $e');
}

// Get network country code
try {
  final networkCountryCode = await SimCardManager.networkCountryCode;
  print('Network Country Code: $networkCountryCode');
} catch (e) {
  print('Error getting network country code: $e');
}

// Get network type
try {
  final networkType = await SimCardManager.networkType;
  print('Network Type: $networkType'); // LTE, HSPA, EDGE, etc.
} catch (e) {
  print('Error getting network type: $e');
}

// Check roaming status
try {
  final isRoaming = await SimCardManager.isRoaming;
  print('Is Roaming: $isRoaming');
} catch (e) {
  print('Error checking roaming status: $e');
}

Dual SIM Support

// Check if device supports dual SIM
try {
  final isDualSim = await SimCardManager.isDualSim;
  print('Is Dual SIM: $isDualSim');
} catch (e) {
  print('Error checking dual SIM support: $e');
}

// Get SIM count
try {
  final simCount = await SimCardManager.simCount;
  print('SIM Count: $simCount');
} catch (e) {
  print('Error getting SIM count: $e');
}

// Get all SIM information
try {
  final allSimInfo = await SimCardManager.getAllSimInfo;
  for (var simInfo in allSimInfo) {
    print('Slot Index: ${simInfo['slotIndex']}');
    print('Subscription ID: ${simInfo['subscriptionId']}');
    print('Display Name: ${simInfo['displayName']}');
    print('Carrier Name: ${simInfo['carrierName']}');
    print('Country ISO: ${simInfo['countryIso']}');
    print('Phone Number: ${simInfo['phoneNumber']}');
    print('Is Roaming: ${simInfo['isNetworkRoaming']}');
    print('---');
  }
} catch (e) {
  print('Error getting all SIM info: $e');
}

Sensitive Information (Requires Permissions)

// Get SIM serial number (ICCID)
try {
  final serialNumber = await SimCardManager.simSerialNumber;
  print('SIM Serial Number: $serialNumber');
} catch (e) {
  print('Error getting SIM serial number: $e');
}

// Get phone number
try {
  final phoneNumber = await SimCardManager.phoneNumber;
  print('Phone Number: $phoneNumber');
} catch (e) {
  print('Error getting phone number: $e');
}

// Get device ID (IMEI/MEID)
try {
  final deviceId = await SimCardManager.deviceId;
  print('Device ID: $deviceId');
} catch (e) {
  print('Error getting device ID: $e');
}

📊 SIM States

The plugin returns the following SIM states:

State	Description
READY	SIM card is ready for use
ABSENT	No SIM card detected
PIN_REQUIRED	SIM card requires PIN entry
PUK_REQUIRED	SIM card requires PUK entry
NETWORK_LOCKED	SIM card is network locked
NOT_READY	SIM card is not ready
PERM_DISABLED	SIM card is permanently disabled
CARD_IO_ERROR	SIM card I/O error
CARD_RESTRICTED	SIM card is restricted
UNKNOWN	Unknown SIM state

🌐 Network Types

The plugin identifies the following network types:

Type	Description
LTE	4G LTE network
HSPA	High Speed Packet Access
HSDPA	High Speed Downlink Packet Access
HSUPA	High Speed Uplink Packet Access
HSPAP	Evolved High Speed Packet Access
UMTS	Universal Mobile Telecommunications System
EDGE	Enhanced Data rates for GSM Evolution
GPRS	General Packet Radio Service
CDMA	Code Division Multiple Access
EVDO_0	Evolution-Data Optimized Rev 0
EVDO_A	Evolution-Data Optimized Rev A
1xRTT	Single Carrier Radio Transmission Technology
EHRPD	Evolved High Rate Packet Data
UNKNOWN	Unknown network type

⚠️ Error Handling

The plugin may return null in the following cases:

• No SIM card is detected
• The device doesn't support the requested functionality
• Required permissions are not granted
• Any other error occurs during execution

All methods may throw exceptions with specific error codes:

Error Code	Description
PERMISSION_DENIED	Required permissions not granted
SIM_*_ERROR	Specific SIM-related errors
NETWORK_*_ERROR	Network-related errors

Always wrap your calls in try-catch blocks to handle exceptions gracefully.

🔒 Privacy Considerations

⚠️ Important: This plugin accesses sensitive device and SIM information. Some methods require the READ_PHONE_STATE permission and may return personally identifiable information such as:

• Phone numbers
• Device IMEI/MEID
• SIM serial numbers

Compliance Requirements:

• Ensure you comply with your app store's privacy policies
• Inform users about data collection in your privacy policy
• Only collect necessary information for your app's functionality
• Follow GDPR, CCPA, and other applicable data protection regulations

💖 Support

If you find this plugin helpful, consider supporting the development:

📞 Contact

For bugs or feature requests, please create an issue on the GitHub repository.

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.