Managing NaCl Toolchains

ImportantDue to NaCl deprecation by the Chromium project, Tizen TV will continue its support for NaCl only until 2021-year products. Meanwhile, Tizen TV will start focusing on high-performance, cross-browser WebAssembly from 2020-year products.

This topic describes how to manage Native Client toolchains in the Tizen Studio.

The Native Client (NaCl) SDK manager allows you to manage NaCl toolchain versions from within the Tizen Studio. You can select the toolchain to use with your project, and easily download, update, and remove toolchains.

Figure 1. NaCl SDK manager

Opening the NaCl SDK Manager

Depending on what you want to do, you can access the NaCl SDK manager in various ways:

To define the NaCl SDK root directory for the current workspace:
1. In the Tizen Studio menu, select "Window > Preferences > Tizen Studio > NaCl".
  
  The NaCl SDK manager opens.
2. To define the NaCl SDK root directory, click "Browse" and select the folder, or enter the directory path.
3. Click "Apply".
To define the NaCl toolchain for a specific NaCl project:
1. In the "Project Explorer" view, right-click the project and select "Properties > Tizen Studio > NaCl toolchain".
2. Select the toolchain you want to use, and click "Apply".
To define the default NaCl toolchain for an existing NaCl-enabled TV application project:
1. In the "Project Explorer" view, right-click the project and select "NaCl > Select NaCl Toolchain".
2. Select the toolchain you want to use, and click "OK".
To define the default NaCl toolchain for a new TV application project, in the "New Tizen Project" wizard, when defining the application type, enable NaCl support. The NaCl SDK manager opens at the last step in the project creation process.

For more information, see Creating NaCl-enabled TV Applications.

When you open the NaCl SDK manager, the currently defined "NaCl SDK root" directory is scanned for available NaCl toolchain versions. Each toolchain version is verified for file integrity by comparing its checksum to that of the version on the NaCl SDK download server.

While a toolchain is being verified, it cannot be selected for use. To cancel the verification process, select the toolchain in the list, and click "Cancel".

Figure 2. NaCl toolchain verification

If the checksums differ, the status column for that toolchain says "Installation modified". This does not prevent you from using the toolchain, but the toolchain is not guaranteed to work properly.

Managing NaCl Toolchain Versions

In the NaCl SDK manager, you can download, update, and remove NaCl toolchains:

To download and install a NaCl toolchain:
1. Select the toolchain you want to download, and click "Download".
  
  If you select a toolchain that has the "installation modified" status, it is re-downloaded to get the unmodified files. Before downloading begins, you must confirm removing the existing files.
  
  After downloading has started, you can close the NaCl SDK manager. The toolchain is downloaded to the defined NaCl SDK root directory.
2. To monitor the detailed download progress, in the Tizen Studio status bar, click the progress circle.
To update an installed NaCl toolchain:
1. Select the toolchain you want to update, and click "Update".
2. To confirm removing the existing toolchain files, click "Yes".
  
  After downloading has started, you can close the NaCl SDK manager.
3. To monitor download progress, in the Tizen Studio status bar, click the progress circle.
To remove an installed NaCl toolchain:
1. Select the toolchain you want to remove, and click "Remove".
2. To confirm removing the toolchain, click "Yes". The toolchain's files are deleted from your computer.