V3.9 release

.github/workflow/dart.yml

@@ -0,0 +1,38 @@
+# This workflow uses actions that are not certified by GitHub.
+# They are provided by a third-party and are governed by
+# separate terms of service, privacy policy, and support
+# documentation.
+
+name: build
+
+on:
+  push:
+    branches: [develop, release, hotfix, master]
+  pull_request:
+    branches: [develop, release, hotfix, master]
+  # Allows you to run this workflow manually from the Actions tab
+  workflow_dispatch:
+
+jobs:
+  test:
+    name: Build test
+    runs-on: macos-latest
+    steps:
+      - uses: actions/checkout@v2
+      - uses: actions/setup-java@v1
+        with:
+          java-version: "12.x"
+      - uses: subosito/flutter-action@v1
+        with:
+          channel: "stable"
+      - run: dart --version
+      - run: flutter --version
+      - run: flutter test
+      - name: iOS build
+        run: |
+          cd example
+          flutter build ios --release --no-codesign
+      - name: android build
+        run: |
+          cd example
+          flutter build appbundle

.github/workflow/prerelease.yml

@@ -0,0 +1,50 @@
+# This is a basic workflow to help you get started with Actions
+
+name: prerelease
+
+# Controls when the workflow will run
+on:
+  # Triggers the workflow on push or pull request events but only for the develop branch
+  push:
+    branches: [release, hotfix]
+  # Allows you to run this workflow manually from the Actions tab
+  workflow_dispatch:
+
+# A workflow run is made up of one or more jobs that can run sequentially or in parallel
+jobs:
+  # This workflow contains a single job called "build"
+  prerelease:
+    name: Development Release
+    # The type of runner that the job will run on
+    runs-on: ubuntu-latest
+    # Steps represent a sequence of tasks that will be executed as part of the job
+    steps:
+      # Checks-out your repository under $GITHUB_WORKSPACE, so your job can access it
+      - uses: actions/checkout@v2
+      - uses: subosito/flutter-action@v1
+        with:
+          channel: "stable"
+      - run: dart --version
+      - run: flutter --version
+      - name: Edit pubspec.ymal for dev release
+        run: |
+          sed  -i "s/version.*/&-$GITHUB_RUN_ID/" pubspec.yaml
+      - name: Get Changelog Entry
+        id: changelog_reader
+        uses: mindsers/changelog-reader-action@v2.0.0
+      - name: Edit changelog.md for dev release
+        run: |
+          sed -i "0,/\#\# \[.*/s//## [${{steps.changelog_reader.outputs.version}}-$GITHUB_RUN_ID]/" CHANGELOG.md
+          cat CHANGELOG.md
+      - name: Setup credentials
+        run: |
+          cat <<EOF > $PUB_CACHE/credentials.json
+          ${{ secrets.CREDENTIALS }}
+          EOF
+      - name: Publish package
+        run: flutter pub publish --force
+      - name: Add entry to Github release
+        uses: softprops/action-gh-release@v1
+        with:
+          tag_name: ${{ steps.changelog_reader.outputs.version }}+${{ github.run_id }}
+          prerelease: true

.github/workflow/release.yml

@@ -0,0 +1,42 @@
+# This is a basic workflow to help you get started with Actions
+
+name: release
+
+# Controls when the workflow will run
+on:
+  # Triggers the workflow on push or pull request events but only for the develop branch
+  push:
+    branches: [master]
+  # Allows you to run this workflow manually from the Actions tab
+  workflow_dispatch:
+
+# A workflow run is made up of one or more jobs that can run sequentially or in parallel
+jobs:
+  # This workflow contains a single job called "build"
+  release:
+    # The type of runner that the job will run on
+    runs-on: ubuntu-latest
+    # Steps represent a sequence of tasks that will be executed as part of the job
+    steps:
+      # Checks-out your repository under $GITHUB_WORKSPACE, so your job can access it
+      - uses: actions/checkout@v2
+      - uses: subosito/flutter-action@v1
+        with:
+          channel: "stable"
+      - run: dart --version
+      - run: flutter --version
+      - name: Setup credentials
+        run: |
+          cat <<EOF > $PUB_CACHE/credentials.json
+          ${{ secrets.CREDENTIALS }}
+          EOF
+      - name: Publish package
+        run: flutter pub publish --force
+      - name: Get Changelog Entry
+        id: changelog_reader
+        uses: mindsers/changelog-reader-action@v2.0.0
+      - name: Add entry to Github release
+        uses: softprops/action-gh-release@v1
+        with:
+          tag_name: ${{ steps.changelog_reader.outputs.version }}
+          body: ${{ steps.changelog_reader.outputs.changes }}

