이 튜토리얼에서는 안드로이드 앱에서 기기의 이미지 갤러리에 접근하여 사용자가 원하는 이미지를 선택하고, 그 이미지를 화면에 표시하는 방법을 단계별로 알아봅니다.
1단계: 새 프로젝트 생성
Android Studio를 실행한 후 File ⇒ New Project 메뉴로 이동하여 새 프로젝트를 생성하고, 프로젝트 생성에 필요한 모든 세부 정보를 입력합니다.
2단계: 레이아웃 파일 작성 (res/layout/activity_main.xml)
선택한 이미지를 표시할 ImageView와 갤러리를 여는 역할을 하는 Button으로 구성된 레이아웃을 아래와 같이 작성합니다.
<?xml version="1.0" encoding="utf-8"?> <LinearLayout xmlns:android="https://schemas.android.com/apk/res/android" android:orientation="vertical" android:layout_width="fill_parent" android:layout_height="fill_parent"> <ImageView android:id="@+id/imageView" android:layout_width="fill_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_weight="0" android:text="Load Picture" android:layout_gravity="center"/> </LinearLayout>
3단계: 메인 액티비티 코드 작성 (src/MainActivity.java)
ACTION_PICK 인텐트를 사용해 내부 이미지 저장소(MediaStore)를 대상으로 갤러리를 열고, onActivityResult() 콜백에서 사용자가 선택한 이미지의 URI를 받아 ImageView에 표시합니다.
import android.app.Activity;
import android.content.Intent;
import android.net.Uri;
import android.os.Bundle;
import android.provider.MediaStore;
import android.view.View;
import android.widget.Button;
import android.widget.ImageView;
public class MainActivity extends Activity {
ImageView imageView;
Button button;
private static final int PICK_IMAGE = 100;
Uri imageUri;
@Override
public void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.activity_main);
imageView = (ImageView)findViewById(R.id.imageView);
button = (Button)findViewById(R.id.buttonLoadPicture);
button.setOnClickListener(new View.OnClickListener() {
@Override
public void onClick(View v) {
openGallery();
}
});
}
private void openGallery() {
Intent gallery = new Intent(Intent.ACTION_PICK, MediaStore.Images.Media.INTERNAL_CONTENT_URI);
startActivityForResult(gallery, PICK_IMAGE);
}
@Override
protected void onActivityResult(int requestCode, int resultCode, Intent data){
super.onActivityResult(requestCode, resultCode, data);
if (resultCode == RESULT_OK && requestCode == PICK_IMAGE){
imageUri = data.getData();
imageView.setImageURI(imageUri);
}
}
}
4단계: 매니페스트 권한 설정 (AndroidManifest.xml)
갤러리의 이미지에 접근하려면 외부 저장소 읽기 권한인 READ_EXTERNAL_STORAGE가 필요합니다. 매니페스트 파일에 아래와 같이 권한을 추가합니다.
<?xml version="1.0" encoding="utf-8"?> <manifest xmlns:android="https://schemas.android.com/apk/res/android" package="app.com.sample"> <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>
앱 실행 및 결과 확인
이제 애플리케이션을 실행해 보겠습니다. 실제 안드로이드 모바일 기기를 컴퓨터에 연결했다고 가정합니다. Android Studio에서 프로젝트의 액티비티 파일 중 하나를 연 다음, 툴바의 Run 아이콘을 클릭하여 앱을 실행합니다. 옵션 목록에서 자신의 모바일 기기를 선택하면, 기기 화면에 아래와 같은 기본 화면이 표시됩니다.
참고: 최신 안드로이드 개발 환경에서는 위와 같은 startActivityForResult() 방식보다 ActivityResultContracts.GetContent() 또는 PickVisualMedia를 활용하는 Activity Result API 사용이 권장됩니다. 또한 Android 13(API 33) 이상에서는 세분화된 미디어 권한(READ_MEDIA_IMAGES)이 도입되었으므로, 타겟 SDK 버전에 맞게 권한 선언을 조정하는 것이 좋습니다.