Lingara uygulamaları geliştirmek

Bu sayfa İngilizceden çevrilmiştir. İkisi arasında fark varsa İngilizce sayfa doğrudur. İngilizce sayfayı oku

Bir Lingara uygulaması, sizin çalıştırdığınız bir sunucudur. Bir öğrenci uygulamanızı kurduğunda Lingara sunucunuza imzalı bir istek gönderir, sunucunuz bir kartla yanıt verir ve Lingara bu kartı kendi stiliyle çizer. Kodunuz hiçbir zaman öğrencinin cihazında çalışmaz ve Lingara’nın orada sakladıklarını hiçbir zaman görmez.

Lingara için bir uygulama, manifestosu olan bir OAuth istemcisidir. İstemci, uygulamanıza kimliğini verir. Manifesto ise kartının nerede görünebileceğini, neyi görmek istediğini ve Lingara’nın isteklerini nereye gönderdiğini söyler.

Bir kart nerede görünür

Manifestonuz, kartınızın doldurabileceği yerleri adlandırır. İki tane vardır:

• plans.empty_detail: Ders Planları ekranının ayrıntı bölmesi, hiçbir plan seçili değilken. Ekran iki bölme gösterecek kadar geniş olduğunda web’de, Android’de ve iOS’ta çizilir.
• home.side: web’deki ana sayfanın yan sütunu.

Bu yerlerden hiçbirinin çizilmediği durumlarda öğrenci uygulamanızı Uygulamalar bölümünden tam ekran açar: web’de konsolda, Android ve iOS’ta ise Ayarlar’da. Her yer aynı anda tek bir uygulama gösterir. Bir öğrenci aynı yer için birden fazla uygulama kurduğunda, orada hangisinin gösterileceğini kendisi seçer.

Bir uygulamayı kim kurabilir

Şu anda bir uygulama yalnızca sahibi tarafından, kendi hesabına kurulabilir. Başka birinin kurması henüz mümkün değildir.

Neye ihtiyacınız var

• Konsolda oluşturduğunuz bir OAuth istemcisi.
• Lingara’nın isteklerini HTTPS üzerinden yanıtlayan bir sunucu.
• Aşağıdaki uygulama kitlerinden biri. Bir kit her isteğin imzasını kontrol eder, kartınızı göndermeden önce Lingara’nın sınırları içinde tutar ve yanıtı yazar.

Hızlı başlangıç sayfası, yeni bir istemciden kendi hesabınızdaki bir karta kadar tüm yolu adım adım anlatır.

Bir kit kurun

Aşağıdan dilinizi seçin.

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