[FilePicker] Add support for selecting PDF files (Issue 1404) (#1412)

Co-authored-by: Matthew Leibowitz <mattleibow@live.com>
2020-10-22 18:40:56 -04:00 · 2020-10-22 18:40:56 -04:00 · 95f0009b08
--- a/Samples/Samples/View/FilePickerPage.xaml
+++ b/Samples/Samples/View/FilePickerPage.xaml
@ -14,6 +14,7 @@
        <FlexLayout Direction="Row" Wrap="Wrap">
            <Button Text="Pick file" Command="{Binding PickFileCommand}" HorizontalOptions="FillAndExpand" />
            <Button Text="Pick image" Command="{Binding PickImageCommand}" HorizontalOptions="FillAndExpand" />
+            <Button Text="Pick pdf" Command="{Binding PickPdfCommand}" HorizontalOptions="FillAndExpand" />
            <Button Text="Pick custom type" Command="{Binding PickCustomTypeCommand}" HorizontalOptions="FillAndExpand" />
            <Button Text="Pick image and send email" Command="{Binding PickAndSendCommand}" HorizontalOptions="FillAndExpand" />
            <Button Text="Pick multiple files" Command="{Binding PickMultipleFilesCommand}" HorizontalOptions="FillAndExpand" />
--- a/Samples/Samples/ViewModel/FilePickerViewModel.cs
+++ b/Samples/Samples/ViewModel/FilePickerViewModel.cs
@ -19,6 +19,7 @@ namespace Samples.ViewModel
        {
            PickFileCommand = new Command(() => DoPickFile());
            PickImageCommand = new Command(() => DoPickImage());
+            PickPdfCommand = new Command(() => DoPickPdf());
            PickCustomTypeCommand = new Command(() => DoPickCustomType());
            PickAndSendCommand = new Command(() => DoPickAndSend());
            PickMultipleFilesCommand = new Command(() => DoPickMultipleFiles());
@ -28,6 +29,8 @@ namespace Samples.ViewModel

        public ICommand PickImageCommand { get; }

+        public ICommand PickPdfCommand { get; }
+
        public ICommand PickCustomTypeCommand { get; }

        public ICommand PickAndSendCommand { get; }
@ -68,6 +71,17 @@ namespace Samples.ViewModel
            await PickAndShow(options);
        }

+        async void DoPickPdf()
+        {
+            var options = new PickOptions
+            {
+                PickerTitle = "Please select a pdf",
+                FileTypes = FilePickerFileType.Pdf,
+            };
+
+            await PickAndShow(options);
+        }
+
        async void DoPickCustomType()
        {
            var customFileType =
--- a/Xamarin.Essentials/FilePicker/FilePicker.android.cs
+++ b/Xamarin.Essentials/FilePicker/FilePicker.android.cs
@ -69,22 +69,34 @@ namespace Xamarin.Essentials

    public partial class FilePickerFileType
    {
-        public static FilePickerFileType PlatformImageFileType() =>
+        static FilePickerFileType PlatformImageFileType() =>
            new FilePickerFileType(new Dictionary<DevicePlatform, IEnumerable<string>>
            {
                { DevicePlatform.Android, new[] { "image/png", "image/jpeg" } }
            });

-        public static FilePickerFileType PlatformPngFileType() =>
+        static FilePickerFileType PlatformPngFileType() =>
            new FilePickerFileType(new Dictionary<DevicePlatform, IEnumerable<string>>
            {
                { DevicePlatform.Android, new[] { "image/png" } }
            });

-        public static FilePickerFileType PlatformVideoFileType() =>
+        static FilePickerFileType PlatformJpegFileType() =>
+            new FilePickerFileType(new Dictionary<DevicePlatform, IEnumerable<string>>
+            {
+                { DevicePlatform.Android, new[] { "image/jpeg" } }
+            });
+
+        static FilePickerFileType PlatformVideoFileType() =>
            new FilePickerFileType(new Dictionary<DevicePlatform, IEnumerable<string>>
            {
                { DevicePlatform.Android, new[] { "video/*" } }
            });
+
+        static FilePickerFileType PlatformPdfFileType() =>
+            new FilePickerFileType(new Dictionary<DevicePlatform, IEnumerable<string>>
+            {
+                { DevicePlatform.Android, new[] { "application/pdf" } }
+            });
    }
 }
--- a/Xamarin.Essentials/FilePicker/FilePicker.ios.cs
+++ b/Xamarin.Essentials/FilePicker/FilePicker.ios.cs
@ -74,22 +74,34 @@ namespace Xamarin.Essentials

    public partial class FilePickerFileType
    {
-        public static FilePickerFileType PlatformImageFileType() =>
+        static FilePickerFileType PlatformImageFileType() =>
            new FilePickerFileType(new Dictionary<DevicePlatform, IEnumerable<string>>
            {
                { DevicePlatform.iOS, new[] { (string)UTType.Image } }
            });

-        public static FilePickerFileType PlatformPngFileType() =>
+        static FilePickerFileType PlatformPngFileType() =>
            new FilePickerFileType(new Dictionary<DevicePlatform, IEnumerable<string>>
            {
                { DevicePlatform.iOS, new[] { (string)UTType.PNG } }
            });

-        public static FilePickerFileType PlatformVideoFileType() =>
+        static FilePickerFileType PlatformJpegFileType() =>
+            new FilePickerFileType(new Dictionary<DevicePlatform, IEnumerable<string>>
+            {
+                { DevicePlatform.iOS, new[] { (string)UTType.JPEG } }
+            });
+
+        static FilePickerFileType PlatformVideoFileType() =>
            new FilePickerFileType(new Dictionary<DevicePlatform, IEnumerable<string>>
            {
                { DevicePlatform.iOS, new string[] { UTType.MPEG4, UTType.Video, UTType.AVIMovie, UTType.AppleProtectedMPEG4Video, "mp4", "m4v", "mpg", "mpeg", "mp2", "mov", "avi", "mkv", "flv", "gifv", "qt" } }
            });
+
+        static FilePickerFileType PlatformPdfFileType() =>
+            new FilePickerFileType(new Dictionary<DevicePlatform, IEnumerable<string>>
+            {
+                { DevicePlatform.iOS, new[] { (string)UTType.PDF } }
+            });
    }
 }
