Testerra Appium Connector

Setup • Documentation • Support • Contribute • Contributors • Licensing

About this module

This module provides additional features for Testerra Framework for automated tests.

Appium connector uses the open source standard Appium to run web and app tests based on Testerra on mobile devices.

This connector fully supports the Mobile Device Cloud of Deutsche Telekom MMS GmbH to run automated tests on real mobile devices. More information can be found here: https://mobiledevice.cloud/.

Setup

Requirements

Appium connector	Testerra	Notes
>= 1.1	>= 1.3
2.0 - 2.2	2.0 - 2.3
2.3	2.4	Supports Appium Client 8.5.1/8.6.0
>= 2.4	>= 2.6	Supports Appium Client 9.x

Important notes:

• Please check the matrix at https://github.com/appium/java-client?tab=readme-ov-file#compatibility-matrix if Appium Java Client matches to Selenium version
• Please check the Testerra releaes at https://github.com/telekom/testerra/releases which Selenium vesion is used

Usage

Include the following dependency in your project.

Gradle:

// Version from this module
implementation 'io.testerra:appium:2.5'
// Used Testerra version
implementation 'io.testerra:driver-ui:2.10'
implementation 'io.testerra:report-ng:2.10'
implementation 'io.appium:java-client:9.2.3'

Maven:

<!-- Version from this module -->
<dependency>
    <groupId>io.testerra</groupId>
    <artifactId>appium</artifactId>
    <version>2.5</version>
</dependency>
<!-- Used Testerra version -->
<dependency>
    <groupId>io.testerra</groupId>
    <artifactId>driver-ui</artifactId>
    <version>2.10</version>
</dependency>
<dependency>
    <groupId>io.testerra</groupId>
    <artifactId>report-ng</artifactId>
    <version>2.10</version>
</dependency>
<dependency>
    <groupId>io.appium</groupId>
    <artifactId>java-client</artifactId>
    <version>9.2.3</version>
    <!-- Needed for correct Testerra logging -->
    <exclusions>
        <exclusion>
            <groupId>org.slf4j</groupId>
            <artifactId>slf4j-api</artifactId>
        </exclusion>
    </exclusions>
</dependency>

Documentation

Please have a look to the Wiki pages.

Publication

Testerra Appium connector is deployed and published to Maven Central. All JAR files are signed via Gradle signing plugin.

For the signing and publishing the following environment variables have to be set:

Property	Description
ORG_GRADLE_PROJECT_signingKeyId	GPG private key ID (short form)
ORG_GRADLE_PROJECT_signingPassword	GPG private key password
ORG_GRADLE_PROJECT_signingKey	GPG private key in ASCII-armored format
MAVEN_CENTRAL_PORTAL_USERNAME	Maven Central publishing user
MAVEN_CENTRAL_PORTAL_PASSWORD	Maven Central publishing token

Publish snapshots

Publishing snapshots the default maven-publish plugin is used:

gradle publish

Publish release

Publishing releases the org.danilopianini.publish-on-central plugin is used:

gradle buildReport publishMavenJavaPublicationToProjectLocalRepository zipMavenCentralPortalPublication releaseMavenCentralPortalPublication -DttVersion=2.1 

Code of Conduct

This project has adopted the Contributor Covenant in version 2.0 as our code of conduct. Please see the details in our CODE_OF_CONDUCT.md. All contributors must abide by the code of conduct.

Working Language

We decided to apply English as the primary project language.

Consequently, all content will be made available primarily in English. We also ask all interested people to use English as language to create issues, in their code (comments, documentation etc.) and when you send requests to us. The application itself and all end-user faing content will be made available in other languages as needed.

Support and Feedback

The following channels are available for discussions, feedback, and support requests:

Type	Channel
Issues
Other Requests

How to Contribute

Contribution and feedback is encouraged and always welcome. For more information about how to contribute, the project structure, as well as additional contribution information, see our Contribution Guidelines. By participating in this project, you agree to abide by its Code of Conduct at all times.

Contributors

At the same time our commitment to open source means that we are enabling -in fact encouraging- all interested parties to contribute and become part of its developer community.

Licensing

Copyright (c) 2021 Deutsche Telekom AG.

Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License.

You may obtain a copy of the License at https://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.