デスクトップランチャーを起動する¶

ほとんどのユーザーにランチャーは不要です

Adaptive Learner はブラウザで直接動作します。インストールも、 Docker も、ランチャーも不要です： astrapi69.github.io/adaptive-learner。デスクトップランチャーが必要なのは、アプリを自分でホストしたい場合や、バックエンド機能（サーバーモード、ローカル同期）をローカルで動かしたい場合だけです。

デスクトップランチャーは、あなた自身のマシンで 独自のバックエンドとともに Adaptive Learner を動かす最も簡単な方法です。これは小さなウィンドウで、それ以外のすべてを代わりに行います。Docker が実行されているかを確認し、初回起動時にアプリのイメージをダウンロードしてビルドし（一度だけ、5-10 分が普通です）、コンテナを起動し、そして http://localhost:8501 でブラウザにアプリを開きます。同じウィンドウから、アプリの停止、ポートの変更、すべてのアンインストールも行えます。

ポートはデフォルトで 8501 で、ランチャーのウィンドウから変更できます。使用中の場合、ランチャーは空いているポートに切り替えます。

前提条件：Docker - ランチャーが自分で確認します¶

ランチャーは実行中の Docker を必要とします。アプリ自体がコンテナ群として動作するためです。ただし、手動で何かを確認する必要はありません。ランチャーは起動時に、Docker がインストールされ実行されているかを自分で確認し、別の Docker コンテキストで動作している Docker（Docker Desktop for Linux や rootless Docker など）も見つけ出し、何かが欠けている場合には解決策付きの明確なメッセージを表示します。Docker がまだ一切インストールされていない場合は：Docker Desktop をインストールする。

ランチャーのメッセージとその意味：

メッセージ	意味	解決策
「Docker がインストールされていません（docker が PATH にありません）。」	`docker` コマンドが見つかりませんでした。	Docker Desktop をインストールする。ランチャーはインストール用リンクを直接表示します。
「Docker はインストールされていますが、起動していません。」または「Docker が実行されていません。確認したコンテキスト '...'（...）：...」	Docker サービスが今は実行されていません。詳細形式では、確認したコンテキスト、ソケット、および Docker の元のエラーが示されます。	ランチャー内の「Docker を起動」ボタンをクリックする（Linux）か、Docker Desktop を開く（macOS/Windows）、その後「再確認」。
「Docker はインストールされていますが、権限がありません。」	あなたのユーザーが `docker` グループに属していません（Linux）。	ランチャーが正確なコマンドを表示します。その後、一度ログアウトして再度ログインしてください。
「Docker が応答しません。」	Docker はおそらくまだ起動中です（Docker Desktop を開いた直後によくあります）。	少し待ってから「再確認」。
「Docker はコンテキスト '...' 経由で実行されています - アクティブなコンテキストに到達できなかったため、ランチャーが自動的に接続しました。」	情報のみ：Docker は別のコンテキストで実行されており、ランチャーがそれを見つけて使用しています。	何もする必要はありません。
「Docker Desktop はインストールされていますが、PATH にありません。」	Docker Desktop アプリは存在しますが、そのコマンドラインツールが（まだ）到達可能になっていません。	ランチャーのボタンから Docker Desktop を起動し、少し待ちます。

詳細メッセージ付きのコンテキスト検出は、docker-app-launcher#26 に続くランチャーバージョンから搭載されています。それより古いバージョンでは、同じ表にある短いメッセージが表示されます。

ダウンロード¶

3 つのランチャーはすべて、各リリースに同梱されています。 github.com/astrapi69/adaptive-learner/releases：

プラットフォーム	ファイル	チェックサム
Linux	`adaptive-learner-launcher`	`adaptive-learner-launcher.sha256`
macOS	`adaptive-learner-launcher-macos.zip`	`adaptive-learner-launcher-macos.zip.sha256`
Windows	`adaptive-learner-launcher.exe`	`adaptive-learner-launcher.exe.sha256`

Linux¶

チェックサムを検証します（両方のファイルを同じフォルダーに）：
```
sha256sum -c adaptive-learner-launcher.sha256
```
実行権限を設定します。ブラウザのダウンロードは常にバイナリから実行権限を取り除くため、この手順は必ず必要です：
```
chmod +x adaptive-learner-launcher
```
起動します。ターミナルからが最も簡単です：
```
./adaptive-learner-launcher
```
環境によっては、ファイルマネージャーでのダブルクリックでも動作します。GNOME/Nautilus では、プロパティ > アクセス権で「ファイルをプログラムとして実行できるようにする」を設定する必要があります。ターミナルからの起動には、エラーメッセージを直接確認できるという利点があります。

既知の落とし穴：

「Permission denied」：手順 2（chmod +x）が抜けています。
起動時の GLIBC エラー：このバイナリは Ubuntu 22.04 上でビルドされており、glibc 2.35 以降が必要です（Ubuntu 22.04+、 Debian 12+、Fedora 36+）。より古いディストリビューションでは、代わりに install.sh または Docker Compose で直接アプリを実行してください。
アプリにブラウザから到達できない：アプリはローカルでのみ（localhost）動作するため、ファイアウォールのルールは不要です。ブラウザが自動的に開かない場合は、http://localhost:8501 （またはランチャーのウィンドウに表示されているポート）を手動で開いてください。

macOS¶

チェックサムを検証し、ZIP を展開します：

shasum -a 256 -c adaptive-learner-launcher-macos.zip.sha256
unzip adaptive-learner-launcher-macos.zip

初回起動時、Gatekeeper はこのバイナリを「未確認の開発者」からのものとしてブロックします。回避方法は 2 つあります：
- バイナリを右クリック（または Ctrl キーを押しながらクリック）して開くを選び、ダイアログで開くを確認します。 macOS はこれを以降のすべての起動について記憶します。
- あるいは：システム設定 > プライバシーとセキュリティ > 下にスクロールしてブロックされたアプリのところで このまま開く をクリックします。

Windows¶

チェックサムを検証します（PowerShell、両方のファイルを同じフォルダーに）：
```
Get-FileHash .\adaptive-learner-launcher.exe -Algorithm SHA256
Get-Content .\adaptive-learner-launcher.exe.sha256
```
2 つのハッシュ値が一致している必要があります。
adaptive-learner-launcher.exe をダブルクリックします。初回起動時に SmartScreen が警告します（「Windows によって PC が保護されました」）：詳細情報 をクリックし、続いて実行をクリックします。

うまくいかないときは¶

Docker が実行されていない場合、ランチャー自体が通知ダイアログを表示し、Docker Desktop の起動を提案します。
初回起動ではアプリのイメージをダウンロードしてビルドします。ランチャーのウィンドウにあるステップのチェックリスト（Check Docker / Download / Build / Start / Ready）が進捗を示します。以降の起動は高速です。
アプリの実行中は、いつでも http://localhost:8501（または変更したポート）で到達できます。ランチャーの「ブラウザで開く」ボタンも同じことを行います。