feat: Add mobile: startActivity extension (#803)

README.md

@@ -730,6 +730,19 @@ Name | Type | Required | Description | Example
 --- | --- | --- | --- | ---
 remotePath | string | yes | The full path to the remote file or a file inside an application bundle | `/sdcard/myfile.txt` or `@my.app.id/path/in/bundle`
 
+### mobile: startActivity
+
+Starts the given activity with intent options, activity options and locale. Activity could only be executed in scope of the current app package.
+
+#### Arguments
+
+Name | Type | Required | Description | Example
+--- | --- | --- | --- | ---
+appActivity | string | yes | Applicaiton acitivity identifier to start | `com.myapp.myacitivty`
+locale | object | no | Sets the locale for the app under test. It only uses public APIs for its purpose. See https://github.com/libyal/libfwnt/wiki/Language-Code-identifiers to get the list of available language abbreviations. | `{"language": "zh", "country": "CN", "variant": "Hans"}`
+optionalIntentArguments | object | no | The mapping of custom options for the intent that is going to be passed to the main app activity. Check [Intent Options](#intent-options) for more details. | `{ 'flags': 'ACTIVITY_NEW_TASK', 'action': '<intent_action>', 'className': '<fullyQualifiedAppActivity>', 'es': {'foo': 'bar'} }`
+optionalActivityArguments | object | no | The mapping of custom options for the main app activity that is going to be started. Check [Activity Options](#activity-options) for more details. | `{ 'launchDisplayId': 1 }`
+
 ### mobile: startService
 
 Starts the given service intent.

lib/commands/execute.js

@@ -54,6 +54,8 @@ extensions.executeMobile = async function executeMobile (mobileCommand, opts = {
 
     deleteFile: 'mobileDeleteFile',
 
+    startActivity: 'mobileStartActivity',
+
     startService: 'mobileStartService',
     stopService: 'mobileStopService',
 

lib/commands/general.js

@@ -296,6 +296,31 @@ helpers.suspendChromedriverProxy = function suspendChromedriverProxy () {
   this.jwpProxyActive = true;
 };
 
+/**
+ *  Starts the given activity with intent options, activity options and locale.
+ *  Activity could only be executed in scope of the current app package.
+ *
+ *  appActivity is mandatory
+ *
+ *  locale, optionalIntentArguments, optionalActivityArguments are optional
+ */
+commands.mobileStartActivity = async function mobileStartActivity (opts = {}) {
+  const appPackage = this.caps.appPackage;
+  const {
+    appActivity,
+    locale,
+    optionalIntentArguments,
+    optionalActivityArguments
+  } = assertRequiredOptions(opts, ['appActivity']);
+  return await this.espresso.jwproxy.command(`/appium/device/start_activity`, 'POST', {
+    appPackage,
+    appActivity,
+    locale,
+    optionalIntentArguments,
+    optionalActivityArguments
+  });
+};
+
 commands.startActivity = async function startActivity (appPackage, appActivity,
   appWaitPackage, appWaitActivity) {
   // intentAction, intentCategory, intentFlags, optionalIntentArguments, dontStopAppOnReset