Install Context

Add the package

To use this package, add the following to your pubspec.yaml file. Note that this package only works together with carp_mobile_sensing.

dependencies:
  carp_mobile_sensing: ^latest
  carp_context_package: ^latest
  ...

Permissions

This context package makes use of what Apple and Google denote as sensitive information, especially location and physical activity. Therefore it is important to configure the app to access this information. Please read carefully the [instructions on how to set up the permission_handler plugin](https://github.com/carp-dk/carp.sensing-flutter/tree/main/packages/carp_context_package/ https://pub.dev/packages/permission_handler#setup) - both for Android and iOS.

Android

Add the following to your app’s AndroidManifest.xml file located in android/app/src/main:

<manifest xmlns:android="http://schemas.android.com/apk/res/android"
    package="<your_package_name>"
    xmlns:tools="http://schemas.android.com/tools">

   ...

    <uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" />
    <uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION" />
    <uses-permission android:name="android.permission.ACCESS_BACKGROUND_LOCATION" />
    <uses-permission android:name="android.permission.FOREGROUND_SERVICE_LOCATION" />

</manifest>

iOS

In order to use Location and Activity Recognition, you need to set your minimum deployment target to iOS 15.0 or later. Furthermore, you need to enable the macros from the [permission_handler](https://github.com/carp-dk/carp.sensing-flutter/tree/main/packages/carp_context_package/ https://pub.dev/packages/permission_handler#setup) plugin. Please see the [setup instructions](https://github.com/carp-dk/carp.sensing-flutter/tree/main/packages/carp_context_package/ https://pub.dev/packages/permission_handler#setup) for iOS.

The activity_recognition_flutter plugin used for the ACTIVITY measure ships its iOS side as a Swift package only - CocoaPods is not supported. Your app therefore has to use Swift Package Manager, which is enabled by default from Flutter 3.44. If you have turned it off, re-enable it with:

flutter config --enable-swift-package-manager

Change the post_install part of your ios/Podfile:

platform :ios, '15.0'


...

post_install do |installer|
  installer.generated_projects.each do |project|
    project.targets.each do |target|
      target.build_configurations.each do |config|
          config.build_settings['IPHONEOS_DEPLOYMENT_TARGET'] = '15.0'
      end
    end
  end
  installer.pods_project.targets.each do |target|
    flutter_additional_ios_build_settings(target)

    target.build_configurations.each do |config|
      config.build_settings['GCC_PREPROCESSOR_DEFINITIONS'] ||= [
        '$(inherited)',
        # See https://pub.dev/packages/permission_handler#setup - under iOS setup

        # The context package uses the following permissions:
        'PERMISSION_LOCATION=1',      # Location access
        'PERMISSION_NOTIFICATIONS=1', # CARP Mobile Sensing uses notifications
        'PERMISSION_SENSORS=1',       # Core Motion sensors on iOS (pedometer)
      ]
    end
  end
end

Add the following permissions in the Info.plist file located in ios/Runner (use your own text for explanation in the <string> tags):

<plist version="1.0">
<dict>
    ...
    <key>NSLocationWhenInUseUsageDescription</key>
    <string>Uses the location API to record location.</string>
    <key>NSLocationAlwaysUsageDescription</key>
    <string>Uses the location API to record location.</string>
    <key>NSLocationAlwaysAndWhenInUseUsageDescription</key>
    <string>Uses the location API to record location.</string>
    <key>NSMotionUsageDescription</key>
    <string>Detects activity.</string>
    <key>UIBackgroundModes</key>
      <array>
        <string>fetch</string>
        <string>location</string>
      </array>
</dict>
</plist>

Also - make sure to activate Background mode for your Runner. Open XCode and go to “Signing & Capabilities”. Add the “Background Modes” section and add “Location updates” to the list:

iOS Setup