Ability to set location, add reminder, and set android calendar to sync.

.gitignore

@@ -22,6 +22,8 @@ build/
 [Tt]est[Rr]esult*/
 [Bb]uild[Ll]og.*
 
+*.lock.json
+
 *_i.c
 *_p.c
 *.ilk

Calendars.sln

@@ -1,7 +1,7 @@
 
 Microsoft Visual Studio Solution File, Format Version 12.00
 # Visual Studio 14
-VisualStudioVersion = 14.0.23107.0
+VisualStudioVersion = 14.0.24720.0
 MinimumVisualStudioVersion = 10.0.40219.1
 Project("{FAE04EC0-301F-11D3-BF4B-00C04F79EFBC}") = "Calendars.Plugin", "Calendars\Calendars.Plugin\Calendars.Plugin.csproj", "{A6FCEF44-D2BA-42C7-B3CB-13667BCD7B54}"
 EndProject
@@ -273,6 +273,7 @@ Global
 		{56A56F17-7DE1-4CA1-9617-BF32E971AC84}.Debug|iPhone.ActiveCfg = Debug|Any CPU
 		{56A56F17-7DE1-4CA1-9617-BF32E971AC84}.Debug|iPhoneSimulator.ActiveCfg = Debug|Any CPU
 		{56A56F17-7DE1-4CA1-9617-BF32E971AC84}.Debug|Mixed Platforms.ActiveCfg = Debug|Any CPU
+		{56A56F17-7DE1-4CA1-9617-BF32E971AC84}.Debug|Mixed Platforms.Build.0 = Debug|Any CPU
 		{56A56F17-7DE1-4CA1-9617-BF32E971AC84}.Debug|x64.ActiveCfg = Debug|Any CPU
 		{56A56F17-7DE1-4CA1-9617-BF32E971AC84}.Debug|x86.ActiveCfg = Debug|Any CPU
 		{56A56F17-7DE1-4CA1-9617-BF32E971AC84}.Release|Android.ActiveCfg = Release|Any CPU
@@ -717,6 +718,8 @@ Global
 		{E6284EB0-BDB0-4D38-AFC4-ECDC7BFF6D6E}.Debug|iPhone.ActiveCfg = Debug|Any CPU
 		{E6284EB0-BDB0-4D38-AFC4-ECDC7BFF6D6E}.Debug|iPhoneSimulator.ActiveCfg = Debug|Any CPU
 		{E6284EB0-BDB0-4D38-AFC4-ECDC7BFF6D6E}.Debug|Mixed Platforms.ActiveCfg = Debug|Any CPU
+		{E6284EB0-BDB0-4D38-AFC4-ECDC7BFF6D6E}.Debug|Mixed Platforms.Build.0 = Debug|Any CPU
+		{E6284EB0-BDB0-4D38-AFC4-ECDC7BFF6D6E}.Debug|Mixed Platforms.Deploy.0 = Debug|Any CPU
 		{E6284EB0-BDB0-4D38-AFC4-ECDC7BFF6D6E}.Debug|x64.ActiveCfg = Debug|Any CPU
 		{E6284EB0-BDB0-4D38-AFC4-ECDC7BFF6D6E}.Debug|x86.ActiveCfg = Debug|Any CPU
 		{E6284EB0-BDB0-4D38-AFC4-ECDC7BFF6D6E}.Release|Android.ActiveCfg = Release|Any CPU

Calendars/Calendars.Plugin.Abstractions/CalendarEvent.cs

@@ -26,6 +26,11 @@ public class CalendarEvent
         /// </summary>
         public DateTime End { get; set; }
 
+        /// <summary>
+        /// Gets or sets the location of the event
+        /// </summary>
+        public string Location { get; set; }
+
         /// <summary>
         /// Whether or not this is an "all-day" event.
         /// </summary>
@@ -42,14 +47,15 @@ public class CalendarEvent
         /// </summary>
         /// <remarks>This ID will be the same for each instance of a recurring event.</remarks>
         public string ExternalID { get; set; }
+
 
         /// <summary>
         /// Simple ToString helper, to assist with debugging.
         /// </summary>
         /// <returns></returns>
         public override string ToString()
         {
-            return "Name=" + Name + ", AllDay=" + AllDay + ", Start=" + Start + ", End=" + End;
+            return "Name=" + Name + ", AllDay=" + AllDay + ", Start=" + Start + ", End=" + End + ", Location=" + Location;
         }
     }
 }

