開發 Lingara 應用程式
這頁是對英文翻譯過來的。若兩篇無仝,以英文頁為準。 看英文頁
Lingara 應用程式是一台你家己咧運行的伺服器。學習者安裝你的應用程式了後,Lingara 會送一个簽名過的請求去你的伺服器,你的伺服器用一張卡片回應,Lingara 才用伊家己的風格共彼張卡片畫出來。你的程式碼永遠袂佇學習者的裝置頂懸行,嘛永遠看袂著 Lingara 佇遐儲存的物件。
對 Lingara 來講,應用程式就是一个有清單的 OAuth 用戶端。用戶端予你的應用程式一个身分。清單就講明伊的卡片會使出現佇佗位、伊要求看啥物,閣有 Lingara 欲共請求送去佗位。
卡片出現佇佗位
你的清單列出你的卡片會使填入去的所在。總共有兩个:
plans.empty_detail:課程計畫畫面猶未揀任何計畫的時,彼个詳細資料窗格。只要螢幕闊甲會當顯示兩个窗格,網頁、Android 佮 iOS 攏會共伊畫出來。home.side:網頁首頁邊仔的欄。
兩个所在攏無畫出來的所在,學習者會使對「應用程式」用全螢幕拍開你的應用程式:網頁是佇控制台內底,Android 佮 iOS 是佇「設定」內底。逐个所在一擺干焦顯示一个應用程式。學習者若佇仝一个所在安裝幾若个應用程式,就由個家己揀遮欲顯示佗一个。
啥人會使安裝應用程式
這馬應用程式干焦會使由伊的主人安裝佇家己的帳戶。別人的安裝猶未開放。
你需要啥物
- 一个 OAuth 用戶端,你佇控制台建立。
- 一台用 HTTPS 回應 Lingara 請求的伺服器。
- 下跤其中一个應用程式套件。套件會檢查逐个請求的簽名,佇你送出卡片進前共伊限佇 Lingara 的上限內底,閣共回應寫好。
快速入門會紮你行過規个流程,對一个新的用戶端到你家己帳戶頂懸的一張卡片。
安裝套件
佇下跤揀你的語言。
TypeScript
npm install @lingara/apps@0.1.0-alpha.6Rust
cargo add lingara-apps@0.1.0-alpha.6 --features axum
cargo add axum@0.8
cargo add tokio --features macros,net,rt-multi-threadGo
go get github.com/Spinning-Cat-Studios/lingara_app_framework_sdk/go@v0.1.0-alpha.6Java
<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.6PHP
composer require spinningcatstudios/lingara-apps:0.1.0-alpha.6 spinningcatstudios/lingara:@alpha