ساختن اپلیکیشن‌های Lingara

این صفحه از انگلیسی ترجمه شده است. اگر این دو با هم فرق داشته باشند، صفحهٔ انگلیسی درست است. صفحهٔ انگلیسی را بخوانید

اپلیکیشن Lingara سروری است که خود شما اجرا می‌کنید. وقتی یک آموزنده اپلیکیشن شما را نصب کرده باشد، Lingara یک درخواست امضاشده به سرور شما می‌فرستد، سرور شما با یک کارت پاسخ می‌دهد، و Lingara آن کارت را به سبک خودش ترسیم می‌کند. کود شما هرگز روی دستگاه آموزنده اجرا نمی‌شود و هرگز آنچه Lingara در آنجا ذخیره می‌کند را نمی‌بیند.

از نظر Lingara، اپلیکیشن یک کلاینت OAuth با یک مانیفست است. کلاینت هویت اپلیکیشن شما را به آن می‌دهد. مانیفست می‌گوید کارت آن کجا می‌تواند نمایش داده شود، چه چیزی را می‌خواهد ببیند و Lingara درخواست‌هایش را به کجا بفرستد.

کارت کجا نمایش داده می‌شود

مانیفست شما جایگاه‌هایی را که کارت شما می‌تواند پر کند نام می‌برد. دو جایگاه وجود دارد:

• plans.empty_detail: پنل جزئیات صفحهٔ برنامه‌های درسی، تا زمانی که هیچ برنامه‌ای انتخاب نشده باشد. این جایگاه در ویب، Android و iOS هر زمان که صفحه به اندازهٔ کافی عریض باشد که دو پنل را نشان دهد ترسیم می‌شود.
• home.side: ستون کناری صفحهٔ خانه در ویب.

در جایی که هیچ‌کدام از این دو جایگاه ترسیم نمی‌شود، آموزنده اپلیکیشن شما را به صورت تمام‌صفحه از «اپلیکیشن‌ها» باز می‌کند: در کنسول در ویب، و در تنظیمات در Android و iOS. هر جایگاه در هر زمان یک اپلیکیشن را نشان می‌دهد. وقتی آموزنده چند اپلیکیشن برای یک جایگاه نصب کرده باشد، خودش انتخاب می‌کند کدام نشان داده شود.

چه کسی می‌تواند اپلیکیشن را نصب کند

فعلاً یک اپلیکیشن را تنها مالک آن، روی حساب خودش، می‌تواند نصب کند. نصب توسط هر کس دیگری هنوز در دسترس نیست.

آنچه نیاز دارید

• یک کلاینت OAuth، که آن را در کنسول ایجاد می‌کنید.
• سروری که از طریق HTTPS به درخواست‌های Lingara پاسخ دهد.
• یکی از کیت‌های اپلیکیشن در پایین. کیت امضای هر درخواست را بررسی می‌کند، پیش از فرستادن کارت شما آن را در حدود Lingara نگه می‌دارد و پاسخ را می‌نویسد.

شروع سریع تمام مسیر را، از یک کلاینت تازه تا یک کارت روی حساب خودتان، قدم به قدم طی می‌کند.

نصب یک کیت

زبان خود را در پایین انتخاب کنید.

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