Android 앱 개발 교육
사전 설치 & 기기 연결 가이드

Android Studio 설치부터 SDK · JDK 확인, ADB 설정, 실제 안드로이드 기기 연결까지

Windows 기준Git Bash 사용 가능Codex CLI 준비 완료 기준2026-07

0. 무엇을 설치해야 하나요?

필수
Android Studio
IDE + Android 개발 도구 관리
필수
Android SDK / Platform-Tools
빌드 도구와 adb. Android Studio에서 설치
기본 포함
JDK (JetBrains Runtime)
Android Studio에 JDK가 포함되므로 보통 별도 설치 불필요
Windows 기기 연결 시
USB Driver
휴대폰 제조사에 따라 필요
핵심: 예전처럼 JDK를 무조건 따로 설치할 필요는 없습니다. 현재 Android Studio에는 JetBrains Runtime(JBR)이라는 JDK가 함께 제공됩니다. 교육에서는 Android Studio + Android SDK + Platform-Tools를 정상 설치하는 것을 우선 권장합니다.

Node.js, Git, Git Bash, Codex CLI가 이미 설치되어 있다면 그대로 사용하면 됩니다. Android 앱 개발 자체를 위해 Node.js는 필수는 아닙니다.

1. Android Studio 설치

1
Android Studio 다운로드

Android Studio 공식 다운로드 페이지에서 Windows용 최신 안정 버전을 다운로드합니다.

2
설치 프로그램 실행

기본 옵션으로 설치하면 됩니다. 처음 실행하면 Setup Wizard가 Android SDK 등 필요한 구성요소를 내려받습니다.

3
SDK 구성 확인

Android Studio → Tools → SDK Manager를 엽니다.

확인할 항목
SDK Platforms교육에서 사용할 Android SDK Platform 1개 이상
SDK ToolsAndroid SDK Platform-Tools, Android SDK Build-Tools, Android SDK Command-line Tools
Platform-Tools 안에 adb가 포함되어 있습니다.

2. JDK 확인

Android Studio는 자체 JDK(JBR)를 포함합니다. Android Studio에서 빌드할 때는 별도 JDK 설치 없이 진행하는 것이 가장 간단합니다.

Android Studio에서 확인

File → Settings → Build, Execution, Deployment → Build Tools → Gradle에서 Gradle JDK가 Android Studio의 JBR 계열로 설정되어 있는지 확인합니다.

Git Bash에서 확인

java -version

java가 인식된다면 버전이 출력됩니다. 단, 여기서 명령어가 없다고 나오더라도 Android Studio 자체 빌드가 안 된다는 뜻은 아닙니다.

교육에서 Codex가 Git Bash에서 직접 ./gradlew를 실행하게 할 예정이라면 터미널에서도 JDK를 사용할 수 있도록 JAVA_HOME 설정을 해두는 편이 좋습니다. 프로젝트의 Android Gradle Plugin 버전에 맞는 JDK를 사용해야 하며, 최근 AGP 계열은 일반적으로 JDK 17 이상을 사용합니다.

3. adb를 Git Bash에서 사용할 수 있게 설정

Android SDK의 기본 위치는 보통 다음과 같습니다.

C:\Users\내계정\AppData\Local\Android\Sdk

그 안의 platform-tools 폴더에 adb.exe가 있습니다.

먼저 직접 확인

"/c/Users/내계정/AppData/Local/Android/Sdk/platform-tools/adb.exe" version

권장: Windows PATH에 추가

시스템 환경 변수 편집 → 환경 변수 → 사용자 변수의 Path → 새로 만들기에서 아래 경로를 추가합니다.

%LOCALAPPDATA%\Android\Sdk\platform-tools

Git Bash를 완전히 종료했다가 다시 실행한 뒤:

adb version
Android Debug Bridge version ... 이 출력되면 준비 완료입니다.

4. 안드로이드 휴대폰에서 개발자 옵션 켜기

1
설정 → 휴대전화 정보 → 소프트웨어 정보로 이동합니다.
2
빌드 번호를 연속으로 약 7번 터치합니다.
3
잠금 비밀번호/PIN을 입력하면 개발자 옵션이 활성화됩니다.
4
설정 → 개발자 옵션 → USB 디버깅을 켭니다.

메뉴 이름과 위치는 삼성 Galaxy 등 제조사와 Android 버전에 따라 조금 다를 수 있습니다.

5. USB로 기기 연결

1
데이터 통신이 가능한 USB 케이블로 휴대폰과 PC를 연결합니다.
2
휴대폰에 “USB 디버깅을 허용하시겠습니까?”가 뜨면 허용합니다. 교육용 개인 PC라면 “이 컴퓨터에서 항상 허용”을 선택해도 됩니다.
3
Git Bash에서 실행합니다.
adb devices
정상 예:
List of devices attached
R3XXXXXXXXX    device
device라고 표시되면 실제 기기 연결까지 완료된 것입니다.

6. adb devices가 안 될 때

증상확인 방법
adb: command not foundPlatform-Tools가 PATH에 들어갔는지 확인하고 Git Bash 재실행
목록이 비어 있음USB 케이블이 데이터 통신용인지 확인, USB 연결 모드를 파일 전송으로 변경, 다른 포트 시도
unauthorized휴대폰 화면을 켜고 USB 디버깅 허용 팝업 승인
Windows에서 기기 자체를 못 찾음제조사 OEM USB 드라이버 설치. Pixel/Google 기기는 Google USB Driver 사용
adb가 이상하게 동작adb kill-serveradb start-server 실행
adb kill-server
adb start-server
adb devices

Android 공식 OEM USB Driver 안내

7. 최종 점검 — 교육 시작 전 여기까지

  1. Git Bash 실행 가능
  2. git --version 정상
  3. node --version 정상 (기존 교육 환경 유지용)
  4. codex --version 정상
  5. Android Studio 실행 가능
  6. SDK Manager에서 Android SDK Platform + Platform-Tools 설치 완료
  7. adb version 정상
  8. 휴대폰 개발자 옵션 + USB 디버깅 활성화
  9. adb devices에서 기기가 device 상태로 표시
여기까지 성공하면 교육 준비 완료.
이후에는 Codex에게 Android 프로젝트 생성/수정 → Gradle 빌드 → 실제 기기에 설치 및 실행하는 흐름으로 교육을 진행할 수 있습니다.

8. 선택 사항: 에뮬레이터

실제 기기를 사용할 예정이라면 에뮬레이터는 필수가 아닙니다. 기기가 없는 교육생을 위해 준비하려면 Android Studio의 Device Manager에서 가상 기기(AVD)를 생성할 수 있습니다.

에뮬레이터는 시스템 이미지 다운로드로 용량을 많이 사용하고 PC 성능/가상화 설정의 영향을 받습니다. 교육 시간이 짧다면 실제 안드로이드 기기 연결을 우선하는 편이 단순합니다.

공식 참고 문서

Android Studio 설치 · Android 빌드와 JDK · ADB · 실제 기기에서 실행 · 개발자 옵션

작성 기준: 2026년 7월. Android Studio 및 SDK 메뉴는 버전에 따라 일부 명칭이 달라질 수 있습니다.