Calendars/Calendars.Plugin.Abstractions/CalendarEventReminder.cs

@@ -0,0 +1,48 @@
+using System;
+using System.Collections.Generic;
+using System.Linq;
+using System.Text;
+using System.Threading.Tasks;
+
+namespace Calendars.Plugin.Abstractions
+{
+    /// <summary>
+    /// Calendar reminder that happens before the event such as an alert
+    /// </summary>
+    public class CalendarEventReminder
+    {
+
+        /// <summary>
+        /// How many minutes before the event the reminder happens
+        /// </summary>
+        public uint MinutesBefore { get; set; } = 0;
+        /// <summary>
+        /// Type of reminder to display
+        /// </summary>
+        public CalendarReminderMethod Method { get; set; } = CalendarReminderMethod.Default;
+
+    }
+
+    /// <summary>
+    /// Types of methods of the reminder
+    /// </summary>
+    public enum CalendarReminderMethod
+    {
+        /// <summary>
+        /// Use system default
+        /// </summary>
+        Default,
+        /// <summary>
+        /// Pop up alert
+        /// </summary>
+        Alert,
+        /// <summary>
+        /// Send an email
+        /// </summary>
+        Email,
+        /// <summary>
+        /// Send an sms
+        /// </summary>
+        Sms
+    }
+}

Calendars/Calendars.Plugin.Abstractions/Calendars.Plugin.Abstractions.csproj

@@ -40,6 +40,7 @@
   <ItemGroup>
     <Compile Include="Calendar.cs" />
     <Compile Include="CalendarEvent.cs" />
+    <Compile Include="CalendarEventReminder.cs" />
     <Compile Include="ICalendars.cs" />
     <Compile Include="ICalendarsExtensions.cs" />
     <Compile Include="PlatformException.cs" />

Calendars/Calendars.Plugin.Abstractions/ICalendars.cs

@@ -88,5 +88,15 @@ public interface ICalendars
       /// <exception cref="System.UnauthorizedAccessException">Calendar access denied</exception>
       /// <exception cref="Calendars.Plugin.Abstractions.PlatformException">Unexpected platform-specific error</exception>
       Task<bool> DeleteEventAsync(Calendar calendar, CalendarEvent calendarEvent);
+
+      /// <summary>
+      /// Adds a reminder to the specified calendar event
+      /// </summary>
+      /// <param name="calendarEvent">Event to add</param>
+      /// <param name="reminder">Reminder to add</param>
+      /// <returns>If successful</returns>
+      /// <exception cref="ArgumentException">If calendar event is not create or note valid</exception>
+      /// <exception cref="Calendars.Plugin.Abstractions.PlatformException">Unexpected platform-specific error</exception>
+      Task<bool> AddEventReminderAsync(CalendarEvent calendarEvent, CalendarEventReminder reminder);
   }
 }

Calendars/Calendars.Plugin.Android/CalendarsImplementation.cs

@@ -177,6 +177,7 @@ public async Task<IList<CalendarEvent>> GetEventsAsync(Calendar calendar, DateTi
                 CalendarContract.Events.InterfaceConsts.Dtstart,
                 CalendarContract.Events.InterfaceConsts.Dtend,
                 CalendarContract.Events.InterfaceConsts.AllDay,
+                CalendarContract.Events.InterfaceConsts.EventLocation,
                 CalendarContract.Instances.EventId
             };
 
@@ -204,6 +205,7 @@ await Task.Run(() =>
                                     Description = cursor.GetString(CalendarContract.Events.InterfaceConsts.Description),
                                     Start = cursor.GetDateTime(CalendarContract.Events.InterfaceConsts.Dtstart),
                                     End = cursor.GetDateTime(CalendarContract.Events.InterfaceConsts.Dtend),
+                                    Location = cursor.GetString(CalendarContract.Events.InterfaceConsts.EventLocation),
                                     AllDay = cursor.GetBoolean(CalendarContract.Events.InterfaceConsts.AllDay)
                                 });
                         } while (cursor.MoveToNext());
@@ -241,6 +243,7 @@ public Task<CalendarEvent> GetEventByIdAsync(string externalId)
                 CalendarContract.Events.InterfaceConsts.Description,
                 CalendarContract.Events.InterfaceConsts.Dtstart,
                 CalendarContract.Events.InterfaceConsts.Dtend,
+                CalendarContract.Events.InterfaceConsts.EventLocation,
                 CalendarContract.Events.InterfaceConsts.AllDay
             };
 
