Managing private devices in AWS Device Farm
A private device is a physical mobile device that AWS Device Farm deploys on your behalf in an Amazon data center. This device is exclusive to your AWS account.
Note
Currently, private devices are available in the AWS US West (Oregon) Region (us-west-2) only.
You can set up a fleet that contains one or more private devices. These devices are dedicated to your AWS account. After you set up the devices, you can optionally create one or more instance profiles for them. Instance profiles can help you automate test runs and consistently apply the same settings to device instances.
This topic explains how to create an instance profile and perform other common device management tasks.
Topics
Creating an instance profile
To control the behavior of private devices during a test run or remote access session, you can create or modify an instance profile in Device Farm. You do not need an instance profile to start using your private devices.
Open the Device Farm console at https://console.aws.amazon.com/devicefarm/
. -
On the Device Farm navigation panel, choose Mobile Device Testing, then choose Private devices.
-
Choose Instance profiles.
-
Choose Create instance profile.
-
Enter a name for the instance profile.
-
(Optional) Enter a description for the instance profile.
-
(Optional) Change any of the following settings to specify which actions you want Device Farm to take on a device after each test run or session ends:
-
Reboot after use – To reboot the device, select this check box. By default, this check box is cleared (
false). -
Package cleanup – To remove all the app packages that you installed on the device, select this check box. By default, this check box is cleared (
false). To keep all the app packages that you installed on the device, leave this check box cleared. -
Exclude packages from cleanup – To keep only selected app packages on the device, select the Package Cleanup check box, and then choose Add new. For the package name, enter the fully qualified name of the app package that you want to keep on the device (for example,
com.test.example). To keep more app packages on the device, choose Add new, and then enter the fully qualified name of each package.
-
-
Choose Save.
Managing a private device instance
If you already have one or more private devices in your fleet, you can view information about and manage certain settings for each device instance. You can also request an additional private device instance.
Open the Device Farm console at https://console.aws.amazon.com/devicefarm/
. -
On the Device Farm navigation panel, choose Mobile Device Testing, then choose Private devices.
-
Choose Device instances. The Device instances tab displays a table of the private devices that are in your fleet. To quickly search or filter the table, enter search terms in the search bar above the columns.
-
(Optional) To request a new private device instance, choose Request device instance or contact us
. Private devices require additional setup with help from the Device Farm team. -
In the table of device instances, choose the toggle option next to the instance that you want to view information about or manage, then choose Edit.
-
(Optional) For Profile, choose an instance profile to attach to the device instance. This can be helpful if you want to always exclude a specific app package from cleanup tasks, for example.
-
(Optional) Under Labels, choose Add new to add a label to the device instance. Labels can help you categorize your devices and find specific devices more easily.
-
Choose Save.
Creating a test run or starting a remote access session
After you set up a private device fleet, you can create test runs or start remote access sessions with one or more private devices in your fleet.
Open the Device Farm console at https://console.aws.amazon.com/devicefarm/
. -
On the Device Farm navigation panel, choose Mobile Device Testing, then choose Projects.
-
Choose an existing project from the list or create a new one. To create a new project, choose New project, enter a name for the project, and then choose Submit.
-
Do one of the following:
-
To create a test run, choose Automated tests, and then choose Create a new run. The wizard guides you through the steps to create the run. For the Select devices step, you can edit an existing device pool or create a new device pool that includes only those private devices that the Device Farm team set up and associated with your AWS account. For more information, see Creating a private device pool with private devices (console).
-
To start a remote access session, choose Remote access, and then choose Start a new session. On the Choose a device page, select Private device instances only to limit the list to only those private devices that the Device Farm team set up and associated with your AWS account. Then, choose the device that you want to access, enter a name for the remote access session, and choose Confirm and start session.
-
Next steps
After you set up your private devices, you can also manage your private devices in the following ways:
To delete an instance profile, on the Instance profiles menu, choose the toggle option next to the instance that you want to delete, then choose Delete.