--- a/Xamarin.Essentials/FilePicker/FilePicker.macos.cs
+++ b/Xamarin.Essentials/FilePicker/FilePicker.macos.cs
@ -51,22 +51,34 @@ namespace Xamarin.Essentials

    public partial class FilePickerFileType
    {
-        public static FilePickerFileType PlatformImageFileType() =>
+        static FilePickerFileType PlatformImageFileType() =>
            new FilePickerFileType(new Dictionary<DevicePlatform, IEnumerable<string>>
            {
                { DevicePlatform.macOS, new string[] { UTType.PNG, UTType.JPEG, "jpeg" } }
            });

-        public static FilePickerFileType PlatformPngFileType() =>
+        static FilePickerFileType PlatformPngFileType() =>
            new FilePickerFileType(new Dictionary<DevicePlatform, IEnumerable<string>>
            {
                { DevicePlatform.macOS, new string[] { UTType.PNG } }
            });

-        public static FilePickerFileType PlatformVideoFileType() =>
+        static FilePickerFileType PlatformJpegFileType() =>
+            new FilePickerFileType(new Dictionary<DevicePlatform, IEnumerable<string>>
+            {
+                { DevicePlatform.macOS, new string[] { UTType.JPEG } }
+            });
+
+        static FilePickerFileType PlatformVideoFileType() =>
            new FilePickerFileType(new Dictionary<DevicePlatform, IEnumerable<string>>
            {
                { DevicePlatform.macOS, new string[] { UTType.MPEG4, UTType.Video, UTType.AVIMovie, UTType.AppleProtectedMPEG4Video, "mp4", "m4v", "mpg", "mpeg", "mp2", "mov", "avi", "mkv", "flv", "gifv", "qt" } }
            });
+
+        static FilePickerFileType PlatformPdfFileType() =>
+            new FilePickerFileType(new Dictionary<DevicePlatform, IEnumerable<string>>
+            {
+                { DevicePlatform.macOS, new string[] { UTType.PDF } }
+            });
    }
 }
--- a/Xamarin.Essentials/FilePicker/FilePicker.netstandard.watchos.tvos.cs
+++ b/Xamarin.Essentials/FilePicker/FilePicker.netstandard.watchos.tvos.cs
@ -18,7 +18,13 @@ namespace Xamarin.Essentials
        static FilePickerFileType PlatformPngFileType()
            => throw new NotImplementedInReferenceAssemblyException();

