rebeccahughes/react-native-device-info
6,669 Stars·1,461 Forks·TypeScript·MIT·5 Aufrufereact-native-device-info.github.io/react-native-device-info↗
React Native Device Info
This project is a cross-platform mobile device information library designed to retrieve hardware, software, and network specifications from iOS and Android devices. It serves as a tool for accessing unique device identifiers, hardware models, and processor architectures to distinguish individual mobile devices.
The library provides specialized capabilities for mobile hardware identification and operating system metadata retrieval, including build numbers and API levels. It also functions as a system state monitor for real-time tracking of battery levels, charging status, and network connectivity modes.
The project covers a broad surface of device analysis, including storage and memory metrics, display characteristics, and the detection of peripheral connectivity. It also includes utilities for verifying the execution environment to determine if an application is running on a physical device or an emulator, as well as tools for checking security lock configurations.
Features
- Device Identification Utilities - Provides specialized utilities for generating and retrieving unique hardware, software, and installation identifiers for mobile devices.
- Device Information Libraries - Provides a comprehensive toolset for retrieving hardware specifications, OS details, and unique identifiers across iOS and Android.
- Device and Hardware Identification - Identifies physical hardware properties, models, and vendors to help adapt the user interface and features.
- Installation Timestamps - Retrieves the initial installation timestamp, last update time, and installation referrer.
- Native API Bridges - Implements native API bridges to expose iOS and Android system functions to a cross-platform JavaScript codebase.
- Emulator Detection - Determines whether the application is running on a physical device or within an emulator.
- Device Hardware Accessors - Provides utilities for retrieving unique hardware identifiers, models, and processor architectures to distinguish individual mobile devices.
- Application Metadata - Provides utilities to retrieve app-specific metadata including version, build numbers, and installation timestamps.
- OS Versioning Tools - Provides utilities for detecting mobile operating system versions and API levels to ensure software compatibility.
- Runtime Environment Verification - Determines if a React Native application is running on a physical device or an emulator for testing and security.
- Hardware Specification Querying - Retrieves read-only summaries of hardware specifications including model, device type, and processor architectures.
- System Environment Retrievers - Fetches machine-specific configuration and OS metadata such as build numbers and system names.
- Mobile Resource Monitoring - Monitors battery levels and available storage space to optimize app behavior and prevent resource exhaustion.
- JNI Bridges - Uses JNI bridges to allow high-level logic to query low-level Android OS properties and hardware identifiers.
- Hardware Capability Detection - Automatically identifies hardware features, such as cameras or keyboards, to configure software resources.
- Peripheral Connectivity Detectors - Detects the connection status of external hardware peripherals like headphones, keyboards, and Bluetooth devices.
- Battery Status Monitors - Tracks battery levels, charging status, and power states to optimize application behavior.
- iOS Framework Integrations - Leverages CocoaTouch and other Apple system frameworks to retrieve device metadata and hardware characteristics.
- React Native Integrations - Implements technical instrumentation for React Native apps to collect hardware IDs and installation metadata for analytics.
- Disk Storage Metrics - Calculates the total disk capacity and the amount of free storage available on the device.
- Native-to-JS Thread Dispatching - Dispatches real-time hardware state changes from native background threads back to the JavaScript main thread.
- Platform-Specific API Implementations - Implements unified interfaces that map to platform-specific Java and Objective-C code for accessing device details.
- Device State Monitors - Tracks real-time device states including battery levels, charging status, and network connectivity modes.
- Memory Usage Analyzers - Tracks current memory consumption and maximum memory limits to prevent resource exhaustion.
- Storage and Memory Analysis - Calculates total disk capacity, available free storage, and current application memory consumption.
- System Setting Detectors - Detects system-level configuration flags such as airplane mode, location services, and screen brightness.
- Display Feature Detectors - Queries hardware-level display features including screen orientation, tablet mode, and physical notches.
- System Integration - Retrieve detailed hardware and software device information.
