3.0.0アップグレードガイド

本ページは以前のバージョン（2.x）から3.0.0へアップデートする方を対象に、注意点をまとめたものです。アップデート作業の前にかならずお読みください。

まずご留意いただきたいこと

アップデート作業には時間がかかりますため、しばらく本アプリを利用しない期間（数日程度）を選んで作業してください。
中央競馬のみご利用の場合は、作業を月曜日または火曜日に開始されることを強くおすすめします。
地方競馬をご利用になる場合は、netkeibaなど代替手段を必ず用意した上で、作業を行ってください。
作業を開始するまでは3.0.0のインストールは行わず、2.5.0など2.xのバージョンを引き続きご利用ください。インストール作業はすべてバックグラウンドで行えますが、インストール中は最新情報の更新に遅延が発生しますのでご了承ください。

Ver 3.0.0ではデータベースの構造にこれまでで一番大きい変更が加えられています。従来のバージョンから3.0.0へアップデートするさいの動作確認は何度か行っておりますが、それでも私の確認漏れによって利用者の大事なデータ（メモなど）が消えてしまうおそれがございます。

アップデート手順を実行する前に、ディスク容量の許す限り、以下を行っていただけますと大変ありがたいです。
何度か動作確認してメモなどのデータが壊れないことを確認しておりますが万が一のこともありますため、データベースのバックアップをおすすめします。

• 事前に本アプリを終了する
  • Swliteデータベースのビューアーアプリ（通常はアプリを開発するような人が利用するツールなのでほとんどの人は使ってないかも）を起動していればそれも終了する
  • データベースを開いている時にキャッシュファイルが生成されます。それがある状態でデータベースをコピーなどした場合の動作確認は行っていません
• C:\Users\[User name]\AppData\Local\KMYsofts\KmyKeiba\maindata.sqlite3にデータベースファイルがあるので、別のフォルダへコピーする（バックアップ）
  • [User name]はご自身のWindowsユーザー名に置き換えてください。
  • AppDataフォルダは通常は隠しフォルダになっています。エクスプローラの設定を変更した上でアクセスしてください。
• アプリ起動してアップデート作業を行い、一通り触って問題がなければバックファイルを削除する
• アップデートで何らかの問題が起きデータが破損した場合
  • 3.0.0をアンインストールし、必要に応じて2.5.0をインストールする
  • バックアップファイルを元の場所に「移動」ではなく「コピー」する（バックアップファイルが消えないように）
  • Twitterで製作者に問い合わせる

なおアップデートにおいて、既知のトラブルがございます。このページの下にまとめてあります。

2.xからのアップデート手順

データベースの再インストール、ならびにマスターデータの更新が必要になります。

中央競馬データを最初からインストールし直す
　↓
地方競馬データを最初からインストールし直す
　↓
マスターデータ更新

なお既存のデータベースに上書きすると、メモのデータがそのまま引き継がれることを想定しています。（簡単なデータであれば動作確認済ですが、がっつりメモを使う人向けの動作確認は大変時間がかかるので行っておりません）

上記作業を行わなかった場合の影響

上記作業を行わなくても本アプリは引き続きご利用いただけますが、以下の影響があります。逆に言うと拡張検索を使わず、過去データをあまり重視しない場合は自己責任で作業せずお使いいただいても大丈夫です（サポートはしません）

• 拡張検索で一部の項目を設定しても正常に検索されません。データが壊れたかのような検索結果が返ってくることもあります
• UmaConnをご利用の場合、地方重賞が正しく表示されません
• 過去レースのラップタイムが表示されません
• 傾向検索で「条件」で絞り込み検索しても、地方競馬のデータが正しく表示されません

アップデートにおける既知の問題点

アプリ起動直後のデータベースの初期化が異様に長い

データベースのマイグレーション処理を挟みますので、アップデート直後初回起動には時間がかかります。

不安であればCtrl+Shift+Escなどでタスクマネージャーを起動し、「詳細」タブよりKmyKeiba.Downloader.exeプロセスが残っていないか確認してください。
残っていた場合、プロセスが消えるまで待ってください。
残っていなかった場合、本アプリを再起動してみてください。何度かやってみてダメだったらご連絡ください。

なおこちらのテスト時は、データベースの初期化はすべて成功しました。

アップデートに失敗してデータベースのバックアップを復元した後、アプリが起動できなくなった

１，２回程度であれば、Windowsがファイルコピーに失敗してファイルが壊れている可能性がありますので、コピーをお試しください。
何回かやってダメだった場合、お気の毒ですがデータベースファイルは壊れています。データベースファイルを削除した上で再インストールが必要になりますが、メモ・印などのデータは消えます。

過去のレース結果が正常に表示されない、ラップタイムが表示されないなど

上記手順で案内したとおり、データベースの再インストールが必要です。必ず行ってください。

「拡張検索」機能で、中央重賞を検索しようとしても地方交流重賞、外国重賞が混ざるなど、挙動がおかしい

上記手順で案内したとおり、マスターデータの更新が必要です。必ず行ってください。
なおデータベースの再インストールを行っていない場合も、同様の問題が発生します。