+        static FilePickerFileType PlatformJpegFileType()
+            => throw new NotImplementedInReferenceAssemblyException();
+
        static FilePickerFileType PlatformVideoFileType()
            => throw new NotImplementedInReferenceAssemblyException();
+
+        static FilePickerFileType PlatformPdfFileType()
+            => throw new NotImplementedInReferenceAssemblyException();
    }
 }
--- a/Xamarin.Essentials/FilePicker/FilePicker.shared.cs
+++ b/Xamarin.Essentials/FilePicker/FilePicker.shared.cs
@ -19,7 +19,9 @@ namespace Xamarin.Essentials
    {
        public static readonly FilePickerFileType Images = PlatformImageFileType();
        public static readonly FilePickerFileType Png = PlatformPngFileType();
+        public static readonly FilePickerFileType Jpeg = PlatformJpegFileType();
        public static readonly FilePickerFileType Videos = PlatformVideoFileType();
+        public static readonly FilePickerFileType Pdf = PlatformPdfFileType();

        readonly IDictionary<DevicePlatform, IEnumerable<string>> fileTypes;

--- a/Xamarin.Essentials/FilePicker/FilePicker.tizen.cs
+++ b/Xamarin.Essentials/FilePicker/FilePicker.tizen.cs
@ -48,22 +48,34 @@ namespace Xamarin.Essentials

    public partial class FilePickerFileType
    {
-        public static FilePickerFileType PlatformImageFileType() =>
+        static FilePickerFileType PlatformImageFileType() =>
            new FilePickerFileType(new Dictionary<DevicePlatform, IEnumerable<string>>
            {
                { DevicePlatform.Tizen, new[] { "image/*" } },
            });

-        public static FilePickerFileType PlatformPngFileType() =>
+        static FilePickerFileType PlatformPngFileType() =>
            new FilePickerFileType(new Dictionary<DevicePlatform, IEnumerable<string>>
            {
                { DevicePlatform.Tizen, new[] { "image/png" } }
            });

-        public static FilePickerFileType PlatformVideoFileType() =>
+        static FilePickerFileType PlatformJpegFileType() =>
+            new FilePickerFileType(new Dictionary<DevicePlatform, IEnumerable<string>>
+            {
+                { DevicePlatform.Tizen, new[] { "image/jpeg" } }
+            });
+
+        static FilePickerFileType PlatformVideoFileType() =>
            new FilePickerFileType(new Dictionary<DevicePlatform, IEnumerable<string>>
            {
                { DevicePlatform.Tizen, new[] { "video/*" } }
            });
+
+        static FilePickerFileType PlatformPdfFileType() =>
+            new FilePickerFileType(new Dictionary<DevicePlatform, IEnumerable<string>>
+            {
+                { DevicePlatform.Tizen, new[] { "application/pdf" } }
+            });
    }
 }
--- a/Xamarin.Essentials/FilePicker/FilePicker.uwp.cs
+++ b/Xamarin.Essentials/FilePicker/FilePicker.uwp.cs
@ -64,22 +64,34 @@ namespace Xamarin.Essentials

    public partial class FilePickerFileType
    {
-        public static FilePickerFileType PlatformImageFileType() =>
+        static FilePickerFileType PlatformImageFileType() =>
            new FilePickerFileType(new Dictionary<DevicePlatform, IEnumerable<string>>
            {
                { DevicePlatform.UWP, new[] { "*.png", "*.jpg", "*.jpeg", "*.gif", "*.bmp" } }
            });

-        public static FilePickerFileType PlatformPngFileType() =>
+        static FilePickerFileType PlatformPngFileType() =>
            new FilePickerFileType(new Dictionary<DevicePlatform, IEnumerable<string>>
            {
                { DevicePlatform.UWP, new[] { "*.png" } }
            });

-        public static FilePickerFileType PlatformVideoFileType() =>
+        static FilePickerFileType PlatformJpegFileType() =>
+            new FilePickerFileType(new Dictionary<DevicePlatform, IEnumerable<string>>
+            {
+                { DevicePlatform.UWP, new[] { "*.jpg", "*.jpeg" } }
+            });
+
+        static FilePickerFileType PlatformVideoFileType() =>
           new FilePickerFileType(new Dictionary<DevicePlatform, IEnumerable<string>>
           {
                { DevicePlatform.UWP, new[] { "*.mp4", "*.mov", "*.avi", "*.wmv", "*.m4v", "*.mpg", "*.mpeg", "*.mp2", "*.mkv", "*.flv", "*.gifv", "*.qt" } }
           });
+
+        static FilePickerFileType PlatformPdfFileType() =>
+            new FilePickerFileType(new Dictionary<DevicePlatform, IEnumerable<string>>
+            {
+                { DevicePlatform.UWP, new[] { "*.pdf" } }
+            });
    }
 }
