0.6.4 #

• Support 1.0.0 version of stable dependencies. (dart_lsc)

0.6.3 #

• moved the connectivity sampling package to an external carp_connectivity_package due to issue#46.

0.6.2 #

• intensive test of data upload to CARP and Firebase on both Android and iOS
• support for retry in upload of data to CARP
• handling that a study id can only be an integer in the CARP web services

0.6.1 #

• Thorough testing on iOS.
• Better handling of probes not available on iOS via the initialize method.
• Centralized concept for handling permissions.

0.6.0 - Trigger Model & Data Manager events #

• Extension of Study domain model to include support for Trigger, which manages the temporal triggering of data sampling. See the documentation on how to defined a study with triggers.

• Adjustment of runtime environment to reflect the new study model

  • Addition of a TriggerExecutor
  • Update to Executors, i.e. StudyExecutor, TaskExecutor and Probe

• The data manager model has been updated

  • A DataManager now expose a stream of state events as defined in DataManagerEventTypes
  • A DataManager now has a type which is a string as defined in DataEndPointTypes
  • These changes are also implemented for the file and CARP data managers.

• Minor refactoring

  • Apps and AppUsage are no longer periodic measure, but one-off measures. Hence, use the new trigger model to sample installed apps and their usage e.g. on a daily basis.
  • The BluetoothDatum now lists all devices found in a scan.
  • The pedometer now works as a simple step stream which sense and report each step taken.
  • datastore library have been renamed to data_managers.

0.5.1 #

• Update of readme file.

0.5.0 - AndroidX Compatibility #

• Breaking change. This version has been migrated from the deprecated Android Support Library to AndroidX. This should not result in any functional changes, but it requires any Android app using this plugin to also migrate if they're using the original support library.
  • See Flutter AndroidX compatibility
• Fixed error in PedometerProbe

0.4.0 - Data Transformers and Privacy Support #

• support for data transformers
  • OMH Geolocation
  • OMH PhysicalActivity
• support for privacy schema
  • added support for hashing bluetooth names in the bluetooth package
• upgrade to json_serializable v.2

0.3.10 #

• minor change to the StreamProbe API - now non-static streams can be used by implementing the get stream method.
• update of the relevant sampling packages using StreamProbe

0.3.8+9 #

• update and rename of CARPDataPoint to DataPoint to reflect new CARP API.
• moved CARP web service specific data model to CARPDataPoint to the carp_webservices package.

0.3.5+6+7 #

