App decision

A decision block that start an app activity.

The fiber will pause until the activity has finished or the timeout expired. If you don’t want the fiber to pause, use the App start block instead.

Only some app activities are designed to return a meaningful result, those activities often perform a single task, like picking, inserting or deleting content.

An app activity is referred, either explicitly by its package and activity class (use the Pick app activity button), or implicitly by an action and data URI. To implicitly start the “main” activity like the launcher does, specify only the package

What data and actions an activity support varies. Search for public documentation, or look at the app manifest for clues.

When including a file URI either as data URI or "android.intent.extra.STREAM" extra, ensure to enable the appropriate Grant flags otherwise it may be inaccessible to the app.

Note! If this block cause a SecurityException failure is likely because the activity isn’t exported, it’s been temporarily or permanently disabled, or it’s secured by a permission to prevent third-party apps from launching it.

Common extras

Key	Conversion type	Description
`"android.intent.extra.HTML_TEXT"`	`String`	A HTML alternative to `"android.intent.extra.TEXT"`
`"android.intent.extra.REFERRER"`	`Uri`	HTTP or package referrer
`"android.intent.extra.STREAM"`	`Uri`	Data stream
`"android.intent.extra.SUBJECT"`	`String`	Subject of a message
`"android.intent.extra.TEXT"`	`CharSequence`	A generic text
`"android.intent.extra.TITLE"`	`CharSequence`	A generic title
`"query"`	`String`	A search query

Launch options

Key	Conversion type	Description
`"android:activity.animType"`	`Int`	Value as `7` will launch activity (behind) without presenting it to user, only accessible through “recents” screen (Android 4.4+)
`"android:activity.launchBounds"`	`Rect`	The `[top,left,right,bottom]` bounds (window size) that the activity should be launched in (Android 7+)
`"android.activity.launchDisplayId"`	`Int`	Display id the activity should be launched into (Android 8+)
`"android:activity.lockTaskMode"`	`Boolean`	Whether the activity should be launched into “LockTask” mode (Android 9+)

Input arguments

Package — package name of the app activity.
Activity class — class name of the app activity.
Action — action the activity should perform.
Data URI — URI for the activity to handle.
MIME type — MIME type of data the Data URI is referring.
Category — action category, use an array for multiple categories.
Extras — dictionary with extended data, inconvertible entries lacking a conversion type may be excluded.
Flags — launch flags.
Launch options — dictionary with activity launch options. (Android 4.1+)
Timeout — time until the notification/dialog is automatically canceled, default is no timeout.
Notification channel — UUID of notification channel used for shown notification, default is the flow default or Flow.
Show window — whether to show the dialog window directly without having to tap the notification. Requires the “appear atop of other apps or parts of the screen” privilege on Android 10+.

Output variables

Result URI — variable to assign the resulting URI.
Result extras — variable to assign a dictionary with extended result data, inconvertible entries may be excluded.