--- a/docs/en/FrameworksIndex/xamarin-essentials-android.xml
+++ b/docs/en/FrameworksIndex/xamarin-essentials-android.xml
@ -402,14 +402,13 @@
    </Type>
    <Type Name="Xamarin.Essentials.FilePickerFileType" Id="T:Xamarin.Essentials.FilePickerFileType">
      <Member Id="F:Xamarin.Essentials.FilePickerFileType.Images" />
+      <Member Id="F:Xamarin.Essentials.FilePickerFileType.Jpeg" />
+      <Member Id="F:Xamarin.Essentials.FilePickerFileType.Pdf" />
      <Member Id="F:Xamarin.Essentials.FilePickerFileType.Png" />
      <Member Id="F:Xamarin.Essentials.FilePickerFileType.Videos" />
      <Member Id="M:Xamarin.Essentials.FilePickerFileType.#ctor" />
      <Member Id="M:Xamarin.Essentials.FilePickerFileType.#ctor(System.Collections.Generic.IDictionary{Xamarin.Essentials.DevicePlatform,System.Collections.Generic.IEnumerable{System.String}})" />
      <Member Id="M:Xamarin.Essentials.FilePickerFileType.GetPlatformFileType(Xamarin.Essentials.DevicePlatform)" />
-      <Member Id="M:Xamarin.Essentials.FilePickerFileType.PlatformImageFileType" />
-      <Member Id="M:Xamarin.Essentials.FilePickerFileType.PlatformPngFileType" />
-      <Member Id="M:Xamarin.Essentials.FilePickerFileType.PlatformVideoFileType" />
      <Member Id="P:Xamarin.Essentials.FilePickerFileType.Value" />
    </Type>
    <Type Name="Xamarin.Essentials.FileProvider" Id="T:Xamarin.Essentials.FileProvider">
--- a/docs/en/FrameworksIndex/xamarin-essentials-ios.xml
+++ b/docs/en/FrameworksIndex/xamarin-essentials-ios.xml
@ -390,14 +390,13 @@
    </Type>
    <Type Name="Xamarin.Essentials.FilePickerFileType" Id="T:Xamarin.Essentials.FilePickerFileType">
      <Member Id="F:Xamarin.Essentials.FilePickerFileType.Images" />
+      <Member Id="F:Xamarin.Essentials.FilePickerFileType.Jpeg" />
+      <Member Id="F:Xamarin.Essentials.FilePickerFileType.Pdf" />
      <Member Id="F:Xamarin.Essentials.FilePickerFileType.Png" />
      <Member Id="F:Xamarin.Essentials.FilePickerFileType.Videos" />
      <Member Id="M:Xamarin.Essentials.FilePickerFileType.#ctor" />
      <Member Id="M:Xamarin.Essentials.FilePickerFileType.#ctor(System.Collections.Generic.IDictionary{Xamarin.Essentials.DevicePlatform,System.Collections.Generic.IEnumerable{System.String}})" />
      <Member Id="M:Xamarin.Essentials.FilePickerFileType.GetPlatformFileType(Xamarin.Essentials.DevicePlatform)" />
-      <Member Id="M:Xamarin.Essentials.FilePickerFileType.PlatformImageFileType" />
-      <Member Id="M:Xamarin.Essentials.FilePickerFileType.PlatformPngFileType" />
-      <Member Id="M:Xamarin.Essentials.FilePickerFileType.PlatformVideoFileType" />
      <Member Id="P:Xamarin.Essentials.FilePickerFileType.Value" />
    </Type>
    <Type Name="Xamarin.Essentials.FileResult" Id="T:Xamarin.Essentials.FileResult">
