이 튜토리얼에서는 Android에서 런타임 권한(runtime permission)을 활용해 외부 저장소(External Storage)에 이미지 파일을 저장하는 방법을 단계별로 살펴봅니다.
1단계 — 새 프로젝트 생성
Android Studio에서 File → New Project를 선택하여 새 프로젝트를 만들고, 프로젝트 생성에 필요한 모든 정보를 입력합니다.
2단계 — 레이아웃 작성
res/layout/activity_main.xml 파일에 아래 코드를 추가합니다.
<?xml version="1.0" encoding="utf-8"?>
<LinearLayout xmlns:android="https://schemas.android.com/apk/res/android"
xmlns:tools="https://schemas.android.com/tools"
android:layout_width="match_parent"
android:layout_height="match_parent"
tools:context=".MainActivity"
android:orientation="vertical">
<Button
android:id="@+id/save"
android:text="save"
android:layout_width="wrap_content"
android:layout_height="wrap_content" />
</LinearLayout>위 코드에는 버튼 하나만 배치되어 있습니다. 사용자가 이 버튼을 클릭하면 데이터가 외부 저장소에 저장됩니다.
3단계 — 메인 액티비티 코드 작성
src/MainActivity.java 파일에 아래 코드를 추가합니다.
package com.example.andy.myapplication;
import android.content.pm.PackageManager;
import android.graphics.Bitmap;
import android.graphics.drawable.BitmapDrawable;
import android.graphics.drawable.Drawable;
import android.os.Build;
import android.os.Bundle;
import android.os.Environment;
import android.support.annotation.NonNull;
import android.support.v4.app.ActivityCompat;
import android.support.v4.content.ContextCompat;
import android.support.v7.app.AppCompatActivity;
import android.util.Log;
import android.view.View;
import android.widget.Button;
import android.widget.Toast;
import java.io.File;
import java.io.FileOutputStream;
public class MainActivity extends AppCompatActivity {
private static final int PERMISSION_REQUEST_CODE = 100;
Button save;
Bitmap bitmap;
@Override
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.activity_main);
Drawable drawable = getResources().getDrawable(R.drawable.mario);
bitmap = ((BitmapDrawable) drawable).getBitmap();
save = findViewById(R.id.save);
save.setOnClickListener(new View.OnClickListener() {
@Override
public void onClick(View v) {
String state = Environment.getExternalStorageState();
if (Environment.MEDIA_MOUNTED.equals(state)) {
if (Build.VERSION.SDK_INT >= 23) {
if (checkPermission()) {
String path = Environment.getExternalStorageDirectory().toString();
File file = new File(path, "UniqueFileName" + ".jpg");
if (!file.exists()) {
Log.d("path", file.toString());
try {
FileOutputStream fos = new FileOutputStream(file);
bitmap.compress(Bitmap.CompressFormat.JPEG, 100, fos);
fos.flush();
fos.close();
} catch (Exception e) {
e.printStackTrace();
}
}
} else {
requestPermission(); // 권한 요청 코드
}
} else {
String path = Environment.getExternalStorageDirectory().toString();
File file = new File(path, "UniqueFileName" + ".jpg");
if (!file.exists()) {
Log.d("path", file.toString());
FileOutputStream fos = null;
try {
fos = new FileOutputStream(file);
bitmap.compress(Bitmap.CompressFormat.JPEG, 100, fos);
fos.flush();
fos.close();
} catch (java.io.IOException e) {
e.printStackTrace();
}
}
}
}
}
});
}
private boolean checkPermission() {
int result = ContextCompat.checkSelfPermission(MainActivity.this,
android.Manifest.permission.WRITE_EXTERNAL_STORAGE);
return result == PackageManager.PERMISSION_GRANTED;
}
private void requestPermission() {
if (ActivityCompat.shouldShowRequestPermissionRationale(MainActivity.this,
android.Manifest.permission.WRITE_EXTERNAL_STORAGE)) {
Toast.makeText(MainActivity.this,
"파일 저장을 위해서는 외부 저장소 쓰기 권한이 필요합니다. 앱 설정에서 권한을 허용해 주세요.",
Toast.LENGTH_LONG).show();
} else {
ActivityCompat.requestPermissions(MainActivity.this,
new String[]{android.Manifest.permission.WRITE_EXTERNAL_STORAGE},
PERMISSION_REQUEST_CODE);
}
}
@Override
public void onRequestPermissionsResult(int requestCode, String permissions[], int[] grantResults) {
switch (requestCode) {
case PERMISSION_REQUEST_CODE:
if (grantResults.length > 0 && grantResults[0] == PackageManager.PERMISSION_GRANTED) {
Log.e("value", "권한 승인됨. 이제 로컬 드라이브를 사용할 수 있습니다.");
} else {
Log.e("value", "권한 거부됨. 로컬 드라이브를 사용할 수 없습니다.");
}
break;
}
}
}코드 동작 방식
핵심 로직은 다음과 같습니다.
checkPermission() — WRITE_EXTERNAL_STORAGE 권한이 이미 부여되었는지 확인합니다. 마시멜로(API 23) 이상에서는 런타임 권한 확인이 필수이며, 그 미만 버전에서는 설치 시점에 권한이 자동 부여되므로 바로 저장을 진행합니다.
requestPermission() — 권한이 없을 경우 시스템 권한 대화상자를 호출합니다. 사용자가 이전에 권한을 거부한 적이 있다면 shouldShowRequestPermissionRationale()이 true를 반환하므로, 왜 권한이 필요한지 안내하는 토스트 메시지를 먼저 보여주는 것이 좋습니다.
onRequestPermissionsResult() — 사용자의 권한 승인 여부 결과를 콜백으로 받아 처리합니다.
버튼 클릭 시에는 먼저 Environment.getExternalStorageState()로 외부 저장소가 마운트된 상태인지 확인한 뒤, 비트맵을 JPEG 형식으로 압축하여 FileOutputStream으로 파일에 기록합니다.
4단계 — 매니페스트 설정
manifest.xml 파일에 아래 코드를 추가합니다.
<?xml version="1.0" encoding="utf-8"?>
<manifest xmlns:android="https://schemas.android.com/apk/res/android"
package="com.example.andy.myapplication">
<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE"/>
<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 기기가 컴퓨터에 연결되어 있다고 가정합니다. Android Studio에서 프로젝트의 액티비티 파일 중 하나를 연 후 툴바의 실행(Run) 아이콘을 클릭하세요. 목록에서 자신의 모바일 기기를 선택하면 기기에 아래와 같은 기본 화면이 표시됩니다.
위 화면에서 save 버튼을 클릭하면 권한 요청 대화상자가 나타나고, 권한을 승인하면 아래와 같이 이미지가 외부 저장소에 저장됩니다.
참고: 최신 Android 버전에서의 주의 사항
Android 10(API 29)부터 도입된 범위 지정 저장소(Scoped Storage) 정책으로 인해, 공용 저장소에 임의의 파일을 직접 쓰는 방식은 점차 제한되고 있습니다. Android 10 이상을 지원해야 한다면 MediaStore API를 통해 이미지를 저장하거나, 앱 전용 디렉터리(getExternalFilesDir())를 사용하는 것이 좋습니다. 다만 이 예제는 런타임 권한 요청 흐름을 이해하는 데 유용한 기본 패턴을 잘 보여줍니다.