ساخت برنامه‌های 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