بناء تطبيقات Lingara

هذه الصفحة مترجمة من الإنجليزية. إذا اختلفت النسختان، فالصفحة الإنجليزية هي الصحيحة. اقرأ الصفحة الإنجليزية

تطبيق Lingara هو خادم تشغّله أنت. عندما يثبّت متعلّم تطبيقك، ترسل Lingara إلى خادمك طلبًا موقّعًا، فيردّ خادمك ببطاقة، وترسم Lingara تلك البطاقة بأسلوبها الخاص. لا تعمل شيفرتك أبدًا على جهاز المتعلّم، ولا ترى أبدًا ما تخزّنه Lingara هناك.

بالنسبة إلى Lingara، التطبيق هو عميل OAuth له بيان. يمنح العميل تطبيقك هويته. ويحدّد البيان أين يمكن أن تظهر بطاقته، وما يطلب رؤيته، وإلى أين ترسل Lingara طلباتها.

أين تظهر البطاقة

يسمّي بيانك الخانات التي يمكن أن تشغلها بطاقتك. وهي اثنتان:

• plans.empty_detail: لوحة التفاصيل في شاشة خطط الدروس، طالما لم تُحدَّد أي خطة. تُرسم على الويب وAndroid وiOS كلما كانت الشاشة عريضة بما يكفي لعرض لوحتين.
• home.side: العمود الجانبي في الصفحة الرئيسية على الويب.

حيث لا تُرسم أيّ من الخانتين، يفتح المتعلّم تطبيقك بملء الشاشة من «التطبيقات»: في وحدة التحكم على الويب، وفي الإعدادات على Android وiOS. تعرض كل خانة تطبيقًا واحدًا في كل مرة. وعندما يثبّت المتعلّم عدة تطبيقات للخانة نفسها، يختار هو أيّها تعرضه.

من يمكنه تثبيت تطبيق

اليوم لا يمكن تثبيت التطبيق إلا من قِبل مالكه، على حسابه الخاص. التثبيت من قِبل أي شخص آخر غير متاح بعد.

ما تحتاجه

• عميل OAuth، تنشئه في وحدة التحكم.
• خادم يجيب عن طلبات Lingara عبر HTTPS.
• إحدى حِزم التطبيقات أدناه. تتحقّق الحزمة من التوقيع على كل طلب، وتُبقي بطاقتك ضمن حدود 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