• rename of packages folder to sampling_packages (seems like Dart Pub don't like folders called packages)
• rename of core folder to domain

0.3.3 #

• update to new versions of CACHET Flutter Plugins
• rename of probes folder to packages
• upgrade and test on Flutter v. 1.3.4 Dart v. 2.2.1

0.3.2 - Sampling Packages #

• support for dividing probes into separate sampling packages
• included in carp_mobile_sensing are
  • device (device, screen, memory, battery)
  • sensors (sensors, light, pedometer)
  • connectivity (connectivity, bluetooth)
  • apps (installed apps, app usage)
• implementation of the following external probe packages:
  • communication (sms & call log)
  • context (location, activity, weather)
  • audio (noise, audio recording)
  • movisens (Movisens Move/ECG devices)

0.3.1 #

• small updates to the data format incl. documentation on the wiki.
• fixed error in the stop method.

0.3.0 - Domain Model update #

• major updates to the domain model as a core library
  • Measure now have a configuration
• simplification to probe implementations
• all probes now uses the Dart Stream API and supports a reactive programming model
• all probes adjusted to a stream model
• implementation of SamplingSchema architecture
• support for power-aware sampling using different sampling schemas

0.2.6 #

• fixed small bug in weater probe.

0.2.5 #

• small bug fixes in connectivity datum model (to work w. `carp_firebase_backend).
• weather probe added.

0.2.4 #

• error in light probe fixed.
• noise probe added.
• using the carp_core domain model

0.2.3 #

• fixed error in readme file.

0.2.2 #

• phone_log probe added
• audio probe added
• activity probe added
• improvement to readme file on manifest.xml and Info.plist.

0.2.1 #

• re-organization of github location and outline
• improvements to FileDataManager to avoid race conditions
• improved API documentation

0.2.0 #

• refactor of organization of classes into libraries
• complete API documentation

0.1.1 #

• small improvements incl. documentation

0.1.0 #

• removal of all remote backend code to separate packages

0.0.1 #

• Initial version by Jakob E. Bardram
• Transferring the old implementation to this carp.sensing-flutter framework
• General refactor and clean-up

example/lib/main.dart

/*
 * Copyright 2018 Copenhagen Center for Health Technology (CACHET) at the
 * Technical University of Denmark (DTU).
 * Use of this source code is governed by a MIT-style license that can be
 * found in the LICENSE file.
 */
import 'package:flutter/material.dart';
import 'package:carp_mobile_sensing/carp_mobile_sensing.dart';

void main() => runApp(new CARPMobileSensingApp());

class CARPMobileSensingApp extends StatelessWidget {
  // This widget is the root of your application.
  @override
  Widget build(BuildContext context) {
    return new MaterialApp(
      title: 'CARP Mobile Sensing Demo',
      theme: new ThemeData(
        primarySwatch: Colors.blue,
      ),
      home: new ConsolePage(title: 'CARP Mobile Sensing Demo'),
    );
  }
}

class ConsolePage extends StatefulWidget {
  ConsolePage({Key key, this.title}) : super(key: key);

  final String title;

  @override
  Console createState() => new Console();
}

class Console extends State<ConsolePage> {
  String _log = "";
  Sensing sensing;

  void log(String msg) {
    setState(() {
      _log += "$msg\n";
    });
  }

  void clearLog() {
    setState(() {
      _log += "";
    });
  }

  void restart() {
    log("-------------------------------------\nSensing restarted...");
    sensing.start();
  }

  @override
  void initState() {
    super.initState();
    sensing = new Sensing(this);
    sensing.start();
  }

  @override
  void dispose() {
    sensing.stop();
    super.dispose();
  }

  @override
  Widget build(BuildContext context) {
    return new Scaffold(
      appBar: new AppBar(
        title: new Text(widget.title),
      ),
      body: new SingleChildScrollView(
        child: StreamBuilder(
          stream: sensing.controller.events,
          builder: (context, AsyncSnapshot<Datum> snapshot) {
            if (snapshot.hasData) {
              _log += "${snapshot.data.toString()}\n";
              return Text(_log);
            } else if (snapshot.hasError) {
              return Text(snapshot.error.toString());
            }
            return Center(child: CircularProgressIndicator());
          },
        ),
      ),
      floatingActionButton: new FloatingActionButton(
        onPressed: restart,
        tooltip: 'Restart study & probes',
        child: new Icon(Icons.cached),
      ),
    );
  }
}

/// This class implements sensing incl. setting up a [Study] with [Task]s and [Measure]s.
///
/// This example is useful for creating a Business Logical Object (BLOC) in a Flutter app.
/// See e.g. the CARP Mobile Sensing App.
class Sensing {
  Study study;
  Console console;
  StudyController controller;

  Sensing(this.console) {
    //DataManagerRegistry.register(DataEndPointType.PRINT, new ConsoleDataManager());
    //DataManagerRegistry.register(DataEndPointType.FILE, new FileDataManager());
  }

  /// (Re)start sensing.
  void start() async {
    console.log("Setting up study...");

    // create the study
    study = Study("2", 'user@cachet.dk',
            name: 'A default / common study',
            dataEndPoint: FileDataEndPoint()
              ..bufferSize = 500 * 1000
              ..zip = true
              ..encrypt = false)
          ..addTriggerTask(
              ImmediateTrigger(),
              Task()
                ..measures = SamplingSchema.debug().getMeasureList(
                  namespace: NameSpace.CARP,
                  types: [
                    SensorSamplingPackage.LIGHT,
                    AppsSamplingPackage.APP_USAGE,
                    DeviceSamplingPackage.MEMORY,
                  ],
                ))
//      ..addTriggerTask(ImmediateTrigger(),
//          Task()..measures = SamplingSchema.common(namespace: NameSpace.CARP).measures.values.toList())
        ;

    console.log("Setting up '${study.name}'...");

    // print the study to the console
    console.log(study.toString());

    // Create a Study Controller that can manage this study, initialize it, and start it.
    controller = StudyController(study);
    await controller.initialize();
    controller.start();
    console.log("Sensing started ...");

    // listening on all probe events from the study
    controller.events.forEach(print);

    // listening on a specific probe
    //ProbeRegistry.probes[DataType.LOCATION].events.forEach(print);
  }

  /// Stop sensing.
  void stop() async {
    controller.stop();
    study = null;
    console.log("Sensing stopped ...");
  }
}