.gitignore

@@ -12,6 +12,12 @@ 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
+**/.idea/
+**/.vs/
+**/.settings
+**/.project
+**/.classpath
+.vscode

device_calendar/CHANGELOG.md → CHANGELOG.md

@@ -1,31 +1,43 @@
 # Changelog
 
-## 3.1.0 6th March 2020 - Bug fixes and new features
+## [3.9.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)
+* Migrated to null safety
+* Updated multiple underlying dependencies
+* Rebuilt iOS podfile
+* Upgraded to new Android plugins APIs for flutter
+
+## 3.2.0
+
+* 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 +62,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 +74,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 +93,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 +103,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 +116,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 +134,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
 

README.md

@@ -0,0 +1,64 @@
+# 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=111)
+
+A cross platform plugin for modifying calendars on the user's device.
+
+## Features
+
+* Request permissions to modify calendars on the user's device
+* Check if permissions to modify the calendars on the user's device have been granted
+* Add or retrieve calendars on the user's device
+* Retrieve events associated with a calendar
+* Add, update or delete events from a calendar
+* Set up, edit or delete recurring events
+  * **NOTE**: Editing a recurring event will currently edit all instances of it
+  * **NOTE**: Deleting multiple instances in **Android** takes time to update, you'll see the changes after a few seconds
+* Add, modify or remove attendees and receive if an attendee is an organiser for an event
+* Setup reminders for an event
+* 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.
+
+## Null migration
+
+From v4.0.0, device_calendar fits null safety. However, not all workflow had been checked and bugs from 3.2 still presists.
+
+You are strongly advised to test your workflow with the new package before shipping. 
+Better yet, please leave a note for what works and what doesn't, or contribute some bug fixes!
+
+## Android Integration
+
+The following will need to be added to the manifest file for your application to indicate permissions to modify calendars a needed
+
+```xml
+<uses-permission android:name="android.permission.READ_CALENDAR" />
+<uses-permission android:name="android.permission.WRITE_CALENDAR" />
+```
+### Proguard / R8 exceptions
+By default, all android apps go through R8 for file shrinking when building a release version. Currently, it interferes with some functions such as `retrieveCalendars()`.
+
+You may add the following setting to the ProGuard rules file (thanks to [Britannio Jarrett](https://github.com/britannio)). Read more about the issue [here](https://github.com/builttoroam/device_calendar/issues/99)
+
+```
+-keep class com.builttoroam.devicecalendar.** { *; }
+```
+
+See [here](https://github.com/builttoroam/device_calendar/issues/99#issuecomment-612449677) for an example setup.
+
+For more information, refer to the guide at [Android Developer](https://developer.android.com/studio/build/shrink-code#keep-code)
+
+### AndroidX migration
+**IMPORTANT**: Since version 0.1.0, this version has migrated to use AndroidX instead of the deprecated Android support libraries. When using version 0.10.0 and onwards for this plugin, please ensure your application has been migrated following the guide [here](https://developer.android.com/jetpack/androidx/migrate)
+
+## iOS Integration
+
+For iOS 10 support, you'll need to modify the Info.plist to add the following key/value pair
+
+```xml
+<key>NSCalendarsUsageDescription</key>
+<string>INSERT_REASON_HERE</string>
+```
+
+Note that on iOS, this is a Swift plugin. There is a known issue being tracked [here](https://github.com/flutter/flutter/issues/16049) by the Flutter team, where adding a plugin developed in Swift to an Objective-C project causes problems. If you run into such issues, please look at the suggested workarounds there.

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

@@ -25,7 +25,7 @@ apply plugin: 'com.android.library'
 apply plugin: 'kotlin-android'
 
 android {
-    compileSdkVersion 28
+    compileSdkVersion 29
 
     sourceSets {
         main.java.srcDirs += 'src/main/kotlin'
@@ -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'
 }

android/src/main/kotlin/com/builttoroam/devicecalendar/AvailabilitySerializer.kt

@@ -0,0 +1,14 @@
+package com.builttoroam.devicecalendar
+
+import com.builttoroam.devicecalendar.models.Availability
+import com.google.gson.*
+import java.lang.reflect.Type
+
+class AvailabilitySerializer: JsonSerializer<Availability> {
+    override fun serialize(src: Availability?, typeOfSrc: Type?, context: JsonSerializationContext?): JsonElement {
+        if(src != null) {
+            return JsonPrimitive(src.name)
+        }
+        return JsonObject()
+    }
+}