Creare app per Lingara

Questa pagina è tradotta dall'inglese. Se le due versioni differiscono, fa fede la pagina in inglese. Leggi la pagina in inglese

Un’app Lingara è un server che gestisci tu. Quando uno studente ha installato la tua app, Lingara invia al tuo server una richiesta firmata, il tuo server risponde con una scheda e Lingara disegna quella scheda nel proprio stile. Il tuo codice non viene mai eseguito sul dispositivo dello studente e non vede mai ciò che Lingara vi memorizza.

Per Lingara, un’app è un client OAuth con un manifest. Il client dà alla tua app la sua identità. Il manifest indica dove può comparire la sua scheda, cosa chiede di vedere e dove Lingara invia le sue richieste.

Dove compare una scheda

Il tuo manifest nomina gli spazi che la tua scheda può occupare. Sono due:

• plans.empty_detail: il riquadro di dettaglio della schermata dei piani di lezione, finché nessun piano è selezionato. Viene disegnato sul web, su Android e su iOS ogni volta che lo schermo è abbastanza largo da mostrare due riquadri.
• home.side: la colonna laterale della pagina Home sul web.

Dove nessuno dei due spazi viene disegnato, lo studente apre la tua app a schermo intero da App: nella console sul web, e in Impostazioni su Android e iOS. Ogni spazio mostra una sola app alla volta. Quando uno studente ha installato più app per lo stesso spazio, sceglie quale mostrare.

Chi può installare un’app

Oggi un’app può essere installata solo dal suo proprietario, sul proprio account. Le installazioni da parte di chiunque altro non sono ancora disponibili.

Cosa ti serve

• Un client OAuth, che crei nella console.
• Un server che risponde alle richieste di Lingara tramite HTTPS.
• Uno dei kit per app qui sotto. Un kit verifica la firma di ogni richiesta, mantiene la tua scheda entro i limiti di Lingara prima che tu la invii e scrive la risposta.

La guida rapida percorre tutto il cammino, da un nuovo client fino a una scheda sul tuo account.

Installare un kit

Scegli il tuo linguaggio qui sotto.

npm install @lingara/apps@0.1.0-alpha.6

cargo add lingara-apps@0.1.0-alpha.6 --features axum
cargo add axum@0.8
cargo add tokio --features macros,net,rt-multi-thread

go get github.com/Spinning-Cat-Studios/lingara_app_framework_sdk/go@v0.1.0-alpha.6

<dependency>
  <groupId>com.getlingara</groupId>
  <artifactId>lingara-apps-java</artifactId>
  <version>0.1.0-alpha.6</version>
</dependency>

implementation("com.getlingara:lingara-apps-kotlin:0.1.0-alpha.6")

gem install lingara-apps -v 0.1.0-alpha.6

composer require spinningcatstudios/lingara-apps:0.1.0-alpha.6 spinningcatstudios/lingara:@alpha