🚀 インストールガイド
AMBAは、macOS、Windows、およびLinux向けに自己完結型の高効率デスクトップアプリケーションとして提供されています。
🍏 macOSでのインストール手順
1. ディスクイメージ（.dmg）のダウンロード
ダウンロードポータルより最新パッケージを入手してください：
- Apple Silicon (M1/M2/M3/M4): 2020年以降のすべての現行Mac（MacBook Air/Pro、Mac mini等）に推奨。
- Intel x64: 従来のIntelプロセッサ搭載Mac用。
2. Applicationsフォルダへの追加
- ダウンロードした
.dmgファイルをダブルクリックして開きます。 - インストーラ画面で、AMBAアイコンをApplicationsフォルダのショートカットへドラッグ＆ドロップします。
- Finderでディスクイメージを取り出します（Eject）。
3. 初回起動とmacOS Gatekeeperについて
現在AMBAは企業向けパイロット検証版として配布されているため、初回起動時にmacOS Gatekeeperにより「開発元を検証できない」旨のダイアログが表示される場合があります：
パイロット版を初回起動する方法
- Finderを開き、**アプリケーション（Applications）**フォルダに移動します。
- AMBAアイコンを**右クリック（またはControlキーを押しながらクリック）し、「開く」**を選択します。
- 表示された確認ダイアログで、もう一度**「開く」**をクリックします。
- この操作は初回のみ必要です。2回目以降は通常通りLaunchpadやSpotlightから起動できます。
🪟 Windowsでのインストール手順
1. インストーラーのダウンロード
ダウンロードポータルより最新のWindows 64ビット版インストーラー（.exeまたは.msi）を入手します。
2. セットアップの実行
- ダウンロードしたインストーラーをダブルクリックして実行します。
- Windows SmartScreenの警告画面（「WindowsによってPCが保護されました」）が表示された場合：
- **「詳細情報」**をクリックします。
- **「実行」**ボタンをクリックします。
- 画面の案内に従ってセットアップを完了します。デスクトップにショートカットが作成されます。
🐧 Linuxでのインストール手順
AMBAはDebianパッケージ（.deb）およびスタンドアロンの.AppImage形式を通じて主要なLinuxディストリビューションを公式サポートしています。
1. Debian / Ubuntu環境でのインストール（.deb）
- ダウンロードポータルから最新の
.debパッケージ（AMBA_<version>_amd64.deb）を入手します。 - パッケージをインストールします。依存するランタイムライブラリはaptが自動で導入します：bashパッケージは
sudo apt-get update sudo apt install ./AMBA_*_amd64.debgnome-keyring（KDEではKWallet）を推奨パッケージとして指定しています。AMBAがAPIキーを保存するために必要です。--no-install-recommendsでインストールした場合や最小構成のデスクトップでは、sudo apt install gnome-keyringで導入してください。
2. スタンドアロンAppImage（Fedora / Arch / RHEL等）
- ダウンロードポータルから
.AppImageファイル（AMBA_<version>_amd64.AppImage）をダウンロードします。 - 動作に必要なライブラリが導入されていることを確認します：
- Debian / Ubuntu:
sudo apt install libwebkit2gtk-4.1-0 libayatana-appindicator3-1 gnome-keyring - Fedora / RHEL:
sudo dnf install webkit2gtk4.1 gnome-keyring - Arch Linux:
sudo pacman -S webkit2gtk-4.1 gnome-keyring
- Debian / Ubuntu:
- 実行権限を付与して起動します：bash
chmod +x AMBA_*_amd64.AppImage ./AMBA_*_amd64.AppImage
3. LinuxでのAPIキー保存（キーリング必須）
AMBAはAPIキーとコネクタの認証情報を、D-Bus経由のSecret Serviceキーリングにのみ保存します。平文やデータベースへの代替保存はありません。
- GNOME、KDE Plasma、XFCE、Cinnamon: 通常は GNOME Keyring または KWallet（5.97以降）がすでに動作しています。
- 軽量ウィンドウマネージャー（i3, sway, bspwm, Hyprland）またはKeePassXC: セッション内でSecret Serviceプロバイダーを起動してください（例:
gnome-keyring-daemon --start --components=secrets、またはKeePassXCのSecret Service連携を有効化）。 - キーリングが動作していない場合: AMBAは起動しますが、キーの保存は「システムキーチェーンを利用できません…」というメッセージで失敗し、設定 → システム診断 にキーチェーン利用不可と表示されます。GNOME KeyringまたはKWalletをインストール／有効化してからAMBAを再起動してください。
- 0.5.8以前からのアップデート: 旧バージョンが保存したキーは初回起動時にキーリングへ移行されます。キーリングがない間は、利用可能になるまでローカルデータベースに残ります。
🔄 自動アップデート機能
AMBAには安全な自動アップデート機構が組み込まれています。新バージョンが配信されると：
- 画面下部のステータスバーに通知アイコンが表示されます。
- 更新内容を確認し、ワンクリックで最新状態に更新できます。
- すべての更新パッケージは暗号化署名によって改ざん防止が検証されます。