Dev release

.gitignore

@@ -12,6 +12,6 @@ pubspec.lock
 # If you don't generate documentation locally you can remove this line.
 doc/api/
 device_calendar.code-workspace
-device_calendar/example/.flutter-plugins-dependencies
-device_calendar/example/ios/Flutter/flutter_export_environment.sh
-device_calendar/example/ios/Flutter/Flutter.podspec
+example/.flutter-plugins-dependencies
+example/ios/Flutter/flutter_export_environment.sh
+example/ios/Flutter/Flutter.podspec

device_calendar/CHANGELOG.md → CHANGELOG.md

@@ -1,31 +1,36 @@
 # Changelog
 
-## 3.1.0 6th March 2020 - Bug fixes and new features
+## 3.2.0
 
-* Boolean variable `isDefault` added for issue [145](https://github.com/builttoroam/flutter_plugins/issues/145) (**NOTE**: This is not supported Android API 16 or lower, `isDefault` will always be false)
-* Events with 'null' title now defaults to 'New Event', issue [126](https://github.com/builttoroam/flutter_plugins/issues/126)
-* Updated property summaries for issues [121](https://github.com/builttoroam/flutter_plugins/issues/121) and [122](https://github.com/builttoroam/flutter_plugins/issues/122)
-* Updated example documentation for issue [119](https://github.com/builttoroam/flutter_plugins/issues/119)
+* Added time zone support
+* Project hierarchy update and clean up
+
+## 3.1.0 25th March 2020 - Bug fixes and new features
+
+* Boolean variable `isDefault` added for issue [145](https://github.com/builttoroam/device_calendar/issues/145) (**NOTE**: This is not supported Android API 16 or lower, `isDefault` will always be false)
+* Events with 'null' title now defaults to 'New Event', issue [126](https://github.com/builttoroam/device_calendar/issues/126)
+* Updated property summaries for issues [121](https://github.com/builttoroam/device_calendar/issues/121) and [122](https://github.com/builttoroam/device_calendar/issues/122)
+* Updated example documentation for issue [119](https://github.com/builttoroam/device_calendar/issues/119)
 * Read-only calendars cannot be edited or deleted for the example app
 * Added `DayOfWeekGroup` enum and an extension `getDays` to get corresponding dates of the enum values
 * Added to retrieve colour for calendars. Thanks to [nadavfima](https://github.com/nadavfima) for the contribution and PR to add colour support for both Android and iOS
 * Added compatibility with a new Flutter plugin for Android. Thanks to the PR submitted by [RohitKumarMishra](https://github.com/RohitKumarMishra)
-* [Android] Fixed all day timezone issue [164](https://github.com/builttoroam/flutter_plugins/issues/164)
-* Added support for deleting individual or multiple instances of a recurring event for issue [108](https://github.com/builttoroam/flutter_plugins/issues/108)
-* Ability to add local calendars with a desired colour for issue [115](https://github.com/builttoroam/flutter_plugins/issues/115)
-* Returns account name and type for each calendars for issue [179](https://github.com/builttoroam/flutter_plugins/issues/179)
+* [Android] Fixed all day timezone issue [164](https://github.com/builttoroam/device_calendar/issues/164)
+* Added support for deleting individual or multiple instances of a recurring event for issue [108](https://github.com/builttoroam/device_calendar/issues/108)
+* Ability to add local calendars with a desired colour for issue [115](https://github.com/builttoroam/device_calendar/issues/115)
+* Returns account name and type for each calendars for issue [179](https://github.com/builttoroam/device_calendar/issues/179)
 
 ## 3.0.0+3 3rd February 2020
 
-* Fixed all day conditional check for issue [162](https://github.com/builttoroam/flutter_plugins/issues/162)
+* Fixed all day conditional check for issue [162](https://github.com/builttoroam/device_calendar/issues/162)
 
 ## 3.0.0+2 30th January 2020
 
 * Updated `event.allDay` property in `createOrUpdateEvent` method to be null-aware
 
 ## 3.0.0+1 28th January 2020
 
-* Updated `event.url` property in `createOrUpdateEvent` method to be null-aware for issue [152](https://github.com/builttoroam/flutter_plugins/issues/152)
+* Updated `event.url` property in `createOrUpdateEvent` method to be null-aware for issue [152](https://github.com/builttoroam/device_calendar/issues/152)
 
 ## 3.0.0 21st January 2020
 
@@ -50,7 +55,7 @@
 ## 1.0.0+3 9th January 2020
 
 * Flutter upgrade to 1.12.13
-* Added an URL input for calendar events for issue [132](https://github.com/builttoroam/flutter_plugins/issues/132)
+* Added an URL input for calendar events for issue [132](https://github.com/builttoroam/device_calendar/issues/132)
 
 ## 1.0.0+2 30th August 2019
 
@@ -62,11 +67,11 @@
 
 ## 1.0.0 28th August 2019
 
-* **BREAKING CHANGE** `retrieveCalendars` and `retrieveEvents` now return lists that cannot be modified (`UnmodifiableListView`) to address part of  issue [113](https://github.com/builttoroam/flutter_plugins/issues/113)
+* **BREAKING CHANGE** `retrieveCalendars` and `retrieveEvents` now return lists that cannot be modified (`UnmodifiableListView`) to address part of  issue [113](https://github.com/builttoroam/device_calendar/issues/113)
 * Support for more advanced recurrence rules
-* Update README to include information about using ProGuard for issue [99](https://github.com/builttoroam/flutter_plugins/issues/99)
-* Made event title optional to fix issue [72](https://github.com/builttoroam/flutter_plugins/issues/72)
-* Return information about the organiser of the event as per issue [73](https://github.com/builttoroam/flutter_plugins/issues/73)
+* Update README to include information about using ProGuard for issue [99](https://github.com/builttoroam/device_calendar/issues/99)
+* Made event title optional to fix issue [72](https://github.com/builttoroam/device_calendar/issues/72)
+* Return information about the organiser of the event as per issue [73](https://github.com/builttoroam/device_calendar/issues/73)
 * Return attendance status of attendees and if they're required for an event. These are details are different across iOS and Android and so are returned within platform-specific objects
 * Ability to modify attendees for an event
 * Ability to create reminders for events expressed in minutes before the event starts
@@ -81,7 +86,7 @@
 
 ## 0.2.1 5th August 2019
 
-* [Android] Fixes issue [101](https://github.com/builttoroam/flutter_plugins/issues/101) where plugin results in a crash with headless execution
+* [Android] Fixes issue [101](https://github.com/builttoroam/device_calendar/issues/101) where plugin results in a crash with headless execution
 
 ## 0.2.0 30th July 2019
 
@@ -91,7 +96,7 @@
 
 ## 0.1.3 5th July 2019
 
-* [iOS] Fixes issue [94](https://github.com/builttoroam/flutter_plugins/issues/94) that occurred on 32-bit iOS devices around date of events. Thanks to the PR submitted by [duzenko](https://github.com/duzenko)
+* [iOS] Fixes issue [94](https://github.com/builttoroam/device_calendar/issues/94) that occurred on 32-bit iOS devices around date of events. Thanks to the PR submitted by [duzenko](https://github.com/duzenko)
 
 ## 0.1.2+2 28th May 2019
 
@@ -104,11 +109,11 @@
 
 ## 0.1.2 - 16th May 2019
 
-* [Android] An updated fix to address issue [79](https://github.com/builttoroam/flutter_plugins/issues/79), thanks to the PR submitted by [Gerry High](https://github.com/gerryhigh)
+* [Android] An updated fix to address issue [79](https://github.com/builttoroam/device_calendar/issues/79), thanks to the PR submitted by [Gerry High](https://github.com/gerryhigh)
 
 ## 0.1.1 - 1st March 2019
 
-* Fixed issue [79](https://github.com/builttoroam/flutter_plugins/issues/79) where on Android, the plugin was indicating that it was handling permissions that it shouldn't have
+* Fixed issue [79](https://github.com/builttoroam/device_calendar/issues/79) where on Android, the plugin was indicating that it was handling permissions that it shouldn't have
 
 ## 0.1.0 - 26th February 2019
 
@@ -122,7 +127,7 @@
 
 ## 0.0.7 - 16th November 2018
 
-* Fixes issue [##67](https://github.com/builttoroam/flutter_plugins/issues/67) and [##68](https://github.com/builttoroam/flutter_plugins/issues/68). Thanks to PR submitted by huzhiren.
+* Fixes issue [##67](https://github.com/builttoroam/device_calendar/issues/67) and [##68](https://github.com/builttoroam/device_calendar/issues/68). Thanks to PR submitted by huzhiren.
 
 ## 0.0.6 - 18th June 2018
 

device_calendar/README.md → README.md

@@ -1,6 +1,6 @@
 # Device Calendar Plugin
 
-[![pub package](https://img.shields.io/pub/v/device_calendar.svg)](https://pub.dartlang.org/packages/device_calendar) [![Build Status](https://dev.azure.com/builttoroam/Flutter%20Plugins/_apis/build/status/Device%20Calendar)](https://dev.azure.com/builttoroam/Flutter%20Plugins/_build/latest?definitionId=106)
+[![pub package](https://img.shields.io/pub/v/device_calendar.svg)](https://pub.dartlang.org/packages/device_calendar) [![Build Status](https://dev.azure.com/builttoroam/Flutter%20Plugins/_apis/build/status/Device%20Calendar)](https://dev.azure.com/builttoroam/Flutter%20Plugins/_build/latest?definitionId=111)
 
 A cross platform plugin for modifying calendars on the user's device.
 
@@ -16,6 +16,10 @@ A cross platform plugin for modifying calendars on the user's device.
   * **NOTE**: Deleting multiple instances in **Android** takes time to update, you'll see the changes after a few seconds
 * Ability to add, modify or remove attendees and receive if an attendee is an organiser for an event
 * Ability to setup reminders for an event
+* Ability to specify a time zone for event start and end date
+  * **NOTE**: Due to a limitation of iOS API, single time zone property is used for iOS (`event.startTimeZone`)
+  * **NOTE**: For the time zone list, please refer to the `TZ database name` column on [Wikipedia](https://en.wikipedia.org/wiki/List_of_tz_database_time_zones)
+  * **NOTE**: If the time zone values are null or invalid, it will be defaulted to the device's current time zone.
 
 ## Android Integration
 
@@ -26,7 +30,7 @@ The following will need to be added to the manifest file for your application to
 <uses-permission android:name="android.permission.WRITE_CALENDAR" />
 ```
 
-If you have Proguard enabled, you may need to add the following to your configuration (thanks to [Britannio Jarrett](https://github.com/britannio) who posted about it [here](https://github.com/builttoroam/flutter_plugins/issues/99))
+If you have Proguard enabled, you may need to add the following to your configuration (thanks to [Britannio Jarrett](https://github.com/britannio) who posted about it [here](https://github.com/builttoroam/device_calendar/issues/99))
 
 ```
 -keep class com.builttoroam.devicecalendar.** { *; }

device_calendar/android/build.gradle → android/build.gradle

@@ -44,4 +44,5 @@ dependencies {
     implementation 'com.google.code.gson:gson:2.8.5'
     api 'androidx.appcompat:appcompat:1.0.2'
     implementation 'org.dmfs:lib-recur:0.11.2'
+    implementation 'org.jetbrains.kotlinx:kotlinx-coroutines-android:1.3.5'
 }