Membina aplikasi Lingara

Halaman ini diterjemahkan daripada bahasa Inggeris. Jika kedua-duanya berbeza, halaman bahasa Inggeris adalah yang betul. Baca halaman bahasa Inggeris

Aplikasi Lingara ialah pelayan yang anda jalankan. Apabila seorang pelajar telah memasang aplikasi anda, Lingara menghantar permintaan yang ditandatangani kepada pelayan anda, pelayan anda menjawab dengan kad, dan Lingara melukis kad itu dalam gayanya sendiri. Kod anda tidak pernah berjalan pada peranti pelajar dan tidak pernah melihat apa yang disimpan oleh Lingara di situ.

Bagi Lingara, aplikasi ialah klien OAuth yang mempunyai manifest. Klien memberikan identiti kepada aplikasi anda. Manifest menyatakan di mana kadnya boleh muncul, apa yang ia minta untuk dilihat, dan ke mana Lingara menghantar permintaannya.

Tempat kad muncul

Manifest anda menamakan slot yang boleh diisi oleh kad anda. Terdapat dua:

• plans.empty_detail: panel butiran pada skrin pelan pelajaran, semasa tiada pelan dipilih. Ia dilukis di web, Android dan iOS setiap kali skrin cukup lebar untuk memaparkan dua panel.
• home.side: lajur sisi Laman Utama di web.

Di tempat kedua-dua slot itu tidak dilukis, pelajar membuka aplikasi anda dalam skrin penuh daripada Aplikasi: dalam konsol di web, dan dalam Tetapan di Android dan iOS. Setiap slot memaparkan satu aplikasi pada satu masa. Apabila pelajar telah memasang beberapa aplikasi untuk slot yang sama, dia memilih aplikasi yang dipaparkan.

Siapa yang boleh memasang aplikasi

Buat masa ini, aplikasi hanya boleh dipasang oleh pemiliknya, pada akaunnya sendiri. Pemasangan oleh orang lain belum tersedia.

Apa yang anda perlukan

• Klien OAuth, yang anda cipta dalam konsol.
• Pelayan yang menjawab permintaan Lingara melalui HTTPS.
• Salah satu kit aplikasi di bawah. Kit menyemak tandatangan pada setiap permintaan, memastikan kad anda mematuhi had Lingara sebelum anda menghantarnya, dan menulis jawapan.

Permulaan pantas membawa anda melalui keseluruhan laluan, daripada klien baharu hingga kad pada akaun anda sendiri.

Pasang kit

Pilih bahasa anda di bawah.

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