Lingara Lingara Ohjeet Oppaat API Kirjastot Sovellukset Rakenna Verkkosovellus
Kieli: Suomi

Lingara-sovellusten tekeminen

Tämä sivu on käännetty englannista. Jos ne eroavat toisistaan, englanninkielinen sivu on oikea. Lue englanninkielinen sivu

Lingara-sovellus on palvelin, jota ylläpidät itse. Kun oppija on asentanut sovelluksesi, Lingara lähettää palvelimellesi allekirjoitetun pyynnön, palvelimesi vastaa kortilla, ja Lingara piirtää kortin omalla tyylillään. Koodisi ei koskaan suoritu oppijan laitteella eikä koskaan näe, mitä Lingara sinne tallentaa.

Lingaralle sovellus on OAuth-asiakas, jolla on manifesti. Asiakas antaa sovelluksellesi sen identiteetin. Manifesti kertoo, missä sen kortti saa näkyä, mitä se pyytää nähdä ja minne Lingara lähettää sen pyynnöt.

Missä kortti näkyy

Manifestisi nimeää paikat, joihin korttisi saa tulla. Niitä on kaksi:

  • plans.empty_detail: tuntisuunnitelmanäkymän yksityiskohtaruutu silloin, kun yhtään suunnitelmaa ei ole valittu. Se piirretään verkossa, Androidilla ja iOS:llä aina, kun näyttö on tarpeeksi leveä kahdelle ruudulle.
  • home.side: verkon kotisivun sivupalsta.

Kun kumpaakaan paikkaa ei piirretä, oppija avaa sovelluksesi koko näytön kokoisena Sovellukset-kohdasta: verkossa konsolista ja Androidilla ja iOS:llä Asetuksista. Kukin paikka näyttää yhden sovelluksen kerrallaan. Kun oppija on asentanut samaan paikkaan useita sovelluksia, hän valitsee, minkä niistä paikka näyttää.

Kuka voi asentaa sovelluksen

Tällä hetkellä sovelluksen voi asentaa vain sen omistaja omalle tililleen. Muiden tekemät asennukset eivät ole vielä käytettävissä.

Mitä tarvitset

  • OAuth-asiakkaan, jonka luot konsolissa.
  • Palvelimen, joka vastaa Lingaran pyyntöihin HTTPS:n kautta.
  • Yhden alla olevista sovelluspaketeista. Paketti tarkistaa jokaisen pyynnön allekirjoituksen, pitää korttisi Lingaran rajoissa ennen kuin lähetät sen ja kirjoittaa vastauksen.

Pikaopas käy läpi koko polun uudesta asiakkaasta korttiin omalla tililläsi.

Asenna paketti

Valitse kielesi alta.

TypeScript

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

Rust

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

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

Java

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

Kotlin

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

Ruby

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

PHP

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

Sovelluksen tekeminen

  • Pikaopas

    Uudesta OAuth-asiakkaasta sovelluksesi korttiin omalla tililläsi.

  • Kortit

    Kahdeksan elementtiä, joista kortti koostuu, Lingaran soveltamat rajat ja se, mitä oppija näkee, kun kortti epäonnistuu.

  • Konteksti ja suostumus

    Mitä sovelluksesi voi saada tietää oppijasta, kenttä kentältä, ja miten oppija suostuu siihen.

  • Tutorin muistiinpano

    Yksi rivi, jonka sovelluksesi voi antaa Lingaran tutorille, ja säännöt, joiden läpi se kulkee.