XAML in Xamarin.Forms 基礎篇 電子書

XAML in Xamarin.Forms 基礎篇 電子書
XAML in Xamarin.Forms 基礎篇 電子書

Xamarin.Forms 快速入門 電子書

Xamarin.Forms 快速入門 電子書
Xamarin.Forms 快速入門 電子書

2018/06/04

Xamarin.Android 執行時期的權限處理說明 3 使用手機內其他 PDF App 來開啟在 download 資料夾內的檔案

範例專案 : XFFileProvider

了解更多關於 [Xamarin.Android] 的使用方式
了解更多關於 [Xamarin.iOS] 的使用方式
了解更多關於 [Xamarin.Forms] 的使用方式
了解更多關於 [Hello, Android:快速入門] 的使用方式
了解更多關於 [Hello, iOS – 快速入門] 的使用方式
了解更多關於 [Xamarin.Forms 快速入門] 的使用方式
在上兩篇文章 Xamarin.Android 執行時期的權限處理說明 2 使用 Plugin.Permissions / Xamarin.Android 執行時期的權限處理說明 1 最低的 Android 版本 / 目標 Android 版本 / 目標 Framework 中,我們說明了 Android API Level 23 以上的作業系統,如何進行處理執行時期的權限授權處理方法,在這篇文章中,我們將會產生一個檔案到 Android 檔案系統中,不過,我們不是要將檔案儲存 App Sandbox 沙箱目錄內,而是要建立在 Download 資料夾內,這個資料夾內存在的檔案,連使用者也可以自行查看與開啟,不過,我們將要使用手機內已將安裝的其他,使用這些 App 來開啟這個檔案,在這裡,我們會建立一個 PDF 檔案,不過,檔案內容卻是一般文字,接者,可以讓使用者選取要使用哪個已安裝的 PDF 檢視軟體來開啟這個檔案。
不過,由於在 Android SDK 24 以上的版本,在使用 Intent 來開啟檔案的時候,加入了開啟檔案的權限判斷,因此,我們之前所使用的 Android.Net.Uri.FromFile(file); 方法,將會需要修改成為 Android.Support.V4.Content.FileProvider.GetUriForFile(Android.App.Application.Context,Android.App.Application.Context.PackageName + ".fileprovider", file); 這樣的方法呼叫,不過,還不只如此,我們還需要在 AndroidManifest 檔案內,加入額外的宣告,並且另外新增一個 XML 檔案。
因此,在這篇文章中,我們將會說明要如何做到這樣的事情,我們會設計一個頁面,裡面有兩個按鈕,第一個按鈕,將會取得使用者授權這個 App 可以使用 Storage 使用權限,第二個按鈕,將會在 download 目錄下產生一個 pdf 檔案,緊接著,將會使用手機內可以開啟 pdf 的檔案,幫助我們開啟這個 PDF 檔案與看到這些內容,當然,若您的手機中,可以開啟 pdf 的檔案 App 超過一個以上,Android 系統,將會顯示一個小對話窗,列出您手機中可以開啟 pdf 檔案的所有 App,您可以選擇任何一個來開啟這個 pdf 檔案。

在 Download 目錄下建立一個 PDF 檔案

在這個按鈕的命令委派方法中,我們透過相依性注入方法,取得了 download 目錄的路徑,並且包裝成為 PCLStorage 套件中使用的 IFolder 物件,如此,我們針對這個 IFolder 注入後的物件,也就是下面程式碼中的 rootFoler 變數,就可以在這個 download 目錄下來產生任何檔案了。我們將會在這裡產生一個 PDF.pdf 名稱的檔案,不過,該檔案內容僅是一個文字內容。
最後,我們使用相依性注入方法,取得了在 Android 平台下實作的 IOpenFileByName 物件,我們就可以針對該物件進行使用別的 App 來開啟這個檔案的動作了。
OpenPDFCommand = new DelegateCommand(async () =>
{
    string filename = "PDF.pdf";
    IFolder rootFolder = _publicFileSystem.PublicDownloadFolder;
    IFile file = await rootFolder.CreateFileAsync(filename, CreationCollisionOption.OpenIfExists);
    await file.WriteAllTextAsync("123");
    _openFileByName.OpenFile(file.Path);
});

開啟 Downoad 目錄下的檔案

