App shortcuts are hidden on the Kiosk home screen

Environment

• Knox Platform for Enterprise (KPE)
• Kiosk devices
• Knox SDK

Overview

Some admins are facing issues where app shortcuts are not visible on the Kiosk home screen after calling the addHomeShortcut API method:

boolean result = applicationPolicy.addHomeShortcut(getPackageName(), kioskHomePackage);

This article guides you through how to resolve this issue, which involves calling enableKioskMode() with a delay of 100 ms.

Resolution

To configure the enableKioskMode() API method:

1. Enable Kiosk Mode and register a broadcast receiver for the result. Refer to Enable Kiosk Mode.

2. In the broadcast receiver, give the handler a delay of 100 ms:

final Handler handler = new Handler(Looper.getMainLooper());
handler.postDelayed(new Runnable() {
    @Override
    public void run() {
        mMainActivity.addShortcutToKioskMode();
        mMainActivity.finish();
    }
}, 100);

3. Create a method in MainActivity() to add app shortcuts, which will be called when MainActivity is instantiated. Refer to Add an app shortcut to Kiosk Mode.

The app shortcuts are now visible on the Home screen of the Kiosk.

Additional information

Learn how to get started with Sample Apps APIs and Knox Platform for Enterprise.