appium-espresso-driver 1.46.0

package/espresso-server/app/src/androidTest/java/io/appium/espressoserver/lib/handlers/PressKeyCode.kt

@@ -0,0 +1,90 @@
+/*
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * See the NOTICE file distributed with this work for additional
+ * information regarding copyright ownership.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+package io.appium.espressoserver.lib.handlers
+
+import android.os.SystemClock
+import android.view.KeyCharacterMap
+import android.view.KeyEvent
+import android.view.ViewConfiguration
+
+import androidx.test.espresso.InjectEventSecurityException
+import androidx.test.espresso.UiController
+import io.appium.espressoserver.lib.handlers.exceptions.AppiumException
+import io.appium.espressoserver.lib.handlers.exceptions.InvalidArgumentException
+import io.appium.espressoserver.lib.model.KeyEventParams
+import io.appium.espressoserver.lib.viewaction.UiControllerPerformer
+import io.appium.espressoserver.lib.viewaction.UiControllerRunnable
+
+class PressKeyCode(private val isLongPress: Boolean) : RequestHandler<KeyEventParams, Void?> {
+
+    private val LONG_PRESS_TIMEOUT = ViewConfiguration.getLongPressTimeout()
+
+    @Throws(AppiumException::class)
+    override fun handleInternal(params: KeyEventParams): Void? {
+        val runnable = object : UiControllerRunnable<Void?> {
+            override fun run(uiController: UiController): Void? {
+                val keyCode = params.keycode
+                val metaState = params.metastate
+                val flags = params.flags
+                val downTime = SystemClock.uptimeMillis()
+
+                try {
+                    var isSuccessful = uiController.injectKeyEvent(
+                            KeyEvent(
+                                    downTime,
+                                    downTime,
+                                    KeyEvent.ACTION_DOWN,
+                                    keyCode,
+                                    0,
+                                    metaState,
+                                    KeyCharacterMap.VIRTUAL_KEYBOARD,
+                                    0,
+                                    flags
+                            )
+                    )
+
+                    if (isLongPress) {
+                        // https://developer.android.com/reference/android/view/KeyEvent#FLAG_LONG_PRESS
+                        // The FLAG_LONG_PRESS flag is set after the first key repeat that occurs after the long press timeout
+                        isSuccessful = isSuccessful and uiController.injectKeyEvent(
+                                KeyEvent(downTime, SystemClock.uptimeMillis() + LONG_PRESS_TIMEOUT,
+                                        KeyEvent.ACTION_DOWN, keyCode, 1, metaState, KeyCharacterMap.VIRTUAL_KEYBOARD,
+                                        0, flags or KeyEvent.FLAG_LONG_PRESS))
+                    }
+
+
+                    isSuccessful = isSuccessful and uiController.injectKeyEvent(KeyEvent(downTime,
+                            SystemClock.uptimeMillis() + if (isLongPress) LONG_PRESS_TIMEOUT else 0,
+                            KeyEvent.ACTION_UP, keyCode, 0, metaState, KeyCharacterMap.VIRTUAL_KEYBOARD,
+                            0, flags))
+
+                    if (!isSuccessful) {
+                        throw InvalidArgumentException(String.format(
+                                "Cannot generate long key press event for key code %s", keyCode))
+                    }
+                } catch (ie: InjectEventSecurityException) {
+                    throw AppiumException(String.format("Could not inject key code %s. Reason: %s", keyCode, ie.cause))
+                }
+
+                return null
+            }
+        }
+
+        UiControllerPerformer(runnable).run()
+        return null
+    }
+}

package/espresso-server/app/src/androidTest/java/io/appium/espressoserver/lib/handlers/RegisterIdlingResources.kt

@@ -0,0 +1,33 @@
+/*
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * See the NOTICE file distributed with this work for additional
+ * information regarding copyright ownership.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+package io.appium.espressoserver.lib.handlers
+
+import androidx.test.espresso.IdlingRegistry
+import io.appium.espressoserver.lib.model.*
+
+class RegisterIdlingResources : RequestHandler<IdlingResourcesParams, Void?> {
+
+    override fun handleInternal(params: IdlingResourcesParams): Void? {
+        val instances = params.toIdlingResources()
+        if (!IdlingRegistry.getInstance().register(*instances.toTypedArray())) {
+            throw IllegalStateException(
+                    "Cannot register the given idling resource classes: ${params.classNames}")
+        }
+        return null
+    }
+
+}

package/espresso-server/app/src/androidTest/java/io/appium/espressoserver/lib/handlers/ReleaseActions.kt

@@ -0,0 +1,41 @@
+/*
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * See the NOTICE file distributed with this work for additional
+ * information regarding copyright ownership.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+package io.appium.espressoserver.lib.handlers
+
+import androidx.test.espresso.UiController
+import io.appium.espressoserver.lib.handlers.exceptions.AppiumException
+import io.appium.espressoserver.lib.helpers.w3c.models.Actions
+import io.appium.espressoserver.lib.model.AppiumParams
+import io.appium.espressoserver.lib.viewaction.UiControllerPerformer
+import io.appium.espressoserver.lib.viewaction.UiControllerRunnable
+
+class ReleaseActions : RequestHandler<AppiumParams, Void?> {
+
+    @Throws(AppiumException::class)
+    override fun handleInternal(params: AppiumParams): Void? {
+
+        val runnable = object : UiControllerRunnable<Void?> {
+            override fun run(uiController: UiController): Void? {
+                Actions().release(params.sessionId!!)
+                return null
+            }
+        }
+
+        UiControllerPerformer(runnable).run()
+        return null
+    }
+}

package/espresso-server/app/src/androidTest/java/io/appium/espressoserver/lib/handlers/RequestHandler.kt

@@ -0,0 +1,43 @@
+/*
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * See the NOTICE file distributed with this work for additional
+ * information regarding copyright ownership.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+package io.appium.espressoserver.lib.handlers
+
+import io.appium.espressoserver.lib.handlers.exceptions.AppiumException
+import io.appium.espressoserver.lib.handlers.exceptions.NoSuchDriverException
+import io.appium.espressoserver.lib.helpers.AndroidLogger
+import io.appium.espressoserver.lib.model.AppiumParams
+import io.appium.espressoserver.lib.model.GlobalSession
+
+interface RequestHandler<in T : AppiumParams, out R> {
+    @Throws(AppiumException::class)
+    fun handleInternal(params: T): R
+
+    @Suppress("UNCHECKED_CAST")
+    @Throws(AppiumException::class)
+    fun handle(params: AppiumParams): R {
+        AndroidLogger.info("Executing ${this::class.simpleName} handler")
+
+        if (this !is NoSessionCommandHandler
+            && (params.sessionId == null || params.sessionId != GlobalSession.sessionId)) {
+            throw NoSuchDriverException("The requested session id ${params.sessionId} does not exist")
+        }
+
+        return handleInternal(params as? T
+                ?: throw IllegalArgumentException("Invalid type ${params::class.simpleName} " +
+                        "passed to ${this::class.simpleName} handler"))
+    }
+}

package/espresso-server/app/src/androidTest/java/io/appium/espressoserver/lib/handlers/ScreenshotHandler.kt

@@ -0,0 +1,29 @@
+/*
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * See the NOTICE file distributed with this work for additional
+ * information regarding copyright ownership.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+package io.appium.espressoserver.lib.handlers
+
+import io.appium.espressoserver.lib.handlers.exceptions.AppiumException
+import io.appium.espressoserver.lib.helpers.ScreenshotsHelper
+import io.appium.espressoserver.lib.model.AppiumParams
+
+class ScreenshotHandler : RequestHandler<AppiumParams, String> {
+
+    @Throws(AppiumException::class)
+    override fun handleInternal(params: AppiumParams): String {
+        return ScreenshotsHelper().screenshot
+    }
+}

package/espresso-server/app/src/androidTest/java/io/appium/espressoserver/lib/handlers/ScrollToPage.kt

@@ -0,0 +1,60 @@
+/*
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * See the NOTICE file distributed with this work for additional
+ * information regarding copyright ownership.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+package io.appium.espressoserver.lib.handlers
+
+import androidx.test.espresso.EspressoException
+import androidx.test.espresso.contrib.ViewPagerActions
+import io.appium.espressoserver.lib.handlers.exceptions.AppiumException
+import io.appium.espressoserver.lib.handlers.exceptions.InvalidArgumentException
+import io.appium.espressoserver.lib.model.EspressoElement
+import io.appium.espressoserver.lib.model.ScrollToPageParams
+import io.appium.espressoserver.lib.model.ScrollToPageParams.ScrollTo.*
+
+class ScrollToPage : RequestHandler<ScrollToPageParams, Void?> {
+
+    @Throws(AppiumException::class)
+    override fun handleInternal(params: ScrollToPageParams): Void? {
+        val viewInteraction = EspressoElement.getViewInteractionById(params.elementId)
+        try {
+            val smoothScroll = params.smoothScroll
+            params.scrollTo?.let {
+                val scrollAction = when (it) {
+                    FIRST -> ViewPagerActions.scrollToFirst(smoothScroll)
+                    LAST -> ViewPagerActions.scrollToLast(smoothScroll)
+                    LEFT -> ViewPagerActions.scrollLeft(smoothScroll)
+                    RIGHT -> ViewPagerActions.scrollRight(smoothScroll)
+                }
+                viewInteraction.perform(scrollAction)
+                return null
+            }
+
+            params.scrollToPage?.let {
+                viewInteraction.perform(ViewPagerActions.scrollToPage(it, smoothScroll))
+                return null
+            }
+
+            throw InvalidArgumentException("Could not complete scrollToPage action. Must provide either 'scrollTo' or 'scrollToPage'")
+        } catch (e: ClassCastException) {
+            throw AppiumException("Could not perform scroll to on element ${params.elementId}. Reason: ${e}")
+        } catch (e: Exception) {
+            if (e is EspressoException) {
+                throw AppiumException("Could not scroll to page. Reason: ${e}", e)
+            }
+            throw e
+        }
+    }
+}

package/espresso-server/app/src/androidTest/java/io/appium/espressoserver/lib/handlers/SetClipboard.kt

@@ -0,0 +1,64 @@
+/*
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * See the NOTICE file distributed with this work for additional
+ * information regarding copyright ownership.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+package io.appium.espressoserver.lib.handlers
+
+import android.util.Base64
+
+import java.nio.charset.StandardCharsets
+
+import io.appium.espressoserver.lib.handlers.exceptions.AppiumException
+import io.appium.espressoserver.lib.handlers.exceptions.InvalidArgumentException
+import io.appium.espressoserver.lib.helpers.ClipboardHelper
+import io.appium.espressoserver.lib.model.ClipboardDataType
+import io.appium.espressoserver.lib.model.SetClipboardParams
+
+import androidx.test.platform.app.InstrumentationRegistry.getInstrumentation
+
+class SetClipboard : RequestHandler<SetClipboardParams, Void?> {
+    private val mInstrumentation = getInstrumentation()
+
+    @Throws(AppiumException::class)
+    override fun handleInternal(params: SetClipboardParams): Void? {
+        params.content ?: throw InvalidArgumentException("The 'content' argument is mandatory")
+        try {
+            mInstrumentation.runOnMainSync(SetClipboardRunnable(
+                    params.contentType, params.label, fromBase64String(params.content)))
+        } catch (e: IllegalArgumentException) {
+            throw InvalidArgumentException(e)
+        }
+
+        return null
+    }
+
+    private fun fromBase64String(s: String?): String {
+        return String(Base64.decode(s, Base64.DEFAULT), StandardCharsets.UTF_8)
+    }
+
+    // Clip feature should run with main thread
+    private inner class SetClipboardRunnable constructor(
+            private val contentType: ClipboardDataType,
+            private val label: String?,
+            private val content: String
+    ) : Runnable {
+
+        override fun run() {
+            when (contentType) {
+                ClipboardDataType.PLAINTEXT -> ClipboardHelper(mInstrumentation.targetContext).setTextData(label, content)
+            }
+        }
+    }
+}

package/espresso-server/app/src/androidTest/java/io/appium/espressoserver/lib/handlers/SetDate.kt

@@ -0,0 +1,41 @@
+/*
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * See the NOTICE file distributed with this work for additional
+ * information regarding copyright ownership.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+package io.appium.espressoserver.lib.handlers
+
+import androidx.test.espresso.EspressoException
+import androidx.test.espresso.contrib.PickerActions
+import io.appium.espressoserver.lib.handlers.exceptions.AppiumException
+import io.appium.espressoserver.lib.model.EspressoElement
+import io.appium.espressoserver.lib.model.SetDateParams
+
+class SetDate : RequestHandler<SetDateParams, Void?> {
+
+    @Throws(AppiumException::class)
+    override fun handleInternal(params: SetDateParams): Void? {
+        val viewInteraction = EspressoElement.getViewInteractionById(params.elementId)
+        try {
+            viewInteraction.perform(PickerActions.setDate(params.year, params.monthOfYear, params.dayOfMonth))
+        } catch (e: Exception) {
+            if (e is EspressoException) {
+                throw AppiumException("Could not set date on element. Reason: $e")
+            }
+            throw e
+        }
+
+        return null
+    }
+}

package/espresso-server/app/src/androidTest/java/io/appium/espressoserver/lib/handlers/SetOrientation.kt

@@ -0,0 +1,61 @@
+/*
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * See the NOTICE file distributed with this work for additional
+ * information regarding copyright ownership.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+package io.appium.espressoserver.lib.handlers
+
+import io.appium.espressoserver.lib.handlers.exceptions.AppiumException
+import io.appium.espressoserver.lib.model.EspressoElement
+import io.appium.espressoserver.lib.model.OrientationParams
+
+import androidx.test.espresso.Espresso.onView
+import androidx.test.espresso.matcher.ViewMatchers.isRoot
+import io.appium.espressoserver.lib.model.OrientationType
+import io.appium.espressoserver.lib.viewaction.orientationLandscape
+import io.appium.espressoserver.lib.viewaction.orientationPortrait
+
+class SetOrientation : RequestHandler<OrientationParams, Void?> {
+
+    @Throws(AppiumException::class)
+    override fun handleInternal(params: OrientationParams): Void? {
+        val orientation = params.orientation
+
+        // Validate the orientation
+        orientation ?: throw AppiumException("Screen orientation value must not be null")
+
+        val supportedValues = OrientationType.values().map { it.name }
+        if (!supportedValues.contains(orientation.toUpperCase())) {
+            throw AppiumException("Screen orientation must be one of $supportedValues. Found '$orientation'")
+        }
+
+        // Get the view interaction for the element or for the root, if no element provided
+        val viewInteraction = params.elementId?.let {elementId ->
+            EspressoElement.getViewInteractionById(elementId)
+        } ?: run {
+            onView(isRoot())
+        }
+
+        try {
+            if (orientation.equals(OrientationType.LANDSCAPE.name, ignoreCase = true)) {
+                viewInteraction.perform(orientationLandscape())
+            } else {
+                viewInteraction.perform(orientationPortrait())
+            }
+            return null
+        } catch (e: Exception) {
+            throw AppiumException("Cannot change screen orientation to '$orientation'", e)
+        }
+    }
+}

package/espresso-server/app/src/androidTest/java/io/appium/espressoserver/lib/handlers/SetRotation.kt

@@ -0,0 +1,46 @@
+/*
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * See the NOTICE file distributed with this work for additional
+ * information regarding copyright ownership.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+package io.appium.espressoserver.lib.handlers
+
+import android.os.SystemClock
+import io.appium.espressoserver.lib.handlers.exceptions.AppiumException
+import io.appium.espressoserver.lib.handlers.exceptions.InvalidElementStateException
+import io.appium.espressoserver.lib.helpers.InteractionHelper
+import io.appium.espressoserver.lib.helpers.InteractionHelper.getUiAutomation
+import io.appium.espressoserver.lib.model.RotationParams
+import java.time.Duration
+
+val ROTATION_CHANGE_TIMEOUT: Duration = Duration.ofSeconds(5)
+
+class SetRotation : RequestHandler<RotationParams, Void?> {
+
+    @Throws(AppiumException::class)
+    override fun handleInternal(params: RotationParams): Void? {
+        val desiredRotation = params.validate().z!! / 90
+        if (getUiAutomation().setRotation(desiredRotation)) {
+            val start = SystemClock.currentThreadTimeMillis()
+            do {
+                if (InteractionHelper.getUiDevice().displayRotation == desiredRotation) {
+                    return null
+                }
+                SystemClock.sleep(100)
+            } while (SystemClock.currentThreadTimeMillis() - start < ROTATION_CHANGE_TIMEOUT.toMillis())
+        }
+        throw InvalidElementStateException(
+                "The display rotation cannot be changed to ${params.z} degrees after $ROTATION_CHANGE_TIMEOUT")
+    }
+}

package/espresso-server/app/src/androidTest/java/io/appium/espressoserver/lib/handlers/SetTime.kt

@@ -0,0 +1,41 @@
+/*
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * See the NOTICE file distributed with this work for additional
+ * information regarding copyright ownership.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+package io.appium.espressoserver.lib.handlers
+
+import androidx.test.espresso.EspressoException
+import androidx.test.espresso.contrib.PickerActions
+import io.appium.espressoserver.lib.handlers.exceptions.AppiumException
+import io.appium.espressoserver.lib.model.EspressoElement
+import io.appium.espressoserver.lib.model.SetTimeParams
+
+class SetTime : RequestHandler<SetTimeParams, Void?> {
+
+    @Throws(AppiumException::class)
+    override fun handleInternal(params: SetTimeParams): Void? {
+        val viewInteraction = EspressoElement.getViewInteractionById(params.elementId)
+        try {
+            viewInteraction.perform(PickerActions.setTime(params.hours, params.minutes))
+        } catch (e: Exception) {
+            if (e is EspressoException) {
+                throw AppiumException("Could not set time on element. Reason: $e")
+            }
+            throw e
+        }
+
+        return null
+    }
+}

package/espresso-server/app/src/androidTest/java/io/appium/espressoserver/lib/handlers/Source.kt

@@ -0,0 +1,29 @@
+/*
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * See the NOTICE file distributed with this work for additional
+ * information regarding copyright ownership.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+package io.appium.espressoserver.lib.handlers
+
+import io.appium.espressoserver.lib.handlers.exceptions.AppiumException
+import io.appium.espressoserver.lib.model.AppiumParams
+import io.appium.espressoserver.lib.model.SourceDocument
+
+class Source : RequestHandler<AppiumParams, String> {
+
+    @Throws(AppiumException::class)
+    override fun handleInternal(params: AppiumParams): String {
+        return SourceDocument().toXMLString()
+    }
+}

package/espresso-server/app/src/androidTest/java/io/appium/espressoserver/lib/handlers/StartActivity.kt

@@ -0,0 +1,30 @@
+/*
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * See the NOTICE file distributed with this work for additional
+ * information regarding copyright ownership.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+package io.appium.espressoserver.lib.handlers
+
+import io.appium.espressoserver.lib.handlers.exceptions.AppiumException
+import io.appium.espressoserver.lib.model.StartActivityParams
+import io.appium.espressoserver.lib.helpers.ActivityHelpers.startActivity
+
+class StartActivity : RequestHandler<StartActivityParams, Void?> {
+
+    @Throws(AppiumException::class)
+    override fun handleInternal(params: StartActivityParams): Void? {
+        startActivity(params)
+        return null
+    }
+}

package/espresso-server/app/src/androidTest/java/io/appium/espressoserver/lib/handlers/StartService.kt

@@ -0,0 +1,40 @@
+/*
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * See the NOTICE file distributed with this work for additional
+ * information regarding copyright ownership.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+package io.appium.espressoserver.lib.handlers
+
+import android.content.Intent
+import androidx.test.platform.app.InstrumentationRegistry
+import io.appium.espressoserver.lib.helpers.extractQualifiedClassName
+import io.appium.espressoserver.lib.model.StartServiceParams
+
+class StartService : RequestHandler<StartServiceParams, String> {
+
+    override fun handleInternal(params: StartServiceParams): String {
+        val targetContext = InstrumentationRegistry.getInstrumentation().targetContext
+        val intent = Intent(targetContext,
+                Class.forName(extractQualifiedClassName(targetContext.packageName, params.intent)))
+        val componentName = if (params.foreground == true) {
+            targetContext.startForegroundService(intent)
+        } else {
+            targetContext.startService(intent)
+        }
+        componentName ?: throw IllegalStateException("The '${params.intent}' service cannot be started " +
+                "or is unknown. Does the service belong to ${targetContext.packageName} app?")
+
+        return "${componentName.packageName}/${componentName.className}"
+    }
+}