React Native
Wireless Debugging Guide

A practical troubleshooting guide for running React Native applications on a physical Android device using wireless ADB.

Note

This guide is based on an Android 8.1.0 device. Commands and settings may differ on newer Android versions.

Device Information

ComponentDetails
DeviceAndroid Device
Android VersionAndroid 8.1.0
Debugging MethodADB over Wi-Fi (TCP/IP)
ADB Port5555
Operating SystemWindows 10
FrameworkReact Native
Metro0.84.4
Java17.0.18
ADB36.0.0-13206524
Important

This device uses an older Android version and does not provide the newer Android Wireless Debugging / pairing workflow found on modern Android versions. This guide uses the traditional ADB TCP/IP method:

bash 
adb tcpip 5555
adb connect PHONE_IP:5555
Tip

The phone's IP address may change depending on the Wi-Fi network. Do not assume that 192.168.1.15 will always be the correct IP address.

I recommend keeping the exact ADB, Java, Metro, and OS versions because they make the guide more reproducible for someone debugging the same type of setup.

What This Guide Covers

Wireless ADB Setup
Step-by-step instructions for connecting the device to a Windows PC over Wi-Fi using ADB TCP/IP mode.
ADB Connection Problems
Error 10060, offline status, no device, multiple devices, ADB reverse failures, and more.
SDK Problems
SDK location not found, incorrect paths, missing components, Java version issues, and Gradle cleanup.
APK Installation
InstallException: EOF, insufficient storage, manual installation, and diagnostic techniques.
Metro & Port 8081
Metro not running, port conflicts, Windows Firewall, router isolation, and IP address confusion.
Troubleshooting Flow
Decision trees and stage identification to quickly isolate the root cause.

Quick Start

If you already have USB debugging enabled and ADB installed, the essential commands are:

bash 
adb devices
adb tcpip 5555
adb shell ip addr show wlan0
adb connect PHONE_IP:5555
adb devices
npx react-native run-android
Tip

You normally only need the USB connection for the initial adb tcpip 5555 setup. After that, you can use ADB wirelessly as long as the phone and PC can communicate over the same network.