Create a BAPP - Step by Step tutorial

Uno dei componenti principali del sistema OSP è la possibilità per chiunque di creare una applicazione per il sailing.

Ma come creare un'applicazione? Creare un'applicazione per OSP è semplice e veloce. In questo tutorial vado a spiegare come crearne una in semplici passag.

Per la spiegazione usiamo web.uniparthenope.it come host della nostra BAPP

Prima di tutto dobbiamo posizionarci nella cartella opt/fairwind 

cd opt/fairwind

Diamo il comando:

source etc/profile

Questo comando setta tutte le variabili di ambiente e il path per la creazione della BAPP. 

A questo punto possiamo creare tutte le BAPP di cui abbiamo bisogno.

E' semplice settare il template di base della BAPP mediante:

fairwind-bapp-create <nameOfBAPP> "Short description of BAPP"

Una volta settato il template la BAPP è situata in:

cd lib/dev/apis/<nameOfBAPP>

ed include semplice codice di esempio. Diviso in due sezioni:

  • Statica che contiene il frontend della BAPP
  • Codice che contiene la core application

Sezione Statica

Contenuta nella directory:

cd <nameOfBAPP>/static

In questa sezione viene inserito tutto il necessario per la GUI del sistema OSP. Scritto in HTML e JavaScript. Troviamo al suo interno due files: home.html e home.js dove verrà scitto il codice del frontend

Sezione Codice

La sezione codice è divisa in un file e una directory:

  • __init__.py contiene la dichiarazione delle classi usate dalla BAPP
  • the lib/ directory contiene il codice delle classi dichiarate in __init__.py

Alla fine della creazione per eseguire la BAPP dobbiamo tornare nella directory:

cd opt/fairwind

e lanciare:

./developer-run.sh

che esegue il server e inizializza la BAPP

Se dobbiamo fermare la BAPP bisogna inviare il segnale ctrl+z e poi eseguire:

./stop.sh

 che ferma l'app e rilascia la socket in uso.

Italiano