The runIntent action launches an Android intent that facilitates late runtime binding between the code in different applications. Use these intents to accomplish actions on your Android devices.

The most significant use of runIntent is the launching of activities, where it can be thought of as the glue between activities. It is basically a passive data structure holding an abstract description of an action to be performed. The runIntent action supports both explicit and implicit intents.

Depending on the arguments used, the AirWatch Agent will use either of the following to launch the specified intent:

  • android.content.Context.startActivity( Intent intent)
  • android.content.Context.sendBroadcast( Intent intent) to launch the specified intent.

RunIntent Syntax

The argument syntax changes depending on whether explicit or implicit mode is specified:

mode=explicit,  broadcast=[true|false] ,  action=< action>, package=<package>, class=<class>
                  [, data=<data>][, extraString=<stringname>=<string value>[,...]][, extraInt=<int name>=<int
                  value>[,…]]
                  
                  
                  
               
mode=implicit, broadcast=[true|false] ,  action=<action> [,category=<category>][,
                  uri=<uri>] [, data=<data>] [, extraString=<string name>=<string value>[,...]][, extraInt=<int
                  name>=<int value>[,…]]
                  
                  
                  
               

Arguments

Argument Explanation

mode=[explicit|implicit]

Specifies whether the intent to be launched is explicit or implicit.

broadcast=[true|false]

Specifies whether the intent to be launched using startActivity() or sendBroadcast().

action=<action>

Specifies the Android action string for the intent. An example of an Android action string is android.intent.action.MAIN.

package=<package >

Specifies the Android package name of the java class to be explicitly launched. Android package names are generally of the format com.mycompany.myapplication.

class=<class>

Specifies the java class in the specified package that is to be explicitly launched.

uri=<uri>

Specifies the URI that is to be passed with the implicitly launched intent.

category =<category >

Specifies the Android category string that is to be passed with the implicitly launched intent. An example of an Android category string is android.intent.category.DEFAULT

data=<data>

Specifies the value of the Android data parameter that is to be passed with the explicitly or implicitly launched intent.

extraString=<string name>=<string value>

Specifies the name of an extra string parameter that is to be passed with the explicitly or implicitly launched intent. string value specifies the value of the extra string. The extraString argument can be used multiple times to specify additional extra string name/values.

extraInt=<int name>=<int value>

Specifies the name of an extra int parameter that is to be passed with the explicitly or implicitly launched intent. int value specifies the value of the extra int. The extraInt argument can be used multiple times to specify additional extra int name/values.

 

The following table indicates which arguments are required, optional, or not applicable for the explicit and implicit modes:

mode

explicit

implicit

broadcast

required

required

action

required

required

package

required

n/a

class

required

n/a

uri

n/a

optional

category

n/a

optional

data

optional

optional

extraString

optional

optional

extraInt

optional

optional

Example RunIntent

mode=explicit,broadcast=false,action=android.intent.action.MAIN,package=com.examples.myappl,class=com.examples.myappl.MainActivity