# ADB Windows 연결 설정 가이드

## 개요
WSL(Windows Subsystem for Linux) 환경에서 Windows용 ADB를 사용하여 Android 기기에 연결하는 방법을 설명합니다.

## 사전 요구사항
- Windows 10/11
- WSL2 설치됨
- Android SDK Platform Tools (Windows용)

## ADB 설치 위치

### Windows 기본 경로
```
C:\Users\[사용자명]\AppData\Local\Android\Sdk\platform-tools\adb.exe
```

### WSL에서의 경로
```
/mnt/c/Users/[사용자명]/AppData/Local/Android/Sdk/platform-tools/adb.exe
```

## .bashrc 설정 내용

### Android SDK 환경 변수
```bash
# =========================
# Android SDK
# =========================

export ANDROID_HOME="$HOME/Android/Sdk"
export ANDROID_SDK_ROOT="$HOME/Android/Sdk"

export PATH="$ANDROID_HOME/platform-tools:$PATH"
export PATH="$ANDROID_HOME/cmdline-tools/latest/bin:$PATH"
export PATH="$ANDROID_HOME/emulator:$PATH"
export PATH="$ANDROID_HOME/build-tools/34.0.0:$PATH"
export PATH="$HOME/.local/bin:$PATH"
```

### ADB Windows 리다이렉트 함수
```bash
# =========================
# adb를 윈도우로 리다이렉트
# =========================
adb() {
    /mnt/c/Users/work/AppData/Local/Android/Sdk/platform-tools/adb.exe "$@"
}
```

> **참고**: `work` 부분을 실제 Windows 사용자명으로 변경하세요.

## 사용 방법

### 1. 기기 연결 확인
```bash
# USB로 Android 기기 연결 후
adb devices
```

### 2. APK 설치
```bash
# Debug APK 설치
adb install app/build/outputs/apk/debug/app-debug.apk

# 또는 Windows 경로 직접 사용
/mnt/c/Users/$USER/AppData/Local/Android/Sdk/platform-tools/adb.exe \
    install app/build/outputs/apk/debug/app-debug.apk
```

### 3. 기타 유용한 명령어
```bash
# 기기 재부팅
adb reboot

# 로그 확인
adb logcat

# 파일 전송
adb push <로컬경로> <기기경로>

# 스크린샷
adb shell screencap -p /sdcard/screenshot.png
adb pull /sdcard/screenshot.png
```

## Windows PATH에 ADB 추가 (선택사항)

Windows 시스템 환경 변수에 다음 경로를 추가하면 `adb` 명령어를 어디서든 사용할 수 있습니다:

1. Windows 검색에서 "환경 변수" 검색
2. "시스템 환경 변수 편집" 클릭
3. "환경 변수" 버튼 클릭
4. "시스템 변수"에서 `Path` 선택 후 "편집"
5. "새로 만들기" 클릭 후 다음 경로 추가:
   ```
   %LOCALAPPDATA%\Android\Sdk\platform-tools
   ```
6. 확인을 눌러 저장

## 문제 해결

### "unauthorized" 오류
- Android 기기에서 USB 디버깅 권한을 허용했는지 확인
- 기기에서 "항상 이 컴퓨터에서 허용" 체크

### "device not found" 오류
- USB 케이블 연결 상태 확인
- USB 드라이버 설치 확인 (제조사별 드라이버 필요)
- `adb kill-server` 후 `adb start-server` 실행

### WSL에서 권한 오류
```bash
# adb 실행 권한 부여
chmod +x /mnt/c/Users/$USER/AppData/Local/Android/Sdk/platform-tools/adb.exe
```

## 참고 링크
- [Android Studio 다운로드](https://developer.android.com/studio)
- [ADB 공식 문서](https://developer.android.com/studio/command-line/adb)
- [Platform Tools 다운로드](https://developer.android.com/studio/releases/platform-tools)