--- a/docs/en/FrameworksIndex/xamarin-essentials-macos.xml
+++ b/docs/en/FrameworksIndex/xamarin-essentials-macos.xml
@ -389,14 +389,13 @@
    </Type>
    <Type Name="Xamarin.Essentials.FilePickerFileType" Id="T:Xamarin.Essentials.FilePickerFileType">
      <Member Id="F:Xamarin.Essentials.FilePickerFileType.Images" />
+      <Member Id="F:Xamarin.Essentials.FilePickerFileType.Jpeg" />
+      <Member Id="F:Xamarin.Essentials.FilePickerFileType.Pdf" />
      <Member Id="F:Xamarin.Essentials.FilePickerFileType.Png" />
      <Member Id="F:Xamarin.Essentials.FilePickerFileType.Videos" />
      <Member Id="M:Xamarin.Essentials.FilePickerFileType.#ctor" />
      <Member Id="M:Xamarin.Essentials.FilePickerFileType.#ctor(System.Collections.Generic.IDictionary{Xamarin.Essentials.DevicePlatform,System.Collections.Generic.IEnumerable{System.String}})" />
      <Member Id="M:Xamarin.Essentials.FilePickerFileType.GetPlatformFileType(Xamarin.Essentials.DevicePlatform)" />
-      <Member Id="M:Xamarin.Essentials.FilePickerFileType.PlatformImageFileType" />
-      <Member Id="M:Xamarin.Essentials.FilePickerFileType.PlatformPngFileType" />
-      <Member Id="M:Xamarin.Essentials.FilePickerFileType.PlatformVideoFileType" />
      <Member Id="P:Xamarin.Essentials.FilePickerFileType.Value" />
    </Type>
    <Type Name="Xamarin.Essentials.FileResult" Id="T:Xamarin.Essentials.FileResult">
--- a/docs/en/FrameworksIndex/xamarin-essentials-tvos.xml
+++ b/docs/en/FrameworksIndex/xamarin-essentials-tvos.xml
@ -389,6 +389,8 @@
    </Type>
    <Type Name="Xamarin.Essentials.FilePickerFileType" Id="T:Xamarin.Essentials.FilePickerFileType">
      <Member Id="F:Xamarin.Essentials.FilePickerFileType.Images" />
+      <Member Id="F:Xamarin.Essentials.FilePickerFileType.Jpeg" />
+      <Member Id="F:Xamarin.Essentials.FilePickerFileType.Pdf" />
      <Member Id="F:Xamarin.Essentials.FilePickerFileType.Png" />
      <Member Id="F:Xamarin.Essentials.FilePickerFileType.Videos" />
      <Member Id="M:Xamarin.Essentials.FilePickerFileType.#ctor" />
--- a/docs/en/FrameworksIndex/xamarin-essentials-uwp.xml
+++ b/docs/en/FrameworksIndex/xamarin-essentials-uwp.xml
@ -391,14 +391,13 @@
    </Type>
    <Type Name="Xamarin.Essentials.FilePickerFileType" Id="T:Xamarin.Essentials.FilePickerFileType">
      <Member Id="F:Xamarin.Essentials.FilePickerFileType.Images" />
+      <Member Id="F:Xamarin.Essentials.FilePickerFileType.Jpeg" />
+      <Member Id="F:Xamarin.Essentials.FilePickerFileType.Pdf" />
      <Member Id="F:Xamarin.Essentials.FilePickerFileType.Png" />
      <Member Id="F:Xamarin.Essentials.FilePickerFileType.Videos" />
      <Member Id="M:Xamarin.Essentials.FilePickerFileType.#ctor" />
      <Member Id="M:Xamarin.Essentials.FilePickerFileType.#ctor(System.Collections.Generic.IDictionary{Xamarin.Essentials.DevicePlatform,System.Collections.Generic.IEnumerable{System.String}})" />
      <Member Id="M:Xamarin.Essentials.FilePickerFileType.GetPlatformFileType(Xamarin.Essentials.DevicePlatform)" />