@@ -262,6 +265,7 @@ public Task<CalendarEvent> GetEventByIdAsync(string externalId)
                             Description = cursor.GetString(CalendarContract.Events.InterfaceConsts.Description),
                             Start = cursor.GetDateTime(CalendarContract.Events.InterfaceConsts.Dtstart),
                             End = cursor.GetDateTime(CalendarContract.Events.InterfaceConsts.Dtend),
+                            Location = cursor.GetString(CalendarContract.Events.InterfaceConsts.EventLocation),
                             AllDay = cursor.GetBoolean(CalendarContract.Events.InterfaceConsts.AllDay)
                         };
                     }
@@ -333,6 +337,7 @@ public async Task AddOrUpdateCalendarAsync(Calendar calendar)
                 values.Put(CalendarContract.Calendars.InterfaceConsts.AccountName, AccountName);
                 values.Put(CalendarContract.Calendars.InterfaceConsts.OwnerAccount, OwnerAccount);
                 values.Put(CalendarContract.Calendars.InterfaceConsts.Visible, true);
+                values.Put(CalendarContract.Calendars.InterfaceConsts.SyncEvents, true);
 
                 values.Put(CalendarContract.Calendars.InterfaceConsts.AccountType, CalendarContract.AccountTypeLocal);
             }
@@ -421,6 +426,8 @@ await Task.Run(() =>
                         DateConversions.GetDateAsAndroidMS(calendarEvent.End));
                     eventValues.Put(CalendarContract.Events.InterfaceConsts.AllDay,
                         calendarEvent.AllDay);
+                    eventValues.Put(CalendarContract.Events.InterfaceConsts.EventLocation,
+                        calendarEvent.Location ?? string.Empty);
 
                     eventValues.Put(CalendarContract.Events.InterfaceConsts.EventTimezone,
                         Java.Util.TimeZone.Default.ID);
@@ -435,7 +442,60 @@ await Task.Run(() =>
                     }
                 });
         }
+
+        /// <summary>
+        /// Adds an event reminder to specified calendar event
+        /// </summary>
+        /// <param name="calendarEvent">Event to add the reminder to</param>
+        /// <param name="reminder">The reminder</param>
+        /// <returns>Success or failure</returns>
+        /// <exception cref="ArgumentException">If calendar event is not create or note valid</exception>
+        /// <exception cref="Calendars.Plugin.Abstractions.PlatformException">Unexpected platform-specific error</exception>
+        public async Task<bool> AddEventReminderAsync(CalendarEvent calendarEvent, CalendarEventReminder reminder)
+        {
+            if (string.IsNullOrEmpty(calendarEvent.ExternalID))
+            {
+                throw new ArgumentException("Missing calendar event identifier", "calendarEvent");
+            }
+            // Verify calendar event exists 
+            var existingAppt = await GetEventByIdAsync(calendarEvent.ExternalID).ConfigureAwait(false);
+
+            if (existingAppt == null)
+            {
+                throw new ArgumentException("Specified calendar event not found on device");
+            }
 
+            return await Task.Run(() =>
+            {
+                var reminderValues = new ContentValues();
+                reminderValues.Put(CalendarContract.Reminders.InterfaceConsts.Minutes, reminder.MinutesBefore);
+                reminderValues.Put(CalendarContract.Reminders.InterfaceConsts.EventId, calendarEvent.ExternalID);
+                switch(reminder.Method)
+                {
+                    case CalendarReminderMethod.Alert:
+                        reminderValues.Put(CalendarContract.Reminders.InterfaceConsts.Method, (int)RemindersMethod.Alert);
+                        break;
+                    case CalendarReminderMethod.Default:
+                        reminderValues.Put(CalendarContract.Reminders.InterfaceConsts.Method, (int)RemindersMethod.Default);
+                        break;
+                    case CalendarReminderMethod.Email:
+                        reminderValues.Put(CalendarContract.Reminders.InterfaceConsts.Method, (int)RemindersMethod.Email);
+                        break;
+                    case CalendarReminderMethod.Sms:
+                        reminderValues.Put(CalendarContract.Reminders.InterfaceConsts.Method, (int)RemindersMethod.Sms);
+                        break;
+
+                }
+                var uri = CalendarContract.Reminders.ContentUri;
+                Insert(uri, reminderValues);
+
+
+                return true;
+            });
+
+        }
+
+
         /// <summary>
         /// Removes a calendar and all its events from the system.
         /// </summary>

