AWS Device Farm Developer Guide API Version 2015-06-23 AWS Device Farm Developer Guide AWS Device Farm: Developer Guide Copyright © Amazon Web Services, Inc. and/or its affiliates. All rights reserved. Amazon's trademarks and trade dress may not be used in connection with any product or service that is not Amazon's, in any manner that is likely to cause confusion among customers, or in any manner that disparages or discredits Amazon. All other trademarks not owned by Amazon are the property of their respective owners, who may or may not be affiliated with, connected to, or sponsored by Amazon. AWS Device Farm Developer Guide Table of Contents What Is AWS Device Farm? .................................................................................................................. 1 Automated App Testing .............................................................................................................. 1 Remote Access Interaction ........................................................................................................... 1 Terminology .............................................................................................................................. 1 Setting Up ................................................................................................................................ 2 Setting Up ........................................................................................................................................ 3 Step 1: Sign Up for AWS ............................................................................................................. 3 Step 2: Create or Use an IAM User in Your AWS Account ................................................................. 3 Step 3: Give the IAM User Permission to Access Device Farm ............................................................ 3 Next Step .................................................................................................................................. 4 Getting started .................................................................................................................................. 5 Prerequisites .............................................................................................................................. 5 Step 1: Sign in to the console ..................................................................................................... 5 Step 2: Create a project .............................................................................................................. 5 Step 3: Create and start a run ..................................................................................................... 6 Step 4: View the run's results ...................................................................................................... 7 Next steps ................................................................................................................................. 7 Purchase device slots .......................................................................................................................... 8 Purchase device slots (console) .................................................................................................... 8 Purchase a device slot (AWS CLI) .................................................................................................. 9 Purchase a device slot (API) ....................................................................................................... 12 Concepts ......................................................................................................................................... 13 Devices .................................................................................................................................... 13 Supported Devices ............................................................................................................ 13 Device Pools .................................................................................................................... 13 Private Devices ................................................................................................................. 13 Device Branding ............................................................................................................... 14 Device Slots ..................................................................................................................... 14 Preinstalled Device Apps ................................................................................................... 14 Device Capabilities ............................................................................................................ 14 Test Environments .................................................................................................................... 14 Standard Test Environment ............................................................................................... 15 Custom Test Environment ................................................................................................. 15 Runs ....................................................................................................................................... 15 Run Configuration ............................................................................................................ 15 Run Files Retention .......................................................................................................... 16 Run Device State .............................................................................................................. 16 Parallel Runs .................................................................................................................... 16 Setting the Execution Timeout ........................................................................................... 16 Instrumenting Apps .......................................................................................................... 16 Re-Signing Apps in Runs ................................................................................................... 16 Obfuscated Apps in Runs .................................................................................................. 16 Ads in Runs ..................................................................................................................... 16 Media in Runs .................................................................................................................. 17 Common Tasks for Runs .................................................................................................... 17 Reports ................................................................................................................................... 17 Report Retention .............................................................................................................. 17 Report Components .......................................................................................................... 17 Performance Samples in Reports ........................................................................................ 17 Logs in Reports ................................................................................................................ 17 Common Tasks for Reports ................................................................................................ 17 Sessions .................................................................................................................................. 18 Supported Devices for Remote Access ................................................................................. 18 Session Files Retention ..................................................................................................... 18 API Version 2015-06-23 iii AWS Device Farm Developer Guide Instrumenting Apps .......................................................................................................... 18 Re-Signing Apps in Sessions .............................................................................................. 18 Obfuscated Apps in Sessions ............................................................................................. 18 Working with Projects ....................................................................................................................... 19 Create a Project ....................................................................................................................... 19 Prerequisites .................................................................................................................... 19 Create a Project (Console) ................................................................................................. 19 Create a Project (AWS CLI) ................................................................................................ 19 Create a Project (API) ........................................................................................................ 20 View the Projects List ............................................................................................................... 20 Prerequisites .................................................................................................................... 20 View the Projects List (Console) ......................................................................................... 20 View the Projects List (AWS CLI) ........................................................................................