C# MAUI - /Download 등의 공용 디렉터리에 접근하는 방법
가령, "Android Emulator"에 윈도우의 탐색기로부터 "file_example_MP4_1920_18MG.mp4" 파일을 드래그&드롭으로 놓으면 "/Download" 디렉터리에 파일이 생성된 것을 볼 수 있습니다.
자, 그럼 그 파일을 MAUI에서 접근하고 싶다면 어떻게 해야 할까요? 개인적으로 안드로이드 환경의 개발 이력을 모르니 ^^ 이런 간단한 것 하나도 헤매게 되는군요. ^^ 일단, 안드로이드의 파일 탐색기로 본 "/Download" 디렉터리는 사용자가 본 경로일 뿐, 내부적으로 코드에서 접근할 수 있는 경로는 "/storage/emulated/0/Download"입니다. 그럼, 아래와 같이 Download 디렉터리를 열거할 수 있을까요?
string downloadPath = Path.Combine(Android.OS.Environment.ExternalStorageDirectory?.AbsolutePath ?? "",
Android.OS.Environment.DirectoryDownloads ?? "");
// downloadPath == "/storage/emulated/0/Download"
// **System.UnauthorizedAccessException:** 'Access to the path '/storage/emulated/0/Download' is denied.'
var files = Directory.GetFiles(downloadPath, "*");
foreach (var file in files)
{
// ...
}
보는 바와 같이, "System.UnauthorizedAccessException" 예외가 발생합니다. 자, 그렇다면 권한을 주면 된다는 건데요, 이 과정은 2단계로 이뤄집니다. 첫 번째로, Android App이 그와 관련된 권한이 필요하다는 것을 AndroidManifest.xml에 READ_EXTERNAL_STORAGE 권한을 명시해야 합니다.
<?xml version="1.0" encoding="utf-8"?>
<manifest xmlns:android="http://schemas.android.com/apk/res/android">
<application android:allowBackup="true" android:icon="@mipmap/appicon" android:supportsRtl="true"></application>
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
<uses-permission android:name="android.permission.INTERNET" />
<uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE" />
<uses-sdk />
</manifest>
혹은, C#/MAUI답게 assembly로 권한을 주는 것도 가능합니다.
[assembly: UsesPermission(Name = Android.Manifest.Permission.ReadExternalStorage)]
두 번째로, 사용자로부터 반드시 해당 위치를 접근해도 좋다는 허락을 받아야만 합니다. 이것은 코드로 구현해야 하는데요, 보통은 권한이 필요한 시점에 다음과 같은 코드를 통해 권한 요청을 할 수 있습니다.
// ReadExternalStorage 권한을 사용자가 부여했는지 확인
PermissionStatus status = await Permissions.CheckStatusAsync<Permissions.StorageRead>();
if (status != PermissionStatus.Granted)
{
// 현재 App에 권한을 준 적이 없다면, 사용자에게 허락을 요청
// (일단 한번 허락을 받으면 이후에는 CheckStatusAsync에서 Granted가 뜹니다.)
var requestStatus = await Permissions.RequestAsync<Permissions.StorageRead>();
if (requestStatus != PermissionStatus.Granted)
{
return; // 사용자가 허락을 안 했으므로, 더 할 수 있는 작업이 없을 테고!
}
}
// 이후 코드에서는 ReadExternalStorage 권한이 있으므로 잘 동작함.
// ...[생략]...
저렇게 2가지 조건을 충족했으면, Directory.GetFiles로 접근할 수 있습니다.
string[] files = Directory.GetFiles("/storage/emulated/0/Download");
foreach (var item in files)
{
if (item.EndsWith(".txt"))
{
string text = File.ReadAllText(item);
}
}
또는, Android/Java로 만들던 코드와 유사하게 Java.IO.File로도 접근할 수 있습니다.
var downloadDir = Android.OS.Environment.GetExternalStoragePublicDirectory(Android.OS.Environment.DirectoryDownloads);
Java.IO.File[] files = downloadDir.ListFiles();
게다가 이게 참 방법이 다양한데요, 검색해 보니까, ContentResolver를 통해서도 조회하는 방법이 나옵니다.
[안드로이드] 안드로이드 Q(API 29)이상에서 이미지 파일 다루기
; https://velog.io/@bonimddal2/안드로이드-안드로이드-QAPI-29이상에서-이미지-파일-다루기
콘텐츠 제공자 기본사항
; https://developer.android.com/guide/topics/providers/content-provider-basics?hl=ko
Using Xamarin Android with MediaStore – Part 2
; https://keithbeattyblog.wordpress.com/2021/11/14/using-xamarin-android-with-mediastore-part-2/
위의 글을 종합해 보면 MAUI에서는 이렇게 구현할 수 있습니다.
{
Android.Content.ContentResolver contentResolver = Microsoft.Maui.ApplicationModel.Platform.CurrentActivity.ContentResolver;
string [] projection = [
Android.Provider.MediaStore.Downloads.InterfaceConsts.Id,
Android.Provider.MediaStore.Downloads.InterfaceConsts.DisplayName,
Android.Provider.MediaStore.Downloads.InterfaceConsts.MimeType,
];
// mime type이 video/mp4 유형의 파일만 조회
string selection = $"{Android.Provider.MediaStore.Downloads.InterfaceConsts.MimeType} = ?";
string[] selectionArgs = [ "video/mp4" ];
var cursor = contentResolver.Query(Android.Provider.MediaStore.Downloads.ExternalContentUri, projection, selection, selectionArgs, null);
int count = cursor.Count;
}
이 외에, 마이크로소프트에서 MAUI의 다중 플랫폼 지원에 맞게 감싼 File picker도 있습니다.
File picker
; https://learn.microsoft.com/en-us/dotnet/maui/platform-integration/storage/file-picker?tabs=android
단지, 이건 파일을 선택하는 외부 선택 창을 띄운 후 거기서 사용자가 직접 선택한 파일 목록을 반환해 주는 역할을 합니다. Windows API라면 FileDialog 창을 띄우는 것과 유사한 사용자 경험인데요, 이 방법이 다른 것들과 비교해 좋은 이유라면 별도의 권한 설정이 필요 없다는 점입니다. 왜냐하면, 1) 내부에서 직접 코드로 접근하는 것이 아닌, 외부의 서비스에 요청해 결과를 받는 방식이라는 점과, 2) 사용자 스스로 파일을 선택했다는 것으로 인해 별도의 권한 체크는 필요 없게 만든 것 같습니다.
그래서 코드는 대충 다음과 같이 작성할 수 있는데요,
{
FilePickerFileType customFileType = new FilePickerFileType(
new Dictionary<DevicePlatform, IEnumerable<string>>
{
{ DevicePlatform.iOS, new[] { "public.audio" } }, // UTType values
{ DevicePlatform.Android, new[] { "audio/*" } }, // MIME type
{ DevicePlatform.WinUI, new[] { ".mp3", ".wav", ".wma", ".m4a", ".flac" } }, // file extension
{ DevicePlatform.Tizen, new[] { "*/*" } },
{ DevicePlatform.macOS, new[] { ".mp3", ".wav", ".wma", ".m4a", ".flac" } }, // UTType values
});
PickOptions options = new()
{
PickerTitle = "Please select audio file's",
FileTypes = customFileType
};
// Download 디렉터리뿐만 아니라, 기기의 다른 공용 디렉터리에서 파일 선택이 가능
var fileResult = await FilePicker.Default.PickMultipleAsync(options);
if (fileResult != null)
{
foreach (FileResult file in fileResult)
{
string filePath = file.FullPath;
// filePath == "/data/user/0/com.companyname.simpleplayer/cache/2203693cc04e0be7f4f024d5f9499e13/3ebb31723ffa4b16b1eeeb44f4ae8a25/test.mp3"
FileStream fs = File.OpenRead(filePath);
long fileLen = fs.Length;
}
}
}
위의 코드는 사용자가 파일을 선택하는 창을 띄운 후, 그 목록을 fileResult로 받아 처리할 수 있게 해줍니다. 게다가 재미있는 것은 File picker를 통해 사용자가 선택한 파일은 분명히 /Download의 경로였지만 코드에서 반환받은 파일의 경로는 "/data/user/0/com.companyname.simpleplayer/cache/..."라는 점입니다. 실제로
adb shell로 들어가 확인해 보면,
C:\Program Files (x86)\Android\android-sdk> adb shell
1|emu64xa:/data $ run-as com.companyname.simpleplayer
emu64xa:/data/user/0/com.companyname.simpleplayer $ ls
cache code_cache files
emu64xa:/data/user/0/com.companyname.simpleplayer $ cd cache/2203693cc04e0be7f4f024d5f9499e13/3ebb31723ffa4b16b1eeeb44f4ae8a25
emu64xa:/data/... $ ls -l
total 8684
-rw------- 1 u0_a165 u0_a165_cache 8887261 2024-05-19 23:51 test.mp3
link 등의 경로가 아닌 걸로 봐서 실제 파일이 App 전용 경로의 cache 디렉터리로 복사된 듯합니다.
혹시 그렇다면, 우리도 (Android Emulator의 "Files"처럼) Android 탐색기와 같은 프로그램을 만들고 싶다면 어떻게 해야 할까요? 이런 경우라면 단순히 READ_EXTERNAL_STORAGE 권한으로는 안 될 텐데요, 검색해 보면 이런 답변들이 나옵니다.
MAUI on Android : listing folder contents of an SD Card and writing in it
; https://stackoverflow.com/questions/75880663/maui-on-android-listing-folder-contents-of-an-sd-card-and-writing-in-it
MAUI :System.UnauthorizedAccessException: Access to the path is denied
; https://stackoverflow.com/questions/73221292/maui-system-unauthorizedaccessexception-access-to-the-path-is-denied
정리하면, 이것 역시 사용자로부터 명식적으로 권한 허락을 받아야 한다는 점입니다. 이를 위해 이전에 READ_EXTERNAL_STORAGE 권한을 요청했을 때처럼 AndroidManifest.xml 파일에 MANAGE_EXTERNAL_STORAGE 항목을 하나 추가하고,
<uses-permission android:name="android.permission.MANAGE_EXTERNAL_STORAGE" />
코드에서는 사용자에게 요청 창을 띄워 권한을 획득해야 합니다.
private void CheckPermission()
{
if (!Android.OS.Environment.IsExternalStorageManager)
{
Intent intent = new Intent();
intent.SetAction(Android.Provider.Settings.ActionManageAppAllFilesAccessPermission);
Android.Net.Uri? uri = Android.Net.Uri.FromParts("package", this.PackageName, null);
intent.SetData(uri);
StartActivity(intent);
}
}
이렇게 하고 실행하면, 사용자에게 "Allow access to manage all files" 여부를 묻는 창을 띄웁니다. (이러한 요구는 사용자가 허락한 이후에는 두 번 다시 뜨지 않습니다.) 사용자가 허락을 하고, "뒤로 가기" 버튼을 눌러 응용 프로그램으로 돌아가면 이후 사용자 기기의 파일 시스템을 (역시 시스템이 허락하는 수준 내에서) 정상적으로 접근할 수 있게 됩니다.
당연히, (전역이 아닌) App 단위로 접근할 수 있는 경로라면 별다른 권한이 필요 없습니다. 예를 들어 아래와 같은 코드인데요,
{
string myPath = System.Environment.GetFolderPath(System.Environment.SpecialFolder.Personal);
// myPath == "/data/user/0/com.companyname.simpleplayer/files/Documents/"
FileStream fs = new(Path.Combine(myPath, "test.json"), FileMode.Create); // 예외 발생
StreamWriter sw = new StreamWriter(fs, System.Text.Encoding.UTF8);
await sw.WriteAsync("TEST is good");
sw.Close();
fs.Close();
}
하지만 FileMode.Create로 파일을 생성하는 단계에서 DirectoryNotFoundException 예외가 발생합니다.
**System.IO.DirectoryNotFoundException:** 'Could not find a part of the path '/data/user/0/com.companyname.simpleplayer/files/Documents/test.json'.'
보니까, /Documents 디렉터리가 없어서 그런 것인데요, 일단 저 디렉터리를 만들어 주면 접근이 됩니다.
string myPath = System.Environment.GetFolderPath(System.Environment.SpecialFolder.Personal);
if (Directory.Exists(myPath) == false)
{
Directory.CreateDirectory(myPath);
}
(따라서 ^^ Environment.GetFolderPath를 이용해 반환받은 디렉터리 경로를 사용할 때는 약간의 주의를 요구합니다.)
[appid가 "com.companyname.mauiapp1"인 경우, Android 관련 경로를 구하는 각종 MAUI 코드]
Microsoft.Maui.ApplicationModel.Platform.CurrentActivity.ApplicationContext.ApplicationInfo.DataDir
예) /data/user/0/com.companyname.mauiapp1
FileSystem.Current.AppDataDirectory
예) /data/user/0/com.companyname.mauiapp1/files
FileSystem.Current.CacheDirectory
Microsoft.Maui.ApplicationModel.Platform.CurrentActivity.ApplicationContext.CacheDir
예) /data/user/0/com.companyname.mauiapp1/cache
Android.OS.Environment.ExternalStorageDirectory // External storage: https://learn.microsoft.com/en-us/previous-versions/xamarin/android/platform/files/external-storage#private-external-files
예) /storage/emulated/0
Android.OS.Environment.GetExternalStoragePublicDirectory(Android.OS.Environment.DirectoryDownloads);
예) /storage/emulated/0/Download
Microsoft.Maui.ApplicationModel.Platform.CurrentActivity.ApplicationContext.GetExternalFilesDir("")
예) /storage/emulated/0/Android/data/com.companyname.mauiapp1/files
Microsoft.Maui.ApplicationModel.Platform.CurrentActivity.ApplicationContext.ExternalCacheDir
예) /storage/emulated/0/Android/data/com.companyname.mauiapp1/cache
files = Microsoft.Maui.ApplicationModel.Platform.CurrentActivity.ApplicationContext.GetExternalCacheDirs();
예) files[0] == /storage/emulated/0/Android/data/com.companyname.mauiapp1/cache
예) files[1] == /storage/0AEC-3C13/Android/data/com.companyname.mauiapp1/cache
Microsoft.Maui.ApplicationModel.Platform.CurrentActivity.ApplicationContext.ApplicationInfo.DeviceProtectedDataDir
예) /data/user_de/0/com.companyname.mauiapp1
Microsoft.Maui.ApplicationModel.Platform.CurrentActivity.ApplicationContext.ApplicationInfo.PublicSourceDir
예) /data/app/~~W76ix361_DLAG9dJ2gTUeQ==/com.companyname.mauiapp1-Fnpp2MLV-yQe-lRxjZy5mA==/base.apk
Android Studio의 Device Explorer에서 파일을 다운로드하는 경우, 대상 디렉터리를 바꾸지 않는다면 윈도우의 경우 아래의 경로에 저장합니다.
형식) %LOCALAPPDATA%\Google\{안드로드스튜디오버전}\device-explorer\{에뮬레이터 이름}\_\storage\emulated\0\Android\data\{AppID}\files\Download
예제) %LOCALAPPDATA%\Google\AndroidStudio2023.3\device-explorer\Pixel 5 - API 33\_\storage\emulated\0\Android\data\com.companyname.simpleplayer\files\Download
참고로, CA1416 경고가 발생한다면?
말 그대로 IsExternalStorageManager 속성은 30.0부터 지원하는 기능인데 현재 MAUI 프로젝트가 21.0 대상으로 빌드하고 있기 때문에 발생하는 것입니다.
따라서 저 기능을 쓰지 말든가, 아니면 MAUI 프로젝트의 최소 Android 지원 버전을 30.0으로 바꾸면 되는데요, 후자의 경우 csproj에서 SupportedOSPlatformVersion 변경으로 가능합니다.
<SupportedOSPlatformVersion Condition="$([MSBuild]::GetTargetPlatformIdentifier('$(TargetFramework)')) == 'android'">30.0</SupportedOSPlatformVersion>
[이 글에 대해서 여러분들과 의견을 공유하고 싶습니다. 틀리거나 미흡한 부분 또는 의문 사항이 있으시면 언제든 댓글 남겨주십시오.]