Este pacote ajuda a detectar o simulador do iOS, o emulador do Android e o modo de depuração. Este pacote também detecta localização falsa/localização por GPS falso em dispositivos Android. Verifique também se o dispositivo é real ou não.
Orientação gerada a partir de informações públicas. Apenas para referência.
O pacote safe_device ajuda os desenvolvedores a detectar se um aplicativo está sendo executado em um ambiente simulado, como o iOS Simulator, o Android Emulator ou em modo de depuração. Também identifica localizações falsas do GPS em dispositivos Android e determina se o dispositivo é genuíno. Isso aumenta a segurança ao impedir o acesso não autorizado de ambientes emulados ou falsificados. O pacote é útil para aplicações que exigem verificações fortes de integridade do dispositivo, especialmente em contextos financeiros ou de dados sensíveis.
Casos de uso
Protegendo aplicativos contra o uso de emuladores
Detectando localizações falsas do GPS
Evitando a exploração do modo de depuração
Validando a presença de dispositivo real
Melhorando a detecção de fraudes
Protegendo o acesso a dados sensíveis
Principais recursos
Detecta o simulador do iOS
Identifica o Emulador Android
Verifica o modo de depuração
Detecta Localização Falsa/GPS Falso
Verifica a autenticidade do dispositivo
Leve e independente de plataforma
Indicado para
Aplicações focadas em segurança
Aplicativos financeiros ou bancários
Sistemas de prevenção de fraude
Aplicativos que exigem integridade do dispositivo
Desenvolvedores priorizando segurança em tempo de execução
Aplicativos móveis com requisitos de segurança elevados
Considerações
Limitado às plataformas Android e iOS
Não impede todas as formas de spoofing
Depende de indicadores específicos do dispositivo
Pode acionar falsos positivos em dispositivos rooteados
Requer gerenciamento adequado de permissões no Android
README original
Snapshot do README original do repositório-fonte vinculado. Consulte o repositório para o conteúdo mais recente.
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 ⏰