Introduction

Welcome to Device Farm, your all-in-one platform for manual and automated testing on real devices. Device Farm provides developers with a powerful testing environment to ensure the quality and performance of their applications across a wide range of devices and configurations.

Key Features

• Access to Real Devices & Cloud Farm: Device Farm offers a diverse catalog of real Android and iOS smartphones, tablets, as well as Cloud Devices (AWS Device Farm integration), allowing you to test applications across physical hardware and cloud instances.

• Manual Testing with Modern Workspace: Interactively test devices with real-time WebRTC streaming, mouse and touch gestures, hardware controls, and a split-pane layout for concurrent log and vitals analysis.

• In-Session App Management: Upload and install new applications (.apk, .ipa, .apks, .aab) on-the-fly directly inside an active testing session without disconnecting.

• Automated Testing with Appium: Automate your test suites using modern Appium (v1 & v2) across Java, Python, and JavaScript frameworks, complete with live execution preview and live Appium logs streaming.

• Element Explorer & XPath Tester: Inspect UI elements, view full XML DOM hierarchies, highlight components on an interactive canvas, and verify XPath expressions live.

• Comprehensive Test Reports & Vitals: Generate rich reports containing time-series device vitals (CPU, Memory, Network) with CSV/PNG export, device and Appium logs, full video recordings, and screenshots.

• Enterprise Collaboration & Security: Integrated Jira bug reporting (with sub-tasks and Xray test integration), secure Project and User API tokens, and custom network profiles.

Experience Device Farm right away by visiting Device Farm.

---

User Guide

1. Getting Started

   • Top Navigation Bar (Navbar)

   • Interactive Product Tour Guide

   • Navigating the Dashboard & Dashboard Details

   • Navigating to Projects

   • Navigating to History & Filter Details

   • Accessing Real Devices

   • Accessing Real Browsers

   • Supported Browsers and Devices

2. Project Creation and Setup

   • Creating a Project

   • Searching & Managing Projects

   • Inside Project (Tests, Devices, Apps, Reports, Integrations, Filters)

   • Application Management (Upload & Multipart)

   • Authentication Management (Project & User API Tokens)

   • Integrations Management (Jira & Xray)

   • Network Profiles Management (Presets & Custom)

   • Remote Devices Management

   • Swagger Documentation

3. Running Manual Tests

   • Creating a Manual Device Session

   • New Split-Pane Workspace vs Classic View

   • Navigation & Control Bar Tools

   • In-Session App Installation

   • Send Keys and Keyboard Capture

   • Device Logs & Live Streaming

   • Network Shaping & Wi-Fi Simulation

   • Creating a Manual Browser Session

4. Running Automated Tests

   • Setting Up Automated Tests

   • Configuring Test Parameters & JSON Capabilities

   • Code Examples (Java, Python, JavaScript)

   • Cloud Device Farm (AWS) Automation

   • Running and Managing Automated Tests

5. Test Reports and Analysis

   • Steps to View Reports

   • Viewing Device Vitals (CPU, Memory, Network Graphs & CSV Export)

   • Accessing Logs, Screenshots & Video

   • Sharing Reports via Email

6. Collaboration and Sharing

   • Integrations with Collaboration Tools (Jira & Xray)

7. Troubleshooting and FAQs

   • Frequently Asked Questions

8. Advanced Features

   • App Upload / Application Management

   • In-Session App Installer

   • File Upload to Remote Storage

   • Biometrics Bypass (BETA)

   • Element Explorer & XPath Tester

   • Network Shaping

   • Interrupt Testing (Call & SMS)

9. API Documentation

   • Accessing Device Farm via APIs

   • API Authentication & Token Management

10. AI Session

    • Record for Automation

    • Run a Session Without an App

    • Upload an App to a Session

    • Run a Web Session

    • Understand Agent Execution

    • Save a Session as a Project Test

    • View Session Reports

    • Re-run a Session and View Its Reports

    • Configure Jira and TestRail

    • Manage Projects and Tests

    • Analyze Session Activity

    • Qyrion CLI

11. AI Session

    • Run a Session Without an App

    • Upload an App to a Session

    • Run a Web Session

    • Understand Agent Execution

    • Save a Session as a Project Test

    • View Session Reports

    • Re-run a Session and View Its Reports

    • Configure Jira and TestRail

    • Manage Projects and Tests

    • Analyze Session Activity

    • Record for Automation

    • Qyrion CLI

    • AI Session FAQs

Intended Audience

Device Farm caters to a wide range of users, including:

• Developers: Test your applications on various devices and configurations to ensure they work flawlessly across the spectrum.

• Quality Assurance Teams: Conduct thorough testing to catch bugs, identify performance bottlenecks, and ensure a high-quality user experience.

• Testers: Simulate user interactions on real devices, ensuring your app's functionality and user interface are up to the mark.

Whether you're a solo developer, a part of a development team, or a dedicated tester, Device Farm is designed to streamline your testing processes and help you deliver robust applications to your users.