How to Configure Home Settings in poshomesettings.xml

You can configure some home settings in poshomesettings.xml.

poshomesettings.xml default file download

Please remove the suffix of each default sample and keep the name as poshomesettings.xml

poshomesettings.xml file description

for Q1: style is android

<?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: style is clarity

<?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: style is metro

<?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/equals 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>

update process

Create the folder:

1) \wizarpos\homesettings\homesettings_XXX\, XXX default is wizarpos, please check the kernel version, it includes splash=XXX, this values is same with the splash value.

2) Or \cloudpos\, this is only supported in PosSysAssistant app version > 2.11.8

Copy the poshomesettings.xml to this folder, then update, the process is like install APK or update firmware.

Update from wizarview

Upload poshomesettings.xml to WizarView:

1. Add a new parameter file name in WizarView.
   1. Click Applications>Application.
   2. Click + icon in the left bottom of the tool box, popup an edit window.
   3. In the edit window, write the name and other input area, then select type param.
   4. Input the package name(com.wizarpos.android.home) and parameter file name(poshomesettings.xml).
   5. Click Commit button.
2. Click Search button in the Applications>Application page.
3. Select the parameter file name in the list.
4. Select config icon in the right bottom of the tool box.
5. Select Upload button in the popup window.
6. Choose the upload file, then click Commit button.

The parameter file has configured in WizarView now.

The pushing process is as same as pushing an app. Please follow Wizarview user manual to configure it and push it to a terminal