HyperIoT Front End Angular Application is a project that includes all tools necessary to manage IoT and BigData projects through hyperiot platform and to access realtime and offline data through a dashboard.
This project was generated with Angular CLI version 9.1.13.
Node v16 and Angular CLI are required to run this project.
The following instructions provide a step-by-step guide for setting up and developing Hyperiot-app locally.
use npm install to install project dependencies
HyperIoT-app relies on core, components and widgets libraries. Before running the application it is necessary to build the libraries with the command ng build <library-name>
Note: Libraries should be build in the following order: core, components, widgets
Note:
npm run build-libscan be used to build the libraries sequentially
The application requires backend services for most of its functions. For development purposes, it is possible to use Docker to start the services locally by following the procedure below.
- Install Docker
- Login to acsoftware registry with
docker login https://nexus.acsoftware.it:18079using the following credentials:
username: hyperiot-read-user
password: hyperiot-read-user- Run
docker-compose -f compose/docker-compose-svil-microservices-only.yml up - You can now divert the requests of your application to your local hyperiot services using
proxy-local.config.jsonfile.
Note: docker-compose-svil-microservices-only will start zookeeper, postgresql and karaf-microservices only. If additional services need to be launched, it is possible to modify the compose file or create a new one
Note: Data streaming will not work with the basic configuration
Run ng serve for a dev server. Navigate to http://localhost:4200/. The app will automatically reload if you change any of the source files.
Use the --proxy-config option to specify a proxy configuration file (e.g. ng serve --proxy-config proxy-local.config.json)
Refer to the Angular proxy documentation for additional info.
Note: Use
npm start(orng serve --proxy-config proxy-local.config.json) to start the application that proxies calls to your local services.
The project is designed to support multiple locales. Current available locales are english (default) and italian.
Use the --configuration option to start the application with a specified locale. (e.g. ng serve --configuration it).
Refer to the Angular internationalization documentation to add new locales or for additional info.
Note: The build using localization might fail due to a known issue. To resolve the error, remove the
node_modules\.cachefolder before launching the build.
Run ng generate component component-name to generate a new component. You can also use ng generate directive|pipe|service|class|guard|interface|enum|module.
Run ng build to build the project. The build artifacts will be stored in the dist/ directory.
To get more help on the Angular CLI use ng help or go check out the Angular CLI README.
Apache 2.0 License (click here to see license information.)