自動更新¶

applanch は GitHub の新しいリリースを確認し、アプリ内から更新を適用できます。

更新の仕組み¶

起動時に applanch は GitHub Releases API に問い合わせ、実行中のバージョンと最新リリースを比較します。新しいバージョンが見つかった場合、メインウィンドウに更新バナーが表示されます。

更新時にダウンロードされるファイルは自己完結型の ZIP アーカイブで、以下の命名規則に従います。

applanch-{バージョン}-{ランタイム識別子}.zip

ランタイム識別子（例: win-x64）は実行中のビルドに合わせて自動的に選択されます。

新しいバージョンが利用可能になると、メインウィンドウのヘッダー下に更新バナーが表示されます。バナーには現在のバージョンと利用可能なバージョンが表示されます。

バナーを閉じた場合でも、ヘッダーの更新ボタンが引き続き表示されるため、いつでも更新を適用できます。

設定 → スタートアップ → アップデート検出時の動作 で設定します。

オプション	動作
通知のみ	バナーが表示されますが、インストールボタンはありません。バナーに表示されるリリースページから手動でダウンロードします。
手動（初期値）	バナーに更新ボタンが表示されます。クリックすると更新をダウンロードして適用します。完了後、applanch は自動的に再起動します。
自動適用	次回起動時に更新が自動的にダウンロードされ適用されます。操作は不要です。

再起動せずに最新バージョンをすぐに確認するには:

設定を開き → ヘッダーの 更新を確認 をクリックします。

設定 → スタートアップ → 起動時に更新を確認 で切り替えます。デフォルトで有効です。手動で更新を管理したい場合はオフにしてください。

更新の適用に失敗した場合、原因の説明とともに通知が表示されます。

原因	説明	推奨対処
ネットワークエラー	GitHub のダウンロードサーバーに接続できませんでした	ネットワーク接続を確認し、再試行してください
IO エラー	展開中にファイルを書き込めませんでした	ディスク容量を確認し、アプリのディレクトリへの書き込み権限があることを確認してください
アクセス拒否	アプリが自身のディレクトリへの書き込み権限を持っていません	アプリを書き込み可能な場所に移動するか、ユーザー向けインストーラーで再インストールしてください
無効なパッケージ	ダウンロードした ZIP アーカイブが破損しているか互換性がありません	再度更新を試みるか、手動でリリースをダウンロードしてください

失敗した場合でも、現在のバージョンは引き続き動作します。問題が解決しない場合は GitHub Releases から最新リリースを手動でダウンロードしてください。

設定 → スタートアップ → デバッグ更新モード を有効にすると、バージョンが同じ場合でも利用可能なリリースを更新対象として扱います。これは開発中に更新メカニズムをテストするためのものです。