Skip to main content

Developing an Application

 

Applies only to Mobile Apps
OutSystems

Troubleshoot Device Connection Issues

Before debugging a mobile application using a device you must prepare it for being discoverable by Service Studio.

Below you can find a list of the most common problems that may arise when setting up your Android or iOS device or when Service Studio is trying to detect your running mobile app, as well as how to fix them.

Issues While Connecting an Android Device

Check the following sections for more information on how to solve these issues:

USB/Android Debugging not enabled in device

For the device to be detected by Service Studio, you should start by having the USB debugging (or Android Debugging) option enabled.

  1. Navigate to the Developer options section inside the Settings and enable the USB debugging option.

    Note: If you don't have the Developer options section in Settings, check how to enable Developer options on your device.

Device not recognized by Windows

After ensuring that the USB debugging option is enabled, you should check if the device is detected by Windows and its drivers are correctly installed:

  1. Open Control Panel;
  2. Navigate to the Hardware and Sound category;
  3. Open Device Manager, located under Devices and Printers;
  4. If your device is listed under Other devices, you need to install the correct drivers before proceeding:

To help Windows correctly detect the device, follow this guide to install the drivers provided by the manufacturer.

If after following the guide mentioned above Windows still fails to recognize the device properly, try using the drivers provided by Google by taking these steps:

  1. Download the Google USB Driver ZIP file and extract it (to the Desktop, for example);

  2. Right-click on your device and select Update Driver Software...;

  3. Choose Browse my computer for driver software;

  4. Choose Let me pick from a list of device drivers on my computer;

  5. Select Show All Devices and click Next;

  6. Choose the option Have Disk..., browse to the usb_driver folder located on the extracted folder and click OK;

  7. Select Android ADB Interface and click Next;

  8. Confirm the installation of the driver by pressing Yes;

  9. Install the driver by choosing Install;

When the installation completes, press Close and check that the device appears in Device Manager:

Incompatible USB mode selected in device

The USB mode which the device is configured to use when connecting to a PC can also cause issues in the device detection process.

Depending on the version of Android and the manufacturer of the device, this option can be in different places. First of all, check if you have any notification referring to the USB mode, like the ones below:

If you find these options, try to switch between them (MTP, PTP and Camera modes), disconnecting and reconnecting the device to the PC and retrying the device discovery in Service Studio.

USB Debugging was not allowed in device

Whenever an Android device is connected to a PC, a request to allow USB Debugging is shown on the device. This request should be accepted so that Service Studio can communicate with the device. If you get a pop-up on your device like the one below, just tap OK and try again on Service Studio to detect the device:

More than one Android device is connected to your PC

Only one device from each platform (Android/iOS) can be connected to the PC for the device discovery process to run successfully.

Ensure that you only have one Android device connected to your PC.

Issues While Connecting an iOS Device

Check the following sections for more information on how to solve these issues:

iTunes is not installed on your PC

One of the requirements for the debugger to work with iOS devices is the iTunes installation on the machine where Service Studio is executing. Please make sure that you have it installed on your machine before trying to perform any debug session with an iOS device.

Download the latest version here.

Web Inspector is not enabled on your device

The next step to ensure that your device is correctly detected is to guarantee that the Web Inspector is enabled. Follow Apple's instructions for enabling it.

PC is not trusted for debugging

The final step to setup your device to be ready for debugging is to trust the PC so it can communicate with the device. To do so, tap Trust when the following pop-up appears on your device:

Check Apple Support for more information on trusted computers.

More than one iOS device is connected to your PC

Only one device from each platform (Android/iOS) can be connected to the PC for the device discovery process to run successfully.

Ensure that you only have one iOS device connected to your PC.

Issues During App Detection by Service Studio

When starting a new debug session using a device, and after the device has been correctly detected, Service Studio will start to actively look for the mobile app that you are debugging.

If you find issues during the app detection step (e.g. the detection is taking too long), make sure that the mobile app was generated with the Debug Build Type for Android and Development Build Type for iOS.

If your app is still not detected, try performing each of the following steps in your device and check if any of them solves your problem:

  • Close all other running OutSystems mobile apps;
  • Close the "OutSystems Now" mobile app;
  • Close any browser app that could be running;
  • Close all running apps.
  • Was this article helpful?