Merge [Readonly] Calendar API

DeviceTests/DeviceTests.Android/Properties/AndroidManifest.xml

@@ -5,9 +5,11 @@
 	<uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" />
 	<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
 	<uses-permission android:name="android.permission.BATTERY_STATS" />
+	<uses-permission android:name="android.permission.READ_CALENDAR" />
 	<uses-permission android:name="android.permission.CAMERA" />
 	<uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE" />
 	<uses-permission android:name="android.permission.FLASHLIGHT" />
+	<uses-permission android:name="android.permission.FLASHLIGHT" />
 	<uses-permission android:name="android.permission.INTERNET" />
 	<uses-permission android:name="android.permission.VIBRATE" />
 	<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />

DeviceTests/DeviceTests.Shared/Calendar_Tests.cs

@@ -0,0 +1,103 @@
+using System;
+using System.Threading.Tasks;
+using Xamarin.Essentials;
+using Xunit;
+
+namespace DeviceTests
+{
+    // TEST NOTES:
+    //   - a human needs to accept permissions on all systems
+    //  If no calendars are set up none will be returned at this stage
+    //  Same goes for events
+    public class Calendar_Tests
+    {
+        [Fact]
+        [Trait(Traits.InteractionType, Traits.InteractionTypes.Human)]
+        public Task Get_Calendar_List()
+        {
+            return Utils.OnMainThread(async () =>
+            {
+                var calendarList = await Calendars.GetCalendarsAsync();
+                Assert.NotNull(calendarList);
+            });
+        }
+
+        [Fact]
+        [Trait(Traits.InteractionType, Traits.InteractionTypes.Human)]
+        public Task Get_Events_List()
+        {
+            return Utils.OnMainThread(async () =>
+            {
+                var eventList = await Calendars.GetEventsAsync();
+                Assert.NotNull(eventList);
+            });
+        }
+
+        [Theory]
+        [InlineData("ThisIsAFakeId")]
+        [Trait(Traits.InteractionType, Traits.InteractionTypes.Human)]
+        public Task Get_Events_By_Bad_Calendar_Text_Id(string calendarId)
+        {
+            return Utils.OnMainThread(async () =>
+            {
+                await Assert.ThrowsAsync<ArgumentOutOfRangeException>(() => Calendars.GetEventsAsync(calendarId));
+            });
+        }
+
+        [Theory]
+        [InlineData("-1")]
+        [Trait(Traits.InteractionType, Traits.InteractionTypes.Human)]
+        public Task Get_Events_By_Bad_Calendar_Id(string calendarId)
+        {
+            return Utils.OnMainThread(async () =>
+            {
+                await Assert.ThrowsAsync<ArgumentOutOfRangeException>(() => Calendars.GetEventsAsync(calendarId));
+            });
+        }
+
+        [Theory]
+        [InlineData("")]
+        [InlineData("   ")]
+        [Trait(Traits.InteractionType, Traits.InteractionTypes.Human)]
+        public Task Get_Event_By_Blank_Id(string eventId)
+        {
+            return Utils.OnMainThread(async () =>
+            {
+                await Assert.ThrowsAsync<ArgumentOutOfRangeException>(() => Calendars.GetEventAsync(eventId));
+            });
+        }
+
+        [Theory]
+        [InlineData(null)]
+        [Trait(Traits.InteractionType, Traits.InteractionTypes.Human)]
+        public Task Get_Event_By_Null_Id(string eventId)
+        {
+            return Utils.OnMainThread(async () =>
+            {
+                await Assert.ThrowsAsync<ArgumentNullException>(() => Calendars.GetEventAsync(eventId));
+            });
+        }
+
+        [Theory]
+        [InlineData("-1")]
+        [Trait(Traits.InteractionType, Traits.InteractionTypes.Human)]
+        public Task Get_Event_By_Bad_Id(string eventId)
+        {
+            return Utils.OnMainThread(async () =>
+            {
+                await Assert.ThrowsAsync<ArgumentOutOfRangeException>(() => Calendars.GetEventAsync(eventId));
+            });
+        }
+
+        [Theory]
+        [InlineData("ThisIsAFakeId")]
+        [Trait(Traits.InteractionType, Traits.InteractionTypes.Human)]
+        public Task Get_Event_By_Bad_Text_Id(string eventId)
+        {
+            return Utils.OnMainThread(async () =>
+            {
+                await Assert.ThrowsAsync<ArgumentOutOfRangeException>(() => Calendars.GetEventAsync(eventId));
+            });
+        }
+    }
+}

DeviceTests/DeviceTests.UWP/Package.appxmanifest

