Remove or alter what is being thrown e.g. sometimes I add what platform is failing, but probably just better off not catching exception in general if I'm not handling it

• UWP
• iOS
• Android

Found the linkage between variables within this list, see: Link to Event

https://docs.google.com/spreadsheets/d/1-k8TuQpdWh1GRrgFsI9b2qWfobrqlquzSzwsFknMApo/edit#gid=0

Calendar.android.cs

e.g. newEvent null validation in:
if (string.IsNullOrEmpty(newEvent.CalendarId))

• Retrieving Calendars
• Retrieving Events
• Retrieving Events by Calendar Id
• Retrieving Event by Event Id
• Creating a Calendar
• Creating an Event
• Deleting an Event
• Adding Attendee to an Event
• Removing Attendee from an Event
• Adding Alarm to an Event
• Removing Alarm from an Event
• Creating Event with Daily Recurrence
• Creating Event with Weekly Recurrence
• Creating Event with Monthly Recurrence
• Creating Event with Yearly Recurrence
• Creating a Event Instance
• Deleting a Event Instance
• Delete event instances from date

• UWP - I can cancel an event, but deletion looks like it may require going via the opening the windows calendar route
• iOS
• Android

var cursor = Platform.AppContext.ApplicationContext.ContentResolver;

• UWP
• iOS
• Android

Calendar API

Calendar API Update to no longer be read-only but will now have CRUD access to events for calendars seamlessly across uwp, iOS and Android.

API

Calendar

Methods

Classes

public class DeviceCalendar
{
    public string Id { get; set; }

    public string Name { get; set; }

    public bool IsReadOnly { get; set; }
}

public class DeviceEvent
{
    public string Id { get; set; }

    public string CalendarId { get; set; }

    public string Title { get; set; }

    public string Description { get; set; }

    public string Location { get; set; }

    public bool AllDay { get; set; }

    public DateTimeOffset StartDate { get; set; }

     public TimeSpan? Duration { get; set; }

    public DateTimeOffset? EndDate { get; set; }

    public IEnumberable<Attendee> Attendees { get; set; }
}

public class DeviceEventAttendee
{
    public string Name { get; set; }

    public string Email { get; set; }
}

Scenarios

• User wants to an event.
• User wants to update an event.
• User wants to delete an event.
• User wants to add more attendees to an existing event.
• User wants to remove attendees from an existing event.

Platform Compatibility

• Target Frameworks:
  • iOS: Support on iOS for the API
  • Android: Support on Android for the API
  • UWP: Support on UWP for the API

Backward Compatibility

• UWP: Windows 10 (introduced v10.0.10240.0)
  (https://docs.microsoft.com/en-us/uwp/api/windows.applicationmodel.appointments.appointment)
• Android: android:minSdkVersion="14"
  (https://developer.android.com/reference/android/provider/CalendarContract)
• iOS: All versions until reminders are added, then iOS 6
  (https://developer.apple.com/documentation/eventkit/ekeventstore)

Difficulty : medium

(suggested TimeSpanExtensions)

• UWP
• iOS
• Android

Not too fussed about this but I would try to avoid abbreviations in code and use full names instead

var app = new Appointment()

• UWP
• iOS
• Android

• UWP
• iOS
• Android

Allow functions to request/check Calendar app permissions before proceeding.

This should be a modification to the existing Permissions API to support requesting Calendar permission. We'll need to add Calendar to the PermissionType enumeration

• UWP
• iOS
• Android - Currently gets weird issue about a name field that I'm struggling to find the cause of

eventValues.Put(CalendarContract.Events.InterfaceConsts.Dtend, newEvent.EndDate.HasValue ? newEvent.EndDate.Value.ToUnixTimeMilliseconds().ToString() : newEvent.StartDate.AddDays(1).ToString());

It looks pretty arbitrary that we're adding a day if the end date hasn't been provided. Couple of questions:

Should we be even providing an end date if it's not provided?
Why are we adding exactly 1 day?
If we need to provide a value and it will be an arbitrary number, I feel that we might want to leave a comment why about it.

• UWP
• iOS
• Android

public ICommand CreateCalendar { get; } = new Command(CreateCalendarCommand);

• UWP
• iOS
• Android

Calendar Read-Only API

Calendar API for reading calendar/event information seamlessly across uwp, iOS and Android

API

Calendar

Methods

Classes

public class DeviceCalendar
{
    public string Id { get; set; }

    public string Name { get; set; }
}

public class DeviceEvent
{
    public string Id { get; set; }

    public string CalendarId { get; set; }

    public string Title { get; set; }

    public string Description { get; set; }

    public string Location { get; set; }

    public bool AllDay
    {
        get => !EndDate.HasValue;
        set
        {
            if (value)
            {
                EndDate = null;
            }
            else
            {
                EndDate = StartDate;
            }
        }
    }

    public DateTimeOffset StartDate { get; set; }

     public TimeSpan? Duration
     {
         get => EndDate.HasValue ? EndDate - StartDate : null;
         set
         {
             if (value.HasValue)
             {
                 EndDate = StartDate.Add(value.Value);
             }
             else
             {
                 EndDate = null;
             }
         }
     }

    public DateTimeOffset? EndDate { get; set; }

    public List<Attendee> Attendees { get; set; }
}

public class DeviceEventAttendee
{
    public string Name { get; set; }

    public string Email { get; set; }
}

Scenarios

• User wants to see upcoming events.
• User wants to see who is attending an upcoming event.
• User wants to know when they will be free.

Platform Compatibility

• Target Frameworks:
  • iOS: Support on iOS for the API
  • Android: Support on Android for the API
  • UWP: Support on UWP for the API

Backward Compatibility

• UWP: Windows 10 (introduced v10.0.10240.0)
  (https://docs.microsoft.com/en-us/uwp/api/windows.applicationmodel.appointments.appointment)
• Android: android:minSdkVersion="14"
  (https://developer.android.com/reference/android/provider/CalendarContract)
• iOS: All versions until reminders are added, then iOS 6
  (https://developer.apple.com/documentation/eventkit/ekeventstore)

Difficulty : low