usage of onscreenapp
===

## dependence

- Onscreenapp depend on libhomescreen add agl-service-homescreen as below:
	- libhomescreen must have 'showWindow/hideWindow/replyShowWindow' event 
		and 'showWindow/hideWindow/replyShowWindow' interface.
	- agl-service-homescreen must have 'showWindow/hideWindow/replyShowWindow' verbs.

- Application need to deploy their onscreen qml file to "/usr/lib/qt5/qml/AGL/OnScreen/appid/" folder.

## sequence

show/hide onscreen sequence.
- ![showOnscreen.svg](parts/showOnscreen.svg)

## about sample 'onstestapp'
onstestapp is a sample to use onscreenapp.

### compile & install
- compile
	- when onscreenapp is compiled, this app's wgt file will exist at "onscreenapp/sample/package" which called onstestapp.wgt.

- install
		`afm-util install onstestapp.wgt;sync`

### onstestapp usage

Before start onstestapp you must copy all files in "qml" folder to "/usr/lib/qt5/qml/AGL/OnScreen/onstestapp/" on your board(R-car M3 etc.),
then do as below:

1. start onstestapp in launcher
2. select onscreen type
3. press "Post" button

### edit parameter with keyboard

You also can edit the text which will post to onscreen, do as below:

- comment below contents in /etc/xdg/weston/weston.ini
	- `#ivi-input-module=ivi-input-controller.so`

- before press "Post" button, touch text area to call keyboard and edit the text.