How to Configure Home Settings in poshomesettings.xml

Downloading the Default poshomesettings.xml File

Download the default file and rename it to poshomesettings.xml by removing any suffixes.

File Description

• For Q1 Models: Use the 'android' style.

<?xml version="1.0" encoding="utf-8"?>
<!--
style: launcher theme, Q1 default is 'android'.
indicatorColor: Page indicator color of the selected page.
itemBackground: The style 'android' does not support this feature.
pageStatus: page indicator location, up / down
topBackgroundColor: the background color of favoritebar
versionCode: When update, the versionCode should larger/equals than the previous in the system.
-->
<desktop
    style="android"
    indicatorColor="4FA2FF"
    itemBackground="false"
    pageStatus="down"
    topBackgroundColor="00BFFF"
    versionCode="2" >

    <!--
    Some special application you want to define.
	cols: How many cols display in one page, Q1 default is 4.
	iconheight: Q1 default is 96.
	iconwidth: Q1 default is 96.
	rows: How many rows display in one page, Q1 default is 3.
    -->
    <applications
        cols="4"
        iconheight="96"
        iconwidth="96"
        rows="3" >

        <!--
		class: app class name, if only one entrance of the package, it can be empty.
		col: at which column.
		package: app package name.
		page: at which page.
		row: at which row.
		columnSpan: icon item span columns, default is 1.
		type: app or clock, default is app. Type clock will display a digital clock in home screen.
        -->
        <application
            class=""
            col="1"
            columnSpan="2"
            package="com.moji.mjweather"
            page="3"
            row="1"
            type="app" />
    </applications>
    <!--
    Define favorite bar.
	cols: How many columns.
    -->
    <favoritebar cols="3" >

        <!--
		class: app class name, if only one entrance of the package, it can be empty.
		col: at which column
		package: app package name
        -->
        <application
            class="com.example.testEditText.FirstActivity"
            col="3"
            package="com.example.testEditText" />
        <application
            class=""
            col="2"
            package="cn.kuwo.player" />
        <application
            class=""
            col="1"
            package="com.sohu.inputmethod.sogou" />
    </favoritebar>
    <!-- Define hidden applications. -->
    <hiddenapplications>

        <!--
		package: app package name, if only set this, all the entrance of this package will be hide; if only one entrance, just set package name.
		class: app class name, if only one entrance of the package, it can be empty.
        -->
        <application
            class=""
            package="com.example.realfullscreensample" />
    </hiddenapplications>

</desktop>

• For Q1V2 Models: Use the 'clarity' style.

<?xml version="1.0" encoding="utf-8"?>
<!--
style: launcher theme, Q1V2 default is 'clarity'.
indicatorColor: Page indicator color of the selected page.
itemBackground: Whether set icon item background color.
pageStatus: page indicator location, up / down
versionCode: When update, the versionCode should larger/equals than the previous in the system.
-->
<desktop
    style="clarity"
    indicatorColor="4FA2FF"
    itemBackground="true"
    pageStatus="down"
    versionCode="2" >

    <!--
    Some special application you want to define.
	cols: How many cols display in one page, Q1V2 default is 2.
	iconheight: Q1V2 default is 72.
	iconwidth: Q1V2 default is 72.
	rows: How many rows display in one page, Q1V2 default is 3.
    -->
    <applications
        cols="2"
        iconheight="72"
        iconwidth="72"
        rows="3" >

        <!--
		backgroundColor: icon item background color.
		class: app class name, if only one entrance of the package, it can be empty.
		col: at which column.
		package: app package name.
		page: at which page.
		row: at which row.
		columnSpan: icon item span columns, default is 1.
		type: app or clock, default is app. Type clock will display a digital clock in home screen.
        -->
        <application
            backgroundColor="20A2DE"
            class=""
            col="1"
            columnSpan="2"
            package="com.moji.mjweather"
            page="3"
            row="1"
            type="app" />
    </applications>
    <!-- This feature was removed in style 'clarity'. -->
    <favoritebar cols="0" />
    <!-- Define hidden applications. -->
    <hiddenapplications>

        <!--
		package: app package name, if only set this, all the entrance of this package will be hide; if only one entrance, just set package name.
		class: app class name, if only one entrance of the package, it can be empty.
        -->
        <application
            class=""
            package="com.example.realfullscreensample" />
    </hiddenapplications>

