Установка (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 Преподаватель на рабочем столе или:

  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/.

Далее 👉 Руководство преподавателя ｜ Руководство ученика