aws-device-farm-sample-app-for-android
A sample native Android app with comprehensive UI components and example tests for AWS Device Farm.
What is aws-device-farm-sample-app-for-android?
AWS Device Farm Sample App for Android is a reference Android application that demonstrates a wide range of native UI components and interactions. It serves as a practical educational tool for developers learning to write automated tests for AWS Device Farm, providing concrete examples for common testing scenarios across multiple frameworks.
Android developers and QA engineers who are learning to write automated tests for AWS Device Farm, specifically those using Appium, Calabash, or Espresso testing frameworks.
Developers choose this project because it offers comprehensive, hands-on examples of testing real-world Android components and native features, with parallel implementations across multiple testing frameworks to accelerate learning and test development.
Overview
AWS Device Farm sample Android app
Use Cases
Best For
- Learning how to write automated tests for AWS Device Farm using Appium, Calabash, or Espresso.
- Referencing example test implementations for common Android UI components like alerts, inputs, navigation drawers, and web views.
- Testing native Android features such as camera, video, and image galleries in automated test scripts.
- Implementing advanced Espresso techniques like Idling Resources for synchronization and custom matchers.
- Handling specific testing scenarios like toasts, dialogs, login pages, nested views, and expected crashes.
- Building and running Espresso tests locally or on AWS Device Farm with proper APK configuration.
Not Ideal For
- Teams developing iOS or cross-platform applications, as this is Android-only.
- Projects using modern Android UI frameworks like Jetpack Compose, since it focuses on traditional views.
- Organizations seeking a plug-and-play test automation suite without customization, as it requires building and adapting examples.
Pros & Cons
Pros
Implements stock Android components like alerts, inputs, and web views with full source code, providing a reference for common UI elements.
Includes parallel test implementations for Appium, Calabash, and Espresso, allowing developers to compare approaches across frameworks.
Demonstrates Idling Resources for synchronization and custom matchers, offering best practices for complex testing scenarios like video playback.
Covers specific cases such as handling toasts, expected crashes, and native features like camera and video, making it practical for learning.
Cons
Uses Butterknife for view binding, which is deprecated in modern Android development in favor of ViewBinding or DataBinding, limiting relevance.
Some components, like crash tests for Calabash and Appium, and DatePicker/TimePicker tests for Appium, are not implemented, as noted in the README tables.
Requires building APKs and configuring Android Studio with specific instrumentation runners, which can be cumbersome for beginners or quick starts.
Frequently Asked Questions
Related Projects
aws-device-farm-appium-tests-for-sample-appAWS Device Farm Appium tests
aws-device-farm-jenkins-pluginJenkins plugin for AWS Device Farm.
aws-device-farm-gradle-pluginGradle plugin for AWS Device Farm.
aws-device-farm-calabash-tests-for-sample-appThis project provides a collection of example Calabash test suites written for the AWS Device Farm Android sample app. It serves as a reference for developers creating their own Calabash tests to run on AWS Device Farm, covering a wide range of common UI components and scenarios. ## Key Features - **Alerts Testing** — Examples for handling Android toasts and dialogs. - **Input Controls** — Tests for checkboxes, date pickers, edit text fields, gestures, radio buttons, spinners, and toggle buttons. - **Native Features** — Coverage for camera, image galleries, scroll views, and video playback. - **Navigation Components** — Testing for navigation drawers, view pagers, and nested views. - **Web Views** — Examples for both hybrid and standard web view interactions. - **Login & Static Pages** — Tests for login functionality and static text views. ## Philosophy The project is designed as a practical reference, providing real-world test examples that include explicit delays for page rendering to ensure reliability in automated testing environments.
Found a gem we're missing?
Open-Awesome is built by the community, for the community. Submit a project, suggest an awesome list, or help improve the catalog on GitHub.