Calendars/Calendars.Plugin.WindowsPhoneSL81/AppointmentExtensions.cs

@@ -27,6 +27,7 @@ public static CalendarEvent ToCalendarEvent(this Appointment appt)
                 Start = appt.StartTime.LocalDateTime,
                 End = appt.StartTime.Add(appt.Duration).LocalDateTime,
                 AllDay = appt.AllDay,
+                Location = appt.Location,
                 ExternalID = appt.LocalId
             };
         }

Calendars/Calendars.Plugin.WindowsPhoneSL81/CalendarsImplementation.cs

@@ -111,6 +111,7 @@ public async Task<IList<CalendarEvent>> GetEventsAsync(Calendar calendar, DateTi
             options.FetchProperties.Add(AppointmentProperties.StartTime);
             options.FetchProperties.Add(AppointmentProperties.Duration);
             options.FetchProperties.Add(AppointmentProperties.AllDay);
+            options.FetchProperties.Add(AppointmentProperties.Location);
 
             var appointments = await deviceCalendar.FindAppointmentsAsync(start, end - start, options).ConfigureAwait(false);
             var events = appointments.Select(a => a.ToCalendarEvent()).ToList();
@@ -227,12 +228,52 @@ public async Task AddOrUpdateEventAsync(Calendar calendar, CalendarEvent calenda
             appt.StartTime = calendarEvent.Start;
             appt.Duration = calendarEvent.End - calendarEvent.Start;
             appt.AllDay = calendarEvent.AllDay;
+            appt.Location = calendarEvent.Location ?? string.Empty;
 
             await appCalendar.SaveAppointmentAsync(appt);
 
             calendarEvent.ExternalID = appt.LocalId;
         }
 
+        /// <summary>
+        /// Adds an event reminder to specified calendar event
+        /// </summary>
+        /// <param name="calendarEvent">Event to add the reminder to</param>
+        /// <param name="reminder">The reminder</param>
+        /// <returns>Success or failure</returns>
+        /// <exception cref="ArgumentException">If calendar event is not create or note valid</exception>
+        /// <exception cref="Calendars.Plugin.Abstractions.PlatformException">Unexpected platform-specific error</exception>
+        public async Task<bool> AddEventReminderAsync(CalendarEvent calendarEvent, CalendarEventReminder reminder)
+        {
+            if (string.IsNullOrEmpty(calendarEvent.ExternalID))
+            {
+                throw new ArgumentException("Missing calendar event identifier", "calendarEvent");
+            }
+
+
+            var existingAppt = await _localApptStore.GetAppointmentAsync(calendarEvent.ExternalID);
+
+
+            if (existingAppt == null)
+            {
+                throw new ArgumentException("Specified calendar event not found on device");
+            }
+
+
+            var appCalendar = await _localApptStore.GetAppointmentCalendarAsync(existingAppt.CalendarId);
+
+            if(appCalendar == null)
+            {
+                throw new ArgumentException("Event does not have a valid calendar.");
+            }
+
+            existingAppt.Reminder = TimeSpan.FromMinutes(reminder.MinutesBefore);
+
+            await appCalendar.SaveAppointmentAsync(existingAppt);
+
+            return true;
+        }
+
         /// <summary>
         /// Removes a calendar and all its events from the system.
         /// </summary>
@@ -335,9 +376,9 @@ public async Task<bool> DeleteEventAsync(Calendar calendar, CalendarEvent calend
             return deleted;
         }
 
-        #endregion
+#endregion
 
-        #region Private Methods
+#region Private Methods
 
         private async Task EnsureInitializedAsync()
         {

Calendars/Calendars.Plugin.WindowsStore/CalendarsImplementation.cs

@@ -72,7 +72,15 @@ public Task AddOrUpdateEventAsync(Calendar calendar, CalendarEvent calendarEvent
       /// <summary>
       /// Not supported for Windows Store apps
       /// </summary>
-      public Task<bool> DeleteCalendarAsync(Calendar calendar)
+      public Task<bool> AddEventReminderAsync(CalendarEvent calendarEvent, CalendarEventReminder reminder)
+      {
+          throw new NotSupportedException();
+      }
+
+      /// <summary>
+      /// Not supported for Windows Store apps
+      /// </summary>
+        public Task<bool> DeleteCalendarAsync(Calendar calendar)
       {
           throw new NotSupportedException();
       }