Skip to content
Customer Portal
  • There are no suggestions because the search field is empty.

Kiosk Mode Troubleshooting

This guide provides troubleshooting steps when applications in Android Edge Kiosk Mode fail to function as expected. It covers common issues such as dependent services not being whitelisted or background services being blocked, which can prevent apps (for example, the Phone app) from working correctly in Kiosk Mode.

1. Application Not Working in Kiosk Mode

Problem: Application not working as expected in Kiosk Mode.

If you are using Android Edge Kiosk Mode and have pushed an application, such as the Phone app. However, the Phone app is not functioning as expected.

  1. Whitelist the required dependent services for the Phone application:
    • com.samsung.android.app.contacts
    • com.samsung.android.dialer
    • com.android.server.telecom
    • com.samsung.android.incallui
    • com.android.incallui.call.dialog
  2. Alternatively, enable the Whitelist All Background Services option in the Kiosk tab of the profile settings.

 

Note: This same approach applies to other applications. If an app is not working in Kiosk Mode, you will need to identify and whitelist its required dependent services.

 


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:

  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, or ensure the Springdel Edge Tool is installed.

Best Practices & Tips

  • Whitelist Specific Services: Only whitelist necessary services to keep Kiosk Mode secure.
  • Use Whitelist All Background Services: As a fallback option, enable this setting if dependent services are unknown or vary across devices.
  • Test Before Deployment: Always test Kiosk profiles with required apps in a staging environment before pushing to production fleets.
  • Monitor Logs: Use the Springdel console logs to confirm whether dependent services are being blocked when apps fail to launch.