개발 환경을 준비한다는 뜻
안드로이드 앱 개발의 첫 단계는 멋진 기능을 만드는 일이 아닙니다. 내 컴퓨터에서 안드로이드 프로젝트를 만들고, 빌드하고, 실제 기기나 에뮬레이터에서 실행하는 흐름을 한 번 끝까지 경험하는 것입니다.
이 과정을 마치면 앞으로 배우는 Kotlin, Compose, 데이터베이스, 네트워크, 배포가 모두 어디에 연결되는지 감이 생깁니다. 반대로 이 단계가 불안정하면 간단한 코드 수정도 실행하지 못해 학습이 자주 멈춥니다.
이번 장의 목표는 명확합니다.
Android Studio를 설치한다.
SDK가 정상적으로 준비되었는지 확인한다.
Kotlin 기반의 새 안드로이드 프로젝트를 만든다.
에뮬레이터 또는 실제 기기에서 첫 앱을 실행한다.
오류가 났을 때 어디부터 확인해야 하는지 익힌다.
AI 생성 이미지
Android Studio 설치 후 먼저 확인할 것
Android Studio를 설치한 뒤 바로 코드를 작성하기보다 설치가 정상인지 먼저 확인해야 합니다. 처음 실행하면 Welcome 화면이 나타납니다. 이 화면에서 새 프로젝트를 만들거나 기존 프로젝트를 열 수 있습니다.
설치 확인은 다음 순서로 진행합니다.
Android Studio Welcome 화면이 정상적으로 열리는지 확인합니다.
상단 메뉴에서
File > Settings를 열어 설정 창이 표시되는지 확인합니다. macOS에서는Android Studio > Settings또는Preferences로 보일 수 있습니다.Help > About을 열어 Android Studio 버전이 표시되는지 확인합니다.More Actions > SDK Manager또는 상단 메뉴의Tools > SDK Manager를 열어 SDK 설치 상태를 확인합니다.
SDK Manager에서는 특히 두 가지를 봅니다. 첫째, 상단에 Android SDK 경로가 표시되어야 합니다. 둘째, SDK Platforms와 SDK Tools 탭에 설치된 항목이 보여야 합니다. 설치 직후에는 Android Studio, SDK Manager, 설치된 플랫폼, Gradle 동기화 가능 여부를 확인하는 것이 좋습니다.1
SDK 경로는 운영체제마다 다를 수 있습니다. Windows에서는 사용자 폴더 아래의 Android SDK 위치가 사용되는 경우가 많고, macOS에서는 보통 ~/Library/Android/sdk 아래에 설치됩니다. 중요한 것은 경로 자체를 외우는 것이 아니라, Android Studio가 SDK 위치를 알고 있고 필요한 구성 요소를 찾을 수 있어야 한다는 점입니다.
SDK Manager에서 확인해야 하는 구성 요소
Android SDK는 안드로이드 앱을 만들고 실행하는 데 필요한 도구 모음입니다. Android Studio만 설치했다고 개발 환경이 완성되는 것은 아닙니다. SDK Platform, Build Tools, Platform Tools, Emulator 같은 구성 요소가 함께 준비되어야 합니다.
SDK Manager의 SDK Platforms 탭에서는 앱을 어떤 Android 버전 기준으로 개발할지 선택합니다. 보통 최신 안정 버전의 Android 플랫폼이 설치되어 있으면 됩니다. 여러 버전을 모두 설치할 필요는 없습니다. 다만 프로젝트에서 요구하는 compileSdk 버전에 해당하는 플랫폼은 반드시 설치되어 있어야 합니다.
SDK Tools 탭에서는 다음 항목을 확인합니다.
Android SDK Build-Tools
Android SDK Platform-Tools
Android Emulator
Android SDK Command-line Tools
이 항목이 빠져 있으면 프로젝트 생성 후 Gradle Sync가 실패하거나, 빌드는 되지만 실행 기기를 찾지 못하는 문제가 생길 수 있습니다. Gradle Sync는 프로젝트 설정, 라이브러리, SDK 정보를 맞추는 과정입니다. 새 프로젝트를 열었을 때 Android Studio가 자동으로 실행하며, 이 과정이 끝나야 코드 자동 완성, 빌드, 실행이 안정적으로 동작합니다.
SDK 다운로드가 오래 걸리거나 실패한다면 먼저 인터넷 연결을 확인합니다. 회사나 학교 네트워크에서는 방화벽, 프록시, VPN 때문에 다운로드가 멈출 수 있습니다. 이때는 VPN을 끄거나 다른 네트워크에서 다시 시도하고, SDK Manager에서 필요한 항목을 다시 설치합니다.
새 프로젝트 만들기
이제 첫 프로젝트를 만듭니다. Welcome 화면에서 New Project를 선택합니다. Android Studio 버전에 따라 문구가 조금 다를 수 있지만, 새 안드로이드 프로젝트를 시작한다는 흐름은 같습니다. 안드로이드 첫 프로젝트는 Android Studio의 Welcome 화면에서 새 프로젝트를 시작하고, 앱 이름과 패키지 이름을 정한 뒤 템플릿을 선택하는 방식으로 생성할 수 있습니다.2
템플릿은 Empty Activity를 선택합니다. 최근 Android Studio의 Empty Activity는 Jetpack Compose를 기본 UI 방식으로 사용하는 경우가 많습니다. 이 책은 Compose 중심으로 진행하므로 Empty Activity가 가장 적합합니다.
프로젝트 설정 화면에서는 다음 항목을 정합니다.
Name: 프로젝트 이름입니다. 예를 들어
MyFirstApp처럼 입력합니다.Package name: 앱의 고유 식별자입니다. 예를 들어
com.example.myfirstapp형식입니다.Save location: 프로젝트가 저장될 폴더입니다.
Language:
Kotlin을 선택합니다.Minimum SDK: 앱을 설치할 수 있는 최소 Android 버전입니다.
패키지 이름은 중요합니다. Google Play에 앱을 배포할 때 같은 패키지 이름을 가진 앱은 동시에 존재할 수 없습니다. 즉, 패키지 이름은 앱의 주민등록번호 같은 역할을 합니다. 연습용이라면 com.example...을 사용해도 되지만, 실제 배포를 생각한다면 본인 도메인이나 고유한 이름을 바탕으로 정하는 것이 좋습니다. 나중에 패키지 이름을 바꾸는 작업은 생각보다 번거롭습니다.
Minimum SDK는 앱이 지원할 가장 낮은 Android 버전을 뜻합니다. 너무 낮게 잡으면 오래된 기기까지 지원할 수 있지만, 최신 기능을 사용할 때 제약이 생길 수 있습니다. 너무 높게 잡으면 개발은 편해질 수 있지만, 설치 가능한 사용자가 줄어듭니다. 처음 학습할 때는 Android Studio가 추천하는 기본값을 사용해도 충분합니다.
Gradle Sync와 프로젝트 구조 확인하기
프로젝트를 생성하면 Android Studio가 여러 파일과 폴더를 자동으로 만듭니다. 동시에 Gradle Sync가 실행됩니다. 화면 아래 상태 표시줄이나 Build 창에서 진행 상황을 볼 수 있습니다.
처음에는 낯선 파일이 많아 보입니다. 하지만 지금 꼭 알아야 할 것은 많지 않습니다.
app: 실제 앱 코드와 리소스가 들어 있는 모듈입니다.MainActivity.kt: 앱이 처음 실행될 때 화면을 연결하는 Kotlin 파일입니다.AndroidManifest.xml: 앱의 구성 요소, 권한, 시작 Activity 등을 선언하는 파일입니다.build.gradle.kts: SDK 버전, 앱 ID, 라이브러리 의존성 등을 설정하는 빌드 파일입니다.res: 앱 이름, 아이콘, 색상, 문자열 같은 리소스를 담는 폴더입니다.
Project 창의 보기 방식은 Android로 두는 것이 초보자에게 편합니다. 실제 디스크 구조를 그대로 보여주는 대신, 안드로이드 개발에 자주 쓰는 파일을 보기 좋게 묶어 보여주기 때문입니다.
MainActivity.kt를 열면 setContent라는 코드가 보일 것입니다. 이 부분이 Compose 화면을 앱에 연결하는 입구입니다. 지금은 코드를 모두 이해하지 않아도 됩니다. 중요한 것은 이 파일을 수정하면 앱 화면이 바뀐다는 사실입니다.
Gradle Sync가 끝났다면 Build 창에 빨간 오류가 없어야 합니다. 경고는 있을 수 있지만, 빨간 오류가 있다면 실행 전에 해결해야 합니다.
에뮬레이터 만들기
실제 기기가 없어도 Android Emulator로 앱을 실행할 수 있습니다. Android Studio에서 Tools > Device Manager를 엽니다. 그런 다음 Create Device를 선택합니다.
처음에는 Pixel 계열 기기를 선택하면 무난합니다. 예를 들어 Pixel 6 같은 일반적인 스마트폰 구성을 고릅니다. 다음 단계에서 시스템 이미지를 선택합니다. 시스템 이미지는 가상 기기에 설치될 Android 운영체제입니다. 다운로드가 필요할 수 있으므로 시간이 조금 걸립니다.
에뮬레이터를 만든 뒤 Device Manager에서 실행 버튼을 누르면 가상 스마트폰이 켜집니다. 처음 부팅은 느릴 수 있습니다. 화면이 정상적으로 뜨면 Android Studio 상단의 실행 대상 목록에 해당 에뮬레이터가 표시됩니다.
에뮬레이터가 검은 화면에서 멈추거나 실행 직후 종료된다면 가상화 설정을 확인해야 합니다. Windows PC에서는 BIOS 또는 UEFI에서 Intel VT-x나 AMD-V 같은 하드웨어 가상화가 꺼져 있을 수 있습니다. 또한 SDK Manager의 SDK Tools 탭에서 Emulator 관련 도구가 설치되어 있는지도 확인합니다.
실제 Android 기기 연결하기
실제 스마트폰이 있다면 기기에서 바로 실행해보는 것도 좋습니다. 실제 기기 테스트는 터치감, 화면 밝기, 성능, 키보드 입력 같은 요소를 더 현실적으로 확인할 수 있습니다.
기본 흐름은 다음과 같습니다.
스마트폰의 설정에서 개발자 옵션을 켭니다.
개발자 옵션에서 USB 디버깅을 활성화합니다.
USB 케이블로 컴퓨터와 스마트폰을 연결합니다.
스마트폰 화면에 디버깅 허용 창이 뜨면 허용합니다.
Android Studio의 실행 대상 목록에서 연결된 기기를 선택합니다.
개발자 옵션은 보통 설정 > 휴대전화 정보 > 빌드 번호를 여러 번 눌러 활성화합니다. 제조사마다 메뉴 이름은 조금 다를 수 있습니다.
기기가 Android Studio에 보이지 않으면 케이블을 먼저 의심합니다. 충전만 되는 케이블은 데이터 전송이 되지 않을 수 있습니다. Windows에서는 제조사 USB 드라이버가 필요할 때도 있습니다. 스마트폰의 USB 연결 모드가 파일 전송이나 디버깅을 허용하는 상태인지도 확인합니다.
첫 앱 실행하기
이제 실행할 차례입니다. Android Studio 상단에서 실행 대상 기기나 에뮬레이터를 선택하고, 초록색 실행 버튼을 누릅니다. 단축키를 사용해도 됩니다.
실행 버튼을 누르면 대략 다음 순서가 진행됩니다.
Gradle이 프로젝트를 빌드합니다.
Kotlin 코드와 리소스가 앱 패키지로 묶입니다.
선택한 기기나 에뮬레이터에 앱이 설치됩니다.
AndroidManifest.xml에 지정된 시작 Activity가 실행됩니다.
MainActivity.kt의setContent안에 있는 Compose 화면이 표시됩니다.
첫 실행은 시간이 걸릴 수 있습니다. 특히 에뮬레이터를 처음 켰거나, Gradle이 필요한 파일을 처음 다운로드하는 상황이라면 몇 분이 걸려도 이상하지 않습니다.
화면에 기본 문구가 나타났다면 성공입니다. 이제 MainActivity.kt에서 화면에 표시되는 텍스트를 찾아 조금 바꿔보세요. 예를 들어 Hello Android를 처음 실행한 내 앱으로 바꾼 뒤 다시 실행합니다. 기기 화면의 문구가 바뀌었다면 코드 수정, 빌드, 설치, 실행의 전체 흐름을 경험한 것입니다.
이 작은 성공이 중요합니다. 앞으로 배우는 모든 기능은 결국 이 흐름 위에 쌓입니다.
오류가 났을 때 확인하는 순서
초기 설정에서 오류는 자주 발생합니다. 중요한 것은 당황하지 않고 순서대로 확인하는 것입니다.
먼저 Gradle Sync 실패가 보이면 Build 창의 오류 메시지를 읽습니다. SDK location not found, Failed to install, Could not resolve, compileSdk 같은 단어가 보이면 SDK 설치나 인터넷 연결 문제일 가능성이 높습니다. SDK Manager를 열어 필요한 플랫폼과 도구가 설치되어 있는지 확인합니다.
SDK 버전 불일치 오류가 나면 build.gradle.kts에 적힌 compileSdk 버전과 SDK Manager에 설치된 플랫폼 버전을 비교합니다. 프로젝트가 Android API 35를 요구하는데 SDK Manager에 API 35가 없다면 빌드가 실패할 수 있습니다.
에뮬레이터가 실행되지 않으면 Device Manager에서 해당 가상 기기를 삭제하고 다시 만들어보는 것이 빠를 때가 많습니다. 시스템 이미지를 다시 다운로드해야 할 수도 있습니다. 그래도 안 되면 하드웨어 가상화 설정, 그래픽 드라이버, 디스크 여유 공간을 확인합니다.
실제 기기가 인식되지 않으면 USB 디버깅 허용 여부, 케이블, USB 연결 모드, 드라이버를 차례로 확인합니다. 스마트폰 화면에 뜬 디버깅 허용 창을 놓치는 경우도 많습니다.
마지막으로 Android Studio 자체가 이상하게 동작한다면 File > Invalidate Caches 후 재시작을 시도할 수 있습니다. 단, 이 방법은 모든 문제의 첫 해결책이 아닙니다. 먼저 오류 메시지, SDK 설치 상태, 인터넷 연결, 기기 연결 상태를 확인하는 습관이 더 중요합니다.
첫 실행 후 기억할 것
이번 장에서 만든 앱은 기능이 거의 없습니다. 하지만 이미 중요한 과정을 통과했습니다. Android Studio를 열고, SDK를 확인하고, 프로젝트를 만들고, Gradle Sync를 기다리고, 기기에서 앱을 실행했습니다.
앞으로 코드를 배우다가 문제가 생기면 다음 질문으로 돌아오면 됩니다.
SDK가 제대로 설치되어 있는가?
Gradle Sync가 성공했는가?
실행 대상 기기나 에뮬레이터가 준비되어 있는가?
Build 창과 Logcat에 어떤 오류가 표시되는가?
내가 수정한 파일이 실제 실행되는 화면과 연결되어 있는가?
개발 환경 구축은 한 번만 지나가는 절차가 아닙니다. 새 컴퓨터를 쓰거나, Android Studio를 업데이트하거나, 프로젝트의 SDK 버전이 바뀔 때마다 다시 마주칠 수 있습니다. 그래서 처음부터 확인 순서를 익혀두는 것이 좋습니다.
다음 장에서는 이 프로젝트 안에서 가장 자주 보게 될 언어인 Kotlin의 기본 문법을 다룹니다. 변수, 함수, 클래스 같은 기초를 알면 MainActivity.kt가 더 이상 낯선 파일로 보이지 않을 것입니다.
참고
이 노트는 보도·비평·교육·연구 목적으로 작성되었습니다. 저작권 문의가 있으시면 에서 알려주세요.