groups:
  - id: registry.android
    prefix: android
    type: attribute_group
    brief: >
      The Android platform on which the Android application is running.
    attributes:
      - id: os.api_level
        type: string
        stability: experimental
        brief: >
          Uniquely identifies the framework API revision offered by a version
          (`os.version`) of the android operating system. More information can be found
          [here](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels).
        examples: ['33', '32']
  - id: registry.android.lifecycle.events
    prefix: android
    type: attribute_group
    brief: >
        This document defines attributes that represents an occurrence of a lifecycle transition on the Android platform.
    attributes:
      - id: state
        stability: experimental
        brief: >
          This attribute represents the state the application has transitioned into at the occurrence of the event.
        note: >
          The Android lifecycle states are defined in [Activity lifecycle callbacks](https://developer.android.com/guide/components/activities/activity-lifecycle#lc),
          and from which the `OS identifiers` are derived.
        type:
          allow_custom_values: false
          members:
            - id: created
              value: 'created'
              brief: >
                Any time before Activity.onResume() or, if the app has no Activity, Context.startService()
                has been called in the app for the first time.
              stability: experimental
            - id: background
              value: 'background'
              brief: >
                Any time after Activity.onPause() or, if the app has no Activity,
                Context.stopService() has been called when the app was in the foreground state.
              stability: experimental
            - id: foreground
              value: 'foreground'
              brief: >
                Any time after Activity.onResume() or, if the app has no Activity,
                Context.startService() has been called when the app was in either the created or background states.
              stability: experimental