</desktop>

• For Q2/Q2A7/Q3/Q3K Models: Use the 'metro' style.

<?xml version="1.0" encoding="utf-8"?>
<!--
style: launcher theme, Q2/Q2A7/Q3/Q3K default is 'metro'.
indicatorColor: The RGB value of the page indicator color of the selected page.
itemBackground: Whether set icon item background color.
pageStatus: page indicator location, up / down
title: Merchant or store name, or other.
titleGravity: title location, left / center / right.
topBackgroundColor: the RGB value of the background color of title and favoritebar
versionCode: When update, the versionCode should larger than the previous in the system.
-->
<desktop
    style="metro"
    indicatorColor="4FA2FF"
    itemBackground="true"
    pageStatus="down"
    title="WizarPOS"
    titleGravity="left"
    topBackgroundColor="00BFFF"
    versionCode="2" >

    <!--
    Some special application you want to define.
	cols: How many cols display in one page, default is 2.
	iconheight: Q2/Q2A7 default is 144, Q3 default is 96, Q3K default is 72.
	iconwidth: Q2/Q2A7 default is 144, Q3 default is 96, Q3K default is 72.
	rows: How many rows display in one page, Q2/Q2A7 default is 4, Q3/Q3K default is 3.
    -->
    <applications
        cols="2"
        iconheight="144"
        iconwidth="144"
        rows="4" >

        <!--
		backgroundColor: icon item background color.
		class: app class name, if only one entrance of the package, it can be empty.
		col: at which column.
		package: app package name.
		page: at which page.
		row: at which row.
		columnSpan: icon item span columns, default is 1.
		type: app or clock, default is app. Type clock will display a digital clock in home screen.
        -->
        <application
            backgroundColor="20A2DE"
            class=""
            col="1"
            columnSpan="2"
            package="com.moji.mjweather"
            page="3"
            row="1"
            type="app" />
    </applications>
    <!--
    Define favorite bar.
	cols: How many columns.
    -->
    <favoritebar cols="3" >

        <!--
		class: app class name, if only one entrance of the package, it can be empty.
		col: at which column
		package: app package name
        -->
        <application
            class="com.example.testEditText.FirstActivity"
            col="3"
            package="com.example.testEditText" />
        <application
            class=""
            col="2"
            package="cn.kuwo.player" />
        <application
            class=""
            col="1"
            package="com.sohu.inputmethod.sogou" />
    </favoritebar>
    <!-- Define hidden applications. -->
    <hiddenapplications>

        <!--
		package: app package name, if only set this, all the entrance of this package will be hide; if only one entrance, just set package name.
		class: app class name, if only one entrance of the package, it can be empty.
        -->
        <application
            class=""
            package="com.example.realfullscreensample" />
    </hiddenapplications>

</desktop>

Updating Process via TF Card or Thumb Drive

1. Folder Creation:
   • On a TF Card: Create a folder named '\wizarpos\homesettings\homesettings_XXX\'. 'XXX' is typically 'wizarpos', matching the 'ro.wp.logo' property value. Or the same with Thumb Drive as below.
   • On a Thumb Drive: Create a folder named '\cloudpos\'. This is supported in PosSysAssistant app versions greater than 2.11.8.
2. Copying the File:
   • Copy 'poshomesettings.xml' into the folder you created.
   • The update process is similar to installing an APK from a TF card or thumb drive.

Update via WizarView

1. Upload to WizarView:
   • In WizarView, add a new parameter file named 'poshomesettings.xml'.
   • Navigate to Applications > Application.
   • Click the '+' icon, then fill in the details in the pop-up edit window.
   • Select 'param' type, input package name ('com.wizarpos.android.home') and parameter file name ('poshomesettings.xml').
   • Click the 'Commit' button.
2. Configuring the File:
   • In Applications > Application, click the 'Search' button.
   • Select the parameter file from the list.
   • Click the 'config' icon and select 'Upload'.
   • Choose the file for upload and click 'Commit'.
3. Pushing the Configuration:
   • Follow the WizarView user manual for configuring and pushing the configuration to a terminal.