Kotlin으로 안드로이드 갤러리에서 이미지 선택하기: 단계별 완벽 가이드

개요

안드로이드 앱을 개발하다 보면 사용자가 기기의 갤러리에서 사진을 골라 업로드하거나 화면에 표시해야 하는 경우가 자주 있습니다. 이 글에서는 Kotlin을 활용해 안드로이드 이미지 갤러리에서 이미지를 선택하고, 선택한 이미지를 ImageView에 출력하는 방법을 단계별로 살펴보겠습니다.

1단계: 새 프로젝트 생성

Android Studio를 실행한 뒤 File → New Project 메뉴로 이동하여 새 프로젝트를 생성합니다. 프로젝트 생성에 필요한 모든 정보(프로젝트명, 패키지명, 최소 SDK 버전 등)를 입력하고 빈 액티비티(Empty Activity) 템플릿을 선택합니다.

2단계: 레이아웃 XML 작성

res/layout/activity_main.xml 파일에 아래 코드를 추가합니다. 세로 방향 LinearLayout 안에 이미지를 보여줄 ImageView와 갤러리를 여는 Button을 배치합니다.

<?xml version="1.0" encoding="utf-8"?>
<LinearLayout xmlns:android="https://schemas.android.com/apk/res/android"
    android:layout_width="fill_parent"
    android:layout_height="fill_parent"
    android:orientation="vertical"
    android:padding="2dp">
    <ImageView
        android:id="@+id/imageView"
        android:layout_width="match_parent"
        android:layout_height="wrap_content"
        android:layout_weight="1" />
    <Button
        android:id="@+id/buttonLoadPicture"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:layout_gravity="center"
        android:layout_weight="0"
        android:text="Load Picture" />
</LinearLayout>

3단계: MainActivity.kt 구현

src/MainActivity.kt 파일에 아래 코드를 작성합니다. 버튼 클릭 시 ACTION_PICK 인텐트로 갤러리를 호출하고, onActivityResult()에서 결과를 받아 ImageView에 이미지를 설정합니다.

import android.content.Intent
import android.net.Uri
import android.os.Bundle
import android.provider.MediaStore
import android.widget.Button
import android.widget.ImageView
import androidx.appcompat.app.AppCompatActivity
class MainActivity : AppCompatActivity() {
    lateinit var imageView: ImageView
    lateinit var button: Button
    private val pickImage = 100
    private var imageUri: Uri? = null
    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        setContentView(R.layout.activity_main)
        title = "KotlinApp"
        imageView = findViewById(R.id.imageView)
        button = findViewById(R.id.buttonLoadPicture)
        button.setOnClickListener {
            val gallery = Intent(Intent.ACTION_PICK, MediaStore.Images.Media.INTERNAL_CONTENT_URI)
            startActivityForResult(gallery, pickImage)
        }
    }
    override fun onActivityResult(requestCode: Int, resultCode: Int, data: Intent?) {
        super.onActivityResult(requestCode, resultCode, data)
        if (resultCode == RESULT_OK && requestCode == pickImage) {
            imageUri = data?.data
            imageView.setImageURI(imageUri)
        }
    }
}

참고: 최신 API 권장 사항

startActivityForResult()와 onActivityResult()는 현재 deprecated(사용 중단 예정) 상태입니다. 새 프로젝트에서는 Activity Result API의 registerForActivityResult()와 StartActivityForResult 계약을 사용하는 것이 좋습니다. 다만 위 코드는 동작 원리를 이해하기에 가장 직관적인 예제입니다.

4단계: AndroidManifest.xml 권한 설정

갤러리의 외부 저장소 이미지에 접근하려면 매니페스트에 읽기 권한을 선언해야 합니다. androidManifest.xml에 아래와 같이 READ_EXTERNAL_STORAGE 권한을 추가합니다.

<?xml version="1.0" encoding="utf-8"?>
<manifest xmlns:android="https://schemas.android.com/apk/res/android" package="com.example.q11">
<uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE"/>
    <application
        android:allowBackup="true"
        android:icon="@mipmap/ic_launcher"
        android:label="@string/app_name"
        android:roundIcon="@mipmap/ic_launcher_round"
        android:supportsRtl="true"
        android:theme="@style/AppTheme">
        <activity android:name=".MainActivity">
            <intent-filter>
                <action android:name="android.intent.action.MAIN" />
                <category android:name="android.intent.category.LAUNCHER" />
            </intent-filter>
        </activity>
    </application>
</manifest>

앱 실행 및 결과 확인

이제 애플리케이션을 실행해 보겠습니다. 실제 안드로이드 스마트폰을 컴퓨터에 USB로 연결했다고 가정합니다. Android Studio에서 프로젝트의 액티비티 파일을 연 뒤 툴바의 Run 아이콘을 클릭합니다. 실행 대상 목록에서 연결된 모바일 기기를 선택하면, 기기 화면에 앱의 기본 화면이 나타납니다.

버튼을 누르면 갤러리가 열리고, 이미지를 하나 선택하면 해당 사진이 앱 화면의 ImageView에 즉시 표시됩니다. 이처럼 ACTION_PICK 인텐트와 onActivityResult() 콜백만으로도 간단하게 갤러리 이미지 선택 기능을 구현할 수 있습니다.