【ITニュース解説】How AIClaw 3.7.15 Makes Windows Updates Easier with an Installer

アプリケーションを常に最新の状態に保つことは重要だが、その更新作業は手間がかかる場合がある。特に多くのデスクトップアプリケーションが採用しているZIPファイル形式での配布は、ユーザーにとって繰り返し行う手動作業が多いという課題があった。

これまでのZIPファイルによるアプリケーションの更新は、新しいバージョンのZIPファイルをダウンロードし、現在実行中のアプリケーションを終了させ、ダウンロードしたファイルを解凍し、正しいディレクトリに上書きするという手動作業を伴っていた。これは、アプリケーションをインストールせずに持ち運べる「ポータブル版」としては便利な形態だが、頻繁にリリースが公開される場合、その都度これらの手作業を繰り返すのは非常に煩雑だった。

AIClawの最新バージョン3.7.15では、この課題に対し、Windows x64環境向けのインストーラーが新たに導入された。これにより、従来のZIPファイルによる配布に加え、より簡便な更新方法が提供されるようになった。

新しいインストーラーを使った更新のプロセスは、アプリケーションが利用者に代わっていくつかのステップを自動的に実行することで、手動でのファイル管理作業を大幅に削減する。まず、AIClawアプリケーションは、開発プラットフォームであるGitHub上で公開されている最新のリリース情報を確認し、現在インストールされているバージョンよりも新しいバージョンが存在するかどうかをチェックする。もし新しいバージョンが見つかった場合、そのバージョンに対応したWindowsセットアップ実行ファイルを一時的なディレクトリにダウンロードする。

ファイルが無事にダウンロードされると、次にそのファイルの「完全性」を確認する重要なステップに入る。アプリケーションは、リリースとともに提供されている「SHA256SUMS.txt」というチェックサムファイルもダウンロードする。そして、ダウンロードしたセットアップ実行ファイルの固有のハッシュ値（これを「ダイジェスト」と呼ぶ）を算出し、チェックサムファイルに記載されているダイジェストと比較するのだ。このチェックサムは、ダウンロード中にファイルが破損したり、改ざんされたりしていないかを検証するためのものだ。ダイジェストが一致すれば、ダウンロードしたファイルが正規であると判断でき、アプリケーションの安全性と信頼性を確保する。

チェックサムによる検証が成功した後、AIClawはWindowsオペレーティングシステムに対して、ダウンロードしたインストーラーの起動を依頼する。インストーラーの起動が成功し、Windowsに処理が引き渡されると、AIClaw自身は自動的に終了する。しかし、この時点ではまだインストールが完了したわけではない。その後のインストール作業は、インストーラーの指示に従ってユーザー自身が行う必要があり、例えば途中でインストールをキャンセルすることも可能だ。アプリケーションは「サイレントインストール」と呼ばれる、ユーザーの操作なしに自動でインストールを進める方式は採用していないため、インストールに関する最終的な決定権は常にユーザーが持つ。もしユーザーがインストーラーのウィザードをキャンセルした場合でも、古いバージョンのAIClawを再び起動して利用できる。

この更新プロセスにおいては、安全性とユーザー体験への配慮が随所にみられる。例えば、チェックサムの不一致やインストーラーファイルのダウンロード失敗、あるいはWindowsがインストーラーを起動できなかった場合など、何らかの問題が発生した場合でも、AIClawアプリケーションはすぐに終了せず、実行を継続する。問題が発生した際には、ダウンロードした一時ファイルを削除し、ユーザーが手動でダウンロード状況を確認できるよう、リリースページをブラウザで開く。これにより、ユーザーは状況を把握し、適切な対処を選択できる。また、アプリケーションは開発モードからのインストールを拒否し、インストーラーが提供されていない古いリリースに対しては、これまで通りのZIPダウンロードと展開の手法にフォールバックする仕組みも備えている。これは、過去のリリースとの互換性を保ちつつ、新しいインストーラーの利便性を提供するための設計と言える。

チェックサムによる完全性チェックは、ダウンロードされた実行ファイルが、リリース元が提供したものと完全に一致することを保証する。しかし、これは発行元の身元を独立して証明するものではない点に注意が必要だ。ダウンロードされた実行ファイルとチェックサムの両方が同じ配布チャネルから提供されるため、チェックサムはあくまで「その配布チャネルから提供されたものが改ざんされていないか」を確認するものとなる。現在のインストーラーには、Windowsがアプリケーションの信頼性を確認するために用いる「Authenticode署名」が施されていない。そのため、Windowsはインストーラーの起動時に「不明な発行元からのアプリケーションです」といった警告を表示する可能性がある。AIClawの実装では、このWindowsの保護機能を無効化したり、チェックサムを署名として扱ったりしない。ユーザーは警告を理解した上でインストールを進めるか判断する必要がある。

