Skip to main content
Samsung Developer Program

Fundamental Tasks

Fundamental tasks are the most common tasks to perform in the Cloud Device Farm (CDF).

For a comprehensive list of actions that are available in CDF, see Actions Summary.

Select and reserve a device

After you have logged in to the Samsung Developer Program site and launched CDF, CDF guides you through the process of selecting the Samsung mobile device on which you will be testing your app.

  1. Click the platform on which the device is running. Currently, only Android devices are supported.

  1. Click on the device series type on which you want to test your app (for example, Galaxy Note, S, or Tablet). If you are not sure which series type you want to use, select any type. In the next step, you can change the series type if you cannot find the exact device you want to test.
CDF_selectSeries.png
  1. Select the exact device to use:

    1. Scroll through the list of available devices and locate the exact type of device on which to test your app.

    2. Select the amount of time to reserve the device (15 or 30 minutes).

      Caution: When your reservation time runs out, your session is ended and any content you added to the device is deleted.

    3. Click Reserve.

    If you do not see the specific device on which you want to test, then the device may not be available for testing. In the Filter By section of the screen, select and/or unselect the filters to view devices that are available for testing. At least one checkbox in the series type must be selected.

    Note: Carrier does not refer to the cellular connection type. Mobile devices in CDF do not contain SIM cards. Instead, carrier refers to the type of operator-customized apps that appear on the device.

    For more information about filter types, see Filter by (Device Reservation).

CDF_reserveDevice.png

 

Currently, all devices in the Cloud Device Farm are located in the United States. For users outside of the continental U.S., there may be a noticeable delayed response when using a device.

Note: When your reservation starts, an automatic video recording of your session is also started. When your sessions ends, a copy of the video is available from the History area of CDF. It can take 10 minutes or more after your session ends before the video is available for viewing.

Upload an app

After you have selected and reserved a device, upload your app for testing.

  1. From the CDF top menu bar, click CDF_uploadAPK_button.jpg.

  2. Click CDF_upload_chooseFile_button.jpg, navigate to and select the APK file to upload.

  3. Click CDF_uploadAPK_upload_button.jpg.

    The Upload button is replaced by a status bar indicating the status of the upload. Installation is completed when the message "Successfully installed" blinks briefly below the status bar and the window disappears.

Test an app

After you have uploaded your app, you are ready to start testing it. This section describes some of the common actions you can perform from CDF when testing your app. See Actions Summary for a complete list of actions.

CDF_recentApps_button.jpg

Displays the most recent apps used on the device.

CDF_home_button.jpg

Returns you to the home screen of the device.

CDF_back_button.jpg

Takes you back to the previous screen or app you were using.

CDF_swipe_button.jpg

Emulates swiping your finger across the display of the device in one of four directions, starting from the middle of the display. You can also hold down your mouse button and use the cursor to swipe across the display.

Capture a screen

Take an image of the screen displayed on the device.

  1. From the CDF top menu bar, click CDF_screenshot_button.jpg.

  2. An image of the display appears in the Take Screenshot area.

    CDF_screenshot_screenshot_button.jpg

    Capture a new image of the display of the device.

    CDF_screenshot_download_button.jpg

    Save the image to your personal computer. If you cleared the screenshot, the last image displayed in the Take Screenshot area is saved.

    CDF_screenshot_clear_button.jpg

    Clear the image from the Take Screenshot area.

  3. Click CDF_screenshot_blue_button.jpg in the top menu bar to clear the Take Screenshot area from CDF.

Debug an app

If your app is not performing as expected, you can monitor and download the log file (generated by logcat).

  1. From the CDF top menu bar, click CDF_logs_button.jpg.

  2. An active listing of the most recent messages in the log file is shown. Only the messages that fit in the display area, not the entire log file, are shown.

    CDF_logs_filter_button.png

    Dropdown menu to filter the type of messages displayed, based on priority.

    Priority in the menu is listed from lowest to highest (Verbose, Debug, Info, Warn, Error, Assert). Selecting a priority includes messages of the selected priority and higher. For example, if you select Warn, messages with Warn, Error, and Assert priority are displayed.

    It may take a few seconds for the display to refresh and list the filtered messages.

    CDF_logs_download_button.jpg

    Save the entire log file to your personal computer. Filtering only affects the displayed log file content, not the content that is downloaded.

    CDF_logs_clear_button.jpg

    Clear the contents of the log file.

    CDF_logs_search.png

    Filter by tag and priority. The tag in a log message typically refers to the system component from which the message originates.

    Filter format
    <tag>[:<priority>]

    • <tag> (required) must match the tag used in the log message exactly. It is case-sensitive and wildcards are not allowed. For example, specifying a filter tag of "scanrecord" or "Scan" or "Scan*" does not return log messages with a tag of "ScanRecord."

    • <priority> (optional) is the first letter of the priority type, in uppercase (for example, W for Warn). If no priority is specified, the lowest priority (V or Verbose) is used.

      If you want to filter by priority only, use the priority dropdown menu.

    You can specify more than one filter. Each filter must be separated by a space. Messages that match any of the filters are displayed. For example, if you specify "MyActivity:I  MyService:D" as the filter, messages with the MyActivity tag and a priority of Info or higher in addition to messages with the MyService tag and a priority of Debug or higher are displayed.

    After entering a tag filter, click the magnifying glass icon or press Enter to initiate filtering.

    To clear the tag filter, you must either select a priority from the dropdown menu or exit and re-enter the Logs area.

     

    Note: Only one filter is active at a time (either the priority filter [dropdown menu] or tag filter). The last filter set is the filter used. For example, if you select a priority of Warn from the dropdown menu, all messages with a priority of Warning or higher are displayed. If you then enter "ScanRecord:D" into the tag filter, the filter resets and all messages with a tag of ScanRecord and a priority of Debug or higher are displayed.

  3. Click CDF_logs_blue_button.jpg in the top menu bar to remove the log view.

End device sesion

When you have completed testing and downloading any screenshots or log files, you can end your device session. You can wait for the countdown timer to reach zero, or you can click CDF_disconnect_button.jpg to end your session immediately.

Note: When your session ends, the automatic video recording of your session is also ended. A copy of the video will be available 10 minutes (or more) after your session ends, accessible from the History area of CDF.

Also, when your session ends, any content you added to the device (such as any apps or files you uploaded, browser history, pictures or videos, and user credentials) is automatically deleted.