Merge branch 'audiostreamer-dev' into feature/fix-microphone-in-use-crash

Author: hoffmatteo

.github/workflows/dependency-review.yml

@@ -0,0 +1,20 @@
+# Dependency Review Action
+#
+# This Action will scan dependency manifest files that change as part of a Pull Request, surfacing known-vulnerable versions of the packages declared or updated in the PR. Once installed, if the workflow run is marked as required, PRs introducing known-vulnerable packages will be blocked from merging.
+#
+# Source repository: https://github.com/actions/dependency-review-action
+# Public documentation: https://docs.github.com/en/code-security/supply-chain-security/understanding-your-software-supply-chain/about-dependency-review#dependency-review-enforcement
+name: 'Dependency Review'
+on: [pull_request]
+
+permissions:
+  contents: read
+
+jobs:
+  dependency-review:
+    runs-on: ubuntu-latest
+    steps:
+      - name: 'Checkout Repository'
+        uses: actions/checkout@v3
+      - name: 'Dependency Review'
+        uses: actions/dependency-review-action@v1

.gitignore

@@ -116,4 +116,6 @@ app.*.symbols
 !**/ios/**/default.pbxuser
 !**/ios/**/default.perspectivev3
 !/packages/flutter_tools/test/data/dart_dependencies_test/**/.packages
-!/dev/ci/**/Gemfile.lock
+!/dev/ci/**/Gemfile.lock
+packages/app_usage/example/.flutter-plugins-dependencies
+packages/app_usage/example/.flutter-plugins-dependencies

README.md

