Skip to content

Latest commit

 

History

History
40 lines (22 loc) · 6 KB

activity-startup.md

File metadata and controls

40 lines (22 loc) · 6 KB
Raw

How To Troubleshoot Activities Startup

Capabilities

The Activity class is a crucial component of an Android app, and the way activities are launched and put together is a fundamental part of the platform's application model. Unlike programming paradigms in which apps are launched with a main() method, the Android system initiates code in an Activity instance by invoking specific callback methods that correspond to specific stages of its lifecycle. © Android Developer Documentation

Espresso driver needs to know package and activity names in order to properly initialize the application under test. This information is expected to be provided in driver capabilities and consists of the following keys:

  • appActivity: The name of the main application activity
  • appPackage: The identifier of the application package
  • appWaitActivity: The name of the application activity to wait for/which starts the first
  • appWaitPackage: The id of the application package to wait for/which starts the first
  • appWaitDuration: The maximum duration to wait until the appWaitActivity is focused in milliseconds (20000 by default)
  • appWaitForLaunch: Whether to wait until Activity Manager returns the control to the calling process. By default the driver always waits until appWaitDuration is expired. Setting this capability to false effectively cancels this wait and unblocks the server loop as soon as am successfully triggers the command to start the activity.

All these capabilities are optional. If they are not set explicitly then Espresso driver tries to auto detect them by reading their values from the APK manifest. Although, if the application under test is supposed to be already installed on the device (noReset=true) then at least appActivity and appPackage options are required to be set, since no package manifest is available in such case. If you don't set appWaitPackage and appWaitActivity explicitly then these are getting assigned to appPackage/appActivity values automatically. For more details check on the implementation of packageAndLaunchActivityFromManifest method in the appium-adb package.

How Espresso Starts Activities

Activities are started by Android Instrumentation. Espresso tries to start the appPackage/appActivity combination, and then waits until the appWaitPackage/appWaitActivity is focused or the appWaitDuration timeout expires. The currently focused activity name is parsed from adb shell dumpsys window windows command output (mFocusedApp or mCurrentFocus entries). For more details check on the implementation of getFocusedPackageAndActivity method in the appium-adb package and startActivity helper.

Possible Problems And Solutions

java.lang.SecurityException: Permission Denial: starting Intent

The full error description usually looks like 'java.lang.SecurityException: Permission Denial: starting Intent { act=android.intent.action.MAIN cat=[android.intent.category.LAUNCHER] flg=0x10200000 cmp=com.mypackage/.myactivity.MainActivity launchParam=MultiScreenLaunchParams { mDisplayId=0 mBaseDisplayId=0 mFlags=0 } } from null (pid=11366, uid=2000) not exported from uid 10191. Such error might be the indication of the fact that the combination of application package and activity name, which has been passed to Espresso as appPackage/appActivity (or auto detected implicitly), is not the correct one to start the application under test. As a solution, it is necessary to check the correct values with the application developer and test them manually first by executing: adb shell am start -W -n com.myfixedpackage/.myfixedactivity.MainActivity -S -a android.intent.action.MAIN -c android.intent.category.LAUNCHER -f 0x10200000. If this commands succeeds manually and starts the necessary application on the device then it will work for Espresso driver as well.

com.myactivity or com.myapp.com.myactivity never started

This exception usually indicates, that the first application activity is not the same package/activity, as it is set (or auto detected) by appWaitPackage/appWaitActivity. Such error normally happens in applications having multiple activities. In order to resolve the problem one should check with application developer regarding which activity/package is the very first one that appears on application startup. The currently focused activity name might be verified using the adb shell dumpsys window windows command mentioned above. Also, Espresso driver allows to use wildcards while setting appWaitActivity value. This might be particularly useful if the activity name is generated dynamically or it is not the same all the time. For example com.mycomany.* will match any of com.mycomany.foo, com.mycomany.bar.

Command '…' timed out after X ms

If you've double checked that activity names are correct, but the startup still times out, then try to increase the value of appWaitDuration capability. Normally, the default 20 seconds is enough for the most of applications, however, some bigger apps might require more time to start and show the first activity. Please, don't create such apps.

There might be also situations where an activity does not return the control to the calling process at all, so am start call blocks forever independently of the value of appWaitDuration, thus causing the timeout. In such case setting appWaitForLaunch to false might help to resolve the issue. Although, by choosing this option, the driver cannot make sure the activity has fully started, so then it is up to the client code to verify the initial UI state is the one that is expected.