Dieses Paket hilft bei der Erkennung von iOS-Simulatoren, Android-Emulatoren und Debug-Modus. Dieses Paket erkennt auch Mock-Location/Fake-GPS-Standort auf Android-Geräten. Prüfen Sie außerdem, ob das Gerät echt ist oder nicht.
Aus öffentlichen Paketdaten erstellte Orientierung.
Das safe_device-Paket hilft Entwicklern dabei, festzustellen, ob eine App in einer simulierten Umgebung wie dem iOS-Simulator, dem Android-Emulator oder im Debug-Modus läuft. Es erkennt auch gefälschte GPS-Positionen auf Android-Geräten und prüft, ob das Gerät echt ist. Dadurch wird die Sicherheit erhöht, indem unerlaubter Zugriff aus emulierten oder manipulierten Umgebungen verhindert wird. Das Paket ist nützlich für Anwendungen, die starke Geräteintegritätsprüfungen erfordern, insbesondere in Finanz- oder sensiblen Datenkontexten.
Anwendungsfälle
Sicherung von Apps gegen die Verwendung von Emulatoren
Erkennung von gefälschten GPS-Orten
Verhinderung der Ausnutzung des Debug-Modus
Überprüfung der Anwesenheit eines echten Geräts
Verbesserung der Betrugsdetektion
Schutz des Zugriffs auf sensible Daten
Hauptmerkmale
Erkennt iOS-Simulator
Erkennt Android-Emulator
Überprüfung des Debug-Modus
Erkennt MockLocation/Fake GPS
Überprüft die Echtheit des Geräts
Leichtgewichtig und plattformunabhängig
Geeignet für
Sicherheitsorientierte Anwendungen
Finanz- oder Bankanwendungen
Betrugspräventionsysteme
Apps, die Geräteintegrität erfordern
Entwickler, die Laufzeit-Sicherheit priorisieren
Mobile Apps mit hohen Sicherheitsanforderungen
Hinweise
Beschränkt auf die Plattformen Android und iOS
Verhindert nicht alle Arten von Spoofing
Beruht auf gerätespezifischen Indikatoren
Kann bei gerooteten Geräten Falschpositiv-Ergebnisse auslösen
Erforderliche Berechtigungsverwaltung unter Android
Original-README
Originaler README-Schnappschuss aus dem verknüpften Quell-Repository. Aktuelle Inhalte finden Sie im Repository.
safe_device (Null-Safety)
Flutter (Null-Safety) Jailbroken, root, emulator and mock location detection.
Getting Started
In your flutter project add the dependency:
dependencies:...safe_device:^1.4.1
Usage
Importing package
import'package:safe_device/safe_device.dart';
Configuration
You can configure the plugin at startup using SafeDevice.init and SafeDeviceConfig. This is useful if you want to disable automatic check such as the mock location detection.
import'package:safe_device/safe_device.dart';
import'package:safe_device/safe_device_config.dart';
voidmain() async {
SafeDevice.init(
SafeDeviceConfig(mockLocationCheckEnabled: false), // disables mock location check on Android
);
// ...rest of your app
}
It's not mandatory to configure the plugin at the start, if not provided a default configuration with everything enable is provided automatically
Using it
Checks whether device JailBroken on iOS/Android?
bool isJailBroken = awaitSafeDevice.isJailBroken;
(iOS ONLY) Enhanced jailbreak detection with custom path checking
Android: If mock location check is disabled via config, the check always returns false and no location updates are started. If enabled (default), the check is active.
iOS: The config is stored for future use but does not affect current detection logic. Mock location detection on iOS is based on jailbreak/emulator status.
(ANDROID ONLY) Check if application is running on external storage
Detects a wide range of Android emulators including:
Android SDK Emulator, Genymotion
LDPlayer, MEmu, BlueStacks, MuMu Player (NetEase), Nox, Droid4X
Known Limitations
Root and jailbreak detection is a best-effort approach. A determined attacker using tools such as Magisk Hide or Zygisk can bypass detection. This plugin is intended as a security layer — not a guarantee.
Device-specific handling: Some manufacturers (Samsung, Xiaomi, Vivo) ship with system properties or Knox security components that can cause false positives. The plugin applies conservative multi-indicator checks for these brands to balance accuracy and reliability.
Notes
Mock location detection
Android — Location permission is required to detect mock location. The check can be disabled at runtime via config.
iOS — Mock location detection is based on jailbreak/emulator status.
Development Mode
Development Options in emulator is always true by default.
❗Since emulators are usually rooted, you might want to bypass these checks during development. Unless you're keen on constant false alarms ⏰