Add TV content to Training 35/138435/3
authorEditor Lionbridge <TizenEditor.SEL@lionbridge.com>
Wed, 12 Jul 2017 07:14:46 +0000 (10:14 +0300)
committerEditor Lionbridge <TizenEditor.SEL@lionbridge.com>
Thu, 13 Jul 2017 08:03:02 +0000 (11:03 +0300)
This is a manual cherry pick of the changes implemented in change #130901
in the tizen_3.0 branch in response to queries for that change (the base
content of #130901 was already implemented in the tizen branch).

PS2: Issues arising from queries dealt with.
PS3: Added one more missed fix.

Change-Id: Ic93c1ab415e4b530ea169f4a82848b8ba1bae664

org.tizen.training/html/cover_page.htm
org.tizen.training/html/images/profile_tv.png [new file with mode: 0644]
org.tizen.training/html/native/details/deprecation_policy_n.htm
org.tizen.training/html/web/details/app_filtering_w.htm
org.tizen.training/html/web/details/deprecation_policy_w.htm
org.tizen.training/html/web/details/tizen_apis_w.htm
org.tizen.training/html/web/process/app_dev_process_w.htm
org.tizen.training/html/web/process/creating_app_project_w.htm

index 90d3ab4..36c92a3 100644 (file)
@@ -66,7 +66,7 @@
 
 <h2 id="profiles" name="profiles">Tizen Profiles</h2>
 
-<p>Tizen is built to work on a wide variety of platforms with a focus on embedded devices. In order to accommodate the various types of devices, a set of profiles has been defined to make it easier to develop applications for specific purposes and device types. In Tizen 3.0, there are 3 profile types you can choose from: mobile, wearable, and TV. The mobile profile is designed for smart phones, the wearable profile is designed for smart watches, and the TV profile is designed for smart TVs.</p>
+<p>Tizen is built to work on a wide variety of platforms with a focus on embedded devices. In order to accommodate the various types of devices, a set of profiles has been defined to make it easier to develop applications for specific purposes and device types. Since Tizen 3.0, there are 3 profile types you can choose from: mobile, wearable, and TV. The mobile profile is designed for smart phones, the wearable profile is designed for smart watches, and the TV profile is designed for smart TVs.</p>
 
 <p>Both mobile and wearable profiles are supported in native and Web application types. The TV profile is supported in the Web application type only.</p>
 
@@ -76,6 +76,8 @@
 <p align="center"><strong>Figure: Applications using the wearable profile</strong></p>
 <p align="center"><img src="images/profile_wearable.png" alt="Applications using the wearable profile" /></p>
 
+<p align="center"><strong>Figure: Applications using the TV profile</strong></p>
+<p align="center"><img src="images/profile_tv.png" alt="Applications using the TV profile" /></p>
 
 <h2 id="doc" name="doc">Tizen Documentation</h2>
 
     </tr>
        <tr>
      <td>TV Web</td>
-     <td><img alt="TV Web" src="images/tv_s_w.png"/></td>
+     <td><img alt="TV Web" src="images/tv_s_w.png"/> or <img alt="Optional TV Web" src="images/tv_s_w_optional.png"/></td>
     </tr>
    </tbody>
   </table>
 
       <div class="note">
         <strong>Note</strong>
-        In Tizen native APIs and Web Device mobile and wearable APIs, there are 2 types of APIs: mandatory and optional. The fully gray profile icon (as shown in the table above) refers to an optional API.
+        In Tizen native APIs and Web Device APIs, there are 2 types of APIs: mandatory and optional. The fully gray profile icon (as shown in the table above) refers to an optional API.
 <p>The mandatory APIs are always available on all Tizen devices. The optional APIs provide functionality that depends on the available device hardware or software capabilities, and they may not be available in all Tizen devices.</p>
     </div>
 
diff --git a/org.tizen.training/html/images/profile_tv.png b/org.tizen.training/html/images/profile_tv.png
new file mode 100644 (file)
index 0000000..0578747
Binary files /dev/null and b/org.tizen.training/html/images/profile_tv.png differ
index 4eb2989..fe02c0b 100644 (file)
@@ -18,7 +18,7 @@
 
 <div id="toc-navigation">
     <div id="profile">
-        <p><img alt="Mobile" src="../../images/mobile_s_wn.png"/> <img alt="Wearable" src="../../images/wearable_s_wn.png"/></p>
+        <p><img alt="Mobile" src="../../images/mobile_s_wn.png"/> <img alt="Wearable" src="../../images/wearable_s_wn.png"/> <img alt="TV Web" src="../../images/tv_s_w.png"/></p>
     </div>
     <div id="toc_border"><div id="toc">
                <p class="toc-title">Content</p>
index 7d5613d..9c70fdc 100644 (file)
 </tbody>
 </table>
 
+<p align="center" class="Table"><strong>Table: Available requirements for TV Web Device APIs</strong></p>
+<table border="1" id="features">
+   <tbody>
+<tr>
+     <th>Feature key</th>
+     <th>Description</th>
+        <th>Since</th>
+    </tr>
+<tr>
+<td><code>http://tizen.org/feature/tv.audio</code></td>
+     <td>Specify this key, if the application requires the audio control functionality for using the <a href="../../../../org.tizen.web.apireference/html/device_api/tv/tizen/tvaudiocontrol.html">TV Audio Control</a> API.</td>
+        <td>3.0</td>
+   </tr>
+<tr>
+<td><code>http://tizen.org/feature/tv.tuner</code></td>
+     <td>Specify this key, if the application requires the channel tuner functionality for using the <a href="../../../../org.tizen.web.apireference/html/device_api/tv/tizen/tvchannel.html">TV Channel</a> API.</td>
+        <td>3.0</td>
+   </tr>
+<tr>
+<td><code>http://tizen.org/feature/tv.display</code></td>
+     <td>Specify this key, if the application requires the screen display functionality for using the <a href="../../../../org.tizen.web.apireference/html/device_api/tv/tizen/tvdisplaycontrol.html">TV Display Control</a> API.</td>
+        <td>3.0</td>
+   </tr>
+<tr>
+<td><code>http://tizen.org/feature/tv.inputdevice</code></td>
+     <td>Specify this key, if the application requires the input device event monitoring functionality for using the <a href="../../../../org.tizen.web.apireference/html/device_api/tv/tizen/tvinputdevice.html">TV Input Device</a> API.</td>
+        <td>3.0</td>
+   </tr>
+<tr>
+<td><code>http://tizen.org/feature/tv.pip</code></td>
+     <td>Specify this key, if the application requires the picture-in-picture (PIP) functionality for using the <a href="../../../../org.tizen.web.apireference/html/device_api/tv/tizen/tvwindow.html">TV Window</a> API.</td>
+        <td>3.0</td>
+   </tr>
+<tr>
+<td><code>http://tizen.org/feature/tv.information</code></td>
+     <td>Specify this key, if the application requires the TV setting functionality for using the <a href="../../../../org.tizen.web.apireference/html/device_api/tv/tizen/tvinfo.html">TV Information</a> API.</td>
+        <td>3.0</td>
+   </tr>
+</tbody>
+</table>
+
 <h2 id="profile_w" name="profile_w">Profile-based Filtering</h2>
 <p>A Tizen profile describes the requirements for a category of Tizen devices that have a common application execution environment. Applications are created for a single specific target profile, such as mobile, wearable, or TV, and can run on devices compliant to that profile.</p>
 
index 4eb2989..fe02c0b 100644 (file)
@@ -18,7 +18,7 @@
 
 <div id="toc-navigation">
     <div id="profile">
-        <p><img alt="Mobile" src="../../images/mobile_s_wn.png"/> <img alt="Wearable" src="../../images/wearable_s_wn.png"/></p>
+        <p><img alt="Mobile" src="../../images/mobile_s_wn.png"/> <img alt="Wearable" src="../../images/wearable_s_wn.png"/> <img alt="TV Web" src="../../images/tv_s_w.png"/></p>
     </div>
     <div id="toc_border"><div id="toc">
                <p class="toc-title">Content</p>
index a7d39f3..2b11e7f 100644 (file)
       <ul>
           <li>Guides:
           <p><a href="../../../../org.tizen.guides/html/web/connectivity/connectivity_cover_w.htm">Connectivity and Wireless</a></p>
-          <p><a href="../../../../org.tizen.guides/html/web/data/data_cover_w.htm">Data Storage and Management</a></p>
-          <p><a href="../../../../org.tizen.guides/html/web/media/media_cover_w.htm">Media and Camera</a></p></li>
+          <p><a href="../../../../org.tizen.guides/html/web/data/data_cover_w.htm">Data Storage and Management</a></p></li>
        <li>API Reference: <a href="../../../../org.tizen.web.apireference/html/device_api/mobile/index.html#Contents">Content</a></li>
       </ul></td>
     </tr>
        <tr>
      <td>Messaging</td>
-     <td>These APIs contain classes and interfaces that enable you to manage SMS, MMS, and email messages.
+     <td>This API contains classes and interfaces that enable you to manage SMS, MMS, and email messages.
         <p>You can send and receive messages, and receive push notifications from a push server.</p></td>
      <td>
       <ul>
           <li>Guides:
           <p><a href="../../../../org.tizen.guides/html/web/connectivity/connectivity_cover_w.htm">Connectivity and Wireless</a></p>
           <p><a href="../../../../org.tizen.guides/html/web/data/data_cover_w.htm">Data Storage and Management</a></p>
-          <p><a href="../../../../org.tizen.guides/html/web/media/media_cover_w.htm">Media and Camera</a></p></li>
        <li>API Reference: <a href="../../../../org.tizen.web.apireference/html/device_api/wearable/index.html#Contents">Content</a></li>
       </ul></td>
     </tr>
    </tbody>
   </table>
 
+  <p>The following table lists the features provided by the <a href="../../../../org.tizen.web.apireference/html/device_api/tv/index.html">TV Web Device API Reference</a>.</p>
+   <p align="center" class="Table"><strong>Table: Device API features provided for TV applications</strong></p>
+   <table border="1">
+
+   <colgroup>
+    <col width="20%" />
+    <col width="40%" />
+    <col width="40%" />
+   </colgroup>
+   <tbody>
+    <tr>
+     <th>Feature</th>
+     <th>Purpose</th>
+     <th>Documentation</th>
+    </tr>
+       <tr>
+     <td>Base</td>
+     <td>These APIs contain classes and interfaces that provide a set of basic definitions and interfaces that are used in the Tizen Device API.
+        <p>You can manage common files and ZIP archive files, and define filters and sorting modes for queries. You can also use generic success and error event handlers, in addition to a generic error interface and a simple coordinate interface for defining location information.</p></td>
+     <td>
+      <ul>
+          <li>Guides:
+          <p><a href="../../../../org.tizen.guides/html/web/data/data_cover_w.htm">Data Storage and Management</a></p>
+          <p><a href="../../../../org.tizen.guides/html/web/error/error_w.htm">Error Handling</a></p></li>
+       <li>API Reference: <a href="../../../../org.tizen.web.apireference/html/device_api/tv/index.html#Tizen">Base</a></li>
+      </ul></td>
+    </tr>
+    <tr>
+     <td>Application Framework</td>
+     <td>These APIs contain classes and interfaces that enable you to manage alarm, application, and package features.
+        <p>You can schedule an application to be run at a specific time, retrieve information about the applications installed or running on the device, and enable package management.</p></td>
+     <td>
+      <ul>
+          <li>Guides:
+          <p><a href="../../../../org.tizen.guides/html/web/alarm/alarms_w.htm">Alarms</a></p>
+          <p><a href="../../../../org.tizen.guides/html/web/app_management/app_management_cover_w.htm">Application Management</a></p></li>
+       <li>API Reference: <a href="../../../../org.tizen.web.apireference/html/device_api/tv/index.html#Application">Application Framework</a></li>
+      </ul></td>
+    </tr>
+       <tr>
+     <td>Content</td>
+     <td>These APIs contain classes and interfaces that enable you to manage content and download features.
+        <p>You can search and manage multimedia content locally, manipulate EXIF data in JPEG files, download files from the Internet, and monitor the download progress and status.</p></td>
+     <td>
+      <ul>
+          <li>Guides:
+          <p><a href="../../../../org.tizen.guides/html/web/connectivity/connectivity_cover_w.htm">Connectivity and Wireless</a></p>
+          <p><a href="../../../../org.tizen.guides/html/web/data/data_cover_w.htm">Data Storage and Management</a></p>
+          <p><a href="../../../../org.tizen.guides/html/web/media/media_cover_w.htm">Media and Camera</a></p></li>
+       <li>API Reference: <a href="../../../../org.tizen.web.apireference/html/device_api/tv/index.html#Contents">Content</a></li>
+      </ul></td>
+    </tr>
+       <tr>
+     <td>Messaging</td>
+     <td>This API contains classes and interfaces that enable you to manage push messaging.
+        <p>You can receive push notifications from a push server.</p></td>
+     <td>
+      <ul>
+          <li>Guides: <a href="../../../../org.tizen.guides/html/web/messaging/messaging_cover_w.htm">Messaging</a></li>
+       <li>API Reference: <a href="../../../../org.tizen.web.apireference/html/device_api/tv/index.html#Messaging">Messaging</a></li>
+      </ul></td>
+    </tr>
+  <tr>
+     <td>Network</td>
+     <td>This API contains classes and interfaces that enable you to manage IoT connectivity.
+   <p>You can create a client and server, and manage their resources locally and remotely.</p></td>
+     <td>
+      <ul>
+       <li>Guides: <a href="../../../../org.tizen.guides/html/web/connectivity/connectivity_cover_w.htm">Connectivity and Wireless</a></li>
+       <li>API Reference: <a href="../../../../org.tizen.web.apireference/html/device_api/tv/index.html#Network">Network</a></li>
+      </ul></td>
+    </tr>
+       <tr>
+     <td>Security</td>
+     <td>This API contains classes and interfaces that enable you to manage secure keys in your application.
+        <p>You can use security functionalities, such as storing and recalling private data.</p></td>
+     <td>
+      <ul>
+       <li>Guides: <a href="../../../../org.tizen.guides/html/web/security/security_cover_w.htm">Security</a></li>
+       <li>API Reference: <a href="../../../../org.tizen.web.apireference/html/device_api/tv/index.html#Security">Security</a></li>
+      </ul></td>
+    </tr>
+       <tr>
+     <td>System</td>
+     <td>These APIs contain classes and interfaces that enable you to manage system information, time, and Web setting features.
+        <p>You can access the device system information and use locale-specific calendar features by retrieving date and time information. You can also set Web view properties, such as setting Web view user agents and deleting Web view cookies.</p></td>
+     <td>
+      <ul>
+       <li>Guides: <a href="../../../../org.tizen.guides/html/web/device/device_cover_w.htm">Device Settings and Systems</a></li>
+       <li>API Reference: <a href="../../../../org.tizen.web.apireference/html/device_api/tv/index.html#System">System</a></li>
+      </ul></td>
+    </tr>
+       <tr>
+     <td>Cordova</td>
+     <td>These APIs contain classes and interfaces that enable you use common functionalities in creating Tizen Web applications.
+        <p>You can manage the device filesystem, individual files, and various events, access device and network information and the device accelerometer, create dialog boxes and system log entries, and play audio files.</p></td>
+     <td>
+      <ul>
+       <li>Guides: <a href="../../../../org.tizen.guides/html/web/cordova/cordova_cover_w.htm">Cordova</a></li>
+       <li>API Reference: <a href="../../../../org.tizen.web.apireference/html/device_api/tv/index.html#Cordova">Cordova</a></li>
+      </ul></td>
+    </tr>
+       <tr>
+     <td>TV Controls</td>
+     <td>These APIs contain classes and interfaces that enable you control the TV functionalities, such as channels and audio.
+        <p>You can modify the volume level, switch TV channels, get program guide information, and manage TV settings. You can also access 3D mode information, monitor remote control key events, and control the main and PIP window on the TV screen.</p></td>
+     <td>
+      <ul>
+       <li>API Reference: <a href="../../../../org.tizen.web.apireference/html/device_api/tv/index.html#TV Control">TV Controls</a></li>
+      </ul></td>
+    </tr>
+   </tbody>
+  </table>
+
 <p>The following table lists the features provided by the <a href="../../../../org.tizen.web.apireference/html/w3c_api/w3c_api_m.html" shape="rect">Mobile Web W3C/HTML5 and Supplementaries API Reference</a>.</p>
    <p align="center" class="Table"><strong>Table: W3C/HTML5 and some supplementary API features provided for mobile applications</strong></p>
    <table border="1">
index 7d5c08e..f98f775 100644 (file)
 <p>After you have packaged your application, you are ready to certify and publish your application.</p>
   <p>To certify and publish your application:</p>
   <ul>
-       <li>Upload your mobile Web application to the Tizen Store or your wearable Web application to the Samsung Galaxy Apps Store for registration.
-               <p>After the application is uploaded, the application is signed as a certified application installer package and the <code>&lt;Application_name&gt;.wgt</code> archive format, which contains the distributor signature, is added by the Tizen Store or Samsung Galaxy Apps Store.</p>
+       <li>Upload your mobile Web application to the Tizen Store, your wearable Web application to the Samsung Galaxy Apps Store, or your TV Web application to the Samsung App Store for registration.
+               <p>After the application is uploaded, the application is signed as a certified application installer package and the <code>&lt;Application_name&gt;.wgt</code> archive format, which contains the distributor signature, is added by the applicable store.</p>
        </li>
-       <li>Submit your application to the Tizen Store or Samsung Galaxy Apps Store for validation and selling.
-               <p>The Tizen Store or Samsung Galaxy Apps Store checks whether your application functions properly before publishing it.</p>
+       <li>Submit your application to the applicable store for validation and publication.
+               <p>The store checks whether your application functions properly before publishing it.</p>
        </li>
   </ul>
 
   <p>For detailed instructions on how to register your application and submit it for validation and publication in the Tizen Store, see <a href="https://developer.tizen.org/distribution/tizen-store-overview">Tizen Store Overview</a> and other subtopics within the <strong>Distribution</strong> section of the Tizen Developers site.</p>
 
-  <p>You can also upgrade your application after certification. If you want to withdraw your application from distribution and operation, you need to request for application retirement from the Tizen Store or Samsung Galaxy Apps Store.</p>
+  <p>You can also upgrade your application after certification. If you want to withdraw your application from distribution and operation, you need to request for application retirement from the store.</p>
 
 <h2 id="upgrade" name="upgrade">Upgrading the Application</h2>
 
-<p>You can upgrade your application even after you have certified and made it available for sale at the Tizen Store or Samsung Galaxy Apps Store.</p>
+<p>You can upgrade your application even after you have certified and published it at the Tizen Store, Samsung Galaxy Apps Store, or Samsung App Store.</p>
   <p>To upgrade your application:</p>
   <ol>
        <li>Update your application version, and if needed the privileges, in the <code>config.xml</code> configuration file in the Tizen Studio.</li>
        <li>Update the application code as needed.</li>
        <li>If needed, update the privileges in the <code>config.xml</code> configuration file in the Tizen Studio.</li>
        <li>Build, test, and repackage the application.</li>
-       <li>Register the upgraded application on the Tizen Store or Samsung Galaxy Apps Store.</li>
+       <li>Register the upgraded application on the applicable store.</li>
   </ol>
 
   <p>When a previously installed application is upgraded on a device, you can decide which data files from the old version are retained and which are deleted. The common Tizen upgrade policy is to overwrite all the application package files, while keeping the user-created files and directories unchanged.</p>
 
-  <p>Once your application has reached the end of its life-cycle, you can remove it from the Tizen Store or Samsung Galaxy Apps Store.</p>
+  <p>Once your application has reached the end of its life-cycle, you can remove it from the store.</p>
 
 <script type="text/javascript" src="../../scripts/jquery.zclip.min.js"></script>
 <script type="text/javascript" src="../../scripts/showhide.js"></script>
index 1120d8d..2feb184 100644 (file)
        <li><p>Select the <strong>Template</strong> project type and click <strong>Next</strong>.</p>
 <p align="center"><img alt="Selecting the project type" src="../../images/create_project_wizard_type.png" /></p>
 </li>
-<li><p>Select the profile (<strong>Mobile</strong> or <strong>Wearable</strong>) and version from a drop-down list and click <strong>Next</strong>.</p>
+<li><p>Select the profile (<strong>Mobile</strong>, <strong>Wearable</strong>, or <strong>TV</strong>) and version from a drop-down list and click <strong>Next</strong>.</p>
+
+<div class="note">
+       <strong>Note</strong>
+       If you cannot see the TV profile option, open the Package Manager and make sure that you have installed the TV extension packages in the <strong>Extension SDK</strong> tab.
+</div>
+
 <p align="center"><img alt="Selecting the profile and version" src="../../images/create_project_wizard_version_wearable.png" /></p>
 </li>
 <li><p>Select the <strong>Web Application</strong> application type and click <strong>Next</strong>.</p>