<invoke-target>

(Optional) Defines the invocation target, which can be used to launch this app from another app.

Parent elements

<qnx>

Child elements

Name Cardinality
invoke-target-name One or none
icon One or none
splashScreens One or none
invoke-target-type One
filter At minimum, one occurrence

Description

The <invoke-target> defines the invocation target. That invocation target allows the current app to be launched from another app. Invocation is the process by which a client app sends an invoke message to a target app. The target handles the invocation. Typically a target is part of an app or viewer bundled in the BAR file. An app or viewer that hosts targets must declare the target against an entry point (that is, the id of the <invoke-target>).

When declaring a target, a globally unique target-key must be used. To ensure the uniqueness of the value, we recommend that you use conventions such as a reverse-DNS name.

Content

None

Attributes

Name Description Values Default
id (Required) A globally unique ID that must start with app package name. Up to 50 characters that includes the name of the package. None

Example

<invoke-target id="com.mycompany.pdf.viewer">
   <invoke-target-name>DocViewer 10</invoke-target-name>
   <icon>
     <image>docViewer.png</image>
   </icon>
   <invoke-target-type>viewer</invoke-target-type>
   <filter>
      <action>bb.action.VIEW</action>
      <action>bb.action.EDIT</action>
      <mime-type>application/pdf</mime-type>
      <mime-type>application/x-pdf</mime-type>
   </filter>
</invoke-target>

<invoke-target id="com.mycompany.pdf.app">
   <invoke-target-name>DocFactory</invoke-target-name>
   <icon>
     <image>DocFactoryIcon.png</image>
   </icon>
   <splashScreens>
     <image>DocFactorySplash.png</image>
   </splashScreens>
   <invoke-target-type>application</invoke-target-type>
   <filter>
      <action>bb.action.EDIT</action>
      <mime-type>application/pdf</mime-type>
      <mime-type>application/x-pdf</mime-type>
      <property var="uris" value="file://,pdf://"/>
      <property var="exts" value="pdf"/>
   </filter>
   <filter>
      <action>bb.action.VIEW</action>
      <mime-type>application/pdf</mime-type>
      <mime-type>application/x-pdf</mime-type>
   </filter>
 </invoke-target>

Last modified: 2015-07-24



Got questions about leaving a comment? Get answers from our Disqus FAQ.

comments powered by Disqus