Mobile Framework

Add a New Mobile App to the App Launcher

Adding a new app to the App Launcher: involves creating a record for the app in the afm_mobile_apps table, and setting anew icon as described int he following procedure.

To add an app to the App Launcher:

  1. From the Smart Client, click the Views tab and open the afm_mobile_apps table.
  2. Add a new record that includes:
    • title: the app title that appears in App Launcher under the app icon
    • main_page_url: the URL for index.html in the app's folder. This URL was created when you created the directory structure for the new app using the Sencha tool. See Create a New App Directory Structure Using Sencha CMD
    • display_order: a numeric value that defines where the app is displayed in the app's list
    • security_group: the security group for users that should see the app in their app's list

      Note: You must assign the new app to a security group, so that only users assigned to that security group will see the app on their devices. Also, when creating the new record for the app, if you assign it to a security group, the system checks if the user has a license for a corresponding Web Central application. See Licensing and Security for New Mobile Apps

    • activity_id: the app's activity code. This is the unique identifier for the app.
  3. You can now set the new icon for the app. You set a new app icon in the AppLauncher.ui.IconData.js class. A default icon is supplied if you do not configure an icon for the app.