Elftia のアップデート
Elftia には自動アップデート機能が組み込まれており、常に最新バージョンを使用できるようになっています。このページでは、アップデートの仕組みと手動でアップデートする方法を説明します。
自動アップデート
Elftia は自動アップデートに electron-updater を使用しています。デフォルトでは、アプリケーションがバックグラウンドで自動的にアップデートを確認します。
アップデートの流れ
- アップデートの確認: Elftia の起動時および動作中に、アップデートサーバーへ定期的に問い合わせて新しいバージョンを確認します。
- アップデートのダウンロード: 新しいバージョンが見つかると、インストーラーがバックグラウンドで自動的にダウンロードされます。ダウンロード中もアプリケーションをそのまま使用できます。
- インストール通知: ダウンロードが完了すると、アプリケーションにアップデート通知が表示され、新しいバージョンの準備ができたことを知らせます。
- 再起動してインストール: 通知内の「再起動してインストール」をクリックすると、アプリケーションが終了し、アップデートがインストールされ、自動的に再起動します。
アップデート処理はデータに影響しません。チャット履歴、設定、API Keys、その他のデータはすべて、アップデート後もそのまま保持されます。
アップデートチャンネル
Elftia はバージョン文字列に基づいてアップデートチャンネルを自動的に判定します。
| チャンネル | バージョン例 | 説明 |
|---|---|---|
| latest | 1.0.0 | 安定版リリース。すべてのユーザーに推奨されます |
| beta | 1.1.0-beta.1 | 新機能を含むベータ版ですが、問題が発生する可能性があります |
| alpha | 1.2.0-alpha.3 | 開発者とテスター向けの早期プレビューです |
デフォルトでは、latest チャンネルのアップデートのみを受け取ります。新機能を早めに試したい場合は、ベータ版アップデートに参加できます。
手動でアップデートを確認する
利用可能なアップデートをすぐに確認するには、次の手順を実行します。
- 設定 → バージョン情報 を開きます。
- 現在のバージョン番号とアップデート状態が表示されます。
- アップデートを確認 ボタンをクリックします。
- システムがすぐにアップデートサーバーへ問い合わせます。
- 新しいバージョンが利用可能な場合は、バージョン番号とアップデートノートが表示され、その後ダウンロードが開始されます。
- すでに最新の場合は、「すでに最新バージョンです」と表示されます。
ダウンロードの進捗
アップデートパッケージのダウンロード中は、バージョン情報ページでダウンロードの進捗を確認できます。
- ダウンロードの割合と速度が表示されます。
- ダウンロードはバックグラウンドで実行でき、通常の使用には影響しません。
- ネットワークが切断された場合は、接続が復旧するとダウンロードが自動的に再試行されます。
再起動してインストール
アップデートのダウンロードが完了したら、次の流れになります。
- アプリケーションに通知が表示されるか、バージョン情報ページに「再起動してインストール」ボタンが表示されます。
- ボタンをクリックすると、Elftia は次の処理を行います。
- 未保存の状態をすべて保存
- アプリケーションを終了
- アップデートのインストールを実行
- 自動的に再起動
- アップデートのインストールには、通常は数秒から 1 分程度かかります。
後で再起動することもできます。アップデートはすでにダウンロード済みで、次回通常どおりアプリケーションを閉じて再起動したときに自動的にインストールされます。
Steam 版のアップデート
Elftia の Steam 版を使用している場合、アップデートの仕組みは異なります。
| 比較 | 標準版 | Steam 版 |
|---|---|---|
| アップデート確認 | アプリ内で自動 | Steam クライアント経由で自動 |
| ダウンロード方法 | アプリ内のバックグラウンドダウンロード | Steam ダウンロード |
| インストール方法 | アプリを再起動 | Steam が自動インストール |
| 手動トリガー | 設定 → バージョン情報 → アップデートを確認 | Steam → ゲームを右クリック → アップデートを確認 |
Steam 版のアップデートは Steam クライアントによって完全に管理されるため、Elftia 内で操作する必要はありません。
ポータブル版の手動アップデート
ポータブル版を使用している場合、自動アップデートを利用できないことがあります。手動アップデートの手順は次のとおりです。
- 公式 Web サイトまたは GitHub Releases から最新バージョンのインストーラーをダウンロードします。
- 現在実行中の Elftia を終了します。
- 新しいバージョンをインストールします。
- Windows: 新しいインストーラーを実行します。古いバージョンは自動的に置き換えられます。
- macOS: Applications フォルダ内の古い .app を新しいものに置き換えます。
- Linux: 古い AppImage ファイルを置き換えます。
- 新しいバージョンを起動します。
データはユーザーデータディレクトリに保存されます。アプリケーションのインストールディレクトリには保存されないため、手動アップデートでデータが失われることはありません。
アップデート失敗時のトラブルシューティング
自動アップデートに失敗した場合は、次の手順を試してください。
ダウンロード失敗
- ネットワークの問題: インターネット接続を確認してください。プロキシを使用している場合は、プロキシ設定が正しいことを確認してください（プロキシの使用 を参照）。
- ディスク容量: アップデートパッケージ用に十分なディスク容量があることを確認してください（通常は一時領域として 200-500 MB が必要です）。
- ファイアウォール: ファイアウォールが Elftia のアップデートサーバーへのアクセスをブロックしていないことを確認してください。
インストール失敗
- 権限の問題: Windows では、アップデートのインストールに管理者権限が必要になる場合があります。Elftia を管理者として実行してみてください。
- ファイルのロック: Elftia のインストールディレクトリ内のファイルが、他のプログラムによってロックされていないことを確認してください。
- 手動アップデート: 自動インストールが繰り返し失敗する場合は、最新バージョンをダウンロードして手動でインストールしてください。
ロールバック
新しいバージョンに問題がある場合は、次の手順を実行します。
- GitHub Releases から以前の安定版をダウンロードします。
- 現在のバージョンをアンインストールします。
- 古いバージョンをインストールします。
- データはユーザーデータディレクトリに保存されているため、保持されます。
まれに、新しいバージョンにデータベースマイグレーションが含まれる場合があります。新しいバージョンがすでにマイグレーションを実行している状態で古いバージョンへロールバックすると、互換性の問題が発生する可能性があります。アップデート前に、バックアップとして 設定 → システム → Export Diagnostics から診断情報をエクスポートしておくことを推奨します。
バージョン番号の形式
Elftia は semantic versioning に従います。
major.minor.patch[-prerelease]
| 部分 | 意味 | 例 |
|---|---|---|
| メジャーバージョン | 大きな変更または互換性のない更新 | 2.0.0 |
| マイナーバージョン | 新機能。後方互換性があります | 1.1.0 |
| パッチ | バグ修正と軽微な改善 | 1.0.1 |
| プレリリース | ベータ版 | 1.1.0-beta.1 |