Microsoft MVP성태의 닷넷 이야기
Phone: 16. C# MAUI - /Download 등의 공용 디렉터리에 접근하는 방법 [링크 복사], [링크+제목 복사],
조회: 1229
글쓴 사람
정성태 (seongtaejeong at gmail.com)
홈페이지
첨부 파일
 

(시리즈 글이 4개 있습니다.)
Phone: 16. C# MAUI - /Download 등의 공용 디렉터리에 접근하는 방법
; https://www.sysnet.pe.kr/2/0/13631

Phone: 17. C# MAUI - Android 내에 Web 서비스 호스팅
; https://www.sysnet.pe.kr/2/0/13632

Phone: 18. C# MAUI - 안드로이드 플랫폼에서의 Activity 제어
; https://www.sysnet.pe.kr/2/0/13634

Phone: 21. C# MAUI - Android 환경에서의 파일 다운로드(DownloadManager)
; https://www.sysnet.pe.kr/2/0/13640




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 경고가 발생한다면?

warning CA1416: This call site is reachable on: 'Android' 21.0 and later. 'Environment.IsExternalStorageManager' is only supported on: 'android' 30.0 and later. (https://learn.microsoft.com/dotnet/fundamentals/code-analysis/quality-rules/ca1416)


말 그대로 IsExternalStorageManager 속성은 30.0부터 지원하는 기능인데 현재 MAUI 프로젝트가 21.0 대상으로 빌드하고 있기 때문에 발생하는 것입니다.

따라서 저 기능을 쓰지 말든가, 아니면 MAU 프로젝트의 최소 Android 지원 버전을 30.0으로 바꾸면 되는데요, 후자의 경우 csproj에서 SupportedOSPlatformVersion 변경으로 가능합니다.

<SupportedOSPlatformVersion Condition="$([MSBuild]::GetTargetPlatformIdentifier('$(TargetFramework)')) == 'android'">30.0</SupportedOSPlatformVersion>




[이 글에 대해서 여러분들과 의견을 공유하고 싶습니다. 틀리거나 미흡한 부분 또는 의문 사항이 있으시면 언제든 댓글 남겨주십시오.]







[최초 등록일: ]
[최종 수정일: 6/10/2024]

Creative Commons License
이 저작물은 크리에이티브 커먼즈 코리아 저작자표시-비영리-변경금지 2.0 대한민국 라이센스에 따라 이용하실 수 있습니다.
by SeongTae Jeong, mailto:techsharer at outlook.com

비밀번호

댓글 작성자
 




[1]  2  3  4  5  6  7  8  9  10  11  12  13  14  15  ...
NoWriterDateCnt.TitleFile(s)
13646정성태6/14/2024271오류 유형: 908. Process Explorer - "Error configuring dump resources: The system cannot find the file specified."
13645정성태6/13/2024513개발 환경 구성: 711. Visual Studio로 개발 시 기본 등록하는 dev tag 이미지로 Docker Desktop k8s에서 실행하는 방법
13644정성태6/12/2024542닷넷: 2265. C# - System.Text.Json의 기본적인 (한글 등에서의) escape 처리
13643정성태6/12/2024527오류 유형: 907. MySqlConnector 사용 시 System.IO.FileLoadException 오류
13642정성태6/11/2024533스크립트: 65. 파이썬 - asgi 버전(2, 3)에 따라 달라지는 uvicorn 호스팅
13641정성태6/11/2024720Linux: 71. Ubuntu 20.04를 22.04로 업데이트
13640정성태6/10/2024887Phone: 21. C# MAUI - Android 환경에서의 파일 다운로드(DownloadManager)
13639정성태6/8/2024829오류 유형: 906. C# MAUI - Android Emulator에서 "Waiting For Debugger"로 무한 대기
13638정성태6/8/2024960오류 유형: 905. C# MAUI - 추가한 layout XML 파일이 Resource.Layout 멤버로 나오지 않는 문제
13637정성태6/6/20241078Phone: 20. C# MAUI - 유튜브 동영상을 MediaElement로 재생하는 방법
13636정성태5/30/20241100닷넷: 2264. C# - 형식 인자로 인터페이스를 갖는 제네릭 타입으로의 형변환파일 다운로드1
13635정성태5/29/2024930Phone: 19. C# MAUI - 안드로이드 "Share" 대상으로 등록하는 방법
13634정성태5/24/20241185Phone: 18. C# MAUI - 안드로이드 플랫폼에서의 Activity 제어
13633정성태5/22/20241131스크립트: 64. 파이썬 - ASGI를 만족하는 최소한의 구현 코드
13632정성태5/20/20241235Phone: 17. C# MAUI - Android 내에 Web 서비스 호스팅
13631정성태5/19/20241229Phone: 16. C# MAUI - /Download 등의 공용 디렉터리에 접근하는 방법
13630정성태5/19/20241588닷넷: 2263. C# - Thread가 Task보다 더 빠르다는 어떤 예제(?)
13629정성태5/18/20241407개발 환경 구성: 710. Android - adb.exe를 이용한 파일 전송
13628정성태5/17/20241396개발 환경 구성: 709. Windows - WHPX(Windows Hypervisor Platform)를 이용한 Android Emulator 가속
13627정성태5/17/20241377오류 유형: 904. 파이썬 - UnicodeEncodeError: 'ascii' codec can't encode character '...' in position ...: ordinal not in range(128)
13626정성태5/15/20241515Phone: 15. C# MAUI - MediaElement Source 경로 지정 방법파일 다운로드1
13625정성태5/14/20241788닷넷: 2262. C# - Exception Filter 조건(when)을 갖는 catch 절의 IL 구조
13624정성태5/12/20241978Phone: 14. C# - MAUI에서 MediaElement 사용파일 다운로드1
13623정성태5/11/20242144닷넷: 2261. C# - 구글 OAuth의 JWT (JSON Web Tokens) 해석파일 다운로드1
13622정성태5/10/20242065닷넷: 2260. C# - Google 로그인 연동 (ASP.NET 예제)파일 다운로드1
[1]  2  3  4  5  6  7  8  9  10  11  12  13  14  15  ...