@@ -20,7 +20,7 @@ These are the available plugins in this repository.
 | [weather](./packages/weather) | Get current weather, as well as forecasting using the OpenWeatherMap API. | ✔️ | ✔️  | [![pub package](https://img.shields.io/pub/v/weather.svg)](https://pub.dartlang.org/packages/weather) |
 | [air_quality](./packages/air_quality) | Get the air quality index using the WAQI API. | ✔️ | ✔️  | [![pub package](https://img.shields.io/pub/v/air_quality.svg)](https://pub.dartlang.org/packages/air_quality) |
 | [notifications](./packages/notifications) | Track device notifications. | ✔️ | ❌  | [![pub package](https://img.shields.io/pub/v/notifications.svg)](https://pub.dartlang.org/packages/notifications) |
-| [movisens_flutter](./packages/movisens_flutter) | Movisens sensor communication. | ✔️ | ❌  | [![pub package](https://img.shields.io/pub/v/movisens_flutter.svg)](https://pub.dartlang.org/packages/movisens_flutter) |
+| [movisens_flutter](./packages/movisens_flutter) | Movisens sensor communication. | ✔️ | ✔️  | [![pub package](https://img.shields.io/pub/v/movisens_flutter.svg)](https://pub.dartlang.org/packages/movisens_flutter) |
 | [esense_flutter](./packages/esense_flutter) | eSense ear sensor plugin. | ✔️ | ✔️  | [![pub package](https://img.shields.io/pub/v/esense_flutter.svg)](https://pub.dartlang.org/packages/esense_flutter) |
 | [health](./packages/health) | Apple HealthKit and Google Fit interface plugin. | ✔️ | ✔️  | [![pub package](https://img.shields.io/pub/v/health.svg)](https://pub.dartlang.org/packages/health) |
 | [activity_recognition](./packages/activity_recognition_flutter) | Activity Recognition | ✔️ | ✔️  | [![pub package](https://img.shields.io/pub/v/activity_recognition_flutter.svg)](https://pub.dartlang.org/packages/activity_recognition_flutter) |

docs/_config.yml

@@ -0,0 +1,30 @@
+# Miscellaneous
+*.class
+*.log
+*.pyc
+*.swp
+.DS_Store
+.atom/
+.buildlog/
+.history
+.svn/
+migrate_working_dir/
+
+# IntelliJ related
+*.iml
+*.ipr
+*.iws
+.idea/
+
+# The .vscode folder contains launch configuration and tasks you configure in
+# VS Code which you may wish to be included in version control, so this line
+# is commented out by default.
+#.vscode/
+
+# Flutter/Dart/Pub related
+# Libraries should not include pubspec.lock, per https://dart.dev/guides/libraries/private-files#pubspeclock.
+/pubspec.lock
+**/doc/api/
+.dart_tool/
+.packages
+build/

docs/index.html

@@ -0,0 +1,30 @@
+# This file tracks properties of this Flutter project.
+# Used by Flutter tool to assess capabilities and perform upgrades etc.
+#
+# This file should be version controlled.
+
+version:
+  revision: 52b3dc25f6471c27b2144594abb11c741cb88f57
+  channel: stable
+
+project_type: plugin
+
+# Tracks metadata for the flutter migrate command
+migration:
+  platforms:
+    - platform: root
+      create_revision: 52b3dc25f6471c27b2144594abb11c741cb88f57
+      base_revision: 52b3dc25f6471c27b2144594abb11c741cb88f57
+    - platform: android
+      create_revision: 52b3dc25f6471c27b2144594abb11c741cb88f57
+      base_revision: 52b3dc25f6471c27b2144594abb11c741cb88f57
+
+  # User provided section
+
+  # List of Local paths (relative to this file) that should be
+  # ignored by the migrate tool.
+  #
+  # Files that are not part of the templates will be ignored by default.
+  unmanaged_files:
+    - 'lib/main.dart'
+    - 'ios/Runner.xcodeproj/project.pbxproj'

packages/.gitignore

@@ -1,3 +1,13 @@
+## 2.1.1
+
+- check of Android OS version added when getting `lastForeground`.
+
+## 2.1.0
+
+- Addition of `lastForeground` information - when was the app last time in the foreground.
+- update of example app to AndroidX and new gradle build version.
+- update of documentation.
+
 ## 2.0.0
 
 - Migration to null safety

packages/.metadata

@@ -1,21 +1,16 @@
-MIT License
+MIT License.
 
-Copyright (c) 2018 thomasnilsson
+Copyright 2018-2022 Copenhagen Center for Health Technology (CACHET) at the Technical University of Denmark (DTU).
 
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
+Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated
+documentation files (the ”Software”), to deal in the Software without restriction, including without limitation
+the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software,
+and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
 
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
+The above copyright notice and this permission notice shall be included in all copies or substantial
+portions of the Software.
 
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.
+THE SOFTWARE IS PROVIDED ”AS IS”, WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED
+TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL
+THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF
+CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS

packages/app_usage/CHANGELOG.md

@@ -1,14 +1,17 @@
-# app_usage
+# App Usage
 
 [![pub package](https://img.shields.io/pub/v/app_usage.svg)](https://pub.dartlang.org/packages/app_usage)
 
-Application usage stats for Android only. Note that the stats are only precise down to a daily basis. This is a limitation from Google's implementation, unfortunately.
+Application usage stats for Android only. Note that the stats are only precise down to a daily basis. This is a limitation from Google's implementation.
+
 ## Install
-Add ```app_usage``` as a dependency in  `pubspec.yaml`.
+
+Add `app_usage` as a dependency in  `pubspec.yaml`.
 For help on adding as a dependency, view the [documentation](https://flutter.io/using-packages/).
 
 ## Android
-*NB: Requires API level 21 as a minimum!*
+
+> **Note:** Requires API level 21 as a minimum.
 
 I.e. you need to set the min SDK version inside the `android/app/build.gradle`:
 
@@ -17,19 +20,21 @@ minSdkVersion 21
 ```
 
 You need to add the following package to the manifest namespace in `AndroidManifest.xml`:
+
 ```xml
 xmlns:tools="http://schemas.android.com/tools"
 ```
 
 as well as the following permissions to the manifest:
 
-```
+```xml
     <uses-permission
         android:name="android.permission.PACKAGE_USAGE_STATS"
         tools:ignore="ProtectedPermissions" />
 ```
 
 Below is an example of how the start of your manifest should look in the end
+
 ```xml
 <manifest xmlns:android="http://schemas.android.com/apk/res/android"
     package="YOUR_PACKAGE_NAME_HERE"
@@ -41,15 +46,27 @@ Below is an example of how the start of your manifest should look in the end
 ```
 
 ## Usage
+
+The `AppUsage` class works as a singleton and you get app usage statistics by calling:
+
+```dart
+AppUsage().getAppUsage(startDate, endDate)
+````
+
+A larger example (from the example app) could look like:
+
 ```dart
   void getUsageStats() async {
     try {
-      DateTime startDate = DateTime(2018, 01, 01);
-      DateTime endDate = new DateTime.now();
-      List<AppUsageInfo> infos = await AppUsage.getAppUsage(startDate, endDate);
-      setState(() {
-        _infos = infos;
-      });
+      DateTime endDate = DateTime.now();
+      DateTime startDate = endDate.subtract(Duration(hours: 1));
+      List<AppUsageInfo> infoList =
+          await AppUsage().getAppUsage(startDate, endDate);
+      setState(() => _infos = infoList);
+
+      for (var info in infoList) {
+        print(info.toString());
+      }
     } on AppUsageException catch (exception) {
       print(exception);
     }
@@ -60,23 +77,28 @@ Each `AppUsageInfo` object has the following public fields:
 
 ```dart
   /// The name of the application
-  String get appName;
+  String get appName => _appName;
 
   /// The name of the application package
-  String get packageName;
+  String get packageName => _packageName;
 
   /// The amount of time the application has been used
   /// in the specified interval
-  Duration get usage;
+  Duration get usage => _usage;
 
   /// The start of the interval
-  DateTime get startDate;
+  DateTime get startDate => _startDate;
 
   /// The end of the interval
-  DateTime get endDate;
+  DateTime get endDate => _endDate;
+
+  /// Last time app was in foreground
+  DateTime get lastForeground => _lastForeground;
+
 ```
 
+## Example app
+
+The example app shows how to use the plugin.
 
-## Example screenshot
-The first screen will ask for permission to view usage stats. Tap on your application.
-![Screenshot](https://raw.githubusercontent.com/cph-cachet/flutter-plugins/master/packages/app_usage/images/app_usage_screenshot.png)
+The first screen will ask for permission to view usage stats. Tap on your application and allow it to access usage information. Then you can "download" app usage stats by pressing the arrow button.