Skip to main content
Version: v1.8.x

Building plugin apps

You can build a plugin app by using the following steps as a model. Alternatively, you can follow the Sample Angular App tutorial.

The basic requirement for a plugin app is that static web content must be in a /web directory, and server and other backend files must be in a /lib directory. You can place other plugin source code anywhere.

Before you can build a plugin app you must install all prerequisites.

Building web content#

  1. On the computer where the virtual desktop is installed, use the the following command to specify a value for the MVD_DESKTOP_DIR environment variable:

    export MVD_DESKTOP_DIR=/<path>/zowe/zlux-app-manager/virtual-desktop

    Where <path> is the install location of the virtual desktop.

  2. Navigate to /<plugin_dir>/webClient. If there is no /webClient directory, proceed to the Building server content section below.

  3. Run the npm install command to install any application dependencies. Check for successful return code.

  4. Run one of the following commands to build the application code:

    • Run the npm run build command to generate static content in the /web directory. (You can ignore warnings as long as the build is successful.)
    • Run the npm run start command to compile in real-time. Until you stop the script, it compiles code changes as you make them.

Building server content#

  1. Navigate to the plugin directory. If there is no /nodeServer directory in the plugin directory, procede to the Building Javascript content (*.js files) section below.

  2. Run the npm install command to install any application dependencies. Check for successful return code.

  3. Run one of the following commands to build the application code:

    • Run the npm run build command to generate static content in the /lib directory.
    • Run the npm run start command to compile in real-time. Until you stop the script, it compiles code changes as you make them.

Building Javascript content (*.js files)#

Unlike Typescript, Javascript is an interpreted language and does not need to be built. In most cases, reloading the page should build new code changes. For Iframes or other JS-based apps, close and open the app.

Installing#

Follow the steps described in Installing plugins to add your built plugin to the Zowe desktop.

Packaging#

For more information on how to package your Zowe app, developers can see Plugins definition and structure.