public class HealthConfigurationException

  1. Object
  2. Throwable
  3. Exception
  4. RuntimeException
  5. HealthConfigurationException

Thrown when the app is missing build configuration that the health APIs cannot work without – an absent ios.NSHealthShareUsageDescription build hint, a missing Health Connect privacy-policy declaration.

Why this is unchecked, when everything else is an AsyncResource failure

An unsupported platform is a runtime fact that a correct app must handle gracefully, so it arrives as a HealthException through an AsyncResource. A missing usage description is a developer bug that gets the app rejected from the App Store, and it must therefore be impossible to swallow into an error callback nobody logs. It follows the precedent set by LocationManager on iOS, which throws with the exact name of the build hint to add.

Health.getConfigurationProblems() returns the same diagnostics without throwing, so a diagnostics screen or a unit test can assert on them.

Constructors

public HealthConfigurationException(String message)Creates an exception whose message should name the exact build hint to add and describe what to put in it.

Inherited methods

From Throwable

initCause, getCause, getMessage, printStackTrace, printStackTrace, toString, addSuppressed, getStackTrace, setStackTrace, getSuppressed, getLocalizedMessage

From Object

equals, getClass, hashCode, notify, notifyAll, wait, wait, wait, clone

Constructor details

HealthConfigurationException

public HealthConfigurationException(String message)
Creates an exception whose message should name the exact build hint to add and describe what to put in it.