IronSet Documentation

Cardio Workouts

1 Starting Cardio Workout

Set up your activity, follow your intervals, and review your cardio progress. IronSet keeps the session timer available while you work out, including when you need to switch apps.

1 Setting Up Your Workout

2 During the Workout

3 Ending and Progress Tracking

Welcome to the Cardio Timer

This screen is designed to guide you through your high-intensity intervals (HIIT), runs, or cycling sessions. It acts as your personal coach, keeping track of every second so you can focus entirely on your workout.

1 Setting Your Intervals

Use the number pickers at the top of the screen:

2 Controlling the Workout

3 Recorded Intervals Summary

As you exercise, the app builds a live log of your intervals:

What to Expect During Your Workout

Cardio workout setup showing interval options
Cardio interval options

Active Cardio Dashboard

This screen is your Active Cardio Dashboard. It provides real-time tracking, visual cues, and interval management for your workout, and is designed to stay active and accurate even during long sessions.

1 The Workout Header

The status panel at the top gives you an immediate overview of your current progress:

2 Cycle Configuration

3 The Interval Timeline

The Rest/Activity Intervals bar provides a visual map of your workout:

4 Controls and Live Timer

Reliability Features

Behind the scenes, Android features help protect your tracking during long cardio workouts:

Cardio workout setup with custom interval controls
Custom cardio interval setup

2 Overview

How IronSet keeps workout timers and interval logic running reliably when you leave the app or turn off your screen.

Android 14 (API level 34) introduced stricter requirements for foreground services. An app must declare a service type that matches the work it performs. IronSet uses the special-use type for its workout service when cardio timers and related workout logic need to continue while the app is in the background.

1 What special use means

The specialUse type is intended for a critical, user-initiated foreground task that does not fit an available standard category. For IronSet, the service coordinates workout timers and related logic during a session.

3 Why IronSet uses special use

A cardio session may last a long time. The foreground service helps keep the workout's timer and state active if the user switches apps or the screen turns off.

Long-running workouts
Keeps timer and workout logic running through extended sessions instead of relying on the app remaining in the foreground.
Coordinated workout behavior
Supports coordination such as interval timing, audio cues, and local workout data handling.
Declare the purpose accurately. The selected service type and its description should match the behavior users actually receive from the app.

4 Requirements for the service

When using the special-use foreground service type, IronSet should keep the service visible, tied to an explicit user action, and limited to the time the workout needs it.

1 User awareness

Show an ongoing foreground-service notification while the service runs. IronSet starts foreground operation from its workout service using startForeground().

2 User initiation

Start the service as the result of a clear user action, such as selecting Start Workout.

3 Stop when no longer needed

Stop the foreground service when the workout is finished or the user ends the session, so it does not continue running unnecessarily.

4 Explain the special-use subtype

Provide a concise subtype description in the app manifest that explains the user-facing purpose of the service. The project description is:

Foreground service subtype
Workout tracking and timer for physical exercise

5 Health vs. special use

Android also provides a health foreground-service type. Choose the type that accurately describes the service's primary work and permissions; a workout timer alone does not necessarily require live health-sensor access.

1 When a health service may fit

If IronSet adds features that continuously read live heart rate or other health data, review whether the health type better matches those features and their applicable Android requirements.

In Summary

IronSet uses a foreground service to support workout timers and related cardio-session behavior when the app is not on screen. Keep the declaration aligned with the app's real behavior, make the service user-initiated and visible, and stop it when the workout ends.