The manifest document updates.
authorMyungki Lee <mk5004.lee@samsung.com>
Wed, 22 Apr 2015 11:28:16 +0000 (20:28 +0900)
committerMyungki Lee <mk5004.lee@samsung.com>
Wed, 22 Apr 2015 11:28:16 +0000 (20:28 +0900)
Change-Id: I696a02ebcf4c95f0c843c0c438f1764cd373e867
Signed-off-by: Myungki Lee <mk5004.lee@samsung.com>
org.tizen.devtools/html/images/features.png [new file with mode: 0755]
org.tizen.devtools/html/images/manifest.png [new file with mode: 0755]
org.tizen.devtools/html/images/privilege.png [new file with mode: 0755]
org.tizen.devtools/html/images/profiles.png [new file with mode: 0755]
org.tizen.devtools/html/native_tools/manifest_text_editor_n.htm

diff --git a/org.tizen.devtools/html/images/features.png b/org.tizen.devtools/html/images/features.png
new file mode 100755 (executable)
index 0000000..922d9d4
Binary files /dev/null and b/org.tizen.devtools/html/images/features.png differ
diff --git a/org.tizen.devtools/html/images/manifest.png b/org.tizen.devtools/html/images/manifest.png
new file mode 100755 (executable)
index 0000000..2715121
Binary files /dev/null and b/org.tizen.devtools/html/images/manifest.png differ
diff --git a/org.tizen.devtools/html/images/privilege.png b/org.tizen.devtools/html/images/privilege.png
new file mode 100755 (executable)
index 0000000..cee913e
Binary files /dev/null and b/org.tizen.devtools/html/images/privilege.png differ
diff --git a/org.tizen.devtools/html/images/profiles.png b/org.tizen.devtools/html/images/profiles.png
new file mode 100755 (executable)
index 0000000..a4cd059
Binary files /dev/null and b/org.tizen.devtools/html/images/profiles.png differ
index c60f47b..73f1e80 100644 (file)
@@ -38,7 +38,7 @@
 <div id="container"><div id="contents"><div class="content">
  
   <h1>Manifest Text Editor</h1> 
-    <p>A Tizen native application package consists of exactly 1 manifest file, called <span style="font-family: Courier New,Courier,monospace;">tizen-manifest.xml</span>. The manifest file is composed of XML elements, which include the root <a href="#manifest">&lt;manifest&gt;</a> element and its child elements representing application information, such as  <span style="font-family: Courier New,Courier,monospace;">&lt;version&gt;</span>, and <span style="font-family: Courier New,Courier,monospace;">&lt;privileges&gt;</span>. The <a href="#hierarchy">child elements are organized into a specific hierarchy</a>.</p>
+    <p>A Tizen native application package consists of exactly 1 manifest file, called <span style="font-family: Courier New,Courier,monospace;">tizen-manifest.xml</span>. It is used to describe the information of application. The manifest file is composed of XML elements, which include the root <a href="#manifest">&lt;manifest&gt;</a> element and its child elements representing application information, such as  <span style="font-family: Courier New,Courier,monospace;">&lt;version&gt;</span>, and <span style="font-family: Courier New,Courier,monospace;">&lt;privileges&gt;</span>. The <a href="#hierarchy">child elements are organized into a specific hierarchy</a>. Elements may have attributes associated with them. Attributes describe information about the element.</p>
 <p>The manifest file information can be edited using the <a href="../../../org.tizen.gettingstarted/html/process/setting_properties_n.htm#manifest">manifest editor</a>, or you can modify the XML structure directly using the text editor. To open the manifest editor, double-click the <span style="font-family: Courier New,Courier,monospace;">tizen-manifest.xml</span> file in the <strong>Project Explorer</strong> view of the IDE. To use the text editor, right-click the <span style="font-family: Courier New,Courier,monospace;">tizen-manifest.xml</span> file in the <strong>Project Explorer</strong> view and select <strong>Open with &gt; Text Editor</strong>.</p>
 
 <table class="note"><tbody>
 </td> 
     </tr>
 </tbody></table>
