Lingara Lingara Dokumentasyon Mga gabay API Mga library Mga app Gumawa Web app
Wika: Filipino

Paggawa ng mga Lingara app

Isinalin mula sa Ingles ang pahinang ito. Kung magkaiba ang dalawa, ang pahinang Ingles ang tama. Basahin ang pahinang Ingles

Ang isang Lingara app ay isang server na pinapatakbo mo. Kapag na-install ng isang mag-aaral ang app mo, nagpapadala ang Lingara ng pinirmahang kahilingan sa server mo, sumasagot ang server mo gamit ang isang card, at iginuguhit ng Lingara ang card na iyon sa sarili nitong istilo. Hindi kailanman tumatakbo ang code mo sa device ng mag-aaral at hindi nito kailanman nakikita ang iniimbak ng Lingara roon.

Para sa Lingara, ang isang app ay isang OAuth client na may manifest. Ang client ang nagbibigay ng pagkakakilanlan sa app mo. Sinasabi ng manifest kung saan maaaring lumabas ang card nito, kung ano ang hinihiling nitong makita, at kung saan ipinapadala ng Lingara ang mga kahilingan nito.

Saan lumalabas ang isang card

Pinapangalanan ng manifest mo ang mga slot na puwedeng punan ng card mo. Dalawa ang mga ito:

  • plans.empty_detail: ang detail pane ng screen ng mga plano ng aralin, habang walang napiling plano. Iginuguhit ito sa web, Android at iOS tuwing sapat ang lapad ng screen para magpakita ng dalawang pane.
  • home.side: ang gilid na hanay ng home page sa web.

Kung saan hindi iginuguhit ang alinmang slot, binubuksan ng mag-aaral ang app mo nang full screen mula sa Mga app: sa console sa web, at sa Mga Setting sa Android at iOS. Isang app lang ang ipinapakita ng bawat slot sa isang pagkakataon. Kapag nakapag-install ang mag-aaral ng ilang app para sa iisang slot, siya ang pumipili kung alin ang ipapakita nito.

Sino ang puwedeng mag-install ng app

Sa ngayon, ang may-ari lang ng app ang puwedeng mag-install nito, sa sarili niyang account. Hindi pa available ang pag-install ng ibang tao.

Ang kailangan mo

  • Isang OAuth client, na ginagawa mo sa console.
  • Isang server na sumasagot sa mga kahilingan ng Lingara sa HTTPS.
  • Isa sa mga app kit sa ibaba. Sinusuri ng kit ang pirma sa bawat kahilingan, pinapanatili ang card mo sa loob ng mga limitasyon ng Lingara bago mo ito ipadala, at isinusulat ang sagot.

Dinadaanan ng quickstart ang buong landas, mula sa bagong client hanggang sa isang card sa sarili mong account.

Mag-install ng kit

Piliin ang wika mo sa ibaba.

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

Paggawa ng app

  • Quickstart

    Mula sa bagong OAuth client hanggang sa card ng app mo sa sarili mong account.

  • Mga card

    Ang walong elementong bumubuo sa isang card, ang mga limitasyong inilalapat ng Lingara, at kung ano ang nakikita ng mag-aaral kapag nabigo ang isang card.

  • Context at pahintulot

    Ano ang malalaman ng app mo tungkol sa isang mag-aaral, bawat field, at kung paano ito sinasang-ayunan ng mag-aaral.

  • Ang tala sa tutor

    Isang linyang maaaring ialok ng app mo sa tutor ng Lingara, at ang mga patakarang dinadaanan nito.