底下的程式碼將會需要在 Android 原生專案內實作,因為需要使用到各種 Android SDK API,我們將透過傳送過來的檔案完整路徑,建立一個 Java.IO.File 物件,接著檢查 TargetSDK 是否小於 24,若是大於等於 API Level 24,我們將會需要 這個方法,來取得該檔案的 URI : Android.Support.V4.Content.FileProvider.GetUriForFile(Android.App.Application.Context,Android.App.Application.Context.PackageName + ".fileprovider", file);
接著,當然需要建立一個 Intent 物件,最後,呼叫這個方法 Android.App.Application.Context.StartActivity(intent); 來開啟這個檔案。
很不幸的,看似一切完美,可以當您實際執行這個專案,並點下按鈕之後,您將會得到這個例外異常錯誤訊息 : Attempt to invoke virtual method 'android.content.res.XmlResourceParser android.content.pm.PackageItemInfo.loadXmlMetaData(android.content.pm.PackageManager, java.lang.String)' on a null object reference
public void OpenFile(string fullFileName)
{
    try
    {
        Java.IO.File file = new Java.IO.File(fullFileName);
        file.SetReadable(true);

        string application = "";

        application = "application/pdf";

        var targetSdk = ResolvePackageTargetSdkVersion();
        if (targetSdk < 24)
        {
            Android.Net.Uri uri = Android.Net.Uri.FromFile(file);
            Intent intent = new Intent(Intent.ActionView);
            intent.SetDataAndType(uri, application);
            intent.SetFlags(ActivityFlags.ClearWhenTaskReset | ActivityFlags.NewTask);

            Android.App.Application.Context.StartActivity(intent);
            try
            {
                Android.App.Application.Context.StartActivity(intent);
            }
            catch (Exception)
            {
                Toast.MakeText(Android.App.Application.Context, "No Application Available to View this file.", ToastLength.Short).Show();
            }
        }
        else
        {
            var foo = Android.App.Application.Context.PackageName + ".fileprovider";
            Android.Net.Uri uri = Android.Support.V4.Content.FileProvider.GetUriForFile(
                Android.App.Application.Context,
                foo, file);

            Intent intent = new Intent(Intent.ActionView);
            intent.SetDataAndType(uri, application);
            intent.AddFlags(ActivityFlags.GrantReadUriPermission);
            intent.AddFlags(ActivityFlags.NoHistory);
            intent.AddFlags(ActivityFlags.ClearWhenTaskReset | ActivityFlags.NewTask);

            try
            {
                Android.App.Application.Context.StartActivity(intent);
            }
            catch (Exception)
            {
                Toast.MakeText(Android.App.Application.Context, "No Application Available to View this file.", ToastLength.Short).Show();
            }
        }
    }
    catch (Exception ex)
    {
        Console.WriteLine(ex.Message);
    }
}

其他設定

  • 請使用滑鼠雙擊您的 Android 專案 Properties 目錄,切換到 Android 資訊清單頁次,記錄下您這個 Android 專案的套件名稱。
  • 展開 Android 專案的 Properties 節點,您將會看到 AndroidManifest.xml 檔案,請打開他
  • 在 AndroidManifest.xml 檔案中加入底下的宣告
  • 在 android:authorities 屬性中,請使用您實際專案的套件名稱,替換掉這個字串: [Android 專案的套件名稱]
    <provider 
      android:name="android.support.v4.content.FileProvider" 
      android:authorities="[Android 專案的套件名稱].fileprovider" 
      android:exported="false" 
      android:grantUriPermissions="true">
      <meta-data 
        android:name="android.support.FILE_PROVIDER_PATHS" 
        android:resource="@layout/file_provider_path" />
    </provider>
  • 另外,我們需要建立一個 xml 檔案,在這裡,我們建立到 layout 目錄下,他的檔案內容如下:
<?xml version="1.0" encoding="utf-8"?>
<paths xmlns:android="http://schemas.android.com/apk/res/android">
  <external-path name="Download" path="Download/"/>
</paths>
好的,現在我們可以再度執行這個應用程式,當我們點選了 開啟 PDF 檔案,此時,螢幕最下方出現了 選擇開啟工具 對話窗,您可以選擇要使用哪個 App 來開啟這個檔案。
小米 Max 小米 Max



1 則留言: