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:
121
docs/ADB_WINDOWS_SETUP.md
Normal file
121
docs/ADB_WINDOWS_SETUP.md
Normal 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)
|
||||
Reference in New Issue
Block a user