Instalación (Linux / Xinchuang)

cc-class ofrece paquetes Linux para amd64 (x86_64) y arm64 (nacional/Xinchuang: Phytium, Kunpeng, etc.). El rol profesor/alumno sigue decidiéndose por el nombre del equipo (consulta Detección automática).

Paquetes disponibles:

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. Instalación en línea (la máquina tiene una fuente apt)

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

apt incorpora las dependencias de tiempo de ejecución (xdotool, wmctrl, x11-utils, libxtst6, ffmpeg, libssl3, bibliotecas de audio/fuentes, etc.).

2. Instalación sin conexión (sin fuente apt — recomendada para laboratorios)

El paquete sin conexión contiene el .deb principal, todos los .deb de dependencias e 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 instala las dependencias de deps/ con dpkg y luego el paquete principal — sin internet ni fuente apt necesarios.

Desinstalación

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

3. Qué hace la instalación

Elemento	Detalles
Directorio del programa	/opt/cc-class/ (TeacherApp, StudentApp, StudentService, libs/, plugins/, tools/ffmpeg, start_teacher.sh, start_student.sh)
Menú de aplicaciones	/usr/share/applications/cc-class-teacher.desktop, cc-class-student.desktop
Servicios systemd	cc-class-student.service (inicio automático, vigila la aplicación de alumno) cc-class-teacher.service (inicio manual, bajo demanda)
Regla udev	99-cc-class-vdchardev.rules: permite a los usuarios normales leer /dev/vdchardev para la detección de rol (nombre de escritorio en la nube)
Icono de escritorio	gestionado por el demonio de alumno al arrancar según el rol: el profesor obtiene el icono, el alumno ninguno
Wayland	cambia automáticamente GDM a Xorg (ver abajo)

Sobre Wayland → Xorg (lectura obligatoria)

Ubuntu 22.04/24.04 usan por defecto una sesión Wayland, pero bajo Wayland la difusión de pantalla (captura) y el control remoto (inyección XTest) no funcionan — una limitación común a todo el software de aula.

Por eso el paquete desactiva Wayland en GDM automáticamente (/etc/gdm3/custom.conf recibe WaylandEnable=false; el original se respalda como *.cc-class-orig y se restaura al desinstalar).

Requiere cerrar sesión/reiniciar para surtir efecto

Después de reconfigurar GDM, cierra la sesión y vuelve a iniciarla, asegurándote de una sesión Xorg en la pantalla de inicio de sesión (o simplemente reinicia). De lo contrario, la aplicación del profesor advierte "Wayland detectado, difusión/control remoto no disponibles".

4. Ejecución

• Máquina de alumno: se ejecuta automáticamente mediante cc-class-student.service tras la instalación — nada que hacer.

• Máquina de profesor: haz doble clic en el icono de escritorio cc-class Teacher, o:

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

  En el primer inicio eliges un canal de enseñanza, luego se abre la ventana principal.

Gestión manual del servicio

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

El registro de decisión de rol del demonio (el nombre de equipo detectado y el resultado profesor/alumno) se escribe en /tmp/cc-class-service.log, lo cual es útil para diagnóstico.

5. arm64 / Xinchuang

arm64 se instala exactamente igual que amd64, usando cc-class_1.0.18_arm64.deb o el paquete sin conexión correspondiente. Las dependencias arm64 vienen preempaquetadas en deps/arm64/.

Siguiente 👉 Guía del profesor ｜ Guía del alumno