Prerequisites for Developing Applications with Oracle JET

Familiarize yourself with the third party libraries and technologies that Oracle JET uses and choose a development environment before you start developing Oracle JET applications. If you will use Oracle JET tooling to develop web or hybrid mobile applications, install the prerequisite packages.

Topics:

Prerequisite Knowledge for Working with Oracle JET

Before you can successfully develop applications with Oracle JET, you should be familiar with the third party libraries and technologies that Oracle JET uses.

Name	Description	More Information
CSS	Cascading Style Sheets	http://www.w3.org/Style/CSS
HTML5	Hypertext Markup Language 5	http://www.w3.org/TR/html5
JavaScript	Programming language	https://developer.mozilla.org/en/About_JavaScript
jQuery	JavaScript library designed for HTML document traversal and manipulation, event handling, animation, and Ajax. jQuery includes an API that works across most browsers.	http://jquery.com
Knockout	JavaScript library that provides support for two-way data binding	http://www.knockoutjs.com
RequireJS	JavaScript file and module loader used for managing library references and lazy loading of resources. RequireJS implements the Asynchronous Module Definition (AMD) API.	RequireJS: http://www.requirejs.org AMD API: http://requirejs.org/docs/whyamd.html
SASS	SASS (Syntactically Awesome Style Sheets) extends CSS3 and enables you to use variables, nested rules, mixins, and inline imports to customize your application’s themes. Oracle JET uses the SCSS (Sasy CSS) syntax of SASS.	http://www.sass-lang.com

If you will be using Oracle JET tooling to create web or hybrid mobile applications, you should also be familiar with the following technologies.

Name	Description	More Information
Apache Cordova (Hybrid only)	Open source mobile development framework that allows you to use HTML5, CSS3, and JavaScript for cross-platform development targeted to multiple platforms with one code base	http://cordova.apache.org/
Node.js	Open source, cross-platform runtime environment for developing server-side web applications, used by Oracle JET for package management. Node.js includes the `npm` command line tool.	https://nodejs.org

Choose a Development Environment

You can develop Oracle JET applications in virtually any integrated development environment (IDE) that supports JavaScript, HTML5, and CSS3. However, an IDE is not required for developing Oracle JET applications, and you can use any text editor to develop your application.

NetBeans IDE version 8.1 and higher includes support for creating or editing Oracle JET applications. You can use NetBeans in conjunction with the Oracle JET command-line tooling, or use NetBean’s built-in support to load, edit, and run an Oracle JET application from the base distribution, template, or sample application.

If you want to develop hybrid mobile applications using Oracle JET tooling, you must also install a platform-specific SDK for the platform (Android, iOS, or Windows) where you want to run the hybrid mobile application. However, you can still use your favorite editor for editing your application. For details about developing hybrid applications using Oracle JET tooling, see Getting Started with Oracle JET Hybrid Mobile Application Development.

Install the Prerequisite Packages

If you plan to use Oracle JET tooling to develop web or hybrid mobile applications, you must install Node.js and the Oracle JET command-line interface (CLI), ojet-cli.

Note:

If you already have some or all of the prerequisite packages installed on your development platform, check that you are using the minimum versions supported by Oracle JET tooling and upgrade as needed. For the list of minimum supported versions, see Oracle JET Support.

To install the prerequisite packages:

Install Node.js

Install Node.js on your development machine.

From a web browser, download and install one of the installers appropriate for your OS from the Node.js download page. Oracle JET recommends that you install the latest LTS version. Node.js is pre-installed on macOS, but is likely an old version, so upgrade to the latest LTS version if necessary.

After you complete installation and setup, you can enter npm commands from a command prompt to verify that your installation succeeded. For example, to configure a proxy server, use npm config.

npm config set proxy http-proxy-server-URL:proxy-port
npm config set https-proxy https-proxy-server-URL:proxy-port

Include the complete URL in the command. For example:

npm config set proxy http://my.proxyserver.com:80
npm config set https-proxy http://my.proxyserver.com:80

Install the Oracle JET Command-Line Interface

Use npm to install the Oracle JET command-line interface (ojet-cli).

At the command prompt of your development machine, enter the following command as Administrator on Windows or use sudo on Macintosh and Linux machines:
```
[sudo] npm install -g @oracle/ojet-cli
```
Note:
It may not be obvious that the installation succeeded. Enter npm list –g @oracle/ojet-cli to verify that the command succeeded. If the package is not listed, scroll through the install command output to locate the source of the failure.
- If you receive an error related to a network failure, verify that you have set up your proxy correctly if needed.
- If you receive an error that your version of npm is outdated, type the following to update the version: [sudo] npm install -g npm.