CARP Mobile Sensing API 2.0 Released

Posted on by

We are pleased to announce the release of a new major version of the CARP Mobile Sensing (CAMS) framework, now at API level 2.0.

This release introduces a redesigned architecture and a restructured set of Flutter packages, providing a more consistent, modular, and scalable foundation for mobile sensing and digital phenotyping applications.

Overview

This release has two new main features: (i) to support adding, running, and removing multiple studies to the client manager, and (ii) to save the runtime state persistently so that sampling of data in all studies will resume effortlessly across app restarts. In addition, a set of issues has been addressed, as listed in Milestone 2.0.0. The important ones include:

  • Update of the client software architecture to reflect the CARP Core client architecture. This – amongst other things – provides better support for StudyStatus in the client manager (#504)
  • Simplified configuration – now only the client and not the controller needs configuration.
  • Revised state machine model for executors, now using states ‘resumed’ and ‘paused’ instead of ‘started’ and ‘stopped’.
  • Added AppLifecycleEvent measure to collect life-cycle events from the app
  • Correct device registration in the deployment service (#550).

The goal of this release is to provide a stable and extensible platform for building mobile sensing applications across research and clinical domains.

Package Distribution

All packages are available via GitHub and pub.dev:

The primary Flutter package is the carp_mobile_sensing package.

Documentation

A new documentation site has been released alongside API 2.0.

The documentation includes:

  • Installation and setup guides
  • Conceptual overview of the framework
  • API-level documentation
  • Code examples and usage patterns
  • .. and many more topics

Community Support

Community interaction and support are now handled via Discord – join the CARP server here.

This channel is intended for:

  • Technical questions and troubleshooting
  • Discussion of use cases
  • Announcements and updates

Getting Started

To get started with API 2.0:

  1. Install the carp_mobile_sensing package from pub.dev
  2. Review the documentation site for setup and examples
  3. Consult the changelog for recent updates and changes
  4. Take a look at the two example apps – the CARP Demo App and the Pulmonary Monitor – which are both updated to API level 2.0