Add a new OnScreenReply api to agl-service-homescreeneel_4.99.2eel/4.99.24.99.2

    Add a new event named OnScreenReply. Applications
    can use this event to reply to the homescreen.
    Also update the documentation for this event.

    [Patch Sets 8,9]
    Update ApplicationGuide.md. For details:
        Use master source build agl-service-homescreen-2017.
        Change agl version to EE.
        Add libhomescreen sample code path.

    [Patch Sets 10]
    Delete tailing space.

BUG-AGL: SPEC-985
Change-Id: Iea0c321731fa62cd94fc08fc5e303c20847fd525
Signed-off-by: zheng_wenlong <wenlong_zheng@nexty-ele.com>

1 files changed, 27 insertions, 0 deletions

diff --git a/doc/parts/initialize-set-event-handler.svg b/doc/parts/initialize-set-event-handler.svg
new file mode 100644
index 0000000..176ec1f
--- /dev/null
+++ b/doc/parts/initialize-set-event-handler.svg
@@ -0,0 +1,27 @@
+<?xml version="1.0" encoding="UTF-8" standalone="no"?><svg xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" contentScriptType="application/ecmascript" contentStyleType="text/css" height="301px" preserveAspectRatio="none" style="width:452px;height:301px;" version="1.1" viewBox="0 0 452 301" width="452px" zoomAndPan="magnify"><defs><filter height="300%" id="fo5flcejoga9p" width="300%" x="-1" y="-1"><feGaussianBlur result="blurOut" stdDeviation="2.0"/><feColorMatrix in="blurOut" result="blurOut2" type="matrix" values="0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 .4 0"/><feOffset dx="4.0" dy="4.0" in="blurOut2" result="blurOut3"/><feBlend in="SourceGraphic" in2="blurOut3" mode="normal"/></filter></defs><g><text fill="#000000" font-family="sans-serif" font-size="14" font-weight="bold" lengthAdjust="spacingAndGlyphs" textLength="428" x="12" y="22.9951">Application initialization phase (ex. set_event_handler)</text><line style="stroke: #A80036; stroke-width: 1.0; stroke-dasharray: 5.0,5.0;" x1="57.5" x2="57.5" y1="81.5938" y2="244.3906"/><line style="stroke: #A80036; stroke-width: 1.0; stroke-dasharray: 5.0,5.0;" x1="209.5" x2="209.5" y1="81.5938" y2="244.3906"/><line style="stroke: #A80036; stroke-width: 1.0; stroke-dasharray: 5.0,5.0;" x1="350.5" x2="350.5" y1="81.5938" y2="244.3906"/><text fill="#000000" font-family="sans-serif" font-size="14" lengthAdjust="spacingAndGlyphs" textLength="27" x="41.5" y="78.292">App</text><ellipse cx="58" cy="49.2969" fill="#FEFECE" filter="url(#fo5flcejoga9p)" rx="12" ry="12" style="stroke: #A80036; stroke-width: 2.0;"/><line style="stroke: #A80036; stroke-width: 2.0;" x1="46" x2="70" y1="63.2969" y2="63.2969"/><text fill="#000000" font-family="sans-serif" font-size="14" lengthAdjust="spacingAndGlyphs" textLength="27" x="41.5" y="256.3857">App</text><ellipse cx="58" cy="275.6875" fill="#FEFECE" filter="url(#fo5flcejoga9p)" rx="12" ry="12" style="stroke: #A80036; stroke-width: 2.0;"/><line style="stroke: #A80036; stroke-width: 2.0;" x1="46" x2="70" y1="289.6875" y2="289.6875"/><text fill="#000000" font-family="sans-serif" font-size="14" lengthAdjust="spacingAndGlyphs" textLength="135" x="139.5" y="78.292">HomeScreenBinder</text><ellipse cx="210" cy="49.2969" fill="#FEFECE" filter="url(#fo5flcejoga9p)" rx="12" ry="12" style="stroke: #A80036; stroke-width: 2.0;"/><line style="stroke: #A80036; stroke-width: 2.0;" x1="198" x2="222" y1="63.2969" y2="63.2969"/><text fill="#000000" font-family="sans-serif" font-size="14" lengthAdjust="spacingAndGlyphs" textLength="135" x="139.5" y="256.3857">HomeScreenBinder</text><ellipse cx="210" cy="275.6875" fill="#FEFECE" filter="url(#fo5flcejoga9p)" rx="12" ry="12" style="stroke: #A80036; stroke-width: 2.0;"/><line style="stroke: #A80036; stroke-width: 2.0;" x1="198" x2="222" y1="289.6875" y2="289.6875"/><text fill="#000000" font-family="sans-serif" font-size="14" lengthAdjust="spacingAndGlyphs" textLength="114" x="290.5" y="78.292">HomeScreenGUI</text><ellipse cx="350.5" cy="49.2969" fill="#FEFECE" filter="url(#fo5flcejoga9p)" rx="12" ry="12" style="stroke: #A80036; stroke-width: 2.0;"/><line style="stroke: #A80036; stroke-width: 2.0;" x1="338.5" x2="362.5" y1="63.2969" y2="63.2969"/><text fill="#000000" font-family="sans-serif" font-size="14" lengthAdjust="spacingAndGlyphs" textLength="114" x="290.5" y="256.3857">HomeScreenGUI</text><ellipse cx="350.5" cy="275.6875" fill="#FEFECE" filter="url(#fo5flcejoga9p)" rx="12" ry="12" style="stroke: #A80036; stroke-width: 2.0;"/><line style="stroke: #A80036; stroke-width: 2.0;" x1="338.5" x2="362.5" y1="289.6875" y2="289.6875"/><polygon fill="#A80036" points="198,108.5938,208,112.5938,198,116.5938,202,112.5938" style="stroke: #A80036; stroke-width: 1.0;"/><line style="stroke: #A80036; stroke-width: 1.0;" x1="58" x2="204" y1="112.5938" y2="112.5938"/><text fill="#000000" font-family="sans-serif" font-size="13" lengthAdjust="spacingAndGlyphs" textLength="99" x="65" y="107.6606">init(port, token)</text><polygon fill="#A80036" points="198,137.7266,208,141.7266,198,145.7266,202,141.7266" style="stroke: #A80036; stroke-width: 1.0;"/><line style="stroke: #A80036; stroke-width: 1.0;" x1="58" x2="204" y1="141.7266" y2="141.7266"/><text fill="#000000" font-family="sans-serif" font-size="13" lengthAdjust="spacingAndGlyphs" textLength="128" x="65" y="136.7935">set_event_handler()</text><polygon fill="#FBFB77" filter="url(#fo5flcejoga9p)" points="49.5,154.8594,49.5,224.8594,365.5,224.8594,365.5,164.8594,355.5,154.8594,49.5,154.8594" style="stroke: #A80036; stroke-width: 1.0;"/><line style="stroke: #A80036; stroke-width: 1.0;" x1="355.5" x2="355.5" y1="154.8594" y2="164.8594"/><line style="stroke: #A80036; stroke-width: 1.0;" x1="365.5" x2="355.5" y1="164.8594" y2="164.8594"/><text fill="#000000" font-family="sans-serif" font-size="13" lengthAdjust="spacingAndGlyphs" textLength="295" x="55.5" y="171.9263">setup event handler the App wishes to receive</text><text fill="#000000" font-family="sans-serif" font-size="13" lengthAdjust="spacingAndGlyphs" textLength="244" x="55.5" y="187.0591">・LibHomeScreen::Event_TapShortcut</text><text fill="#000000" font-family="sans-serif" font-size="13" lengthAdjust="spacingAndGlyphs" textLength="286" x="55.5" y="202.1919">・LibHomeScreen::Event_OnScreenMessage</text><text fill="#000000" font-family="sans-serif" font-size="13" lengthAdjust="spacingAndGlyphs" textLength="263" x="55.5" y="217.3247">・LibHomeScreen::Event_OnScreenReply</text><!--
+@startuml

+title Application initialization phase (ex. set_event_handler)

+entity App

+entity HomeScreenBinder

+entity HomeScreenGUI

+App->HomeScreenBinder: init(port, token)

+App->HomeScreenBinder: set_event_handler()

+

+note over HomeScreenBinder

+    setup event handler the App wishes to receive

+    ・LibHomeScreen::Event_TapShortcut

+    ・LibHomeScreen::Event_OnScreenMessage

+    ・LibHomeScreen::Event_OnScreenReply

+end note

+@enduml

+
+PlantUML version 1.2017.18(Fri Oct 06 16:56:32 UTC 2017)
+(GPL source distribution)
+Java Runtime: Java(TM) SE Runtime Environment
+JVM: Java HotSpot(TM) 64-Bit Server VM
+Java Version: 1.7.0_25-b15
+Operating System: Linux
+Default Encoding: UTF-8
+Language: en
+Country: US
+--></g></svg>
\ No newline at end of file