Setting the Home application on the Concierge

Version 14

    Setting the Home application through the UI

     

    The guest-mode Home application (the Home application for standard users, neither admin nor employee) can be set through the Settings application.

     

    • Login to the Admin mode.
      • Long-press in the lower-right-hand corner until the PIN code entry box comes up.
      • Enter the Admin PIN code (default is 5678).
    • Touch the clock display in the lower right-hand corner.
    • Select Settings.
    • Select Users.
    • Select Home Screen under GUEST USER.
    • Choose the application that you want to be your guest-mode Home application.
      • Only applications (technically, Activities) built as a Home/Launcher will be displayed in the list.  See below for details on how to build your application this way.

     

    The admin and employee Home applications can also be set through the Settings application.

     

    • Login to the Admin mode.
      • Long-press in the lower-right-hand corner until the PIN code entry box comes up.
      • Enter the Admin PIN code (default is 5678).
    • Touch the clock display in the lower right-hand corner.
    • Select Settings.
    • Select Users.
    • Select Home Screen under ADMIN or EMPLOYEE.
    • Choose the application that you want to be your guest-mode Home application.
      • Only applications (technically, Activities) built as a Home/Launcher will be displayed in the list.  See below for details on how to build your application this way.

     

     

     

    Building your application to be a Home application

     

    I have attached the sample Home application source that comes with the Android SDK (Home.zip).  You can find this attachment at the bottom of this document.  For more details, please see the helpful links below.

     

    Youtube series for creating a custom home screen:

    http://www.youtube.com/watch?v=vlGEAqlBSzc

    http://www.youtube.com/watch?v=pFhJXkQKk6g

    http://www.youtube.com/watch?v=SiNXupewSc0

    http://www.youtube.com/watch?v=_d3uVT4dyoA

    http://www.youtube.com/watch?v=bdLyYZuuJ1o

    http://www.youtube.com/watch?v=3o5zp974pi4

    http://www.youtube.com/watch?v=WfeI5r2x3W8

    http://www.youtube.com/watch?v=StIx_YY0NYA

    http://www.youtube.com/watch?v=8DvSTQkewXM

    http://www.youtube.com/watch?v=kxmfieg982k

    http://www.youtube.com/watch?v=ztgsZwJJNFY

     

     

     

     

    Setting the Home application via MDZ

     

    The Home application can be set via MDZ by constructing an MDZ package that contains a user_groups.xml file for the UPDATE_USER_GROUPS action.  A sample management folder structure that can be built into an MDZ for this purpose is attached to this document (Home_App_mgmt.zip).  You can find this attachment at the bottom of this document.  Use this sample as a reference for the structure of the directory that needs to be passed into the Management Package Builder tool as described on this page.

     

    The contents of the sample user_groups.xml file is shown below.  For the guest-mode Home application, place the Component name for the Activity that you desire into the guestHome attribute of the <user_groups> tag.  For the admin or employee Home application, instead focus on the home attribute of their respective <user_group> tags.

     

    <user_groups

      version="1.0"

      guestHome="com.motorola.asds.isign.home/.Home">

     

     

           <!-- Employee usergroup -->

           <user_group

                id="0"

                name="employee"

                home="com.android.launcher/com.android.launcher2.Launcher">

     

     

                <operations>

                     <operation name="access_launcher" />

                     <operation name="access_full_browser" />

                </operations>

           </user_group>

     

     

           <!-- Admin usergroup -->

           <user_group

                id="1"

                name="admin"

                home="com.android.launcher/com.android.launcher2.Launcher">

     

     

                <operations>

                     <operation name="access_launcher" />

                     <operation name="access_full_browser" />

                     <operation name="access_system_settings" />

                     <operation name="install_package" />

                     <operation name="uninstall_package" />

                 </operations>

           </user_group>

    </user_groups>