안드로이드 앱 개발 환경 세팅 가이드

Overview

무엇을 설치하나요?

▸

Android Studio

공식 IDE. SDK · Platform-Tools(adb) · 에뮬레이터 · Gradle을 한 번에 포함합니다. 이것만 잘 깔면 대부분 해결됩니다.

필수

▸

JDK

기억과 달리 따로 설치할 필요 없습니다. 요즘 Android Studio는 JDK(JetBrains Runtime)를 자체 포함합니다. 별도로 깔면 오히려 버전 충돌이 생길 수 있어요.

불필요

▸

SDK Platform-Tools

adb가 여기 들어있습니다. Android Studio 설치 시 함께 깔리며, 환경변수(PATH) 등록만 해주면 Git Bash에서 바로 쓸 수 있습니다.

자동 포함

▸

USB 드라이버

Windows에서 실기기를 인식시키려면 필요할 수 있습니다. 삼성폰은 Smart Switch, 그 외는 제조사 드라이버 또는 Google USB Driver.

Windows · 기기별

▸

실기기 또는 에뮬레이터

안드로이드 폰(USB 케이블) 또는 Android Studio 내장 에뮬레이터. 이 가이드는 실기기 연결 기준입니다.

둘 중 하나

💡

이미 깔려있는 것들(Node · Git Bash · Codex)은 지우지 마세요. 안드로이드 개발에 직접 쓰이진 않지만, AI CLI로 코드를 만들고 adb로 폰에 올리는 흐름은 그대로 이어집니다.

Step by step

순서대로 따라오기

내 PC가 준비됐는지 확인

check · 5 min

Windows 10 / 11 (64-bit) — Win + Pause 로 시스템 정보 확인
RAM 8GB 이상 (에뮬레이터까지 쓰려면 16GB 권장)
여유 디스크 8GB 이상 (Android Studio + SDK)
(에뮬레이터를 쓸 경우) BIOS에서 CPU 가상화(VT-x / AMD-V) 활성화 → 실기기만 쓸 거면 필수는 아닙니다

JDK는 건너뜁니다

read & skip · 1 min

예전엔 JDK를 먼저 깔아야 했지만, 지금은 그럴 필요가 없습니다. Android Studio가 실행에 쓰는 자바 런타임(JBR, OpenJDK 기반)을 함께 설치해 주기 때문입니다.

⚠️

일부러 JDK를 따로 깔지 마세요. 시스템에 다른 버전의 자바가 있으면 Gradle 빌드가 꼬일 수 있습니다. 커맨드라인에서 java가 꼭 필요한 특별한 경우가 아니라면, 이 단계는 그냥 넘어가면 됩니다.

Android Studio 다운로드 & 설치

install · 15~25 min

developer.android.com/studio 에서 최신 안정판(Stable) 다운로드 (2026년 기준 2025.x 계열)
받은 .exe 실행 → 설치 방식은 Standard 선택
설치 항목에 Android SDK · SDK Platform · Android Virtual Device가 포함돼 있는지 확인 (기본 체크됨)
용량이 커서(수 GB) 다운로드에 시간이 걸립니다 — 미리 받아두면 좋아요

첫 실행 — SDK 구성 & 경로 확인

setup wizard · 10 min

처음 실행하면 Setup Wizard가 SDK, Platform-Tools, 에뮬레이터를 자동으로 내려받습니다. Standard로 진행하세요.

다운로드가 끝나면 시작 화면에서 More Actions → SDK Manager 를 열어 확인:

SDK Platforms 탭 — 최신 API(예: Android 15 / API 35 이상) 하나 체크
SDK Tools 탭 — Android SDK Platform-Tools가 체크돼 있는지 확인 (adb가 여기 포함)

맨 위 Android SDK Location 경로를 복사해 두세요. 다음 단계에서 씁니다. 보통:

# 기본 SDK 경로 (사용자 이름만 다름)
C:\Users\<사용자>\AppData\Local\Android\Sdk

환경변수 등록 — Git Bash에서 adb 쓰기

env vars · 5 min · ★ 핵심

