公式トップへ戻る
日本語 English
Hachiko Update Guide

Hachiko 更新案内仕様

Hachiko の更新確認は、公開サイト上の latest.json を参照して新しい版の有無を判定します。 更新ダイアログは「新しい版があることを知らせる」「公式ページを開く」ことを主目的にしています。

関連ドキュメント: ローカルAPI仕様

Hachiko は Windows Service を使うため、Store ではなく Win32 installer を前提にしています。 更新確認も Store 遷移ではなく、公式ページと installer 配布URL を使う形で運用します。

Goal

目的

  • 新しいバージョンの存在を知らせる
  • 利用者を公式ページへ案内する
  • Service 停止を伴う更新処理とは分離する

Non Goal

この機能がしないこと

  • アプリ内での自動更新そのもの
  • 購入やアドオン機能との連動
  • 通知を出した時点での Service 自動停止

Manifest

公開側は latest.json を更新する

Hachiko は公開サイト上の update manifest JSON を読みます。 現在の公開URLは https://hachiko.ritoa.jp/latest.json です。 

{
  "latest_version": "0.1.2",
  "published_at": "2026-06-18T00:00:00Z",
  "message": "Hachiko 0.1.2 を公開しました。",
  "release_notes_url": "update-guide.html",
  "store_product_url": "",
  "store_product_id": ""
}

Fields

manifest の項目

項目 必須 説明
latest_version はい 最新バージョン番号です。
published_at はい 公開日時です。
message はい 更新ダイアログに表示する短い案内文です。
release_notes_url はい 通常の誘導先です。相対パスでも絶対URLでも使えます。
store_product_url いいえ 将来用の予備項目です。現行運用では空でかまいません。
store_product_id いいえ 将来用の予備項目です。現行運用では空でかまいません。

Behavior

更新案内の解決順

  1. store_product_url があればそれを開く
  2. store_product_id があれば補助リンクとして使う
  3. どちらもなければ release_notes_url を開く

現在の Hachiko では通常 3 番目が使われ、公式トップ https://hachiko.ritoa.jp/ を開く運用です。

Dialog

ユーザーに見せる案内

更新確認ダイアログは、更新作業そのものではなく公開ページへの導線として扱います。 

新しいバージョンがあります。公開ページを開きますか？

Settings

アプリ側の設定値

  • update.enabled
  • update.manifest_url
  • update.check_on_start

現在の既定値は https://hachiko.ritoa.jp/latest.json です。