From 134be0531d2aa3926bb6ed441c7839174a8bba17 Mon Sep 17 00:00:00 2001
From: wang_zhiqiang <wang_zhiqiang@dl.cn.nexty-ele.com>
Date: Wed, 10 Apr 2019 17:36:11 +0800
Subject: modify

add wm proxy
add read/write json file
add getRunnables to ApplicationGuide.md

Change-Id: I65e9e6620ecb207c999e590410782590edd7005d
---
 doc/ApplicationGuide.md    |  8 ++++++++
 doc/parts/getRunnables.svg | 45 +++++++++++++++++++++++++++++++++++++++++++++
 2 files changed, 53 insertions(+)
 create mode 100644 doc/parts/getRunnables.svg

(limited to 'doc')

diff --git a/doc/ApplicationGuide.md b/doc/ApplicationGuide.md
index 9c5c409..34b8a14 100644
--- a/doc/ApplicationGuide.md
+++ b/doc/ApplicationGuide.md
@@ -28,6 +28,7 @@
     - [ShowOnscreen](###ShowOnscreen\ Sequence)
     - [ShowNotification](###ShowNotification\ Sequence)
     - [ShowInformation](###ShowInformation\ Sequence)
+    - [GetRunnables](###GetRunnables\ Sequence)
 - [Sample code](#Sample\ code)
 - [Limitation](#Limitation)
 - [Next Plan](#Next\ Plan)
@@ -189,6 +190,9 @@ See also our [Sample code](#Sample\ code).
 8. Show Information on HomeScreenGUI
     - When application who want to display a information,it can call "showInformation",then HomeScreenGUI will
         display the information contents on the screen bottom area.
+9. Get runnables list
+    - When launcher starting, it want to get runnalbes list,it can call "getRunnables",then launcher will
+        receive the runnalbes list in reply.
 * * *
 
 <div id="Software\ Architecture"></div>
@@ -275,6 +279,10 @@ The communication protocols between libhomescreen and upper binder, upper binder
 ### ShowInformation Sequence
 ![showInformation.svg](parts/showInformation.svg)
 
+<div id="GetRunnablesSequence"></div>
+
+### GetRunnables Sequence
+![getRunnables.svg](parts/getRunnables.svg)
 
 <div id="Sample\ code"></div>
 
diff --git a/doc/parts/getRunnables.svg b/doc/parts/getRunnables.svg
new file mode 100644
index 0000000..3b342f8
--- /dev/null
+++ b/doc/parts/getRunnables.svg
@@ -0,0 +1,45 @@
+<?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="578px" preserveAspectRatio="none" style="width:591px;height:578px;" version="1.1" viewBox="0 0 591 578" width="591px" zoomAndPan="magnify"><defs><filter height="300%" id="f1l9mb3ztqbpmo" 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="206" x="193.5" y="24.5332">got runnables list in launcher</text><rect fill="#FFFFFF" filter="url(#f1l9mb3ztqbpmo)" height="201.1094" style="stroke: #A80036; stroke-width: 1.0;" width="10" x="137" y="293.625"/><rect fill="#FFFFFF" filter="url(#f1l9mb3ztqbpmo)" height="140.0547" style="stroke: #A80036; stroke-width: 1.0;" width="10" x="394" y="116.2188"/><rect fill="#FFFFFF" filter="url(#f1l9mb3ztqbpmo)" height="91.0547" style="stroke: #A80036; stroke-width: 1.0;" width="10" x="394" y="367.3281"/><rect fill="#FFFFFF" filter="url(#f1l9mb3ztqbpmo)" height="30" style="stroke: #A80036; stroke-width: 1.0;" width="10" x="548" y="189.9219"/><line style="stroke: #A80036; stroke-width: 1.0; stroke-dasharray: 5.0,5.0;" x1="37" x2="37" y1="84.2188" y2="520.0859"/><line style="stroke: #A80036; stroke-width: 1.0; stroke-dasharray: 5.0,5.0;" x1="141.5" x2="141.5" y1="84.2188" y2="520.0859"/><line style="stroke: #A80036; stroke-width: 1.0; stroke-dasharray: 5.0,5.0;" x1="399" x2="399" y1="84.2188" y2="520.0859"/><line style="stroke: #A80036; stroke-width: 1.0; stroke-dasharray: 5.0,5.0;" x1="553" x2="553" y1="84.2188" y2="520.0859"/><text fill="#000000" font-family="sans-serif" font-size="14" lengthAdjust="spacingAndGlyphs" textLength="52" x="8" y="81.1426">systemd</text><ellipse cx="37" cy="50.6094" fill="#FEFECE" filter="url(#f1l9mb3ztqbpmo)" rx="12" ry="12" style="stroke: #A80036; stroke-width: 2.0;"/><line style="stroke: #A80036; stroke-width: 2.0;" x1="25" x2="49" y1="64.6094" y2="64.6094"/><text fill="#000000" font-family="sans-serif" font-size="14" lengthAdjust="spacingAndGlyphs" textLength="52" x="8" y="533.6191">systemd</text><ellipse cx="37" cy="552.6953" fill="#FEFECE" filter="url(#f1l9mb3ztqbpmo)" rx="12" ry="12" style="stroke: #A80036; stroke-width: 2.0;"/><line style="stroke: #A80036; stroke-width: 2.0;" x1="25" x2="49" y1="566.6953" y2="566.6953"/><text fill="#000000" font-family="sans-serif" font-size="14" lengthAdjust="spacingAndGlyphs" textLength="55" x="111.5" y="81.1426">launcher</text><ellipse cx="142" cy="50.6094" fill="#FEFECE" filter="url(#f1l9mb3ztqbpmo)" rx="12" ry="12" style="stroke: #A80036; stroke-width: 2.0;"/><line style="stroke: #A80036; stroke-width: 2.0;" x1="130" x2="154" y1="64.6094" y2="64.6094"/><text fill="#000000" font-family="sans-serif" font-size="14" lengthAdjust="spacingAndGlyphs" textLength="55" x="111.5" y="533.6191">launcher</text><ellipse cx="142" cy="552.6953" fill="#FEFECE" filter="url(#f1l9mb3ztqbpmo)" rx="12" ry="12" style="stroke: #A80036; stroke-width: 2.0;"/><line style="stroke: #A80036; stroke-width: 2.0;" x1="130" x2="154" y1="566.6953" y2="566.6953"/><text fill="#000000" font-family="sans-serif" font-size="14" lengthAdjust="spacingAndGlyphs" textLength="128" x="332" y="81.1426">homescreen-service</text><ellipse cx="399" cy="50.6094" fill="#FEFECE" filter="url(#f1l9mb3ztqbpmo)" rx="12" ry="12" style="stroke: #A80036; stroke-width: 2.0;"/><line style="stroke: #A80036; stroke-width: 2.0;" x1="387" x2="411" y1="64.6094" y2="64.6094"/><text fill="#000000" font-family="sans-serif" font-size="14" lengthAdjust="spacingAndGlyphs" textLength="128" x="332" y="533.6191">homescreen-service</text><ellipse cx="399" cy="552.6953" fill="#FEFECE" filter="url(#f1l9mb3ztqbpmo)" rx="12" ry="12" style="stroke: #A80036; stroke-width: 2.0;"/><line style="stroke: #A80036; stroke-width: 2.0;" x1="387" x2="411" y1="566.6953" y2="566.6953"/><text fill="#000000" font-family="sans-serif" font-size="14" lengthAdjust="spacingAndGlyphs" textLength="58" x="521" y="81.1426">afm-main</text><ellipse cx="553" cy="50.6094" fill="#FEFECE" filter="url(#f1l9mb3ztqbpmo)" rx="12" ry="12" style="stroke: #A80036; stroke-width: 2.0;"/><line style="stroke: #A80036; stroke-width: 2.0;" x1="541" x2="565" y1="64.6094" y2="64.6094"/><text fill="#000000" font-family="sans-serif" font-size="14" lengthAdjust="spacingAndGlyphs" textLength="58" x="521" y="533.6191">afm-main</text><ellipse cx="553" cy="552.6953" fill="#FEFECE" filter="url(#f1l9mb3ztqbpmo)" rx="12" ry="12" style="stroke: #A80036; stroke-width: 2.0;"/><line style="stroke: #A80036; stroke-width: 2.0;" x1="541" x2="565" y1="566.6953" y2="566.6953"/><rect fill="#FFFFFF" filter="url(#f1l9mb3ztqbpmo)" height="201.1094" style="stroke: #A80036; stroke-width: 1.0;" width="10" x="137" y="293.625"/><rect fill="#FFFFFF" filter="url(#f1l9mb3ztqbpmo)" height="140.0547" style="stroke: #A80036; stroke-width: 1.0;" width="10" x="394" y="116.2188"/><rect fill="#FFFFFF" filter="url(#f1l9mb3ztqbpmo)" height="91.0547" style="stroke: #A80036; stroke-width: 1.0;" width="10" x="394" y="367.3281"/><rect fill="#FFFFFF" filter="url(#f1l9mb3ztqbpmo)" height="30" style="stroke: #A80036; stroke-width: 1.0;" width="10" x="548" y="189.9219"/><polygon fill="#A80036" points="382,112.2188,392,116.2188,382,120.2188,386,116.2188" style="stroke: #A80036; stroke-width: 1.0;"/><line style="stroke: #A80036; stroke-width: 1.0; stroke-dasharray: 2.0,2.0;" x1="37" x2="388" y1="116.2188" y2="116.2188"/><text fill="#000000" font-family="sans-serif" font-size="13" lengthAdjust="spacingAndGlyphs" textLength="147" x="44" y="111.7139">exec homescreen-service</text><line style="stroke: #A80036; stroke-width: 1.0;" x1="404" x2="446" y1="146.9219" y2="146.9219"/><line style="stroke: #A80036; stroke-width: 1.0;" x1="446" x2="446" y1="146.9219" y2="159.9219"/><line style="stroke: #A80036; stroke-width: 1.0;" x1="405" x2="446" y1="159.9219" y2="159.9219"/><polygon fill="#A80036" points="415,155.9219,405,159.9219,415,163.9219,411,159.9219" style="stroke: #A80036; stroke-width: 1.0;"/><text fill="#000000" font-family="sans-serif" font-size="13" lengthAdjust="spacingAndGlyphs" textLength="25" x="411" y="142.0654">init()</text><polygon fill="#A80036" points="536,185.9219,546,189.9219,536,193.9219,540,189.9219" style="stroke: #A80036; stroke-width: 1.0;"/><line style="stroke: #A80036; stroke-width: 1.0;" x1="404" x2="542" y1="189.9219" y2="189.9219"/><text fill="#000000" font-family="sans-serif" font-size="13" lengthAdjust="spacingAndGlyphs" textLength="99" x="411" y="185.417">got runnables list</text><line style="stroke: #A80036; stroke-width: 1.0;" x1="404" x2="446" y1="255.625" y2="255.625"/><line style="stroke: #A80036; stroke-width: 1.0;" x1="446" x2="446" y1="255.625" y2="268.625"/><line style="stroke: #A80036; stroke-width: 1.0;" x1="399" x2="446" y1="268.625" y2="268.625"/><polygon fill="#A80036" points="409,264.625,399,268.625,409,272.625,405,268.625" style="stroke: #A80036; stroke-width: 1.0;"/><text fill="#000000" font-family="sans-serif" font-size="13" lengthAdjust="spacingAndGlyphs" textLength="130" x="411" y="250.7686">maintain runnables list</text><polygon fill="#A80036" points="125,289.625,135,293.625,125,297.625,129,293.625" style="stroke: #A80036; stroke-width: 1.0;"/><line style="stroke: #A80036; stroke-width: 1.0; stroke-dasharray: 2.0,2.0;" x1="37" x2="131" y1="293.625" y2="293.625"/><text fill="#000000" font-family="sans-serif" font-size="13" lengthAdjust="spacingAndGlyphs" textLength="81" x="44" y="289.1201">exec launcher</text><line style="stroke: #A80036; stroke-width: 1.0;" x1="147" x2="189" y1="324.3281" y2="324.3281"/><line style="stroke: #A80036; stroke-width: 1.0;" x1="189" x2="189" y1="324.3281" y2="337.3281"/><line style="stroke: #A80036; stroke-width: 1.0;" x1="148" x2="189" y1="337.3281" y2="337.3281"/><polygon fill="#A80036" points="158,333.3281,148,337.3281,158,341.3281,154,337.3281" style="stroke: #A80036; stroke-width: 1.0;"/><text fill="#000000" font-family="sans-serif" font-size="13" lengthAdjust="spacingAndGlyphs" textLength="17" x="154" y="319.4717">init</text><polygon fill="#A80036" points="382,363.3281,392,367.3281,382,371.3281,386,367.3281" style="stroke: #A80036; stroke-width: 1.0;"/><line style="stroke: #A80036; stroke-width: 1.0; stroke-dasharray: 2.0,2.0;" x1="147" x2="388" y1="367.3281" y2="367.3281"/><text fill="#000000" font-family="sans-serif" font-size="13" lengthAdjust="spacingAndGlyphs" textLength="198" x="154" y="362.8232">set_event_handler("showWindow")</text><polygon fill="#A80036" points="382,393.6797,392,397.6797,382,401.6797,386,397.6797" style="stroke: #A80036; stroke-width: 1.0;"/><line style="stroke: #A80036; stroke-width: 1.0; stroke-dasharray: 2.0,2.0;" x1="147" x2="388" y1="397.6797" y2="397.6797"/><text fill="#000000" font-family="sans-serif" font-size="13" lengthAdjust="spacingAndGlyphs" textLength="223" x="154" y="393.1748">set_event_handler("app_list_changed")</text><polygon fill="#A80036" points="382,424.0313,392,428.0313,382,432.0313,386,428.0313" style="stroke: #A80036; stroke-width: 1.0;"/><line style="stroke: #A80036; stroke-width: 1.0; stroke-dasharray: 2.0,2.0;" x1="147" x2="388" y1="428.0313" y2="428.0313"/><text fill="#000000" font-family="sans-serif" font-size="13" lengthAdjust="spacingAndGlyphs" textLength="99" x="154" y="423.5264">got runnables list</text><polygon fill="#A80036" points="158,454.3828,148,458.3828,158,462.3828,154,458.3828" style="stroke: #A80036; stroke-width: 1.0;"/><line style="stroke: #A80036; stroke-width: 1.0; stroke-dasharray: 2.0,2.0;" x1="152" x2="398" y1="458.3828" y2="458.3828"/><text fill="#000000" font-family="sans-serif" font-size="13" lengthAdjust="spacingAndGlyphs" textLength="145" x="164" y="453.8779">set runnables list in reply</text><line style="stroke: #A80036; stroke-width: 1.0;" x1="147" x2="189" y1="494.0859" y2="494.0859"/><line style="stroke: #A80036; stroke-width: 1.0;" x1="189" x2="189" y1="494.0859" y2="507.0859"/><line style="stroke: #A80036; stroke-width: 1.0;" x1="142" x2="189" y1="507.0859" y2="507.0859"/><polygon fill="#A80036" points="152,503.0859,142,507.0859,152,511.0859,148,507.0859" style="stroke: #A80036; stroke-width: 1.0;"/><text fill="#000000" font-family="sans-serif" font-size="13" lengthAdjust="spacingAndGlyphs" textLength="144" x="154" y="489.2295">update application model</text><!--
+@startuml
+
+title got runnables list in launcher
+
+entity systemd
+entity launcher
+entity "homescreen-service" as hss
+entity "afm-main" as afm
+
+
+systemd- ->hss: exec homescreen-service
+activate hss
+hss->hss: init()
+hss->afm: got runnables list
+activate afm
+deactivate afm
+hss->hss: maintain runnables list
+deactivate hss
+
+systemd- ->launcher: exec launcher
+activate launcher
+launcher->launcher: init
+launcher- ->hss: set_event_handler("showWindow")
+activate hss
+launcher- ->hss: set_event_handler("app_list_changed")
+launcher- ->hss: got runnables list
+hss- ->launcher: set runnables list in reply
+deactivate hss
+launcher->launcher: update application model
+deactivate launcher
+
+@enduml
+
+PlantUML version 1.2018.01(Mon Jan 29 02:08:22 CST 2018)
+(GPL source distribution)
+Java Runtime: Java(TM) SE Runtime Environment
+JVM: Java HotSpot(TM) 64-Bit Server VM
+Java Version: 1.8.0_201-b09
+Operating System: Windows 7
+OS Version: 6.1
+Default Encoding: MS932
+Language: ja
+Country: JP
+--></g></svg>
\ No newline at end of file
-- 
cgit 1.2.3-korg