--- /dev/null
+\r
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">\r
+<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">\r
+<head>\r
+ <meta http-equiv="content-type" content="text/html; charset=utf-8" />\r
+ <meta http-equiv="X-UA-Compatible" content="IE=9" />\r
+ <link rel="stylesheet" type="text/css" href="../css/styles.css" />\r
+ <link rel="stylesheet" type="text/css" href="../css/snippet.css" />\r
+ <script type="text/javascript" src="../scripts/snippet.js"></script>\r
+ <script type="text/javascript" src="../scripts/jquery.util.js" charset="utf-8"></script>\r
+ <script type="text/javascript" src="../scripts/common.js" charset="utf-8"></script>\r
+ <script type="text/javascript" src="../scripts/core.js" charset="utf-8"></script>\r
+ <script type="text/javascript" src="../scripts/search.js" charset="utf-8"></script>\r
+\r
+ <title>Command Line Interface</title>\r
+</head>\r
+\r
+ <body onload="prettyPrint()" style="overflow: auto;">\r
+\r
+ <div id="toc-navigation">\r
+ <div id="toc_border"><div id="toc">\r
+ <p class="toc-title">Dependencies</p>\r
+ <ul class="toc">\r
+ <li>Tizen Studio 2.0 and Higher</li>\r
+ </ul>\r
+ <p class="toc-title">Content</p>\r
+ <ul class="toc">\r
+ <li><a href="#Setting_config">Setting Configuration Options</a></li>\r
+ <li><a href="#Creating_proj">Creating a Tizen .NET Project</a></li>\r
+ <li><a href="#Restoring_proj">Restoring the Project</a></li>\r
+ <li><a href="#Building_proj">Building the Project</a></li>\r
+ <li><a href="#Cleaning_proj">Cleaning the Project</a></li>\r
+ <li><a href="#Issuing_tizen_cert">Issuing a Tizen Certificate</a></li>\r
+ <li><a href="#Managing_sec_prof">Managing Security Profiles</a></li>\r
+ <li><a href="#Installing_App">Installing the Application on a Target</a></li>\r
+ <li><a href="#Running_App">Running the Application on a Target</a></li>\r
+ <li><a href="#Uninstalling_App">Uninstalling an Application from a Target</a></li>\r
+ <li><a href="#Displaying_vers">Displaying the .NET CLI Ext Version</a></li>\r
+ </ul>\r
+ </div></div>\r
+</div>\r
+\r
+<div id="container"><div id="contents"><div class="content">\r
+<h1>Command Line Interface</h1>\r
+\r
+<p>The .NET CLI (Command Line Interface) Ext provides functionalities for developing Tizen .NET applications without the IDE. It includes the entire development process from creating the project to running the application. The CLI tool is located in the <code>$<TIZEN_BASELINE_SDK>/tools/ide/bin/</code> directory.</p>\r
+\r
+<div class="note">\r
+<strong>Note</strong>\r
+The .NET CLI Ext does not support restoring and building Xamarin.Forms projects, as the .NET Core CLI 2.0.0 does not fully support Xamarin.Forms.\r
+</div>\r
+\r
+<h2>Prerequisites </h2>\r
+\r
+<p>The following tools must be installed to use the .NET CLI Ext:</p>\r
+\r
+<ul>\r
+ <li>Tizen Baseline SDK (including Tizen C# CLI)</li>\r
+ <li>.NET Core CLI tools 2.0.0</li>\r
+</ul>\r
+\r
+\r
+<h2 id="Setting_config">Setting Configuration Options</h2>\r
+<p>The <code>cli-config</code> command displays, sets, replaces, and removes .NET CLI Ext configuration options.</p>\r
+\r
+<p>The .NET CLI Ext configuration keys are:</p>\r
+\r
+ <ul>\r
+ <li><code>default.build.architecture=<x86|arm></code>: Sets the default executable architecture type.</li>\r
+ <li><code>default.build.compiler=<llvm|gcc></code>: Sets the default compiler.</li>\r
+ <li><code>default.build.configuration=<Debug|Release></code>: Sets the default build configuration.</li>\r
+ <li><code>default.csharp.buildtool.path=<path/to/msbuild></code>: Sets the C# build tool path. The default is <code>C:/Program Files (x86)/MSBuild/15.0/Bin/MSBuild.exe</code>.</li>\r
+ <li><code>default.csharp.toolchain=<dotnet-cli|msbuild></code>: Sets the C# build tool. The default is <code>dotnet-cli</code> for Windows® and Ubuntu, and <code>msbuild</code> is only supported on Windows®.</li>\r
+ <li><code>default.dotnet.tool.path=<path/to/dotnet></code>: Sets the <code>dotnet</code> CLI tool path. The default is <code>C:/Program Files/dotnet/dotnet.exe</code> for Windows®, and <code>/usr/bin/dotnet</code> for Ubuntu.</li>\r
+ <li><code>default.profiles.path=<PROFILE_PATH></code>: Sets the directory path where the <code>profiles.xml</code> file is located.</li>\r
+ <li><code>default.sdb.timeout=<TIMEOUT_VALUE></code>: Sets the default connection timeout value. The default is 60000 milliseconds.</li>\r
+ </ul>\r
+\r
+<p><strong>Syntax:</strong></p>\r
+<pre class="prettyprint">\r
+dotnet tizen cli-config [arguments] [options]\r
+</pre>\r
+\r
+<p><strong>Arguments:</strong></p>\r
+<table>\r
+<tbody>\r
+<tr>\r
+ <th>Argument</th>\r
+ <th>Description</th>\r
+</tr>\r
+<tr>\r
+ <td><code><KEY>=<VALUE></code></td>\r
+ <td>Sets a value for the .NET CLI Ext configuration key.</td>\r
+</tr>\r
+</tbody>\r
+</table>\r
+\r
+<p><strong>Options:</strong></p>\r
+\r
+<table>\r
+<tbody>\r
+<tr>\r
+ <th>Option</th>\r
+ <th>Description</th>\r
+</tr>\r
+<tr>\r
+ <td><code>-g</code>, <code>--global</code></td>\r
+ <td>Specifies whether the operation must be done for a global scope (for all installed SDKs or for the current Tizen Baseline SDK only).</td>\r
+</tr>\r
+<tr>\r
+ <td><code>-l</code>, <code>--list</code></td>\r
+ <td>Displays the list of all .NET CLI Ext configuration keys and values.</td>\r
+</tr>\r
+<tr>\r
+ <td><code>-d</code>, <code>--delete <KEY></code></td>\r
+ <td>Removes the .NET CLI Ext configuration key and value.</td>\r
+</tr>\r
+ </tbody></table>\r
+\r
+<p><strong>Examples:</strong></p>\r
+\r
+<ul>\r
+ <li>Display a list of all configurations for which values are set:\r
+ <p>Windows®, Ubuntu, and macOS:</p>\r
+\r
+<pre class="prettyprint">\r
+> dotnet tizen cli-config -l\r
+default.build.architecture=x86\r
+default.build.compiler=llvm\r
+default.build.configuration=Debug\r
+default.csharp.buildtool.path=C:/Program Files (x86)/Microsoft Visual Studio/2017/Professional/MSBuild/15.0/Bin/MSBuild.exe\r
+default.csharp.toolchain=dotnet-cli\r
+default.dotnet.tool.path=/usr/bin/dotnet\r
+default.profiles.path=/home/tizen-developer/tizen-studio-data/profile/profiles.xml\r
+default.sdb.timeout=60000\r
+</pre>\r
+</li>\r
+<li>Set a <code>profiles.xml</code> path globally:\r
+ <ul>\r
+ <li>Windows®:\r
+<pre class="prettyprint">\r
+> dotnet tizen cli-config –g "default.profiles.path=C:\workspace\.metadata\.plugins\org.tizen.common.sign\profiles.xml"\r
+</pre>\r
+ </li>\r
+ <li>Ubuntu and macOS:\r
+<pre class="prettyprint">\r
+$ dotnet tizen cli-config –g default.profiles.path=~/workspace/.metadata/.plugins/org.tizen.common.sign/profiles.xml\r
+</pre>\r
+ </li>\r
+ </ul>\r
+</li>\r
+</ul>\r
+\r
+<h2 id="Creating_proj">Creating a Tizen .NET Project</h2>\r
+<p>The <code>new</code> command creates a Tizen .NET project from a template. If a template is not specified, the command displays project templates, with a usage message.</p>\r
+\r
+<p><strong>Syntax:</strong></p>\r
+\r
+<pre class="prettyprint">\r
+dotnet tizen new [arguments] [options]\r
+</pre>\r
+\r
+<p><strong>Arguments:</strong></p>\r
+<table>\r
+<tbody>\r
+<tr>\r
+ <th>Argument</th>\r
+ <th>Description</th>\r
+</tr>\r
+<tr>\r
+ <td><code><TEMPLATE_NAME></code></td>\r
+ <td>Specifies the template name.</td>\r
+</tr>\r
+</tbody>\r
+</table>\r
+\r
+<p><strong>Options:</strong></p>\r
+\r
+<table>\r
+<tbody>\r
+<tr>\r
+ <th>Option</th>\r
+ <th>Description</th>\r
+</tr>\r
+ <tr>\r
+ <td><code>-n</code>, <code>--name <PROJECT_NAME></code></td>\r
+ <td>Specifies the project name. If no name is specified, the name of the current directory is used.</td>\r
+ </tr>\r
+ <tr>\r
+ <td><code>-o</code>, <code>--output <OUTPUT_DIR></code></td>\r
+ <td>Specifies the output path for the output being created.</td>\r
+ </tr>\r
+ <tr>\r
+ <td><code>-all</code>, <code>--show-all</code></td>\r
+ <td>Shows all templates.</td>\r
+ </tr>\r
+ </tbody>\r
+ </table>\r
+\r
+<p><strong>Examples:</strong></p>\r
+<ul>\r
+ <li>Display Tizen .NET templates:\r
+ <p>Windows®, Ubuntu, and macOS:</p>\r
+\r
+<pre class="prettyprint">\r
+> dotnet tizen new\r
+Initialize Tizen .NET projects.\r
+\r
+Usage: dotnet tizen new [arguments] [options]\r
+\r
+Arguments:\r
+ <TEMPLATE_NAME> Template name.\r
+\r
+Options:\r
+ -h, --help Show help information.\r
+ -n, --name <PROJECT_NAME> Project name. If no name is specified, the name of the current directory is used.\r
+ -o, --output <OUTPUT_DIR> The output directory path for the output being created.\r
+ -all, --show-all Show all templates.\r
+\r
+Examples:\r
+ dotnet tizen new Tizen.Template.BlankAppCorporate\r
+\r
+[TEMPLATE]\r
+Tizen.NET.Template.ElmSharp\r
+Tizen.NET.Template.NSClassLib\r
+Tizen.NUI.Template.Single\r
+</pre>\r
+ </li>\r
+ <li>Create a Tizen .NET project with a specific template:\r
+ <p>Windows®:</p>\r
+\r
+<pre class="prettyprint">\r
+> dotnet tizen new Tizen.NUI.Template.Single -n TizenSingle -o C:\TizenWorkspace\r
+> cd C:\TizenWorkspace\TizenSingle\r
+</pre>\r
+ </li>\r
+</ul>\r
+\r
+<h2 id="Restoring_proj">Restoring the Project</h2>\r
+<p>The <code>restore</code> command restores the dependencies and tools of a Tizen .NET project.</p>\r
+<p>The following options are based on .NET Core CLI tools 2.0.0. For more information, see <a href="https://docs.microsoft.com/en-us/dotnet/core/tools/dotnet-restore?tabs=netcore2x" target="_blank">dotnet restore command</a>.</p>\r
+\r
+<p><strong>Syntax:</strong></p>\r
+<pre class="prettyprint">\r
+dotnet tizen restore [options]\r
+</pre>\r
+\r
+<p><strong>Options:</strong></p>\r
+<table>\r
+<tbody>\r
+<tr>\r
+ <th>Option</th>\r
+ <th>Description</th>\r
+</tr>\r
+<tr>\r
+ <td><code>-s</code>, <code>--source <SOURCE></code></td>\r
+ <td>Specifies a NuGet package source to use during the restore operation. This overrides all of the sources specified in the <code>NuGet.config</code> files. Multiple sources can be provided by specifying this option multiple times.</td>\r
+</tr>\r
+<tr>\r
+ <td><code>-r</code>, <code>--runtime <RUNTIME_IDENTIFIER></code></td>\r
+ <td>Specifies a runtime for package restoration. This is used to restore packages for runtimes not explicitly listed in the <code><RuntimeIdentifiers></code> tag in the <code>.csproj</code> file. For a list of Runtime Identifiers (RIDs), see the <a href="https://docs.microsoft.com/en-us/dotnet/core/rid-catalog" target="_blank">RID catalog</a>. Provide multiple RIDs by specifying this option multiple times.</td>\r
+</tr>\r
+<tr>\r
+ <td><code>--packages <PACKAGES_DIRECTORY></code></td>\r
+ <td>Specifies the directory for restored packages.</td>\r
+</tr>\r
+<tr>\r
+ <td><code>--disable-parallel</code></td>\r
+ <td>Disables restoring multiple projects in parallel.</td>\r
+</tr>\r
+<tr>\r
+ <td><code>--configfile <FILE></code></td>\r
+ <td>Specifies the NuGet configuration file (<code>NuGet.config</code>) to use for the restore operation.</td>\r
+</tr>\r
+<tr>\r
+ <td><code>--no-cache</code></td>\r
+ <td>Does not cache packages and HTTP requests.</td>\r
+</tr>\r
+<tr>\r
+ <td><code>--ignore-failed-sources</code></td>\r
+ <td>Only warns about failed sources if there are packages meeting the version requirement.</td>\r
+</tr>\r
+<tr>\r
+ <td><code>--no-dependencies</code></td>\r
+ <td>When restoring a project with project-to-project (P2P) references, restores the root project and not the references.</td>\r
+</tr>\r
+<tr>\r
+ <td><code>-f</code>, <code>--force</code></td>\r
+ <td>Forces all dependencies to be resolved even if the last restore was successful. This is equivalent to deleting the <code>project.assets.json</code> file.</td>\r
+</tr>\r
+<tr>\r
+ <td><code>-v</code>, <code>--verbosity</code></td>\r
+ <td>Sets the verbosity level of the command. Allowed values are <code>q[uiet]</code>, <code>m[inimal]</code>, <code>n[ormal]</code>, <code>d[etailed]</code>, and <code>diag[nostic]</code>.</td>\r
+</tr>\r
+</tbody>\r
+</table>\r
+\r
+<p><strong>Examples:</strong></p>\r
+<ul>\r
+ <li>Restore the Tizen .NET project:\r
+ <p>Windows®, Ubuntu, and macOS:</p>\r
+<pre class="prettyprint">\r
+> dotnet tizen restore\r
+</pre>\r
+ </li>\r
+</ul>\r
+\r
+<h2 id="Building_proj">Building the Project</h2>\r
+<p>The <code>build</code> command builds a Tizen .NET project and its dependencies into a set of binaries.</p>\r
+<p>The following arguments and options are based on .NET Core CLI tools 2.0.0. For more information, see <a href="https://docs.microsoft.com/en-us/dotnet/core/tools/dotnet-build?tabs=netcore2x" target="_blank">dotnet build command</a>.</p>\r
+\r
+<p><strong>Syntax:</strong></p>\r
+<pre class="prettyprint">\r
+dotnet tizen build [arguments] [options]\r
+</pre>\r
+\r
+<p><strong>Arguments:</strong></p>\r
+<table>\r
+<tbody>\r
+<tr>\r
+ <th>Argument</th>\r
+ <th>Description</th>\r
+</tr>\r
+<tr>\r
+ <td><code><PROJECT></code></td>\r
+ <td>Specifies the MSBuild project file (<code>.csproj</code>) to build. If a project file is not specified, .NET Core CLI (MSBuild) searches the current working directory for a file that has a file extension that ends in <code>proj</code> and uses that file.</td>\r
+</tr>\r
+</tbody>\r
+</table>\r
+\r
+<p><strong>Options:</strong></p>\r
+<table>\r
+<tbody>\r
+<tr>\r
+ <th>Option</th>\r
+ <th>Description</th>\r
+</tr>\r
+<tr>\r
+ <td><code>-o</code>, <code>--output <OUTPUT_DIR></code></td>\r
+ <td>Specifies the directory in which to place the built binaries. You also need to define <code>--framework</code> when you specify this option.</td>\r
+</tr>\r
+<tr>\r
+ <td><code>-f</code>, <code>--framework <FRAMEWORK></code></td>\r
+ <td>Compiles for a specific framework<!--[TBA: link to framework]-->. The framework must be defined in the project file.</td>\r
+</tr>\r
+<tr>\r
+ <td><code>-r</code>, <code>--runtime <RUNTIME_IDENTIFIER></code></td>\r
+ <td>Specifies the target runtime. For a list of Runtime Identifiers (RIDs), see the <a href="https://docs.microsoft.com/en-us/dotnet/core/rid-catalog" target="_blank">RID catalog</a>. Provide multiple RIDs by specifying this option multiple times.</td>\r
+</tr>\r
+<tr>\r
+ <td><code>-c</code>, <code>--configuration <CONFIGURATION></code></td>\r
+ <td>Defines the build configuration. The default value is <code>Debug</code>.</td>\r
+</tr>\r
+<tr>\r
+ <td><code>--version-suffix <VERSION_SUFFIX></code></td>\r
+ <td>Defines the version suffix for an asterisk (*) in the version field of the project file. The format follows NuGet's version guidelines.</td>\r
+</tr>\r
+<tr>\r
+ <td><code>--no-incremental</code></td>\r
+ <td>Marks the build as unsafe for incremental build. This turns off incremental compilation and forces a clean rebuild of the project's dependency graph.</td>\r
+</tr>\r
+<tr>\r
+ <td><code>--no-dependencies</code></td>\r
+ <td>Ignores project-to-project (P2P) references and only builds the root project specified to build.</td>\r
+</tr>\r
+<tr>\r
+ <td><code>--no-restore</code></td>\r
+ <td>Does not perform an implicit restore during build.</td>\r
+</tr>\r
+<tr>\r
+ <td><code>-f</code>, <code>--force</code></td>\r
+ <td>Forces all dependencies to be resolved even if the last restore was successful. This is equivalent to deleting the <code>project.assets.json</code> file.</td>\r
+</tr>\r
+<tr>\r
+ <td><code>-v</code>, <code>--verbosity</code></td>\r
+ <td>Sets the verbosity level of the command. Allowed values are <code>q[uiet]</code>, <code>m[inimal]</code>, <code>n[ormal]</code>, <code>d[etailed]</code>, and <code>diag[nostic]</code>.</td>\r
+</tr>\r
+</tbody>\r
+</table>\r
+\r
+<p><strong>Examples:</strong></p>\r
+<ul>\r
+ <li>Build the Tizen .NET project:\r
+ <p>Windows®, Ubuntu, and macOS:</p>\r
+<pre class="prettyprint">\r
+> dotnet tizen build\r
+</pre>\r
+ </li>\r
+</ul>\r
+\r
+<h2 id="Cleaning_proj">Cleaning the Project</h2>\r
+<p>The <code>clean</code> command cleans the Tizen .NET project. If you clean the project, all build output directories under the project root path are removed.</p>\r
+\r
+<p><strong>Syntax:</strong></p>\r
+<pre class="prettyprint">\r
+dotnet tizen clean [arguments]\r
+</pre>\r
+\r
+<p><strong>Arguments:</strong></p>\r
+<table>\r
+<tbody>\r
+<tr>\r
+ <th>Argument</th>\r
+ <th>Description</th>\r
+</tr>\r
+ <tr>\r
+ <td><code><PROJECT_DIR></code></td>\r
+ <td>Specifies the project directory. Defaults to the current directory if nothing is specified.</td>\r
+</tr>\r
+</tbody></table>\r
+\r
+<p><strong>Examples:</strong></p>\r
+<ul>\r
+ <li>Clean the Tizen .NET project:\r
+ <p>Windows®:</p>\r
+<pre class="prettyprint">\r
+> dotnet tizen clean C:\workspace\blank\r
+</pre>\r
+ <p>Ubuntu and macOS:</p>\r
+<pre class="prettyprint">\r
+$ dotnet tizen clean ~/workspace/blank\r
+</pre>\r
+ </li>\r
+</ul>\r
+\r
+<h2 id="Issuing_tizen_cert">Issuing a Tizen Certificate</h2>\r
+<p>The <code>certificate</code> command generates a Tizen certificate for your application. If you want to upload your application to the Tizen Store or install the application on a Tizen device, you must generate a Tizen certificate.</p>\r
+\r
+<p><strong>Syntax:</strong></p>\r
+<pre class="prettyprint">\r
+dotnet tizen certificate [options]\r
+</pre>\r
+\r
+<p><strong>Options:</strong></p>\r
+\r
+<table>\r
+<tbody>\r
+<tr>\r
+ <th>Option</th>\r
+ <th>Description</th>\r
+</tr>\r
+ <tr>\r
+ <td><code>-a</code>, <code>--alias <ALIAS_NAME></code></td>\r
+ <td>Specifies the certificate alias name. (Required)</td>\r
+</tr>\r
+<tr>\r
+ <td><code>-pw</code>, <code>--password <PASSWORD></code></td>\r
+ <td>Specifies the certificate password. (Required)</td>\r
+</tr>\r
+<tr>\r
+ <td><code>-n</code>, <code>--name <USER_NAME></code></td>\r
+ <td>Specifies the user name.</td>\r
+</tr>\r
+<tr>\r
+ <td><code>-c</code>, <code>--country <COUNTRY_CODE></code></td>\r
+ <td>Specifies the user's 2-letter country code.</td>\r
+</tr>\r
+<tr>\r
+ <td><code>-s</code>, <code>--state <STATE></code></td>\r
+ <td>Specifies the user's state.</td>\r
+</tr>\r
+<tr>\r
+ <td><code>-ct</code>, <code>--city <CITY></code></td>\r
+ <td>Specifies the user's city.</td>\r
+</tr>\r
+<tr>\r
+ <td><code>-og</code>, <code>--organization <ORGANIZATION></code></td>\r
+ <td>Specifies the user's organization.</td>\r
+</tr>\r
+<tr>\r
+ <td><code>-u</code>, <code>--unit <UNIT></code></td>\r
+ <td>Specifies the user's organization unit.</td>\r
+</tr>\r
+<tr>\r
+ <td><code>-e</code>, <code>--email <EMAIL></code></td>\r
+ <td>Specifies the user's email.</td>\r
+</tr>\r
+<tr>\r
+ <td><code>-fn</code>, <code>--filename <FILE_NAME></code></td>\r
+ <td>Specifies the certificate file name, without file extension. If you omit this option, the default file name, <code>author</code>, is used.</td>\r
+</tr>\r
+<tr>\r
+ <td><code>-o</code>, <code>--output <CERT_OUTPUT_DIR></code></td>\r
+ <td>Specifies the output directory path for the created certificate. If you omit this option, the certificate file is saved in the default output directory path, <code><TIZEN_BASELINE_SDK_DATA>/keystore/author/</code>.</td>\r
+</tr>\r
+</tbody></table>\r
+\r
+<p><strong>Examples:</strong></p>\r
+<ul>\r
+ <li>Generate a certificate:\r
+ <p>Windows®:</p>\r
+\r
+<pre class="prettyprint">\r
+> dotnet tizen certificate -a MyTizen -pw 1234 -n "Gildong Hong" -c KR -s Seoul -ct Gangnamgu -og Tizen -u Development -e gildonghong@example.org -fn mycert\r
+Generating a certificate with\r
+ File name = mycert\r
+ Container Password = ****\r
+ Alias = MyTizen\r
+ Key Password = ****\r
+ Country = KR\r
+ State = Seoul\r
+ City = Gangnamgu\r
+ Name = Gildong Hong\r
+ Organization = Tizen\r
+ Organization Unit = Develop\r
+ E-mail = gildonghong@example.org\r
+'mycert' has been generated in 'C:\tizen-studio-data\keystore\author'.\r
+</pre>\r
+\r
+ <p>Ubuntu and macOS:</p>\r
+\r
+<pre class="prettyprint">\r
+$ dotnet tizen certificate -a MyTizen -pw 1234 -n "Gildong Hong" -c KR -s Seoul -ct Gangnamgu -og Tizen -u Development -e gildonghong@example.org -fn mycert\r
+Generating a certificate with\r
+ File name = mycert\r
+ Container Password = ****\r
+ Alias = MyTizen\r
+ Key Password = ****\r
+ Country = KR\r
+ State = Seoul\r
+ City = Gangnamgu\r
+ Name = Gildong Hong\r
+ Organization = Tizen\r
+ Organization Unit = Develop\r
+ E-mail = gildonghong@example.org\r
+'mycert' has been generated in '~/tizen-studio-data/keystore/author'.\r
+</pre>\r
+ </li>\r
+</ul>\r
+\r
+<h2 id="Managing_sec_prof">Managing Security Profiles</h2>\r
+<p>The <code>security-profiles</code> command manages the security profiles, which are sets of signing certificates for Tizen applications.</p>\r
+<p><strong>Syntax:</strong></p>\r
+<pre class="prettyprint">\r
+dotnet tizen security-profiles <sub-command> [options]\r
+</pre>\r
+\r
+<p><strong>Sub-commands:</strong></p>\r
+\r
+<table>\r
+<tbody>\r
+<tr>\r
+ <th>Sub-command</th>\r
+ <th>Description</th>\r
+</tr>\r
+ <tr>\r
+ <td><code>add [options]</code></td>\r
+ <td>Adds the specified security profile, which can contain several certificates.\r
+<p>The command has the following options:</p>\r
+ <ul>\r
+ <li><code>-n</code>, <code>--name <PROFILE_NAME></code>: Specifies the name of the security profile to add. (Required)</li>\r
+ <li><code>-a</code>, <code>--author <AUTHOR_PATH></code>: Specifies the directory path where the author certificate file is located. The format of the certificate is PKCS#12, and the file extension is <code>.p12</code>. (Required)</li>\r
+ <li><code>-pw</code>, <code>--password <AUTHOR_PASSWORD></code>: Specifies the password used to access the author certificate. (Required)</li>\r
+ <li><code>-c</code>, <code>--ca <AUTHOR_CA_PATH></code>: Specifies the directory path where the author CA certificate file is located. The file extension of the CA certificate is <code>.cer</code>.</li>\r
+ <li><code>-r</code>, <code>--rootca <AUTHOR_ROOT_CA_PATH></code>: Specifies the directory path where the author root CA certificate file is located. The file extension of the root CA certificate is <code>.cer</code>.</li>\r
+ <li><code>-d</code>, <code>--dist <DIST_PATH></code>: Specifies the directory path where the distributor certificate file is located. If you omit this option, the default distributor certificate file embedded in the Tizen Baseline SDK is used.</li>\r
+ <li><code>-dp</code>, <code>--dist-password <DIST_PASSWORD></code>: Specifies the distributor certificate password.</li>\r
+ <li><code>-dc</code>, <code>--dist-ca <DIST_CA_PATH></code>: Specifies the directory path where the distributor CA certificate file is located.</li>\r
+ <li><code>-dr</code>, <code>--dist-rootca <DIST_ROOT_CA_PATH></code>: Specifies the directory path where the distributor root CA certificate file is located.</li>\r
+ <li><code>--force</code>: If there is no <code>profiles.xml</code> file, generates the file.</li>\r
+ <li><code>-p</code>, <code>--path <PROFILE_PATH></code>: Specifies the directory path where the <code>profiles.xml</code> file is located. If you omit this option, the value of the <code>default.profiles.path</code> key in the CLI configuration is used to find the <code>profiles.xml</code> file, which consists of new security profiles that are generated in the <code><TIZEN_BASELINE_SDK_DATA>/keystore/</code> directory. The directory path is added to the CLI configuration.</li>\r
+ </ul>\r
+</td>\r
+</tr>\r
+<tr>\r
+ <td><code>list [options]</code></td>\r
+ <td>Displays the security profiles. If you specify the name of the security profile, details about the specified profile are displayed.\r
+<p>The command has the following options:</p>\r
+ <ul>\r
+ <li><code>-n</code>, <code>--name <PROFILE_NAME></code>: Specifies the name of the security profile to list. If you omit this option, a list of the security profile names in the <code>profiles.xml</code> file is displayed.</li>\r
+ <li><code>-p</code>, <code>--path <PROFILE_PATH></code>: Specifies the directory path where the <code>profiles.xml</code> file is located. If you omit this option, the value of the <code>default.profiles.path</code> key in the CLI configuration is used to find the <code>profiles.xml</code> file, which consists of new security profiles that are generated in the <code><TIZEN_BASELINE_SDK_DATA>/keystore/</code> directory. The directory path is added to the CLI configuration.</li>\r
+ </ul>\r
+</td>\r
+</tr>\r
+<tr>\r
+ <td><code>remove [options]</code></td>\r
+ <td>Removes the specified security profile.\r
+<p>The command has the following options:</p>\r
+ <ul>\r
+ <li><code>-n</code>, <code>--name <PROFILE_NAME></code>: Specifies the name of the security profile to remove. (Required)</li>\r
+ <li><code>-p</code>, <code>--path <PROFILE_PATH></code>: Specifies the directory path where the <code>profiles.xml</code> file is located. If you omit this option, the value of the <code>default.profiles.path</code> key in the CLI configuration is used to find the <code>profiles.xml</code> file, which consists of new security profiles that are generated in the <code><TIZEN_BASELINE_SDK_DATA>/keystore/</code> directory. The directory path is added to the CLI configuration.</li>\r
+ </ul>\r
+</td>\r
+</tr>\r
+</tbody></table>\r
+\r
+<p><strong>Examples:</strong></p>\r
+<ul>\r
+ <li>Add a security profile:\r
+ <p>Windows®:</p>\r
+\r
+<pre class="prettyprint">\r
+> dotnet tizen security-profiles add -n MyProfile -a C:\tizen-studio-data\keystore\author\mycert.p12 -pw 1234\r
+No exist the default path of security profiles.\r
+author path: C:\tizen-studio-data\keystore\author\mycert.p12\r
+author password: ****\r
+distributor1 path: C:\tizen-studio\tools\certificate-generator\certificates\distributor\tizen-distributor-signer.p12\r
+distributor1 password: *************************\r
+distributor1 CA path: C:\tizen-studio\tools\certificate-generator\certificates\distributor\tizen-distributor-ca.cer\r
+In Configuration, Set a default profile path to 'C:\tizen-studio-data\ide\keystore\profiles.xml'.\r
+Wrote to 'C:\tizen-studio-data\ide\keystore\profiles.xml'.\r
+Succeed to add 'MyProfile' profile.\r
+If want to sign by this, add the file of security profiles in CLI configuration like 'tizen cli-config "default.profiles.path=C:\tizen-studio-data\ide\keystore\profiles.xml"'.\r
+</pre>\r
+ <p>Ubuntu and macOS:</p>\r
+<pre class="prettyprint">\r
+$ dotnet tizen security-profiles add -n MyProfile -a ~/tizen-studio-data/keystore/author/mycert.p12 -pw 1234\r
+No exist the default path of security profiles.\r
+author path: ~/tizen-studio-data/keystore/author/mycert.p12\r
+author password: ****\r
+distributor1 path: ~/tizen-studio/tools/certificate-generator/certificates/distributor/tizen-distributor-signer.p12\r
+distributor1 password: *************************\r
+distributor1 CA path: ~/tizen-studio/tools/certificate-generator/certificates/distributor/tizen-distributor-ca.cer\r
+In Configuration, Set a default profile path to '~/tizen-studio-data/ide/keystore/profiles.xml'.\r
+Wrote to '~/tizen-studio-data/ide/keystore/profiles.xml'.\r
+Succeed to add 'MyProfile' profile.\r
+If want to sign by this, add the file of security profiles in CLI configuration like 'tizen cli-config "default.profiles.path=~/tizen-studio-data/ide/keystore/profiles.xml"'.\r
+</pre>\r
+ </li>\r
+ <li>Display the security profile list:\r
+ <p>Windows®:</p>\r
+\r
+<pre class="prettyprint">\r
+> dotnet tizen security-profiles list\r
+Loaded in 'C:\tizen-studio-data\ide\keystore\profiles.xml'.\r
+========================================\r
+Name\r
+========================================\r
+MyProfile\r
+</pre>\r
+\r
+ <p>Ubuntu and macOS:</p>\r
+\r
+<pre class="prettyprint">\r
+$ dotnet tizen security-profiles list\r
+Loaded in '~/tizen-studio-data/ide/keystore/profiles.xml'.\r
+========================================\r
+Name\r
+========================================\r
+MyProfile\r
+</pre>\r
+ </li>\r
+ <li>Display the details for a security profile:\r
+ <p>Windows®:</p>\r
+\r
+<pre class="prettyprint">\r
+> dotnet tizen security-profiles list -n MyProfile\r
+Loaded in 'C:\tizen-studio-data\ide\keystore\profiles.xml'.\r
+========================================\r
+'MyProfile' profile information\r
+========================================\r
+author path: C:\tizen-studio-data\keystore\author\mycert.p12\r
+author password: ****\r
+distributor1 path: C:\tizen-studio\tools\certificate-generator\certificates\distributor\tizen-distributor-signer.p12\r
+distributor1 password: *************************\r
+distributor1 CA path: C:\tizen-studio\tools\certificate-generator\certificates\distributor\tizen-distributor-ca.cer\r
+</pre>\r
+\r
+ <p>Ubuntu and macOS:</p>\r
+\r
+<pre class="prettyprint">\r
+$ dotnet tizen security-profiles list -n MyProfile\r
+Loaded in '~/tizen-studio-data/ide/keystore/profiles.xml'.\r
+========================================\r
+'MyProfile' profile information\r
+========================================\r
+author path: ~/tizen-studio-data/keystore/author/mycert.p12\r
+author password: ****\r
+distributor1 path: ~/tizen-studio/tools/certificate-generator/certificates/distributor/tizen-distributor-signer.p12\r
+distributor1 password: *************************\r
+distributor1 CA path: ~/tizen-studio/tools/certificate-generator/certificates/distributor/tizen-distributor-ca.cer\r
+</pre>\r
+ </li>\r
+ <li>Remove the security profile:\r
+ <p>Windows®:</p>\r
+\r
+<pre class="prettyprint">\r
+> dotnet tizen security-profiles remove -n MyProfile\r
+Loaded in 'C:\tizen-studio-data\ide\keystore\profiles.xml'.\r
+Wrote to 'C:\tizen-studio-data\ide\keystore\profiles.xml'.\r
+Succeed to remove 'MyProfile' profile\r
+</pre>\r
+\r
+ <p>Ubuntu and macOS:</p>\r
+\r
+<pre class="prettyprint">\r
+$ dotnet tizen security-profiles remove -n MyProfile\r
+Loaded in '~/tizen-studio-data/ide/keystore/profiles.xml'.\r
+Wrote to '~/tizen-studio-data/ide/keystore/profiles.xml'.\r
+Succeed to remove 'MyProfile' profile\r
+</pre>\r
+ </li>\r
+</ul>\r
+\r
+<h2 id="Installing_App">Installing the Application on a Target</h2>\r
+<p>The <code>install</code> command installs the Tizen .NET application on a target.</p>\r
+\r
+<p><strong>Syntax:</strong></p>\r
+<pre class="prettyprint">\r
+dotnet tizen install [arguments] [options]\r
+</pre>\r
+\r
+<p><strong>Arguments:</strong></p>\r
+<table>\r
+<tbody>\r
+<tr>\r
+ <th>Argument</th>\r
+ <th>Description</th>\r
+</tr>\r
+<tr>\r
+ <td><code><PACKAGE_FILE></code></td>\r
+ <td>Specifies the path of the package file. (Required)</td>\r
+</tr>\r
+</tbody>\r
+</table>\r
+\r
+<p><strong>Options:</strong></p>\r
+<table>\r
+<tbody>\r
+<tr>\r
+ <th>Option</th>\r
+ <th>Description</th>\r
+</tr>\r
+<tr>\r
+ <td><code>-t</code>, <code>--target <TARGET_NAME></code></td>\r
+ <td>Specifies the target to install the package onto.</td>\r
+</tr>\r
+<tr>\r
+ <td><code>-s</code>, <code>--serial <TARGET_SERIAL></code></td>\r
+ <td>Specifies the serial to install the package onto.</td>\r
+</tr>\r
+</tbody>\r
+</table>\r
+\r
+<p><strong>Examples:</strong></p>\r
+<ul>\r
+ <li>Install the Tizen .NET application with the package name <code>blank-1.0.0.tpk</code> on emulator-26101:\r
+ <p>Windows®:</p>\r
+\r
+<pre class="prettyprint">\r
+> dotnet tizen install C:\workspace\blank\bin\Debug\netcoreapp1.0\blank-1.0.0.tpk -s emulator-26101\r
+</pre>\r
+\r
+ <p>Ubuntu and macOS:</p>\r
+\r
+<pre class="prettyprint">\r
+$ dotnet tizen install ~/workspace/blank/bin/Debug/netcoreapp1.0/blank-1.0.0.tpk -s emulator-26101\r
+</pre>\r
+ </li>\r
+</ul>\r
+\r
+<h2 id="Running_App">Running the Application on a Target</h2>\r
+<p>The <code>run</code> command runs the Tizen application on a target.</p>\r
+\r
+<p><strong>Syntax:</strong></p>\r
+<pre class="prettyprint">\r
+dotnet tizen run [options]\r
+</pre>\r
+\r
+<p><strong>Options:</strong></p>\r
+<table>\r
+<tbody>\r
+<tr>\r
+ <th>Option</th>\r
+ <th>Description</th>\r
+</tr>\r
+<tr>\r
+ <td><code>-p</code>, <code>--pkgid <PACKAGE_ID></code></td>\r
+ <td>Specifies the Tizen package ID installed on the target. (Required)</td>\r
+</tr>\r
+<tr>\r
+ <td><code>-t</code>, <code>--target <TARGET_NAME></code></td>\r
+ <td>Specifies the target to run the package on.</td>\r
+</tr>\r
+<tr>\r
+ <td><code>-s</code>, <code>--serial <TARGET_SERIAL></code></td>\r
+ <td>Specifies the serial to run the package on.</td>\r
+</tr>\r
+</tbody>\r
+</table>\r
+\r
+<p><strong>Examples:</strong></p>\r
+<ul>\r
+ <li>Run the Tizen .NET application with the package ID <code>org.tizen.example.blank</code> on emulator-26101:\r
+ <p>Windows®, Ubuntu, and macOS:</p>\r
+<pre class="prettyprint">\r
+> dotnet tizen run -p org.tizen.example.blank -s emulator-26101\r
+</pre>\r
+ </li>\r
+</ul>\r
+\r
+<h2 id="Uninstalling_App">Uninstalling an Application from a Target</h2>\r
+<p>The <code>uninstall</code> command uninstalls a Tizen application from a target.</p>\r
+\r
+<p><strong>Syntax:</strong></p>\r
+<pre class="prettyprint">\r
+dotnet tizen uninstall [options]\r
+</pre>\r
+\r
+<p><strong>Options:</strong></p>\r
+<table>\r
+<tbody>\r
+<tr>\r
+ <th>Option</th>\r
+ <th>Description</th>\r
+</tr>\r
+<tr>\r
+ <td><code>-p</code>, <code>--pkgid <PACKAGE_ID></code></td>\r
+ <td>Specifies the Tizen package ID to be uninstalled from the target. (Required)</td>\r
+</tr>\r
+<tr>\r
+ <td><code>-t</code>, <code>--target <TARGET_NAME></code></td>\r
+ <td>Specifies the target to uninstall the package from.</td>\r
+</tr>\r
+<tr>\r
+ <td><code>-s</code>, <code>--serial <TARGET_SERIAL></code></td>\r
+ <td>Specifies the serial to uninstall the package from.</td>\r
+</tr>\r
+</tbody>\r
+</table>\r
+\r
+<p><strong>Examples:</strong></p>\r
+<ul>\r
+ <li>Uninstall the Tizen .NET application with the package ID <code>org.tizen.example.blank</code> from emulator-26101:\r
+ <p>Windows®, Ubuntu, and macOS:</p>\r
+\r
+<pre class="prettyprint">\r
+> dotnet tizen uninstall -p org.tizen.example.blank -s emulator-26101\r
+</pre>\r
+ </li>\r
+</ul>\r
+\r
+<h2 id="Displaying_vers">Displaying the .NET CLI Ext Version</h2>\r
+<p>The <code>--version</code> option displays the .NET CLI Ext version number.</p>\r
+\r
+<p><strong>Syntax:</strong></p>\r
+\r
+<pre class="prettyprint">\r
+dotnet tizen [-v|--version]\r
+</pre>\r
+\r
+<p><strong>Examples:</strong></p>\r
+<ul>\r
+ <li>Display the .NET CLI Ext version number:\r
+ <p>Windows®, Ubuntu, and macOS:</p>\r
+\r
+<pre class="prettyprint">\r
+> dotnet tizen --version\r
+Tizen .NET Command Line Tools\r
+1.0.0\r
+</pre>\r
+ </li>\r
+</ul>\r
+\r
+<script type="text/javascript" src="../scripts/jquery.zclip.min.js"></script>\r
+<script type="text/javascript" src="../scripts/showhide.js"></script>\r
+</div></div></div>\r
+\r
+<a class="top sms" href="#"><img src="../images/btn_top.gif" alt="Go to top" /></a>\r
+\r
+<div id="footer">\r
+<p class="footer">Except as noted, this content - excluding the Code Examples - is licensed under <a href="http://creativecommons.org/licenses/by/3.0/legalcode" target="_blank">Creative Commons Attribution 3.0</a> and all of the Code Examples contained herein are licensed under <a href="https://www.tizen.org/bsd-3-clause-license" target="_blank">BSD-3-Clause</a>.<br/>For details, see the <a href="https://www.tizen.org/content-license" target="_blank">Content License</a>.</p>\r
+</div>\r
+\r
+<script type="text/javascript">\r
+var _gaq = _gaq || [];\r
+_gaq.push(['_setAccount', 'UA-25976949-1']);\r
+_gaq.push(['_trackPageview']);\r
+(function() {\r
+var ga = document.createElement('script'); ga.type = 'text/javascript'; ga.async = true;\r
+ga.src = ('https:' == document.location.protocol ? 'https://ssl' : 'http://www') + '.google-analytics.com/ga.js';\r
+var s = document.getElementsByTagName('script')[0]; s.parentNode.insertBefore(ga, s);\r
+})();\r
+</script>\r
+\r
+</body>\r
+</html>\r
projects / sdk / online-doc.git / commitdiff