Android Academy · 강의

프로젝트 구조 및 매니페스트

Android 프로젝트 구조와 build.gradle, 리소스, 그리고 앱을 OS에 선언하는 AndroidManifest.xml 파일의 역할을 이해합니다.

프로젝트 구조 및 매니페스트은(는) CoddyKit의 무료 Android Academy 강의입니다. 이것은 7개 중 1번째 강의입니다. 아래에서 전체 강의를 무료로 읽을 수 있으며, 내장 코드 에디터와 24/7 AI 튜터와 함께 브라우저에서 직접 실습할 수 있습니다. 이 강의는 Android Academy 학습 경로의 일부이며, 진행 상황이 웹과 CoddyKit 앱에 동기화됩니다. Android Academy 강의에는 총 7개의 강의가 포함되어 있습니다.

첫 Android 프로젝트

Android Studio에서 새 Android 프로젝트를 만들면 특정 폴더 구조가 생성됩니다. 이 구조를 이해하는 것이 효율적인 Android 개발의 첫 단계입니다.

모든 Android 앱은 동일한 최상위 구조를 가지므로 함께 살펴보겠습니다.

최상위 구조

Android 프로젝트에는 두 가지 주요 모듈이 있습니다.

app/ — 앱 모듈(코드, 리소스, 매니페스트)
Gradle 파일 — 빌드 시스템 구성

app/src/main/ 내부에서 대부분의 시간을 다음 항목에 사용합니다.

java/(또는 kotlin/) — Kotlin 소스 파일
res/ — 레이아웃, 이미지, 문자열
AndroidManifest.xml — 앱 구성 파일

res/ 디렉터리

res/ 폴더에는 코드가 아닌 모든 리소스가 들어 있습니다.

res/layout/ — XML 화면 레이아웃
res/drawable/ — 이미지와 아이콘
res/values/strings.xml — 텍스트 문자열
res/values/colors.xml — 색상 정의
res/mipmap/ — 앱 실행 아이콘

Android는 리소스를 코드에서 참조할 수 있도록 R이라는 클래스를 자동으로 생성합니다.

AndroidManifest.xml

AndroidManifest.xml은 가장 중요한 구성 파일입니다. 다음 정보를 Android에 알려 줍니다.

앱의 패키지 이름(고유 식별자)
존재하는 액티비티
실행 화면으로 사용할 액티비티
앱에 필요한 권한(카메라, 인터넷 등)
최소 Android API 수준과 대상 Android API 수준

매니페스트 구조

최소한의 AndroidManifest.xml은 다음과 같은 모습입니다.

<!-- AndroidManifest.xml -->
<manifest
    xmlns:android="http://schemas.android.com/apk/res/android">

    <uses-permission
        android:name="android.permission.INTERNET" />

    <application
        android:label="@string/app_name"
        android:icon="@mipmap/ic_launcher">

        <activity android:name=".MainActivity"
            android:exported="true">
            <intent-filter>
                <!-- This is the launch activity -->
                <action android:name="android.intent.action.MAIN" />
                <category android:name="android.intent.category.LAUNCHER" />
            </intent-filter>
        </activity>

    </application>
</manifest>

build.gradle 파일

Gradle은 빌드 시스템입니다. build.gradle 파일은 두 개입니다.

프로젝트 수준 — 전역 설정, 저장소 구성
앱 수준(app/build.gradle) — 앱의 의존성, SDK 버전, 플러그인

여기에 라이브러리를 추가합니다: implementation "com.google.code.gson:gson:2.10.1"

app/build.gradle의 주요 필드

app/build.gradle에서 가장 중요한 필드입니다.

compileSdk — 컴파일에 사용할 Android API
minSdk — 지원하는 가장 오래된 Android 버전
targetSdk — 테스트한 Android 버전
versionCode — 출시할 때마다 증가하는 정수
versionName — 사람이 읽을 수 있는 버전(예: "1.2.0")

R 클래스

Android는 모든 리소스를 정수 ID에 매핑하는 R 클래스를 자동으로 생성합니다.

R.layout.activity_main — XML 레이아웃
R.id.tvTitle — 레이아웃 내부의 뷰
R.string.app_name — 문자열 리소스
R.drawable.ic_logo — 이미지

이렇게 Kotlin 코드와 XML 리소스를 연결합니다.

현지화를 위한 strings.xml

사용자에게 표시되는 텍스트는 하드코딩하지 말고 항상 res/values/strings.xml에 넣습니다. 이렇게 하면 현지화가 가능해지며, Android가 기기의 지역 설정에 따라 적절한 언어의 문자열을 자동으로 선택합니다.

예를 들어 터키어 번역에는 res/values-tr/strings.xml을 만듭니다.

빠른 확인

앱이 처음 실행될 때 표시할 액티비티는 어디에 선언하나요?

복습: 프로젝트 구조

이제 Android 프로젝트의 구조를 이해했습니다.

app/src/main/kotlin/ — 코드
app/src/main/res/ — 레이아웃, 이미지, 문자열
AndroidManifest.xml — 권한, 액티비티, 실행 구성
build.gradle — 의존성과 SDK 버전
R 클래스 — 코드와 리소스를 연결

다음에는 모든 Android 화면의 핵심인 액티비티와 수명 주기를 알아보겠습니다.

자주 묻는 질문

“프로젝트 구조 및 매니페스트” 강의는 무료인가요?

네 — “프로젝트 구조 및 매니페스트” 전체 내용을 이 웹사이트에서 무료로 읽을 수 있습니다. 인터랙티브하게 실습하려면(내장 코드 에디터와 24/7 AI 튜터), CoddyKit PRO로 업그레이드하면 Android Academy 강의 전체를 잠금 해제할 수 있습니다. Android Academy 강의에는 총 7개의 강의가 포함되어 있습니다.

“프로젝트 구조 및 매니페스트”에서 뭘 배우나요?

Android 프로젝트 구조와 build.gradle, 리소스, 그리고 앱을 OS에 선언하는 AndroidManifest.xml 파일의 역할을 이해합니다. 브라우저에서 직접 실행하는 실습 코드로 Android Academy을(를) 배우며, 24/7 AI 튜터가 강의를 진행하면서 질문에 답변해줍니다.

Android Academy을(를) 시작하는 데 경험이 필요한가요?

사전 경험은 필요하지 않습니다. CoddyKit의 Android Academy은(는) 초급자부터 고급 학습자까지를 위해 구성되어 있으므로, 여기서 시작하거나 처음부터 시작할 수 있으며 자신의 속도대로 진행할 수 있습니다. 이것은 7개 중 1번째 강의입니다.

“프로젝트 구조 및 매니페스트” 강의는 얼마나 걸리나요?

대부분의 CoddyKit 강의는 약 5~10분이 소요됩니다. 각 강의는 간결하고 인터랙티브하여 꾸준한 진행이 가능하며, 웹과 앱에서 중단한 부분부터 바로 시작할 수 있습니다.

이 Android Academy 강의에서 코드를 작성하고 실행할 수 있나요?

네. 모든 Android Academy 강의에는 내장 코드 에디터가 포함되어 있으므로, 브라우저에서 바로 실제 코드를 작성하고 실행한 후 즉시 AI 피드백을 받을 수 있습니다 — 로컬 설정이 필요 없습니다.

이 강의의 모든 강의

← Android Academy(으)로 돌아가기