Buscar pacotes, repositórios e categorias de apps

Capa de safe_device
Detalhes do pacotev1.4.1

safe_device

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.

AndroidiOS
Downloads em 30 dias
147 mil
Curtidas
386
Pontos Pub
140

Instalar pacote

flutter pub add safe_device

Visão geral do pacote

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)

Safe Device Safe Device 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';

void main() 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 = await SafeDevice.isJailBroken;

(iOS ONLY) Enhanced jailbreak detection with custom path checking

bool isJailBrokenCustom = await SafeDevice.isJailBrokenCustom;

(iOS ONLY) Get detailed breakdown of jailbreak detection methods

Map<String, bool> details = await SafeDevice.jailbreakDetails;

Checks whether device is real or emulator

bool isRealDevice = await SafeDevice.isRealDevice;

bool isMockLocation = await SafeDevice.isMockLocation;

bool isMockLocation = await SafeDevice.isMockLocation;

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

bool isOnExternalStorage = await SafeDevice.isOnExternalStorage;

Check if device violates any of the above

bool isSafeDevice = await SafeDevice.isSafeDevice;

(ANDROID ONLY) Check if development Options is enable on device

bool isDevelopmentModeEnable = await SafeDevice.isDevelopmentModeEnable;

(ANDROID ONLY) Get detailed breakdown of root detection methods for debugging

Map<String, dynamic> rootDetails = await SafeDevice.rootDetectionDetails;

Enhanced iOS Jailbreak Detection

The plugin includes enhanced jailbreak detection for iOS with comprehensive path checking. The custom detection method checks for:

Jailbreak Tool Paths
  • Cydia and package managers (/Applications/Cydia.app, /private/var/lib/apt, etc.)
  • System binaries commonly found on jailbroken devices (/bin/bash, /usr/sbin/sshd, etc.)
  • MobileSubstrate files (/Library/MobileSubstrate/MobileSubstrate.dylib)
  • APT package manager files (/etc/apt, /var/lib/dpkg/status)
  • Launch daemons (/System/Library/LaunchDaemons/com.saurik.Cydia.Startup.plist)
  • Palera1n rootless jailbreak indicators (/var/jb/.installed_palera1n, etc.)
Detection Methods
  • Path Existence: Checks for files and directories commonly present on jailbroken devices
  • URL Scheme Detection: Tests if jailbreak-related URL schemes can be opened (cydia://, sileo://, zebra://, etc.)
  • Sandbox Violation: Attempts to write outside the app sandbox
  • Environment Variables: Checks for jailbreak-related environment variables
  • Symbolic Link Detection: Looks for suspicious symbolic links
  • Process Detection: Checks for running jailbreak-related processes
Platform Notes
  • Simulator: Always returns false — no jailbreak detection runs on simulator
  • Mac Catalyst: Always returns false — macOS filesystem structure differs from iOS
Usage Example
// Basic jailbreak detection (uses both DTTJailbreakDetection and custom detection)
bool isJailbroken = await SafeDevice.isJailBroken;

// Custom detection only (comprehensive path checking)
bool isJailbrokenCustom = await SafeDevice.isJailBrokenCustom;

// Detailed breakdown of detection methods
Map<String, dynamic> details = await SafeDevice.jailbreakDetails;
// Returns:
// {
//   "isSimulator": false,
//   "isDevelopmentEnvironment": false,
//   "hasObviousJailbreakSigns": false,
//   "dttResult": false,
//   "customResult": false,
//   "finalResult": false
// }

Android Emulator Detection

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 ⏰

Categorias

Repositório-fonte

Projetos que usam este pacote