+<p class="figure">Figure: Manifest editor</p>
+<p style="text-align:center;"><img alt="manifest editor" src="../images/manifest.png" /></p>
 <table border="1" id="installlocation"><tbody>
 <tr>
 <th style="text-align:left;margin-left:auto;margin-right:auto;">
     </tr>
 <tr>
 <td> <p>Installation location for the application.</p>
+     <p>By default, set to the internal and developer may select auto or prefer-external to the installation to an external device, sunc as an SD card.</p>
     <p><strong>Expected value:</strong> </p> 
     <ul>
 <li>One of the following values: <span style="font-family: Courier New,Courier,monospace">&quot;auto&quot;</span>, <span style="font-family: Courier New,Courier,monospace">&quot;internal-only&quot;</span>, <span style="font-family: Courier New,Courier,monospace">&quot;prefer-external&quot;</span></li> 
       </ul>
+    <p>auto - The platform will decide where the app is installed.</p>
+    <p>internal-only</p>
+    <p>prefer-external - Asked to install an external storage device, but is not guaranteed. If there is no empty space in the external storage device, it is installed on the internal.</p>
 </td> 
     </tr>
 </tbody></table>
 <span style="font-family: Courier New,Courier,monospace">href</span> attribute</th> 
     </tr>
 <tr>
-<td> <p>Web site of the package creator.</p>
+<td> <p>Web site of the package creator. (e.g., a homepage, a profile on a social network, etc)</p>
     <p><strong>Expected value:</strong> </p> 
     <ul>
 <li>Any valid Web site string value</li> 
 
   <h2 name="service" id="service">&lt;service-application&gt; Element</h2> 
 <p>The <span style="font-family: Courier New,Courier,monospace">&lt;service-application&gt;</span> element represents the manifest information of a Tizen native application without a graphical user interface (GUI).</p>
-
+<p>This is suitable for developing a program to be run continuously, as getting the sensor data. Service application can be packaged with native up application, web application.</p>
 
   <table border="1"><tbody>
 <tr>
 <span style="font-family: Courier New,Courier,monospace">&lt;icon&gt;</span> element</th> 
     </tr>
 <tr>
-<td> <p>Account provider icon image.</p>
+<td> <p>Since the icons are used in the device under settings, Accounts place them in a shared directory.</p>
          <p><strong>Attributes:</strong> </p>      
       <ul>
 <li><span style="font-family: Courier New,Courier,monospace"><a href="#section">section</a></span></li> 
 <span style="font-family: Courier New,Courier,monospace">&lt;capability&gt;</span> element</th> 
     </tr>
 <tr>
-<td> <p>Account provider capability.</p>
+<td> <p>Capability of the account provider. Capabilities are defined in the http://&lt;VENDOR_INFORMAION&gt;/accounts/capability/&lt;NAME&gt; </p>
          <p><strong>Expected value:</strong> </p>      
       <ul>
 <li>IRI string</li> 
 
                 <h2 name="privileges" id="privileges">&lt;privileges&gt; Element</h2> 
 <p>The <span style="font-family: Courier New,Courier,monospace">&lt;privileges&gt;</span> element represents required privileges for the Tizen application.</p>
-
+<p>Applications that use such sensitive APIs must declare the required privileges in the manifest.xml.</P>
+<p>Since the category of privilege different for each type of API, developer have to find a privilege related to the API on document.</p>
+<p>Press the Add button briings up the Add privilege dialog.</p>
+<p class="figure">Figure: Privileges</p>
+<p style="text-align:center;"><img alt="Privileges" src="../images/privilege.png" /></p>
   <table border="1"><tbody>
 <tr>
 <th style="text-align:left;margin-left:auto;margin-right:auto;">
 <span style="font-family: Courier New,Courier,monospace">&lt;privilege&gt;</span> element</th> 
     </tr>
 <tr>