-      <Member Id="M:Xamarin.Essentials.FilePickerFileType.PlatformImageFileType" />
-      <Member Id="M:Xamarin.Essentials.FilePickerFileType.PlatformPngFileType" />
-      <Member Id="M:Xamarin.Essentials.FilePickerFileType.PlatformVideoFileType" />
      <Member Id="P:Xamarin.Essentials.FilePickerFileType.Value" />
    </Type>
    <Type Name="Xamarin.Essentials.FileResult" Id="T:Xamarin.Essentials.FileResult">
@ -816,6 +815,7 @@
      <Member Id="F:Xamarin.Essentials.ScreenshotFormat.Png" />
    </Type>
    <Type Name="Xamarin.Essentials.ScreenshotResult" Id="T:Xamarin.Essentials.ScreenshotResult">
+      <Member Id="M:Xamarin.Essentials.ScreenshotResult.#ctor(System.Int32,System.Int32,Windows.Storage.Streams.IBuffer)" />
      <Member Id="M:Xamarin.Essentials.ScreenshotResult.OpenReadAsync(Xamarin.Essentials.ScreenshotFormat)" />
      <Member Id="P:Xamarin.Essentials.ScreenshotResult.Height" />
      <Member Id="P:Xamarin.Essentials.ScreenshotResult.Width" />
--- a/docs/en/FrameworksIndex/xamarin-essentials-watchos.xml
+++ b/docs/en/FrameworksIndex/xamarin-essentials-watchos.xml
@ -389,6 +389,8 @@
    </Type>
    <Type Name="Xamarin.Essentials.FilePickerFileType" Id="T:Xamarin.Essentials.FilePickerFileType">
      <Member Id="F:Xamarin.Essentials.FilePickerFileType.Images" />
+      <Member Id="F:Xamarin.Essentials.FilePickerFileType.Jpeg" />
+      <Member Id="F:Xamarin.Essentials.FilePickerFileType.Pdf" />
      <Member Id="F:Xamarin.Essentials.FilePickerFileType.Png" />
      <Member Id="F:Xamarin.Essentials.FilePickerFileType.Videos" />
      <Member Id="M:Xamarin.Essentials.FilePickerFileType.#ctor" />
--- a/docs/en/FrameworksIndex/xamarin-essentials.xml
+++ b/docs/en/FrameworksIndex/xamarin-essentials.xml
@ -388,6 +388,8 @@
    </Type>
    <Type Name="Xamarin.Essentials.FilePickerFileType" Id="T:Xamarin.Essentials.FilePickerFileType">
      <Member Id="F:Xamarin.Essentials.FilePickerFileType.Images" />
+      <Member Id="F:Xamarin.Essentials.FilePickerFileType.Jpeg" />
+      <Member Id="F:Xamarin.Essentials.FilePickerFileType.Pdf" />
      <Member Id="F:Xamarin.Essentials.FilePickerFileType.Png" />
      <Member Id="F:Xamarin.Essentials.FilePickerFileType.Videos" />
      <Member Id="M:Xamarin.Essentials.FilePickerFileType.#ctor" />
--- a/docs/en/Xamarin.Essentials/FilePickerFileType.xml
+++ b/docs/en/Xamarin.Essentials/FilePickerFileType.xml
@ -83,15 +83,15 @@
        <ReturnType>Xamarin.Essentials.FilePickerFileType</ReturnType>
      </ReturnValue>
      <Docs>
-        <summary>To be added.</summary>
-        <remarks>To be added.</remarks>
+        <summary>Image file types.</summary>
+        <remarks></remarks>
      </Docs>
    </Member>
-    <Member MemberName="PlatformImageFileType">
-      <MemberSignature Language="C#" Value="public static Xamarin.Essentials.FilePickerFileType PlatformImageFileType ();" />
-      <MemberSignature Language="ILAsm" Value=".method public static hidebysig class Xamarin.Essentials.FilePickerFileType PlatformImageFileType() cil managed" />
-      <MemberSignature Language="DocId" Value="M:Xamarin.Essentials.FilePickerFileType.PlatformImageFileType" />
-      <MemberType>Method</MemberType>
+    <Member MemberName="Jpeg">
+      <MemberSignature Language="C#" Value="public static readonly Xamarin.Essentials.FilePickerFileType Jpeg;" />
+      <MemberSignature Language="ILAsm" Value=".field public static initonly class Xamarin.Essentials.FilePickerFileType Jpeg" />
+      <MemberSignature Language="DocId" Value="F:Xamarin.Essentials.FilePickerFileType.Jpeg" />
+      <MemberType>Field</MemberType>
      <AssemblyInfo>
        <AssemblyName>Xamarin.Essentials</AssemblyName>
        <AssemblyVersion>1.0.0.0</AssemblyVersion>
