The application package (@c8y/apps
) provides example applications for the Web SDK.
To use the @c8y/apps you need to install the @c8y/cli. Refer to its documentation for installation instructions. Once installed you can run:
For example, to generate the tutorial application with the name my-app
you need to run:
The c8ycli new
command can also be provided on its own without the [name]
and [template]
options. In this case a few steps will have to be completed via the interface before the app is scaffolded:
Step 1:
The first step will ask for the project name. If no project name is entered, the default value my-application
will be used.
Info: This step can also be skipped if the name is provided in the initial command:
c8ycli new my-application
.
Step 2:
In the second step, the base scaffolding version must be selected. The interface will provide the last GA release (latest), the latest available release (next) and four older GA releases. Additionally a version can be manually entered by selecting the other
option.
Step 2 (other):
In this step, the desired version must be entered manually e.g. 1010.0.0
.
Info: This question will appear only if
other
was selected in the previous step.
Step 3:
In the final step, the base project to scaffold from must be selected.
Info: This step will only show projects which are available for the selected version in Step 2.
The following table provides an overview on the currently supported applications:
Name | Description |
---|---|
application |
An empty application to quickly bootstrap new applications. It is the default application and used if you don't specify an [example-name] . |
hybrid |
Also an empty application but running in hybrid mode. That means it can import angularjs plugins and therefore can be used for migration purpose. |
tutorial |
An application that already assembles most of the concepts of the @c8y/ngx-components. Use this to get real code examples. |
widget-plugin |
An Module Federation plugin that can be used to create your own custom widgets. |
cockpit |
The Cockpit default application. Use this to extend the existing Cockpit application. |
devicemanagement |
The Devicemanagement default application. Use this to extend the existing Device Management application. |
administration |
The Administration default application. Use this to extend the existing Administration application. |