Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revisionPrevious revision
Next revision
Previous revision
Last revisionBoth sides next revision
app-notes:cumulocity-app [2017/01/17 15:54] shashaapp-notes:cumulocity-app [2017/02/10 14:24] – [Installing Cumulocity UI plugins] krepel
Line 1: Line 1:
-==== Comulocity application ====+===== Build Comulocity Application ===== 
 + 
 +==== Prerequisites ====
   * You will need Node.js (6.7 or newer)   * You will need Node.js (6.7 or newer)
   * You will need npm (installed with Node.js)   * 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.   * 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_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 |}}