이 글에서는 안드로이드 앱에서 런타임 권한(Runtime Permission)을 요청한 뒤 SD 카드(외부 저장소)의 파일 목록을 불러와 ListView에 표시하는 방법을 단계별로 살펴봅니다.
1단계 — 새 프로젝트 만들기
Android Studio에서 File → New Project 메뉴로 이동한 후, 프로젝트 생성에 필요한 정보를 모두 입력하여 새 프로젝트를 만듭니다.
2단계 — 레이아웃 작성(res/layout/activity_main.xml)
아래 코드를 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/read"
android:text="read"
android:layout_width="wrap_content"
android:layout_height="wrap_content" />
<ListView
android:id="@+id/list"
android:layout_width="match_parent"
android:layout_height="wrap_content"></ListView>
</LinearLayout>레이아웃에는 버튼 하나와 ListView 하나가 배치되어 있습니다. 사용자가 버튼을 클릭하면 외부 저장소의 파일 정보를 읽어와 ListView에 담아 화면에 표시합니다.
3단계 — MainActivity 구현(src/MainActivity.java)
아래 코드를 MainActivity.java에 추가합니다. 이 예제는 현재 표준인 androidx 라이브러리를 기준으로 작성되었으며, 기존 support 라이브러리를 사용하는 프로젝트라면 import 경로만 변경하면 됩니다.
package com.example.andy.myapplication;
import android.Manifest;
import android.content.pm.PackageManager;
import android.os.Build;
import android.os.Bundle;
import android.os.Environment;
import android.util.Log;
import android.view.View;
import android.widget.ArrayAdapter;
import android.widget.Button;
import android.widget.ListView;
import android.widget.Toast;
import androidx.appcompat.app.AppCompatActivity;
import androidx.core.app.ActivityCompat;
import androidx.core.content.ContextCompat;
import java.io.File;
import java.util.ArrayList;
public class MainActivity extends AppCompatActivity {
private static final int PERMISSION_REQUEST_CODE = 100;
private Button read;
private ArrayList<String> myList;
private ListView listview;
@Override
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.activity_main);
listview = findViewById(R.id.list);
read = findViewById(R.id.read);
myList = new ArrayList<>();
read.setOnClickListener(new View.OnClickListener() {
@Override
public void onClick(View v) {
String state = Environment.getExternalStorageState();
if (!Environment.MEDIA_MOUNTED.equals(state)) {
Toast.makeText(MainActivity.this, "SD 카드가 마운트되지 않았습니다.", Toast.LENGTH_SHORT).show();
return;
}
// Android 6.0(API 23) 이상에서는 런타임 권한 확인 필요
if (Build.VERSION.SDK_INT >= 23) {
if (checkPermission()) {
loadFileList();
} else {
requestPermission(); // 권한 요청
}
} else {
loadFileList();
}
}
});
}
// 외부 저장소의 파일 이름을 읽어 ListView에 표시
private void loadFileList() {
File dir = new File(Environment.getExternalStorageDirectory().getAbsolutePath() + "/");
if (dir.exists()) {
Log.d("path", dir.toString());
File[] files = dir.listFiles();
if (files != null) {
for (File file : files) {
myList.add(file.getName());
}
}
ArrayAdapter arrayAdapter = new ArrayAdapter(MainActivity.this,
android.R.layout.simple_list_item_1, myList);
listview.setAdapter(arrayAdapter);
}
}
// 권한 부여 여부 확인
private boolean checkPermission() {
int result = ContextCompat.checkSelfPermission(MainActivity.this,
Manifest.permission.READ_EXTERNAL_STORAGE);
return result == PackageManager.PERMISSION_GRANTED;
}
// 권한 요청 처리
private void requestPermission() {
if (ActivityCompat.shouldShowRequestPermissionRationale(MainActivity.this,
Manifest.permission.READ_EXTERNAL_STORAGE)) {
Toast.makeText(MainActivity.this,
"저장소 읽기 권한이 있어야 파일 목록을 확인할 수 있습니다. 앱 설정에서 권한을 허용해 주세요.",
Toast.LENGTH_LONG).show();
} else {
ActivityCompat.requestPermissions(MainActivity.this,
new String[]{Manifest.permission.READ_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", "권한이 승인되어 로컬 드라이브에 접근할 수 있습니다.");
loadFileList(); // 권한 승인 직후 파일 목록 로드
} else {
Log.e("value", "권한이 거부되어 로컬 드라이브에 접근할 수 없습니다.");
}
break;
}
}
}코드 흐름은 다음과 같습니다. 먼저 외부 저장소의 마운트 상태를 확인하고, API 23(Android 6.0) 이상에서는 READ_EXTERNAL_STORAGE 권한이 이미 부여되었는지 검사합니다. 권한이 없으면 시스템 권한 다이얼로그를 호출하고, 사용자가 권한을 승인하면 콜백(onRequestPermissionsResult)을 통해 파일 목록을 불러옵니다.
4단계 — 권한 선언(manifest.xml)
외부 저장소에 접근하려면 매니페스트 파일에 관련 권한을 반드시 선언해야 합니다. 아래 코드를 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 Studio에서 프로젝트의 액티비티 파일 중 하나를 연 뒤 툴바의 Run 아이콘을 클릭하고, 실행 대상으로 자신의 모바일 기기를 선택하세요. 그러면 기기에 아래와 같은 기본 화면이 나타납니다.
위 화면에서 read 버튼을 클릭하면, 권한 승인 후 외부 저장소 디렉터리의 파일 목록이 ListView에 다음과 같이 표시됩니다.
참고 — 최신 안드로이드 버전에서의 저장소 권한
Android 10(API 29)부터는 범위 지정 저장소(Scoped Storage)가 도입되었고, Android 13(API 33) 이상에서는 READ_EXTERNAL_STORAGE 대신 READ_MEDIA_IMAGES, READ_MEDIA_VIDEO, READ_MEDIA_AUDIO처럼 미디어 유형별로 세분화된 권한을 사용합니다. 다양한 OS 버전을 지원하려면 매니페스트에서 maxSdkVersion 속성을 활용해 권한을 조건부로 선언하는 것이 좋습니다.