NativeScript Sidekick

Deploying Your App on a Device

To test your app during development, you can build and deploy them on connected devices. After you have launched a native iOS or Android device emulator, while the emulator is running, Sidekick recognizes and treats it as a connected device. When you run your app on a connected device, you can inspect the device log to troubleshoot your app.

With NativeScript Sidekick, you can deploy your app on multiple connected devices simultaneously.


  • Verify that you have the latest official version of iTunes.
  • Verify that you have connected at least one physical device to your system or you have a running Android emulator or iOS simulator.
  • To build and deploy an app on an iOS device, you need a valid certificate and mobile provision. For more information about iOS code signing, see the iOS Developer Program article. If you have a Free Apple Developer account, you can use the Code Signing Assistance to automatically generate temporary certificate and mobile provision.
  • To build an app in Release configuration and deploy it on an Android device, you need a valid Google Play self-signed code signing identity.


  1. Launch NativeScript Sidekick and open your app.
  2. From the left toolbar, select Devices and then Connected.
  3. Under Connected Devices, select one or more devices.
  4. Click on the settings button (cogwheel icon) of each selected device and choose a valid certificate. For iOS devices, you need to provide a valid mobile provision as well.
  5. Select a Build Type.
  6. Select a Configuration.
  7. (Optional) Enable Clean Build. Available only for Cloud builds. When you enable this option, any previously cached data will be ignored and your app will undergo a complete rebuild. Initiating a clean build might help you resolve sporadic build failures or other unexpected behavior.
  8. (Optional) Enable Start Debugger. When you enable this option, a to begin a debug session as soon as the app is deployed on the device. Start Debugger is available only in Debug Configuration.
  9. (Optional) If any issues are present, resolve them before you continue.
  10. Click Run on Device and wait for the app to be deployed on the device.

Next Steps

Learn how you can LiveSync changes made to the code directly on the device, without the need to rebuild and redeploy your application.