CulebraTester2-public

CulebraTester: Snaky Android Testing

Welcome to CulebraTester2.

Android testing can be complicated, time-consuming, and tedious. What if it didn’t have to be?

CulebraTester2 provides an API that facilitates the creation of test automation tools and UI's. Not sure what we mean?

Continue reading and see how you can run this early preview.

⚠️ Warning
This is an alpha version of CulebraTester2 expect changes

How to run CulebraTester2 ?

1. Have your device or emulator connected to adb
2. Install APKs
   1. Build and install
      1. Copy local.properties.SAMPLE to local.properties and adapt the values to your environment
      2. ./culebratester2 install (or run ./gradlew installDebug installDebugAndroidTest)
   2. or downalod prebuilt app and instrumentation APKs from Github Actions
3. Start server ./culebratester2 start-server
4. Open http://localhost:9987/ with a browser or curl
5. You should see CulebraTester2: Go to http://localhost:<port>/help for usage details.
6. If the previous request worked, you can try something more ambitious as http://localhost:9987/v2/uiDevice/screenshot
7. Take a look at CulebraTester2 API or its spec openapi.yaml for more info
8. When done testing, http://localhost:9987/quit will terminate the server

AndroidViewClient

CulebraTester2 is a new backend for AndroidViewClient/culebra.

culebra

CulebraTester2 is a new implementation in Kotlin of culebra.

A python client implementation can be found at CulebraTester2-client.

This previous version API specification can be found at here.

Example

The script simple-calculator-test shows a rudimentary usage of this API by

• starting Calculator activity
• finding one of the digit Buttons, can be specified or a random one is slected
• clicking on that Button

UI

We mentioned CulebraTester2 provides an API that facilitates the creation of test automation tools and UI's.

Here we are, this is in the making.

Communication

Found issues? Use https://github.com/dtmilano/CulebraTester2-public/issues

Have questions? Use https://stackoverflow.com/questions/tagged/androidviewclient.