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