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
app-notes:cumulocity-app [2017/01/17 15:54] shashaapp-notes:cumulocity-app [2017/02/10 14:27] (current) – [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 <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 |}}