summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorShobhit Adlakha <ShobhitAd@users.noreply.github.com>2020-03-12 13:37:05 -0400
committerGitHub <noreply@github.com>2020-03-12 13:37:05 -0400
commit445794d03f1d17eac21b86d29e74b857cda385c3 (patch)
tree7c36c0a4aa859df41f247a5cb469d67307ca9312
parentbef65ecacb119e2585ec3f09053132a1063bfb66 (diff)
downloadsdl_core-445794d03f1d17eac21b86d29e74b857cda385c3.tar.gz
fix/Move AppProperties struct to the Common interface (#3286)
* Move AppProperties struct to the Common interface * Remove unnecessary response params from SetAppProperties and GetAppProperties response * Add missing description tag * Fix description tag in last commit
-rw-r--r--src/components/interfaces/HMI_API.xml96
1 files changed, 35 insertions, 61 deletions
diff --git a/src/components/interfaces/HMI_API.xml b/src/components/interfaces/HMI_API.xml
index 9e8a32312f..6c5c932c3e 100644
--- a/src/components/interfaces/HMI_API.xml
+++ b/src/components/interfaces/HMI_API.xml
@@ -4131,6 +4131,34 @@
<element name="BOTH"/>
</enum>
+ <struct name="AppProperties">
+ <param name="nicknames" type="String" minlength="0" maxlength="100" array="true" minsize="0" maxsize="100" mandatory="false">
+ <description>An array of app names an app is allowed to register with. If included in a SetAppProperties request, this value will overwrite the existing "nicknames" field in the app policies section of the policy table.</description>
+ </param>
+ <param name="policyAppID" type="String" maxlength="100" minlength="1" mandatory="true" />
+ <param name="enabled" type="Boolean" mandatory="false">
+ <description>If true, the app will be marked as "available" or "installed" and will be included in HMI RPC UpdateAppList.</description>
+ </param>
+ <param name="authToken" type="String" maxlength="65535" mandatory="false">
+ <description>Used to authenticate connection on app activation</description>
+ </param>
+ <param name="transportType" type="String" maxlength="100" mandatory="false">
+ <description>
+ Specifies the connection type Core should use. The Core role (server or client) is dependent of "endpoint" being specified.
+ See "endpoint" for details.
+ </description>
+ </param>
+ <param name="hybridAppPreference" type="Common.HybridAppPreference" mandatory="false">
+ <description>Specifies the user preference to use one specific app type or all available types</description>
+ </param>
+ <param name="endpoint" type="String" maxlength="65535" mandatory="false">
+ <description>
+ If specified, which Core uses a client implementation of the connection type and attempts to connect to the endpoint when this app is selected (activated).
+ If omitted, Core won't attempt to connect as the app selection (activation) is managed outside of Core. Instead it uses a server implementation of the connection type and expects the app to connect.
+ </description>
+ </param>
+ </struct>
+
</interface>
<interface name="Buttons" version="1.3.0" date="2017-07-18">
@@ -4650,59 +4678,17 @@
</param>
</function>
- <struct name="AppProperties">
- <param name="nicknames" type="String" minlength="0" maxlength="100" array="true" minsize="0" maxsize="100" mandatory="false">
- <description>An array of app names an app is allowed to register with. If included in a SetAppProperties request, this value will overwrite the existing "nicknames" field in the app policies section of the policy table.</description>
- </param>
- <param name="policyAppID" type="String" maxlength="100" minlength="1" mandatory="true" />
- <param name="enabled" type="Boolean" mandatory="false">
- <description>If true, the app will be marked as "available" or "installed" and will be included in HMI RPC UpdateAppList.</description>
- </param>
- <param name="authToken" type="String" maxlength="65535" mandatory="false">
- <description>Used to authenticate connection on app activation</description>
- </param>
- <param name="transportType" type="String" maxlength="100" mandatory="false">
- <description>
- Specifies the connection type Core should use. The Core role (server or client) is dependent of "endpoint" being specified.
- See "endpoint" for details.
- </description>
- </param>
- <param name="hybridAppPreference" type="Common.HybridAppPreference" mandatory="false">
- <description>Specifies the user preference to use one specific app type or all available types</description>
- </param>
- <param name="endpoint" type="String" maxlength="65535" mandatory="false">
- <description>
- If specified, which Core uses a client implementation of the connection type and attempts to connect to the endpoint when this app is selected (activated).
- If omitted, Core won't attempt to connect as the app selection (activation) is managed outside of Core. Instead it uses a server implementation of the connection type and expects the app to connect.
- </description>
- </param>
- </struct>
-
<function name="SetAppProperties" messagetype="request">
<description>
HMI >SDL. RPC used to enable/disable an application and set authentication data
</description>
- <param name="properties" type="AppProperties" mandatory="true">
+ <param name="properties" type="Common.AppProperties" mandatory="true">
<description>The new application properties</description>
</param>
</function>
<function name="SetAppProperties" messagetype="response">
<description>The response to SetAppProperties</description>
- <param name="success" type="Boolean" platform="documentation" mandatory="true">
- <description>true if successful; false if failed</description>
- </param>
- <param name="resultCode" type="Common.Result" platform="documentation" mandatory="true">
- <description>See Result</description>
- <element name="SUCCESS"/>
- <element name="INVALID_DATA"/>
- <element name="OUT_OF_MEMORY"/>
- <element name="TOO_MANY_PENDING_REQUESTS"/>
- <element name="GENERIC_ERROR"/>
- <element name="DISALLOWED"/>
- <element name="WARNINGS"/>
- <element name="DATA_NOT_AVAILABLE"/>
- </param>
</function>
<function name="GetAppProperties" messagetype="request">
@@ -4710,37 +4696,25 @@
HMI >SDL. RPC used to get the current properties of an application
</description>
<param name="policyAppID" type="String" maxlength="100" mandatory="false">
- If specified the response will contain the properties of the specified app ID.
- Otherwise if omitted all app properties will be returned at once.
+ <description>
+ If specified the response will contain the properties of the specified app ID.
+ Otherwise if omitted all app properties will be returned at once.
+ </description>
</param>
</function>
<function name="GetAppProperties" messagetype="response">
<description>The response to GetAppProperties</description>
- <param name="properties" type="AppProperties" array="true" minsize="1" mandatory="false">
+ <param name="properties" type="Common.AppProperties" array="true" minsize="1" mandatory="false">
<description>The requested application properties</description>
</param>
- <param name="success" type="Boolean" platform="documentation" mandatory="true">
- <description>true if successful; false if failed</description>
- </param>
- <param name="resultCode" type="Common.Result" platform="documentation" mandatory="true">
- <description>See Result</description>
- <element name="SUCCESS"/>
- <element name="INVALID_DATA"/>
- <element name="OUT_OF_MEMORY"/>
- <element name="TOO_MANY_PENDING_REQUESTS"/>
- <element name="GENERIC_ERROR"/>
- <element name="DISALLOWED"/>
- <element name="WARNINGS"/>
- <element name="DATA_NOT_AVAILABLE"/>
- </param>
</function>
<function name="OnAppPropertiesChange" messagetype="notification">
<description>
SDL >HMI. RPC used to inform HMI about app properties change (such as auth token).
</description>
- <param name="properties" type="AppProperties" mandatory="true">
+ <param name="properties" type="Common.AppProperties" mandatory="true">
<description>The new application properties</description>
</param>
</function>