@@ -33,6 +33,7 @@
     <Capability Name="internetClient" />
     <Capability Name="internetClientServer" />
     <Capability Name="privateNetworkClientServer" />
+    <uap:Capability Name="appointments"/>
     <DeviceCapability Name="location" />
   </Capabilities>
 </Package>

DeviceTests/DeviceTests.iOS/Info.plist

@@ -55,5 +55,7 @@
 	<string>1.0.1.0</string>
 	<key>NSLocationWhenInUseUsageDescription</key>
 	<string>Access to your location is required for cool things to happen!</string>
+	<key>NSCalendarsUsageDescription</key>
+	<string>Access to view and create calendar events</string>
 </dict>
 </plist>

Samples/Samples.Android/Properties/AndroidManifest.xml

@@ -10,6 +10,7 @@
 	<uses-permission android:name="android.permission.INTERNET" />
 	<uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE" />
 	<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />
+	<uses-permission android:name="android.permission.READ_CALENDAR" />
 	<uses-permission android:name="android.permission.VIBRATE" />
 	<uses-permission android:name="android.permission.READ_CONTACTS" />
 	<uses-feature android:name="android.hardware.location" android:required="false" />

Samples/Samples.Mac/Entitlements.plist

@@ -1,6 +1,10 @@
-<?xml version="1.0" encoding="UTF-8" ?>
+<?xml version="1.0" encoding="UTF-8"?>
 <!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
 <plist version="1.0">
 <dict>
+	<key>com.apple.security.app-sandbox</key>
+	<true/>
+	<key>com.apple.security.personal-information.calendar</key>
+	<true/>
 </dict>
 </plist>

Samples/Samples.Mac/Info.plist

@@ -30,6 +30,8 @@
 	<string>Assets.xcassets/AppIcon.appiconset</string>
 	<key>NSLocationWhenInUseUsageDescription</key>
 	<string>Access to your location is required for cool things to happen!</string>
+	<key>NSCalendarsUsageDescription</key>
+	<string>Calendar Access</string>
 	<key>CFBundleURLTypes</key>
 	<array>
 		<dict>

Samples/Samples.UWP/Package.appxmanifest

@@ -32,6 +32,7 @@
   <Capabilities>
     <Capability Name="internetClient" />
     <uap:Capability Name="contacts"/>
+    <uap:Capability Name="appointments"/>
     <DeviceCapability Name="location" />
     <DeviceCapability Name="microphone"/>
     <DeviceCapability Name="webcam"/>

Samples/Samples.iOS/Info.plist

@@ -55,6 +55,8 @@
 	<string>1.0</string>
 	<key>NSLocationWhenInUseUsageDescription</key>
 	<string>Access to your location is required for cool things to happen!</string>
+	<key>NSCalendarsUsageDescription</key>
+	<string>Access to view and create calendar events</string>
 	<key>CFBundleURLTypes</key>
 	<array>
 		<dict>

Samples/Samples/App.xaml

@@ -1,14 +1,22 @@
-<?xml version="1.0" encoding="utf-8" ?>
-<Application xmlns="http://xamarin.com/schemas/2014/forms"
+<Application xmlns="http://xamarin.com/schemas/2014/forms"
              xmlns:x="http://schemas.microsoft.com/winfx/2009/xaml"
              xmlns:converters="clr-namespace:Samples.Converters"
              x:Class="Samples.App">
+
     <Application.Resources>
         <ResourceDictionary>
+
+            <x:String x:Key="TimeSpanDisplayFormatter">{0:h\:mm}</x:String>
+            <x:String x:Key="DateDisplayFormatter">{0:dd/MM/yy hh:mm tt}</x:String>
+
             <converters:NegativeConverter x:Key="NegativeConverter" />
+            <converters:CalendarEventDateConverter x:Key="CalendarEventDateConverter" />
+
             <Style TargetType="Page" ApplyToDerivedTypes="True">
                 <Setter Property="Visual" Value="Material" />
             </Style>
+
         </ResourceDictionary>
     </Application.Resources>
+
 </Application>

Samples/Samples/App.xaml.cs

@@ -30,7 +30,8 @@ public App()
 
             MainPage = new NavigationPage(new HomePage());
 
-            AppActions.OnAppAction += AppActions_OnAppAction;
+            if (Device.RuntimePlatform != Device.macOS)
+                AppActions.OnAppAction += AppActions_OnAppAction;
         }
 
         protected override async void OnStart()
@@ -48,9 +49,12 @@ protected override async void OnStart()
                 typeof(Distribute));
             }
 
