Skip to Content
FeaturesActivity Metrics

Activity Metrics

Status: Current implemented behavior. Audience: Users and contributors. Implementation: features/activity, data/repository/ActivityRepository.kt. Navigation: Screen.Metric; widgets STEPS, DISTANCE, CALORIES_OUT, ACTIVE_CALORIES, FLOORS, ELEVATION, WHEELCHAIR_PUSHES. Related: Feature map, Statistics, Recording of activity.

The activity feature owns period-based detail screens for movement metrics and workout sessions. It is separate from activity recording: recording and manual activity entry create records, while these screens read and explain existing Health Connect data.

Implemented Metrics

Activity metric detail screens currently cover:

  • Steps.
  • Distance.
  • Calories burned.
  • Active calories.
  • Floors.
  • Elevation.
  • Wheelchair pushes.

The workout/session area also covers activity lists, activity detail, route preview/export, heart-rate charts for workouts, activity summaries, and cardio-load context.

Workout Distance

A workout’s distance is the sum of the Health Connect distance records inside the session. When there are none, the route’s length fills in.

Some apps save a GPS route but a distance estimated from steps, which can be half the real one. The Distance from GPS routes setting under Activities, off by default, makes a workout with a route take the route’s length instead. Pace, speed, splits, the activity statistics, exports and the PDF report follow it. Workouts without a route keep their recorded distance.

Routes written by other apps are readable only with the Exercise routes permission, which you grant in Health Connect’s own settings.

Detail Pattern

Activity metric screens follow the shared period-detail model:

  • Day, week, month, and year ranges.
  • Selected anchor date.
  • Previous/next period navigation.
  • Calendar selection.
  • Pull to refresh.
  • Period charts and selected-day entry views where available.
  • In the month view, a goal ring on each day, filled by the day’s share of the daily goal and full on or past it. Workouts, hydration, mindfulness, and sleep show it too; nutrition does not yet.
  • Statistics, comparisons, baselines, confidence, and source context.
  • Reorderable metric detail sections.

The movement metrics share one metric screen configured per metric, which carries each metric’s title, accent, required Health Connect permission, and value extraction. Calories, active calories and BMR render the calories aggregate instead.

Screen state lives in an activity ViewModel loading through ActivityRepository. Period selection is not owned by the view model — the shared metric-detail scaffold owns it and hands a selection down. New activity metric work should keep metric-specific charts and rows in features/activity and use the shared scaffold instead of adding a new screen shell.

AchievementsSleep Tracking