インストーラーの作成プロセスも効率的に設計されている。インストーラーをビルドするスクリプトは、既存のパッケージングツールによって既に生成されているWindowsアプリケーションのディレクトリをそのまま利用する。そこからアプリケーションのバージョン情報を読み取り、「electron-builder」というツールが利用するNSIS（Nullsoft Scriptable Install System）という仕組みを通じてインストーラーが生成される。この設定では、アプリケーションIDは安定したものが使われ、インストーラーはウィザード形式で進行し、セットアップファイル名にはバージョン情報が含まれる。また、インストール先のディレクトリをユーザーが自由に選択できないように設定されており、アンインストール時にユーザーのアプリケーションデータ（設定ファイルなど）を削除しないようにdeleteAppDataOnUninstall=falseと設定されている。これは、アプリケーションのバージョンアップによってプログラムファイルが置き換わっても、ユーザーの設定やチャット履歴などの大切なデータが失われないようにするためだ。設定ファイルやユーザーが作成したデータは、プログラム本体とは別の場所に保存され、インストーラーがプログラムフォルダにそれらを移動させることはない。

既存のZIP版AIClawを利用しているユーザーが、今回導入されたインストーラー版へ移行する場合、最初の更新は手動で行う必要がある。これは、新しいセットアップ実行ファイルをダウンロードし、インストールを実行し、生成された新しいショートカットからアプリケーションを起動する手順を踏むことを意味する。古いZIP版のアプリケーションは自動的に削除されるわけではないため、ユーザー自身で古いディレクトリを削除する必要があるかもしれない。また、古いZIP版のAIClawに搭載されているアップデーターは、GitHub上にインストーラーが公開されたからといって、自動的に新しいインストーラーを利用する挙動に変わるわけではない。一度インストーラー版に移行し、新しい実装でAIClawが動作するようになれば、それ以降はインストーラーが提供される将来のアップデートにおいては、今回解説した自動ダウンロード・起動のパスを利用できるようになる。もちろん、これまで通りZIPファイルでの配布も継続されるため、ポータブル版を好むユーザーは引き続きZIP版を選択することも可能だ。

この新しい更新メカニズムの品質を保証するため、開発チームは複数のテストを行っている。アップデーターの回帰テストでは、Electronフレームワークやネットワークの応答を模擬的に作り出し、チェックサムが有効な場合の正しい起動と終了の順序、不正なチェックサムや欠落したチェックサムの場合の挙動、OSによる起動失敗、ZIP版へのフォールバック、更新がない場合や開発版のケース、リリースAPIの障害など、多岐にわたるシナリオを検証する。これらのテストは、アップデーターの意思決定ロジックが正しく機能するかを確認するものであり、実際のWindowsインストーラーの実行は伴わない。

実際のWindowsインストーラーの動作は、「ネイティブスモークスクリプト」と呼ばれる別のテストで検証される。このテストは、Windows環境で実行され、スペースを含む一時的なパスへのインストール、期待されるアプリケーションファイルの存在確認、プログラムファイルの一部を意図的に古いものに置き換えてからの再インストールによる正しい置き換えの検証、そしてユーザーデータが保存される二つの場所に「センチネルファイル」（目印となるファイル）を配置し、インストール、再インストール、アンインストール後にそれらが適切に扱われているかを確認する。このスクリプトは自動テストのためサイレントインストールフラグを使用するが、ユーザーが対話的に更新を行う際の動作とは異なる。このテストは、すべての異なるバージョン間の移行や、現実のユーザーデータベースの完全な検証をシミュレートするものではないが、インストーラーの基本的な機能とデータの永続性が適切であることを確認する上で非常に重要である。

最終的に、AIClaw v3.7.15の公開リリースは、Windowsインストーラーのビルドを含む一連のワークフローが正常に完了したことを確認した上で公開された。これにより、アプリケーションのダウンロード、完全性の確認、インストーラーの起動、そしてアップグレードの完了という一連のプロセスにおいて、ユーザーが手動で行うファイル管理の手間が大幅に削減され、より明確で安全な更新体験が提供されるようになった。