VS Code로 Flutter 안드로이드 앱 만들기 — 개요

무선 디버깅 (Wi-Fi ADB)

#android #wifi #무선디버깅 #adb

@devpc | 2026-04-01 23:22:53 |

Context:

Flow v1 → Node v1

# 무선 디버깅 (Wi-Fi ADB)

USB 케이블 없이 같은 Wi-Fi 네트워크에서 디버깅하는 방법입니다.

## Android 11 이상 — 무선 디버깅 (권장)

Android 11부터는 설정에서 바로 무선 디버깅을 지원합니다.

### 방법 1 — QR 코드 페어링

1. 폰: **설정 → 개발자 옵션 → 무선 디버깅** ON
2. **"QR 코드로 기기 페어링"** 탭
3. PC 터미널에서:
   ```bash
   adb pair
   ```
4. QR 코드 또는 표시된 IP:포트와 페어링 코드 입력
5. 페어링 성공 후:
   ```bash
   adb connect {폰의 IP}:{무선디버깅 포트}
   ```

### 방법 2 — 페어링 코드

1. 폰: **설정 → 개발자 옵션 → 무선 디버깅 → "페어링 코드로 기기 페어링"**
2. 화면에 표시된 **IP 주소:포트, 페어링 코드** 확인
3. PC 터미널:
   ```bash
   adb pair {IP}:{포트}
   # 페어링 코드 입력
   ```
4. 페어링 후 연결:
   ```bash
   adb connect {IP}:{무선디버깅 포트}
   ```

## Android 10 이하 — USB로 페어링 후 Wi-Fi 전환

1. 먼저 USB로 기기 연결 및 인식 확인
2. 폰의 IP 주소 확인 (설정 → Wi-Fi → 현재 네트워크 → IP 주소)
3. ADB Wi-Fi 모드로 전환:
   ```bash
   adb tcpip 5555
   adb connect {폰의 IP}:5555
   ```
4. USB 케이블 제거
5. 연결 확인:
   ```bash
   adb devices
   ```

## 연결 후 Flutter 실행

```bash
flutter devices   # 무선 연결된 기기 확인
flutter run
```

## 자주 발생하는 문제

| 문제 | 해결 방법 |
|---|---|
| 연결은 되지만 끊김 | PC와 폰이 같은 Wi-Fi에 연결되어 있는지 확인 |
| 페어링 후 connect 실패 | 무선 디버깅 화면의 IP와 포트를 다시 확인 |
| 속도가 느림 | 5GHz Wi-Fi 사용 권장 |

무선 디버깅 (Wi-Fi ADB)

// COMMENTS

ON THIS PAGE