-            await AppActions.SetAsync(
-                new AppAction("app_info", "App Info", icon: "app_info_action_icon"),
-                new AppAction("battery_info", "Battery Info"));
+            if (Device.RuntimePlatform != Device.macOS)
+            {
+                await AppActions.SetAsync(
+                    new AppAction("app_info", "App Info", icon: "app_info_action_icon"),
+                    new AppAction("battery_info", "Battery Info"));
+            }
         }
 
         void AppActions_OnAppAction(object sender, AppActionEventArgs e)

Samples/Samples/Converters/CalendarEventDateConverter.cs

@@ -0,0 +1,27 @@
+using System;
+using System.Globalization;
+using Xamarin.Essentials;
+using Xamarin.Forms;
+
+namespace Samples.Converters
+{
+    public class CalendarEventDateConverter : IValueConverter
+    {
+        public object Convert(object value, Type targetType, object parameter, CultureInfo culture)
+        {
+            var e = value as CalendarEvent;
+            if (e == null)
+                return "<unknown>";
+
+            if (e.AllDay)
+                return "All day";
+
+            var format = Application.Current.Resources["DateDisplayFormatter"] as string;
+
+            return $"{string.Format(format, e.StartDate)} to {string.Format(format, e.EndDate)}";
+        }
+
+        public object ConvertBack(object value, Type targetType, object parameter, CultureInfo culture) =>
+            throw new NotImplementedException();
+    }
+}

Samples/Samples/View/CalendarEventPage.xaml

@@ -0,0 +1,48 @@
+<views:BasePage xmlns="http://xamarin.com/schemas/2014/forms"
+                xmlns:x="http://schemas.microsoft.com/winfx/2009/xaml"
+                xmlns:views="clr-namespace:Samples.View"
+                xmlns:viewmodels="clr-namespace:Samples.ViewModel"
+                xmlns:essentials="clr-namespace:Xamarin.Essentials;assembly=Xamarin.Essentials"
+                xmlns:converters="clr-namespace:Samples.Converters;assembly=Samples"
+                x:Class="Samples.View.CalendarEventPage"
+                x:DataType="essentials:CalendarEvent"
+                Title="{Binding Title}">
+
+    <ScrollView>
+        <StackLayout Padding="12" Spacing="6">
+
+        <Label Text="{Binding Title}" FontSize="Title" HorizontalTextAlignment="Center" />
+
+            <Grid ColumnDefinitions="Auto,*" RowDefinitions="Auto,Auto,Auto,Auto,Auto,Auto,Auto,Auto,Auto"
+                  ColumnSpacing="6" RowSpacing="6">
+                <Label Grid.Column="0" Grid.Row="0" Text="When: " FontAttributes="Bold" />
+                <Label Grid.Column="1" Grid.Row="0" Text="{Binding ., Converter={StaticResource CalendarEventDateConverter}}" />
+
+                <Label Grid.Column="0" Grid.Row="1" Text="Duration: " FontAttributes="Bold" />
+                <Label Grid.Column="1" Grid.Row="1" Text="{Binding Duration}" />
+
+                <Label Grid.Column="0" Grid.Row="2" Text="Location: " FontAttributes="Bold" />
+                <Label Grid.Column="1" Grid.Row="2" Text="{Binding Location}" />
+
+                <Label Grid.Column="0" Grid.Row="3" Text="Attendees: " FontAttributes="Bold" />
+                <ScrollView Grid.Column="1" Grid.Row="3">
+                    <StackLayout Spacing="3" BindableLayout.ItemsSource="{Binding Attendees}">
+                        <BindableLayout.ItemTemplate>
+                            <DataTemplate x:DataType="essentials:CalendarEventAttendee">
+                                <StackLayout Orientation="Horizontal">
+                                    <Label Text="{Binding Name}" />
+                                    <Label Text="{Binding Email}" TextColor="DarkGray"/>
+                                </StackLayout>
+                            </DataTemplate>
+                        </BindableLayout.ItemTemplate>
+                    </StackLayout>
+                </ScrollView>
+
+                <Label Grid.Column="0" Grid.Row="4" Text="Description: " FontAttributes="Bold" />
+                <Label Grid.Column="1" Grid.Row="4" Text="{Binding Description}" />
+            </Grid>
+
+        </StackLayout>
+    </ScrollView>
+
+</views:BasePage>

Samples/Samples/View/CalendarEventPage.xaml.cs

@@ -0,0 +1,15 @@
+using System;
+using System.Collections.ObjectModel;
+using Xamarin.Essentials;
+using Xamarin.Forms;
+
+namespace Samples.View
+{
+    public partial class CalendarEventPage : BasePage
+    {
+        public CalendarEventPage()
+        {
+            InitializeComponent();
+        }
+    }
+}