-<td> <p>Required privilege for the Tizen application.</p> <p><strong>Occurrences:</strong> </p> 
+<td>
+<p>Required privilege for the Tizen application.</p>
+<p><strong>Occurrences:</strong> </p>
       <ul>
 <li>1 or more (optional)</li> 
       </ul>
 <p><strong>Expected value:</strong> </p> 
+<p>name</p>
+<p>Mandatory, URI of the Device API privilege</p>
 <p>For example:</p>     
          <ul>
          <li><span style="font-family: Courier New,Courier,monospace">http://tizen.org/privilege/application.admin</span></li>
 </pre>
 
                <h2 id="feature">&lt;feature&gt; Element</h2> 
-<p>The <span style="font-family: Courier New,Courier,monospace">&lt;feature&gt;</span> element represents the list of required features for feature-based filtering in the Tizen Store. This element has no child elements.</p>
+<p>The <span style="font-family: Courier New,Courier,monospace">&lt;feature&gt;</span> element represents the list of required features for feature-based filtering in the Tizen Store. It is used to define the hardware and software components for the tizen application. In order to use/access to api that specialized for each vendor or platform, features must declare. This element has no child elements.</p>
+<p class="figure">Figure: features</p>
+<p style="text-align:center;"><img alt="features" src="../images/features.png" /></p>
   <table border="1"><tbody>
 <tr>
 <th style="text-align:left;margin-left:auto;margin-right:auto;">
          <ul>
 <li><a href="#name"><span style="font-family: Courier New,Courier,monospace">name</span></a></li> 
       </ul>
+<p>Mandatory: feature key URI</p>
 </td> 
     </tr>
 </tbody></table>
 &lt;feature name=&quot;http://tizen.org/feature/fmradio&quot;/&gt;
 </pre>
 
+               <h2 id="profile">&lt;profile&gt; Element</h2>
+<p>The <span style="font-family: Courier New,Courier,monospace">&lt;profile&gt;</span> element determinated that tizen package operate what kind of device. This element has no child elements.</p>
+<table border="1"><tbody>
+<tr>
+<th style="text-align:left;margin-left:auto;margin-right:auto;">
+<span style="font-family: Courier New,Courier,monospace">&lt;profile&gt;</span> element</th>
+    </tr>
+<tr>
+<td>
+<p>targeted requirements for specific device categories which layer on top of the Tizen Common Platform, including additional components for devices, APIs, and hardware requirements. Platform must conform to the Tizen common requirements as well as at least one profile.</p>
+<p><strong>Occurrences:</strong> </p>
+    <ul>
+<li>1 or more (optional)</li>
+    </ul>
+<p><strong>Attributes:</strong> </p>
+    <ul>
+<li><a href="#name"><span style="font-family: Courier New,Courier,monospace">name</span></a></li>
+    </ul>
+</td>
+    </tr>
+</tbody></table>
+<table border="1" id="name"><tbody>
+<tr>
+<th style="text-align:left;margin-left:auto;margin-right:auto;">
+<span style="font-family: Courier New,Courier,monospace">name</span> attribute</th>
+    </tr>
+<tr>
+<td> <p>Item name used in feature-based filtering in the Tizen Store.</p>
+<p><strong>Expected value:</strong> </p>
+<p>For example:</p>
+    <ul>
+<li><span style="font-family: Courier New,Courier,monospace">mobile</span></li>
+<li><span style="font-family: Courier New,Courier,monospace">wearabel</span></li>
+    </ul>
+</td>
+    </tr>
+</tbody></table>
+<p><strong>For example:</strong></p>
+<pre class="prettyprint">
+&lt;profile name=&quot;mobile&quot;/&gt;
+</pre>
                
 <script type="text/javascript" src="../scripts/jquery.zclip.min.js"></script>
 <script type="text/javascript" src="../scripts/showhide.js"></script>
@@ -1181,4 +1239,4 @@ var s = document.getElementsByTagName('script')[0]; s.parentNode.insertBefore(ga
 </script>
 
 </body>
-</html>
\ No newline at end of file
+</html>