이걸 해야 터미널(Git Bash)에서 adb 명령이 먹습니다. Win 키 → "시스템 환경 변수 편집" 검색 → 환경 변수(N) 클릭.

① 새 시스템 변수 추가 (아래 <사용자> 자리에 본인 경로):

# 변수 이름  ANDROID_HOME
# 변수 값    C:\Users\<사용자>\AppData\Local\Android\Sdk

② Path 변수 편집 → 새로 만들기 로 아래 한 줄 추가:

%ANDROID_HOME%\platform-tools

🔁

이미 열려 있던 Git Bash 창은 반드시 닫고 새로 여세요. 환경변수는 새 터미널부터 반영됩니다.

adb 설치 확인

verify · 1 min

새 Git Bash 창에서:

$ adb version
Android Debug Bridge version 1.0.41
Version 35.x.x ...

이렇게 버전이 나오면 성공입니다. command not found가 나오면 → Step 4의 PATH를 다시 확인하고 터미널을 재시작하세요.

폰 준비 — 개발자 옵션 & USB 디버깅

on your phone · 3 min

폰 설정 → 휴대전화 정보 → 소프트웨어 정보
빌드 번호를 7번 연속 탭 → "개발자가 되었습니다" 뜨면 성공
설정 → 개발자 옵션 진입 → USB 디버깅 켜기
USB 연결 시 알림에서 연결 방식을 "파일 전송(MTP)" 로 두면 인식이 더 잘 됩니다

📱

제조사마다 메뉴 위치가 조금씩 다릅니다. 삼성은 설정 → 휴대전화 정보 → 소프트웨어 정보 → 빌드번호 경로예요.

(Windows) USB 드라이버

driver · 5 min · 필요 시

폰을 꽂아도 인식이 안 되면 드라이버가 필요합니다.

삼성 갤럭시 — PC에 Samsung Smart Switch 설치 (USB 드라이버 함께 설치됨)
그 외 제조사 — 제조사 홈페이지의 USB 드라이버
범용 — SDK Manager → SDK Tools → Google USB Driver 체크 후 설치

🔌

케이블을 의심하세요. 충전 전용 케이블은 데이터가 안 통해서 adb가 폰을 못 봅니다. 데이터 전송이 되는 케이블을 쓰고, 가능하면 USB 허브 말고 PC에 직접 꽂으세요.

✓

adb devices — 연결 확인 🎉

the finish line · 2 min

폰을 USB로 PC에 연결
폰 화면에 뜨는 "USB 디버깅을 허용하시겠습니까?" 팝업 → "이 컴퓨터에서 항상 허용" 체크 후 허용
Git Bash에서:

$ adb devices
List of devices attached
R3CN90ABCDE     device

기기 시리얼 뒤에 device 로 뜨면 완료입니다. 이제 여기에 앱을 빌드해서 바로 설치할 수 있어요.

When it breaks

안 될 때 — 증상별 해결

adb: command not found

PATH가 안 잡힌 겁니다. Step 4에서 %ANDROID_HOME%\platform-tools 추가를 확인하고, 터미널을 새로 여세요.

목록이 비어있음 (기기 안 뜸)

케이블(데이터용?)·포트 확인 → 폰 USB 디버깅 껐다 켜기 → adb kill-server 후 adb start-server 재시도. Windows면 Step 7 드라이버도 확인.

기기가 unauthorized 로 표시

폰 화면의 USB 디버깅 허용 팝업을 아직 안 눌렀습니다. 팝업이 안 뜨면 개발자 옵션 → "USB 디버깅 승인 취소" 후 케이블을 다시 꽂으세요.

기기가 offline 으로 표시

일시적 연결 오류. 케이블·포트를 바꾸고 adb kill-server → adb start-server → 폰 잠금 해제 상태에서 재연결.

장치 관리자에 노란 느낌표(!)

드라이버 문제입니다. Step 7로 가서 제조사 드라이버 또는 Google USB Driver를 설치하세요.

실기기가 아예 없을 때 — 에뮬레이터

Android Studio → Device Manager → 가상 기기 생성(Pixel + Google Play 이미지) → 실행하면 adb devices에 emulator-5554 로 나타납니다.

안드로이드 앱 개발
환경 세팅 가이드