Skip to main content

​
Overview

NativeBridge provides an enterprise-grade debugging toolkit that gives developers and QA engineers unprecedented access to mobile devices for comprehensive application analysis. Our debugging suite offers the same level of control as physical device access, enabling efficient troubleshooting, performance optimization, and quality assurance workflows.

Real Device Access

Direct interaction with actual iOS and Android devices in the cloud

Advanced Diagnostics

Professional-grade tools for deep system analysis and debugging

File Management

Complete file system access for data inspection and manipulation

Remote Development

Full ADB connectivity for development and debugging workflows

​
Core Debugging Features

​
File Transfer System

​
Send Files to Device

Transfer any file type directly to your test device for comprehensive testing scenarios:
1

Access File Transfer

Navigate to the Send files to device button on the session screen or magic link page
2

Select Files

Choose single or multiple files from your local system (supports drag-and-drop)
3

Configure Destination

Specify the target directory on the device or use default app storage
4

Transfer & Verify

Monitor transfer progress and verify file integrity on the device
Use Cases:
  • Test document imports and exports
  • Validate file handling capabilities
  • Load test data and configurations
  • Deploy debug certificates and profiles
File Size Limits: Standard plans support files up to 100MB. Enterprise plans have unlimited file transfer capabilities.

​
Multi-App Testing Environment

​
Upload Multiple Applications

Test complex app interactions and dependencies within a single session:
  • Setup Process
  • Common Scenarios
  • Limitations
  1. Launch your primary application session
  2. Click Upload Another App in the control panel
  3. Select additional APK/IPA files to install
  4. Apps install sequentially with progress tracking
  5. Switch between apps seamlessly during testing

​
Device Shell Access

​
Command-Line Interface

Direct terminal access to device systems for advanced debugging:
  • System Commands: Execute standard Unix/Linux commands
  • Process Management: Monitor and control running processes
  • Network Diagnostics: Run ping, netstat, and trace commands
  • Package Management: Install, update, and remove packages
  • Permission Inspection: Review and modify app permissions
Different permission tiers based on your subscription:Basic Access:
  • Read-only system information
  • Application-specific directories
  • Basic network diagnostics
Advanced Access:
  • Write permissions to app directories
  • Process manipulation capabilities
  • Extended system diagnostics
Root Access (Enterprise):
  • Full system access
  • Kernel-level debugging
  • System file modifications
  • All shell sessions are logged and audited
  • Isolated environments prevent cross-contamination
  • Automatic session timeouts for security
  • Encrypted command transmission
Security Notice: Shell access is monitored and logged. Attempting to access restricted areas or perform unauthorized operations will result in immediate session termination.

​
File System Explorer

​
Visual File Management

Browse and manage device file systems through an intuitive interface:

Navigation Features

  • Hierarchical directory browsing
  • Quick search and filtering
  • Breadcrumb navigation
  • Bookmark frequently used paths

File Operations

  • Create, rename, and delete files
  • Edit text files in-browser
  • View image and media files
  • Download files to local system

Advanced Tools

  • Batch operations support
  • File permission management
  • Symbolic link creation
  • Archive extraction and creation

Integration

  • Direct ADB file push/pull
  • Clipboard synchronization
  • Drag-and-drop upload
  • Context menu actions

​
System Logging

​
Comprehensive Log Management

Access and analyze all system and application logs in real-time:
  • Log Levels
  • Filtering Options
  • Export Formats
VERBOSE  - All messages including debug details
DEBUG    - Debugging messages and application flow
INFO     - Informational messages and events
WARNING  - Potentially harmful situations
ERROR    - Error events and exceptions
FATAL    - Critical errors causing termination
Advanced Features:
  • Real-time streaming with minimal latency
  • Color-coded severity levels
  • Regular expression pattern matching
  • Log persistence across sessions
  • Automatic log rotation and archival

​
ADB Connectivity

​
Professional Development Bridge

Connect to cloud devices as if they were physically connected to your workstation:
1

Generate Connection

Click Connect with ADB to generate unique connection credentials
2

Configure Local ADB

adb connect device-id.nativebridge.io:5555
3

Authenticate

Enter the provided authentication token when prompted
4

Start Development

Use all standard ADB commands as with a local device
Pro Tip: Save frequently used devices as environment variables for quick reconnection:
export NATIVE_BRIDGE_DEVICE="device-id.nativebridge.io:5555"
adb connect $NATIVE_BRIDGE_DEVICE

​
Supported ADB Operations

Development

  • Install/uninstall apps
  • Deploy debug builds
  • Run instrumentation tests
  • Profile performance

Debugging

  • Attach debuggers
  • Inspect databases
  • Monitor network traffic
  • Capture heap dumps

Automation

  • Execute UI tests
  • Record/replay sessions
  • Capture screenshots
  • Generate bug reports

​
Advanced Debugging Workflows

​
Performance Profiling

Monitor CPU usage and identify performance bottlenecks:
  • Method-level profiling
  • Thread activity analysis
  • Call stack visualization
  • Flame graph generation
Track memory allocation and detect leaks:
  • Heap dump analysis
  • Allocation tracking
  • Reference chain inspection
  • Memory pressure simulation
Analyze network traffic and API calls:
  • Request/response inspection
  • Bandwidth usage tracking
  • Latency measurements
  • SSL/TLS debugging
Optimize rendering and UI performance:
  • Frame rate monitoring
  • GPU usage analysis
  • Overdraw detection
  • Layout hierarchy inspection

​
Integration Capabilities

​
CI/CD Pipeline Integration

Incorporate debugging tools into automated workflows: 
# Example GitHub Actions Integration
- name: Debug Failed Tests
  if: failure()
  run: |
    native-bridge debug \
      --session-id ${{ env.SESSION_ID }} \
      --capture-logs \
      --screenshot \
      --heap-dump

​
IDE Plugins

The debugging tools integrate with popular development environments. Please check the main platform documentation for current integration options.

​
Best Practices

​
Debugging Strategy

Recommended Workflow: Start with high-level logs, then progressively dive deeper using specialized tools as you narrow down the issue.
  1. Initial Triage: Review system logs for obvious errors
  2. Reproduce Issue: Use session recording to capture the problem
  3. Deep Analysis: Employ specific tools based on issue type
  4. Root Cause: Use shell and file system access for investigation
  5. Verification: Confirm fix using automated tests

​
Security Guidelines

  • Always use secure connections for ADB access
  • Rotate authentication tokens regularly
  • Limit debug access to development environments
  • Sanitize logs before sharing externally
  • Follow data protection regulations for user data

​
Troubleshooting

IssueSolution
ADB connection timeoutCheck firewall settings and authentication token
File upload failuresVerify file size limits and storage quota
Shell access deniedConfirm subscription tier and permissions
Log streaming interruptionCheck network stability and reconnect
File system not loadingClear browser cache and reload session
For additional documentation and support resources, please check the main platform documentation or contact your system administrator.