Using virtualUSB {beta}

NOTE: virtualUSB is currently in beta. We welcome your feedback at support@kobiton.com

virtualUSB allows users to develop, debug, and test apps on Private and Local mobile devices hosted on the Kobiton Portal.

virtualUSB is available as an option for the Enterprise plan. Please contact support@kobiton.com or your Account Executive if you are interested in adding this feature.

See the macOS or Windows installation and configuration guides for how to set up and configure virtualUSB. Once the setup is done, open virtualUSB and start exploring the features below.

To use virtualUSB via a command-line interface, see this guide.

Device list

The first thing you'll see when you sign into virtualUSB is the list of the Private and Local online devices assigned to you (from all of your assigned teams):

Screen_Shot_2022-11-22_at_10.43.17_AM.png

With the above list, you can:

  • Use the search bar on top of the device list to find devices by Display Name, Model Name, or UDID.
  • Hover on a device's Display Name, Model Name, or UDID to show the full text when the text is long. You can also copy the information by clicking the Copy icon:
    Screen_Shot_2022-11-22_at_11.01.18_AM.png

Connect to a device

On the device list, select the Connect button for a device:

Screen_Shot_2022-11-22_at_10.51.46_AM_copy.png

Once connected:

  • The device status changes to Retained. This status persists for 24 hours unless the device is disconnected sooner. 

  • The Connection Status column displays the value Connected.

Screen_Shot_2022-11-22_at_11.26.53_AM.png

Repeat the above step to connect to additional devices.

To filter and view the list currently connected devices, select the Show Connected Devices checkbox on the right of the search bar. Unselect the checkbox to clear the filter and view all devices.

Screen_Shot_2022-11-22_at_11.32.47_AM.png

Check connected devices

Android devices

In Android Studio, select Device Manager from the run configurations dropdown menu:

Screen_Shot_2022-11-22_at_4.51.43_PM.png

Select the Physical tab to see the list of connected devices:

Screen_Shot_2022-11-22_at_4.54.43_PM.png

iOS devices

On a macOS workstation, connected iOS devices can be accessed via Xcode: 

Screen_Shot_2022-11-22_at_5.15.20_PM.png

Note: in releases of virtualUSB prior to Kobiton 4.1, iOS devices could also be seen in Finder. This option is no longer available.

On a Windows workstation, virtualUSB supports communicating with iOS devices via tools such as libimobiledevice. Below is an example of libimobiledevice showing the UDID and name of an iOS device:

libimobiledevice.png

Launch a manual session

To observe what is happening on the device screen while connected to a device via virtualUSB, sign in to the Kobiton Portal, find the device, and launch a manual session with a virtualUSB. (Hint: copy the device UDID from virtualUSB and paste it in the search bar of the Kobiton Portal Device List.)

Manual sessions will end after staying idle for a certain period of time. To prevent an accidental session end, open the Manual Session Settings while in the manual session, uncheck Quit session after staying idle for 10 minutes in the pop-up, and click Apply.

mceclip0.png

Screen_Shot_2022-11-22_at_5.21.17_PM.png

Disconnect a device

To disconnect and release a device back to the team, go to virtualUSB and click Disconnect under the Action column:

Screen_Shot_2022-11-22_at_5.37.52_PM.png

Confirm the action by selecting Disconnect in the next dialog:

Screen_Shot_2022-11-22_at_5.38.55_PM.png

Save log

To save a log of activities in virtualUSB, select the Save Logs icon:

Screen_Shot_2022-11-22_at_5.41.13_PM.png

In the next dialog, choose a time period from the dropdown list and select Save. A zip archive containing all the logs in the selected period will be downloaded.

Screen_Shot_2022-11-22_at_5.43.42_PM.png

Limitations

  • An Org Admin is able to cancel a device retained for virtualUSB. Once cancelled, the device will be released i.e. that device is no longer connected with the user's workstation. However, in this case, the user will see Connection status as Error and the button stays at Disconnect.To re-connect to this device, the user needs to disconnect and then connect again.
  • After selecting Connect for a device, users may occasionally see the connection status change to Offline or Error before showing Connected. Kobiton will address this behavior in an upcoming release.
  • If a user right-clicks on any part of the virtualUSB app and selects Reload, the user will be directed back to the login page and need to sign in again.
  • You cannot run virtualUSB from a Mac that has deviceConnect or Kobiton Desktop installed.
  • Device connection status is not synced across machines when a user logs into virtualUSB on different machines simultaneously.
  • When a device is connected via virtualUSB and you restart the device:
    • the virtualUSB connection will be re-established.
    • the device status will be back to Retained until timed out.
  • The connection status of the devices may not stay in sync between the virtualUSB UI and virtualUSB command-line interface (CLI). Use only the GUI or only the CLI when connecting and disconnecting devices.
  • Within the zip file exported using the save log feature, the created and modified date time of some of the files and folders are displayed incorrectly as January 1, 1980 at 12:00 AM.
Was this article helpful?
0 out of 0 found this helpful