インストール (Linux / 信創)

cc-class は amd64 (x86_64) および arm64（国産／信創：Phytium、Kunpeng など）向けの Linux パッケージを提供します。教師／生徒の役割は引き続きコンピューター名によって判断されます（自動判別 を参照）。

利用可能なパッケージ：

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 注入）が動作しません — これはすべての教室ソフトウェアに共通する制限です。

そのため、本パッケージは GDM で Wayland を自動的に無効化します（/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 / 信創

arm64 は、cc-class_1.0.18_arm64.deb または対応するオフラインバンドルを使い、amd64 とまったく同じようにインストールできます。arm64 の依存関係は deps/arm64/ 以下にあらかじめバンドルされています。

次へ 👉 教師ガイド ｜ 生徒ガイド