View Categories

Application Deployment Troubleshooting

1 min read

This guide provides troubleshooting steps when application deployment in Android Edge fails. Issues typically fall under three categories: uploading the app, installing the app on devices, or updating an existing version. Follow the outlined steps to quickly identify and resolve problems.


Upload Issues #

You are not able to upload your application onto your console. #

  1. Check if the application has already been uploaded in the My Applications tab.
  2. Use a supported browser – it is recommended to upload using Google Chrome.

You are not able to upload a newer version of your application. #

  1. Verify if the application already exists in the My Applications tab.
  2. Ensure the VERSION CODE (not just the label) has been increased to a later version (e.g., from 1.0 → 2.0).

Install Issues #

You are not able to install your application via profiles (installation shows as failed on the device). #

  1. Check the installation logs of the device to identify the error.
  2. Verify that the device has a stable internet connection.
  3. Confirm that the new version is compatible with the device, including:
    • Device architecture
    • Android minimum version
    • Signature hash compatibility
  4. Check if the device is behind a firewall. Ensure required ports are allowed.
    • To isolate, connect the device to a personal hotspot and reattempt installation.

Update Issues #

You are not able to update your application to a newer version via profiles (installation shows as failed on the device). #

  1. Review the installation logs on the device to determine the issue.
  2. Verify internet connectivity on the device.
  3. Ensure the new version is compatible with your devices:
    • Device architecture
    • Android minimum version
  4. Check if the application’s older version was signed with the same signature certificate as the new version.
    • To confirm, use this APK signature verification tool: APKPure Signature Verification.
  5. Verify firewall settings. If blocked, connect to a personal hotspot to test if the update works.


Remote Debugging #

If all else fails and the issue persists, please contact your support personnel. They will arrange a remote debugging session for your device.

Before the session, please prepare the following:

  1. Set up AnyDesk on the remote debugging laptop.
  2. Download Vysor on the remote debugging laptop.
  3. Connect the target device to the laptop:
    • Ensure Developer Options and USB Debugging are turned on.
    • Turn on Vysor on the laptop.
    • Prepare the ADB Package on the laptop


Best Practices & Tips #

  • Version Control: Always increment the VERSION CODE when uploading a new app version.
  • Consistent Signing: Ensure all application builds use the same signing certificate.
  • Log Analysis: Regularly check installation logs for detailed error messages.
  • Browser Reliability: Use Google Chrome for uploading applications to minimize errors.
  • Network Validation: Test deployments over a hotspot if firewall issues are suspected.