Application Deployment Troubleshooting
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.
1. Upload Issues
Problem: You are not able to upload your application onto Springdel.
- Check if the application has already been uploaded in the My Applications tab.
- Use a supported browser – it is recommended to upload using Google Chrome.
Problem: You are not able to upload a newer version of your application.
- Verify if the application already exists in the My Applications tab.
- Ensure the VERSION CODE (not just the label) has been increased to a later version (e.g., from 1.0 → 2.0).
2. Install Issues
Problem: You are not able to install your application via profiles (installation shows as failed on the device).
- Check the installation logs of the device to identify the error.
- Verify that the device has a stable internet connection.
- Confirm that the new version is compatible with the device, including:
- Device architecture
- Android minimum version
- Signature hash compatibility
- 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.
- To isolate, connect the device to a personal hotspot and reattempt installation.
3. Update Issues
Problem: You are not able to update your application to a newer version via profiles (installation shows as failed on the device).
- Review the installation logs on the device to determine the issue.
- Verify internet connectivity on the device.
- Ensure the new version is compatible with your devices:
- Device architecture
- Android minimum version
- 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.
- 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 Springdel personnel. They will arrange a remote debugging session for your device.
Before the session, please prepare the following:
- Set up AnyDesk on the remote debugging laptop.
- Download Vysor on the remote debugging laptop.
- 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, or ensure the Springdel Edge Tool is installed.
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.