Installation (Linux / Xinchuang)

cc-class fournit des paquets Linux pour amd64 (x86_64) et arm64 (national/Xinchuang : Phytium, Kunpeng, etc.). Le rôle enseignant/élève est toujours décidé par le nom de l'ordinateur (voir Détection automatique).

Paquets disponibles :

cc-class_1.0.18_amd64.deb            # installation en ligne x86_64 (récupère auto. les dépendances)
cc-class_1.0.18_arm64.deb            # arm64 / Xinchuang
cc-class_1.0.18_amd64-offline.tar.gz # paquet hors ligne (toutes les dépendances + install.sh)

1. Installation en ligne (la machine a une source apt)

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

apt récupère les dépendances d'exécution (xdotool, wmctrl, x11-utils, libxtst6, ffmpeg, libssl3, bibliothèques audio/polices, etc.).

2. Installation hors ligne (pas de source apt — recommandée pour les laboratoires)

Le paquet hors ligne contient le .deb principal, chaque dépendance .deb, et 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 installe les dépendances depuis deps/ avec dpkg, puis le paquet principal — aucune connexion Internet ni source apt requise.

Désinstallation

sudo ./install.sh --uninstall, ou sudo apt remove cc-class.

3. Ce que fait l'installation

Élément	Détails
Répertoire du programme	/opt/cc-class/ (TeacherApp, StudentApp, StudentService, libs/, plugins/, tools/ffmpeg, start_teacher.sh, start_student.sh)
Menu des applications	/usr/share/applications/cc-class-teacher.desktop, cc-class-student.desktop
Services systemd	cc-class-student.service (démarrage automatique, protège l'application élève) cc-class-teacher.service (démarrage manuel, à la demande)
Règle udev	99-cc-class-vdchardev.rules : permet aux utilisateurs normaux de lire /dev/vdchardev pour la détection du rôle (nom du bureau cloud)
Icône de bureau	gérée par le démon élève au démarrage selon le rôle : l'enseignant obtient l'icône, l'élève n'en obtient aucune
Wayland	bascule automatiquement GDM vers Xorg (voir ci-dessous)

À propos de Wayland → Xorg (à lire impérativement)

Ubuntu 22.04/24.04 utilisent par défaut une session Wayland, mais sous Wayland la diffusion d'écran (capture) et le contrôle à distance (injection XTest) ne fonctionnent pas — une limitation commune à tous les logiciels de classe.

Le paquet désactive donc Wayland dans GDM automatiquement (/etc/gdm3/custom.conf reçoit WaylandEnable=false ; l'original est sauvegardé sous *.cc-class-orig et restauré lors de la désinstallation).

Nécessite une déconnexion/un redémarrage pour prendre effet

Une fois GDM reconfiguré, déconnectez-vous puis reconnectez-vous, en veillant à une session Xorg sur l'écran de connexion (ou redémarrez simplement). Sinon, l'application enseignant avertit « Wayland détecté, diffusion/contrôle à distance indisponible ».

4. Exécution

• Machine élève : s'exécute automatiquement via cc-class-student.service après l'installation — rien à faire.

• Machine enseignant : double-cliquez sur l'icône de bureau cc-class Enseignant, ou :

  systemctl start cc-class-teacher        # démarrer via le service
  # ou exécuter directement
  /opt/cc-class/start_teacher.sh

  Au premier lancement, vous choisissez un canal d'enseignement, puis la fenêtre principale s'ouvre.

Gérer le service manuellement

systemctl status  cc-class-student     # état du démon élève
systemctl restart cc-class-student     # redémarrer (réévalue le rôle après un renommage)
journalctl -u cc-class-student -e      # journaux

Le journal de décision de rôle du démon (le nom d'ordinateur détecté et le résultat enseignant/élève) est écrit dans /tmp/cc-class-service.log, ce qui est pratique pour le dépannage.

5. arm64 / Xinchuang

arm64 s'installe exactement comme amd64, en utilisant cc-class_1.0.18_arm64.deb ou le paquet hors ligne correspondant. Les dépendances arm64 sont pré-intégrées sous deps/arm64/.

Ensuite 👉 Guide enseignant ｜ Guide élève