التثبيت (Linux / Xinchuang)

يوفّر cc-class حزم Linux لـ amd64 (x86_64) وarm64 (المحلية/Xinchuang: Phytium، Kunpeng، إلخ). لا يزال دور المعلم/الطالب يُحدَّد عبر اسم الحاسوب (انظر الكشف التلقائي).

الحزم المتاحة:

cc-class_1.0.18_amd64.deb            # x86_64 online install (auto-pulls deps)
cc-class_1.0.18_arm64.deb            # arm64 / Xinchuang
cc-class_1.0.18_amd64-offline.tar.gz # offline bundle (all deps + install.sh)

1. التثبيت بالاتصال (الجهاز لديه مصدر apt)

sudo apt install ./cc-class_1.0.18_amd64.deb

يجلب apt تبعيات وقت التشغيل (xdotool، wmctrl، x11-utils، libxtst6، ffmpeg، libssl3، مكتبات الصوت/الخطوط، إلخ).

2. التثبيت دون اتصال (لا مصدر apt — موصى به للمختبرات)

تحتوي الحزمة دون اتصال على ملف .deb الرئيسي، وكل تبعية .deb، وinstall.sh:

tar xzf cc-class_1.0.18_amd64-offline.tar.gz
cd cc-class_1.0.18_amd64-offline
sudo ./install.sh

يثبّت install.sh التبعيات من deps/ باستخدام dpkg، ثم الحزمة الرئيسية — دون الحاجة إلى إنترنت أو مصدر apt.

إلغاء التثبيت

sudo ./install.sh --uninstall، أو sudo apt remove cc-class.

3. ما الذي يفعله التثبيت

العنصر	التفاصيل
مجلد البرنامج	/opt/cc-class/ (TeacherApp، StudentApp، StudentService، libs/، plugins/، tools/ffmpeg، start_teacher.sh، start_student.sh)
قائمة التطبيقات	/usr/share/applications/cc-class-teacher.desktop، cc-class-student.desktop
خدمات systemd	cc-class-student.service (بدء تلقائي، يحمي تطبيق الطالب) cc-class-teacher.service (بدء يدوي، عند الطلب)
قاعدة udev	99-cc-class-vdchardev.rules: تتيح للمستخدمين العاديين قراءة /dev/vdchardev لأجل الكشف عن الدور (اسم سطح المكتب السحابي)
أيقونة سطح المكتب	تتولاها خدمة الطالب الخفية عند الإقلاع حسب الدور: المعلم يحصل على الأيقونة، الطالب لا يحصل على شيء
Wayland	يبدّل GDM تلقائيًا إلى Xorg (انظر أدناه)

حول Wayland → Xorg (يجب قراءته)

يستخدم Ubuntu 22.04/24.04 افتراضيًا جلسة Wayland، لكن تحت Wayland لا يعمل بثّ الشاشة (الالتقاط) ولا التحكم عن بُعد (حقن XTest) — وهو قيد شائع في جميع برامج الفصول.

لذا تعطّل الحزمة Wayland في GDM تلقائيًا (يحصل /etc/gdm3/custom.conf على WaylandEnable=false؛ ويُحتفَظ بنسخة احتياطية من الأصل باسم *.cc-class-orig ويُستعاد عند إلغاء التثبيت).

يتطلب تسجيل الخروج/إعادة التشغيل ليصبح فعّالًا

بعد إعادة ضبط GDM، سجّل الخروج وادخل من جديد، مع التأكد من جلسة Xorg في شاشة تسجيل الدخول (أو أعد التشغيل فقط). وإلا فسيحذّر تطبيق المعلم "تم اكتشاف Wayland، البثّ/التحكم عن بُعد غير متاح".

4. التشغيل

• جهاز الطالب: يعمل تلقائيًا عبر cc-class-student.service بعد التثبيت — لا شيء لفعله.

• جهاز المعلم: انقر نقرًا مزدوجًا على أيقونة سطح المكتب cc-class Teacher، أو:

  systemctl start cc-class-teacher        # start via the service
  # or run directly
  /opt/cc-class/start_teacher.sh

  عند أول تشغيل تختار قناة تدريس، ثم تُفتح النافذة الرئيسية.

إدارة الخدمة يدويًا

systemctl status  cc-class-student     # student daemon status
systemctl restart cc-class-student     # restart (re-evaluates role after a rename)
journalctl -u cc-class-student -e      # logs

يُكتَب سجلّ قرار الدور للخدمة الخفية (اسم الحاسوب المكتشَف ونتيجة المعلم/الطالب) إلى /tmp/cc-class-service.log، وهو مفيد لاستكشاف الأخطاء.

5. arm64 / Xinchuang

يُثبَّت arm64 تمامًا مثل amd64، باستخدام cc-class_1.0.18_arm64.deb أو الحزمة المطابقة دون اتصال. تبعيات arm64 مُرفَقة مسبقًا تحت deps/arm64/.

التالي 👉 دليل المعلم ｜ دليل الطالب