AWS devicefarm documentation change
Summary
Updated instructions for creating test runs in Device Farm, including new UI elements, optional sample app usage, expanded configuration options (radio states, location, locale), and clarified workflow steps
Security assessment
The changes focus on workflow improvements and UI updates rather than addressing security vulnerabilities. While new options like installing additional apps or enabling data capture exist, the documentation doesn't mention security controls for these features. No evidence of patching vulnerabilities or addressing specific security risks.
Diff
diff --git a/devicefarm/latest/developerguide/getting-started.md b/devicefarm/latest/developerguide/getting-started.md index e86be084b..c3adcfc45 100644 --- a//devicefarm/latest/developerguide/getting-started.md +++ b//devicefarm/latest/developerguide/getting-started.md @@ -41 +41 @@ Before you begin, make sure you have completed the following requirements: - * For Android, you need an .apk (Android app package) file. For iOS, you need an .ipa (iOS app archive) file. You upload the file to Device Farm later in this walkthrough. + * For Android, you can bring an .apk (Android app package) file, or use the sample application we provide. For iOS, you need an .ipa (iOS app archive) file. You upload the file to Device Farm later in this walkthrough. @@ -67 +67 @@ To test an app in Device Farm, you must first create a project. - 2. Under **Mobile Device Testing Projects** , choose **New project**. + 2. Under **Mobile Device Testing Projects** , choose **Create project**. @@ -82 +82 @@ Now that you have a project, you can create and then start a run. For more infor - 1. On the **Automated tests** page, choose **Create a new run**. + 1. On the **Automated tests** tab, choose **Create run**. Alternatively, you can follow the in-console tutorial by selecting **Create run with tutorial**. @@ -84 +84 @@ Now that you have a project, you can create and then start a run. For more infor - 2. On the **Choose application** page, under **Mobile App** , choose **Choose File** , and then choose an Android (.apk) or iOS (.ipa) file from your computer. Or, drag the file from your computer and drop it in the console. + 2. (Optional) Under **Run settings** , in the **Run name** section, enter a name for your run. If no name is provided, the Device Farm console will name your run 'My Device Farm run' by default. @@ -86 +86 @@ Now that you have a project, you can create and then start a run. For more infor - 3. Enter a **Run name** , such as `my first test`. By default, the Device Farm console uses the file name. + 3. Under **Run settings** , in the **Run type** section, select your run type. Select **Android app** if you do not have an app ready for testing, or if you are testing an android (.apk) app. Select **iOS app** if you are testing an iOS (.ipa) app. @@ -88 +88 @@ Now that you have a project, you can create and then start a run. For more infor - 4. Choose **Next**. + 4. Under **Select app** , in the **App selection options** section, choose **Select sample app provided by Device Farm** if you do not have an app available for testing. If you are bringing your own app, select **Upload own app** , and choose your application file. If you're uploading an iOS app, be sure to choose **iOS device** , as opposed to a simulator. @@ -90 +90 @@ Now that you have a project, you can create and then start a run. For more infor - 5. On the **Configure** page, under **Setup test framework** , choose one of the testing frameworks or built-in test suites. For information about each option, see [Test frameworks and built-in tests in AWS Device Farm](./test-types.html). + 5. Under **Configure test** , in the **Select test framework** section, choose one of the testing frameworks or built-in test suites. For information about each option, see [Test frameworks and built-in tests in AWS Device Farm](./test-types.html). @@ -96 +96 @@ Now that you have a project, you can create and then start a run. For more infor - 6. Choose **Next**. + 6. Under **Select devices** , choose **Use Device Pool** and **Top Devices**. @@ -98 +98 @@ Now that you have a project, you can create and then start a run. For more infor - 7. On the **Select devices** page, for **Device pool** , choose **Top Devices**. + 7. (Optional) To add additional configuration, open the **Additional configuration** dropdown. In this section, you can do any of the following: @@ -100 +100 @@ Now that you have a project, you can create and then start a run. For more infor - 8. Choose **Next**. + * To provide other data for Device Farm to use during the run, next to **Add extra data** , choose **Choose File** , and then browse to and choose the .zip file that contains the data. @@ -102 +102 @@ Now that you have a project, you can create and then start a run. For more infor - 9. On the **Specify device state** page, do any of the following: + * To install an additional app for Device Farm to use during the run, next to **Install other apps** , choose **Choose File** , and then browse to and choose the .apk or .ipa file that contains the app. Repeat this for other apps you want to install. You can change the installation order by dragging and dropping the apps after you upload them. @@ -104 +104 @@ Now that you have a project, you can create and then start a run. For more infor - * To provide additional data for Device Farm to use during the run, under **Add extra data** , upload a .zip file. + * To specify whether Wi-Fi, Bluetooth, GPS, or NFC is enabled during the run, next to **Set radio states** , select the appropriate boxes. @@ -106 +106 @@ Now that you have a project, you can create and then start a run. For more infor - * To install other apps for the run, under **Install other apps** , upload the .apk or .ipa files for the apps. To change the installation order, drag and drop the files. + * To preset the device latitude and longitude for the run, next to **Device location** , enter the coordinates. @@ -108 +108 @@ Now that you have a project, you can create and then start a run. For more infor - * To turn on Wi-Fi, Bluetooth, GPS, or NFC radios for the run, under **Set radio states** , select the corresponding check boxes. + * To preset the device locale for the run, in **Device locale** , choose the locale. @@ -110 +110 @@ Now that you have a project, you can create and then start a run. For more infor - * To test location-specific behavior during the run, under **Device location** , specify preset **Latitude** and **Longitude** coordinates. + * Select **Enable video recording** to record video during testing. @@ -112,3 +112 @@ Now that you have a project, you can create and then start a run. For more infor - * To preset device language and region for the run, under **Device locale** , choose a locale. - - * To preset the network profile for the run, under **Network profile** , choose a curated profile. Or, choose **Create network profile** to create your own. + * Select **Enable app performance data capture** to capture performance data from the device. @@ -120 +118,3 @@ Setting the device radio state and locale are options only available for Android - 10. Choose **Next**. +###### Note + +If you have private devices, configuration specific to private devices is also displayed. @@ -122 +122 @@ Setting the device radio state and locale are options only available for Android - 11. On the **Review and start run** page, choose **Confirm and start run**. + 8. At the bottom of the page, choose **Create run** to schedule the run.