Differences
This shows you the differences between two versions of the page.
| Next revision | Previous revision | ||
|
app-notes:cumulocity-app [2017/01/17 15:53] shasha created |
app-notes:cumulocity-app [2017/02/10 14:27] (current) krepel [Installing Cumulocity UI plugins] |
||
|---|---|---|---|
| Line 1: | Line 1: | ||
| - | ==== Comulocity application ==== | + | ===== Build Comulocity Application ===== |
| + | |||
| + | ==== Prerequisites ==== | ||
| + | * You will need Node.js (6.7 or newer) | ||
| + | * You will need npm (installed with Node.js) | ||
| + | * You will need access to your Cumulocity account, i.e. you need your tenant name, username and password. | ||
| + | ==== Install Node.js and npm ==== | ||
| + | First download node.js: https://nodejs.org/dist/v7.3.0/node-v7.3.0-linux-x64.tar.gz | ||
| + | |||
| + | Then go to the download folder and unpack node.js. | ||
| + | <code bash> | ||
| + | tar –xzvf node-v7.3.0-linux-x64.tar.gz | ||
| + | </code> | ||
| + | Now we have to create a new folder for node.js. | ||
| + | <code bash> | ||
| + | mkdir /usr/local/node | ||
| + | </code> | ||
| + | Then we move all to the new folder. | ||
| + | <code bash> | ||
| + | mv node-v7.3.0-linux-x64/* /usr/local/node | ||
| + | </code> | ||
| + | At last we go to the root folder with **cd** and add the path of node.js. | ||
| + | <code bash> | ||
| + | export PATH=$PATH:/usr/local/node/bin | ||
| + | </code> | ||
| + | With echo $PATH we can see the paths. | ||
| + | ==== Command line interface ==== | ||
| + | Now we go to the /usr/local/node folder and install the comulocity-tools. | ||
| + | <code bash> | ||
| + | npm i cumulocity-tools –g | ||
| + | </code> | ||
| + | After this we can check the installation and we see the command what we can use to build our Cumulocity apps. | ||
| + | <code bash> | ||
| + | c8y --help | ||
| + | </code> | ||
| + | ==== Installing Cumulocity UI plugins ==== | ||
| + | Now the can create a folder for your Cumulocity app. In this folder we need a package.json file. This file we can create with: | ||
| + | <code bash> | ||
| + | npm init | ||
| + | </code> | ||
| + | We need for our app the Cumulocity UI plugins. So we install in this folder all the Cumulocity plugins. | ||
| + | <code bash> | ||
| + | c8y install latest | ||
| + | </code> | ||
| + | If you want, to see in detail how you can create your app then klick on this link: https://www.cumulocity.com/guides/web/introduction/ | ||
| + | |||
| + | To build the app go to the root folder of your app: | ||
| + | <code bash> | ||
| + | c8y build:app <app_name> | ||
| + | </code> | ||
| + | The app is stored in **/build** folder of your app. | ||
| + | |||
| + | If you are finished with your app, then you can build your app and upload to Cumulocity. | ||
| + | ==== Upload the application to Cumulocity ==== | ||
| + | Navigate to the Administation and klick to menu Own applications. | ||
| + | {{ :app-notes:screenshot_from_2017-01-10_15_08_13.png?nolink |}} | ||
| + | Then we have to klick to Add application. | ||
| + | {{ :app-notes:ownapp.png?nolink |}} | ||
| + | Then we get this window. In our case we want to upload the ZIP file. For this we klick at Upload ZIP file. | ||
| + | {{ :app-notes:upload.png?nolink |}} | ||
| + | Now we can drop our ZIP file in this square or klick at “Upload archive” to upload the file. | ||
| + | {{ :app-notes:upload1.png?nolink |}} | ||
| + | Take your application and klick “Open” and the file will be uploaded. | ||
| + | {{ :app-notes:finish.png?nolink |}} | ||