diff --git a/docs/ADB_WINDOWS_SETUP.md b/docs/ADB_WINDOWS_SETUP.md new file mode 100644 index 0000000..f4754e6 --- /dev/null +++ b/docs/ADB_WINDOWS_SETUP.md @@ -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)