3c43d2636d
- WSL에서 Windows ADB 사용 방법 - 환경 변수 설정 - 문제 해결 가이드 Ultraworked with [Sisyphus](https://github.com/code-yeongyu/oh-my-opencode) Co-authored-by: Sisyphus <clio-agent@sisyphuslabs.ai>
3.1 KiB
3.1 KiB
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 환경 변수
# =========================
# 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 리다이렉트 함수
# =========================
# adb를 윈도우로 리다이렉트
# =========================
adb() {
/mnt/c/Users/work/AppData/Local/Android/Sdk/platform-tools/adb.exe "$@"
}
참고:
work부분을 실제 Windows 사용자명으로 변경하세요.
사용 방법
1. 기기 연결 확인
# USB로 Android 기기 연결 후
adb devices
2. APK 설치
# 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. 기타 유용한 명령어
# 기기 재부팅
adb reboot
# 로그 확인
adb logcat
# 파일 전송
adb push <로컬경로> <기기경로>
# 스크린샷
adb shell screencap -p /sdcard/screenshot.png
adb pull /sdcard/screenshot.png
Windows PATH에 ADB 추가 (선택사항)
Windows 시스템 환경 변수에 다음 경로를 추가하면 adb 명령어를 어디서든 사용할 수 있습니다:
- Windows 검색에서 "환경 변수" 검색
- "시스템 환경 변수 편집" 클릭
- "환경 변수" 버튼 클릭
- "시스템 변수"에서
Path선택 후 "편집" - "새로 만들기" 클릭 후 다음 경로 추가:
%LOCALAPPDATA%\Android\Sdk\platform-tools - 확인을 눌러 저장
문제 해결
"unauthorized" 오류
- Android 기기에서 USB 디버깅 권한을 허용했는지 확인
- 기기에서 "항상 이 컴퓨터에서 허용" 체크
"device not found" 오류
- USB 케이블 연결 상태 확인
- USB 드라이버 설치 확인 (제조사별 드라이버 필요)
adb kill-server후adb start-server실행
WSL에서 권한 오류
# adb 실행 권한 부여
chmod +x /mnt/c/Users/$USER/AppData/Local/Android/Sdk/platform-tools/adb.exe