docs: ADB Windows 연결 설정 가이드 추가

- WSL에서 Windows ADB 사용 방법
- 환경 변수 설정
- 문제 해결 가이드

Ultraworked with [Sisyphus](https://github.com/code-yeongyu/oh-my-opencode)
Co-authored-by: Sisyphus <clio-agent@sisyphuslabs.ai>
This commit is contained in:
sanjeok77
2026-03-05 04:18:35 +09:00
parent 08be7c53d5
commit 3c43d2636d

121
docs/ADB_WINDOWS_SETUP.md Normal file
View File

@@ -0,0 +1,121 @@
# 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)