@ -99,18 +99,16 @@
      <ReturnValue>
        <ReturnType>Xamarin.Essentials.FilePickerFileType</ReturnType>
      </ReturnValue>
-      <Parameters />
      <Docs>
-        <summary>To be added.</summary>
-        <returns>To be added.</returns>
-        <remarks>To be added.</remarks>
+        <summary>JPEG file type (*.jpeg, *.jpg).</summary>
+        <remarks></remarks>
      </Docs>
    </Member>
-    <Member MemberName="PlatformPngFileType">
-      <MemberSignature Language="C#" Value="public static Xamarin.Essentials.FilePickerFileType PlatformPngFileType ();" />
-      <MemberSignature Language="ILAsm" Value=".method public static hidebysig class Xamarin.Essentials.FilePickerFileType PlatformPngFileType() cil managed" />
-      <MemberSignature Language="DocId" Value="M:Xamarin.Essentials.FilePickerFileType.PlatformPngFileType" />
-      <MemberType>Method</MemberType>
+    <Member MemberName="Pdf">
+      <MemberSignature Language="C#" Value="public static readonly Xamarin.Essentials.FilePickerFileType Pdf;" />
+      <MemberSignature Language="ILAsm" Value=".field public static initonly class Xamarin.Essentials.FilePickerFileType Pdf" />
+      <MemberSignature Language="DocId" Value="F:Xamarin.Essentials.FilePickerFileType.Pdf" />
+      <MemberType>Field</MemberType>
      <AssemblyInfo>
        <AssemblyName>Xamarin.Essentials</AssemblyName>
        <AssemblyVersion>1.0.0.0</AssemblyVersion>
@ -118,30 +116,9 @@
      <ReturnValue>
        <ReturnType>Xamarin.Essentials.FilePickerFileType</ReturnType>
      </ReturnValue>
-      <Parameters />
      <Docs>
-        <summary>To be added.</summary>
-        <returns>To be added.</returns>
-        <remarks>To be added.</remarks>
-      </Docs>
-    </Member>
-    <Member MemberName="PlatformVideoFileType">
-      <MemberSignature Language="C#" Value="public static Xamarin.Essentials.FilePickerFileType PlatformVideoFileType ();" />
-      <MemberSignature Language="ILAsm" Value=".method public static hidebysig class Xamarin.Essentials.FilePickerFileType PlatformVideoFileType() cil managed" />
-      <MemberSignature Language="DocId" Value="M:Xamarin.Essentials.FilePickerFileType.PlatformVideoFileType" />
-      <MemberType>Method</MemberType>
-      <AssemblyInfo>
-        <AssemblyName>Xamarin.Essentials</AssemblyName>
-        <AssemblyVersion>1.0.0.0</AssemblyVersion>
-      </AssemblyInfo>
-      <ReturnValue>
-        <ReturnType>Xamarin.Essentials.FilePickerFileType</ReturnType>
-      </ReturnValue>
-      <Parameters />
-      <Docs>
-        <summary>To be added.</summary>
-        <returns>To be added.</returns>
-        <remarks>To be added.</remarks>
+        <summary>PDF file type (*.pdf).</summary>
+        <remarks></remarks>
      </Docs>
    </Member>
    <Member MemberName="Png">
@ -157,8 +134,8 @@
        <ReturnType>Xamarin.Essentials.FilePickerFileType</ReturnType>
      </ReturnValue>
      <Docs>
-        <summary>To be added.</summary>
-        <remarks>To be added.</remarks>
+        <summary>PNG file type (*.png).</summary>
+        <remarks></remarks>
      </Docs>
    </Member>
    <Member MemberName="Value">
@ -192,8 +169,8 @@
        <ReturnType>Xamarin.Essentials.FilePickerFileType</ReturnType>
      </ReturnValue>
      <Docs>
-        <summary>To be added.</summary>
-        <remarks>To be added.</remarks>
+        <summary>Video file types.</summary>
+        <remarks></remarks>
      </Docs>
    </Member>
  </Members>
