Membuat aplikasi Lingara

Halaman ini diterjemahkan dari bahasa Inggris. Jika keduanya berbeda, halaman bahasa Inggris yang benar. Baca halaman bahasa Inggris

Aplikasi Lingara adalah server yang Anda jalankan. Ketika pelajar telah memasang aplikasi Anda, Lingara mengirimkan permintaan bertanda tangan ke server Anda, server Anda menjawab dengan sebuah kartu, dan Lingara menggambar kartu itu dengan gayanya sendiri. Kode Anda tidak pernah berjalan di perangkat pelajar dan tidak pernah melihat apa yang disimpan Lingara di sana.

Bagi Lingara, aplikasi adalah klien OAuth yang memiliki manifest. Klien memberikan identitas kepada aplikasi Anda. Manifest menyatakan di mana kartunya dapat muncul, apa yang dimintanya untuk dilihat, dan ke mana Lingara mengirimkan permintaannya.

Tempat kartu muncul

Manifest Anda menyebutkan slot yang dapat diisi oleh kartu Anda. Ada dua:

• plans.empty_detail: panel detail di layar rencana pelajaran, selama belum ada rencana yang dipilih. Panel ini digambar di web, Android, dan iOS setiap kali layar cukup lebar untuk menampilkan dua panel.
• home.side: kolom samping halaman beranda di web.

Di tempat yang tidak menggambar slot mana pun, pelajar membuka aplikasi Anda dalam layar penuh dari menu Aplikasi: di konsol pada web, dan di Pengaturan pada Android dan iOS. Setiap slot menampilkan satu aplikasi pada satu waktu. Jika pelajar telah memasang beberapa aplikasi untuk slot yang sama, merekalah yang memilih aplikasi mana yang ditampilkan.

Siapa yang dapat memasang aplikasi

Saat ini, aplikasi hanya dapat dipasang oleh pemiliknya, di akunnya sendiri. Pemasangan oleh orang lain belum tersedia.

Yang Anda perlukan

• Klien OAuth, yang Anda buat di konsol.
• Server yang menjawab permintaan Lingara melalui HTTPS.
• Salah satu kit aplikasi di bawah. Kit memeriksa tanda tangan pada setiap permintaan, menjaga kartu Anda tetap dalam batas Lingara sebelum Anda mengirimnya, dan menulis balasannya.

Panduan cepat menjelaskan seluruh alurnya, dari klien baru hingga kartu di akun 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