From 3c43d2636d60d6099129f633bb997d2c08e5799e Mon Sep 17 00:00:00 2001
From: sanjeok77 <sanjeok77@webpluss.net>
Date: Thu, 5 Mar 2026 04:18:35 +0900
Subject: [PATCH] =?UTF-8?q?docs:=20ADB=20Windows=20=EC=97=B0=EA=B2=B0=20?=
 =?UTF-8?q?=EC=84=A4=EC=A0=95=20=EA=B0=80=EC=9D=B4=EB=93=9C=20=EC=B6=94?=
 =?UTF-8?q?=EA=B0=80?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

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

Ultraworked with [Sisyphus](https://github.com/code-yeongyu/oh-my-opencode)
Co-authored-by: Sisyphus <clio-agent@sisyphuslabs.ai>
---
 docs/ADB_WINDOWS_SETUP.md | 121 ++++++++++++++++++++++++++++++++++++++
 1 file changed, 121 insertions(+)
 create mode 100644 docs/ADB_WINDOWS_SETUP.md

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)