--- a/docs/en/Xamarin.Essentials/Permissions.xml
+++ b/docs/en/Xamarin.Essentials/Permissions.xml
@ -166,8 +166,8 @@
      </Docs>
    </Member>
    <Member MemberName="ShouldShowRationale&lt;TPermission&gt;">
-      <MemberSignature Language="C#" Value="public static void ShouldShowRationale&lt;TPermission&gt; () where TPermission : Xamarin.Essentials.Permissions.BasePermissionnew();" />
-      <MemberSignature Language="ILAsm" Value=".method public static hidebysig void ShouldShowRationale&lt;.ctor (class Xamarin.Essentials.Permissions/BasePermission) TPermission&gt;() cil managed" />
+      <MemberSignature Language="C#" Value="public static bool ShouldShowRationale&lt;TPermission&gt; () where TPermission : Xamarin.Essentials.Permissions.BasePermissionnew();" />
+      <MemberSignature Language="ILAsm" Value=".method public static hidebysig bool ShouldShowRationale&lt;.ctor (class Xamarin.Essentials.Permissions/BasePermission) TPermission&gt;() cil managed" />
      <MemberSignature Language="DocId" Value="M:Xamarin.Essentials.Permissions.ShouldShowRationale``1" />
      <MemberType>Method</MemberType>
      <AssemblyInfo>
@ -175,7 +175,7 @@
        <AssemblyVersion>1.0.0.0</AssemblyVersion>
      </AssemblyInfo>
      <ReturnValue>
-        <ReturnType>System.Void</ReturnType>
+        <ReturnType>System.Boolean</ReturnType>
      </ReturnValue>
      <TypeParameters>
        <TypeParameter Name="TPermission">
@ -187,9 +187,9 @@
      </TypeParameters>
      <Parameters />
      <Docs>
-        <typeparam name="TPermission">To be added.</typeparam>
+        <typeparam name="TPermission">The type of permission.</typeparam>
        <summary>Gets whether you should show UI with rationale for requesting a permission.</summary>
-        <remarks>To be added.</remarks>
+        <remarks></remarks>
      </Docs>
    </Member>
  </Members>
--- a/docs/en/Xamarin.Essentials/ScreenshotResult.xml
+++ b/docs/en/Xamarin.Essentials/ScreenshotResult.xml
@ -15,6 +15,28 @@
    <remarks>To be added.</remarks>
  </Docs>
  <Members>
+    <Member MemberName=".ctor">
+      <MemberSignature Language="C#" Value="public ScreenshotResult (int width, int height, Windows.Storage.Streams.IBuffer pixels);" />
+      <MemberSignature Language="ILAsm" Value=".method public hidebysig specialname rtspecialname instance void .ctor(int32 width, int32 height, class Windows.Storage.Streams.IBuffer pixels) cil managed" />
+      <MemberSignature Language="DocId" Value="M:Xamarin.Essentials.ScreenshotResult.#ctor(System.Int32,System.Int32,Windows.Storage.Streams.IBuffer)" />
+      <MemberType>Constructor</MemberType>
+      <AssemblyInfo>
+        <AssemblyName>Xamarin.Essentials</AssemblyName>
+        <AssemblyVersion>1.0.0.0</AssemblyVersion>
+      </AssemblyInfo>
+      <Parameters>
+        <Parameter Name="width" Type="System.Int32" Index="0" FrameworkAlternate="xamarin-essentials-uwp" />
+        <Parameter Name="height" Type="System.Int32" Index="1" FrameworkAlternate="xamarin-essentials-uwp" />
+        <Parameter Name="pixels" Type="Windows.Storage.Streams.IBuffer" Index="2" FrameworkAlternate="xamarin-essentials-uwp" />
+      </Parameters>
+      <Docs>
+        <param name="width">To be added.</param>
+        <param name="height">To be added.</param>
+        <param name="pixels">To be added.</param>
+        <summary>To be added.</summary>
+        <remarks>To be added.</remarks>
+      </Docs>
+    </Member>
    <Member MemberName="Height">
      <MemberSignature Language="C#" Value="public int Height { get; }" />
      <MemberSignature Language="ILAsm" Value=".property instance int32 Height" />