C言語DB入門|別のWindows環境で動作を確認する

C言語DB入門|別のWindows環境で動作を確認する

前回は、実行ファイル、GTK 4・GLib・SQLiteのDLL、アイコンなどをまとめた配布用フォルダを作成しました。

今回は、このフォルダを別のWindows環境へコピーし、書籍管理アプリが動作するか確認します。

確認するのは、ウィンドウが表示されることだけではありません。書籍の登録・変更・削除ができること、終了後もデータが残ること、フォルダを移動しても正しい場所に保存されることまで確かめます。

開発側で使うコマンドは、VS Codeの統合ターミナルで実行します。動作確認先では、エクスプローラーからアプリを起動します。

なぜ別のWindows環境で確認するのか

開発用のパソコンには、MSYS2やGTK 4などがインストールされています。

そのため、配布用フォルダに必要なファイルが不足していても、開発環境にあるファイルが使われて動作する場合があります。

例えば、Windowsの通常のDLL検索では、実行ファイルのあるフォルダに加え、システムのフォルダやPATHに登録されたフォルダなどが検索対象になります。開発用ターミナルの環境が、不足しているDLLを補ってしまう可能性があります。

別のWindows環境で確認すると、こうした不足を見つけやすくなります。

確認すること分かること
開発ツールがない環境で起動する配布した実行ファイルと実行時ファイルで起動できるか
文字やボタンが正しく表示される画面表示に必要なファイルがそろっているか
書籍を登録・変更・削除できるSQLiteを使った操作が動作するか
終了後に再起動するデータがファイルに保存されているか
配布用フォルダを移動する開発時の固定パスに依存していないか

図1:配布用フォルダを別のパソコンへ渡す

この図から分かること

利用者に渡す単位は、実行ファイルだけではなく、必要なファイルをまとめたフォルダ全体です。

別のパソコンへ渡した状態で確認することで、実際の利用に近い条件でテストできます。

動作確認に使うWindows環境を用意する

この記事では、x64版Windows 11のパソコンを動作確認先の例にします。

これまで使ってきたMSYS2のUCRT64環境は、x86_64向けの環境です。今回の配布物も、その環境でビルドしたものを使います。

確認先には、次のような環境を用意します。

項目今回の確認条件
Windowsx64版Windows 11
開発ツールMSYS2、GTKの開発環境などを入れていない
操作するユーザー通常のユーザー
配置場所そのユーザーが書き込めるローカルフォルダ
起動方法エクスプローラーから実行ファイルをダブルクリック

別の実機がない場合は、開発ツールを入れていないWindowsの仮想マシンでも確認できます。ただし、画面描画には仮想マシンのグラフィックス環境も影響するため、可能であれば配布先に近い実機でも確認します。

同じ開発用パソコンで別のユーザーを作成しただけでは、パソコン全体に設定されたPATHなどが残る場合があります。独立したWindows環境を使うと、開発環境の影響を減らせます。

なお、ここでの動作確認は、使用したWindows環境についての結果です。別のWindowsバージョンにも対応すると案内する場合は、その環境でも確認してください。

配布用フォルダの内容を確認する

開発用パソコンの配布用フォルダは、次の場所にあります。

C:\c-db\chap08\book-manager

主な内容を確認します。

配布用フォルダからの相対パス内容
book-manager.exe書籍管理アプリ
libgtk-4-1.dllGTK 4の主要DLL
libglib-2.0-0.dllGLibの主要DLL
libgobject-2.0-0.dllGObjectの主要DLL
libgio-2.0-0.dllGIOの主要DLL
libgmodule-2.0-0.dllGModuleの主要DLL
libgdk_pixbuf-2.0-0.dllGdkPixbufの主要DLL
libsqlite3-0.dllSQLiteの主要DLL
その他のDLL収集スクリプトで確認した依存DLL
share\glib-2.0\schemasスキーマとgschemas.compiled
share\iconsアイコンテーマ
lib\gdk-pixbuf-2.0画像ローダーとloaders.cache
dataデータベースの保存用フォルダ

この表は主要な項目を示したものです。表に名前がないという理由で、前回準備した依存DLLを削除しないでください。

また、開発用パソコンでテストした場合は、data内にbooks.dbが作成されていることがあります。コピー前に、中にどのようなデータが入っているか確認しておきます。

確認先へフォルダ全体をコピーする

まず、書籍管理アプリを終了します。

データベースを別のツールで開いている場合は、そのツールも閉じてください。SQLiteのデータベースを更新中に通常のファイルコピーで複製すると、整合性のないコピーになるおそれがあります。

その後、USBメモリなどを使って、book-managerフォルダ全体を確認先へコピーします。

今回は、確認先のユーザーフォルダ内にAppsフォルダを作成し、その中へ配置する例にします。

項目配置例
ユーザーフォルダC:\Users\Taro
配布用フォルダC:\Users\Taro\Apps\book-manager
実行ファイルC:\Users\Taro\Apps\book-manager\book-manager.exe
データベースC:\Users\Taro\Apps\book-manager\data\books.db

Taroの部分は、実際のユーザーフォルダ名に読み替えてください。

今回のアプリは、実行ファイルのあるフォルダ内にデータを保存します。そのため、Program Filesなどの書き込みが制限される場所ではなく、ユーザーが書き込める場所で確認します。

空のデータベースから確認する場合

今回は、新規利用時の動作から確認します。

コピーした確認用フォルダのdata内にbooks.dbがある場合は、アプリを起動する前に、確認用フォルダ内のdataフォルダを丸ごと別の場所へ移動して保管します。

例えば、次のようにします。

移動前保管先の例
C:\Users\Taro\Apps\book-manager\dataC:\Users\Taro\Apps\book-manager-data-backup

保管先には、まだ存在しないフォルダ名を使ってください。開発用パソコンの元データはそのまま残します。

前の記事で変更したプログラムは、起動時にdataフォルダがなければ作成し、その中にbooks.dbを作成します。

エクスプローラーから起動する

確認先のエクスプローラーでbook-managerフォルダを開き、book-manager.exeをダブルクリックします。

この操作では、VS CodeやMSYS2を起動する必要はありません。

起動後は、次の項目を確認します。

確認項目期待する状態
ウィンドウ書籍管理アプリが表示される
日本語ラベルやボタンが読める
入力欄タイトルと著者を入力できる
書籍一覧空の状態で表示される
登録ボタン書籍を登録できる状態になっている
変更・削除ボタン未選択なので無効になっている
保存先の表示確認先のdata\books.dbを示している

保存先の表示例は、次のとおりです。

保存先:C:\Users\Taro\Apps\book-manager\data\books.db

ここに開発用パソコンのC:\c-db\chap08などが表示されている場合は、想定した実行ファイルを起動できていません。コピー元とコピー先の実行ファイルを確認します。

また、エクスプローラーでdataフォルダを開き、books.dbが作成されていることを確認してください。

書籍の登録と入力チェックを確認する

次のテストデータを使います。

項目入力内容
タイトルC言語の練習帳
著者山田太郎

タイトルと著者を入力して「登録」ボタンを押します。

期待する動作は、次のとおりです。

  • 一覧に書籍が追加される。
  • タイトルと著者が文字化けせずに表示される。
  • 登録後に入力欄が空になる。

続いて、入力チェックを確認します。

操作期待する動作
タイトルを空にして登録入力を促すメッセージが表示され、登録されない
著者を空にして登録入力を促すメッセージが表示され、登録されない
タイトルを空白だけにして登録登録されない
タイトルに全角空白だけを入力して登録登録されない

不正な入力を試した後は、クリアボタンで入力欄を空にします。

正常に登録した書籍が一覧に残っていることも確認してください。

書籍の選択・変更・クリアを確認する

登録した書籍を一覧で選択します。

タイトルと著者が入力欄に表示され、「登録」ボタンが無効になり、「変更」・「削除」ボタンが有効になることを確認します。

次に、タイトルを次の内容へ書き換え、「変更」ボタンを押します。

C言語の練習帳 改訂版

一覧のタイトルが変更され、同じ書籍が重複して増えていなければ、変更処理は期待どおりです。

続いて、クリアボタンの動作を確認します。

  1. 変更した書籍を選択する。
  2. 入力欄のタイトルを、一時的に別の内容へ書き換える。
  3. 変更ボタンを押さずに、クリアボタンを押す。
  4. 入力欄と選択状態が解除されることを確認する。
  5. 一覧のタイトルがC言語の練習帳 改訂版のままであることを確認する。

クリアは、入力欄と選択状態を初期状態へ戻す操作です。一覧に保存されている書籍が削除されていないことを確認します。

図2:画面操作とデータ保存を順番に確認する

この図から分かること

起動できても、すべての機能が正しく動くとは限りません。

画面の操作結果と、データが保存された結果を分けて確認すると、問題が起きた箇所を絞り込みやすくなります。

削除のキャンセルと確定を確認する

削除のテストには、別の書籍を追加します。

項目入力内容
タイトル削除テスト用の本
著者テスト著者

登録した削除テスト用の本を選択し、削除ボタンを押します。

確認画面が表示されたら、最初はキャンセルを選びます。

次の状態を確認してください。

  • 削除対象の書籍が一覧に残っている。
  • 書籍の選択状態と入力内容が残っている。
  • 別の書籍が削除されていない。

続いて、もう一度削除ボタンを押し、確認画面で削除を確定します。

削除テスト用の本だけが一覧から消え、C言語の練習帳 改訂版が残っていれば、期待どおりです。

終了してもデータが残ることを確認する

書籍管理アプリのウィンドウを閉じます。

アプリが終了した後、同じbook-manager.exeを再びダブルクリックします。

一覧にC言語の練習帳 改訂版が表示され、削除テスト用の本が表示されなければ、変更と削除の結果が保存されています。

再起動後の確認項目期待する状態
変更したタイトルC言語の練習帳 改訂版と表示される
著者山田太郎と表示される
削除した書籍表示されない
保存先再起動前と同じbooks.dbを示す

もし一覧が空になった場合は、まず画面の保存先を確認します。

別のフォルダにあるbook-manager.exeを起動した場合、そのフォルダ側のdata\books.dbが使われます。データが消えたと判断する前に、起動した実行ファイルと保存先を照合してください。

日本語と空白を含む場所へ移動する

次に、配布用フォルダが開発時の配置場所に依存していないか確認します。

アプリを完全に終了してから、book-managerフォルダ全体を次のような場所へ移動します。

C:\Users\Taro\Apps\配布 テスト\book-manager

配布とテストの間には、半角の空白を入れています。

移動後のbook-manager.exeを起動し、次の項目を確認します。

確認項目期待する状態
起動移動先でも起動する
画面表示文字や画面内のアイコンが表示される
既存データC言語の練習帳 改訂版が表示される
保存先移動先のdata\books.dbを示す
新しい登録移動先でも書籍を追加できる

保存先の表示例は、次のとおりです。

保存先:C:\Users\Taro\Apps\配布 テスト\book-manager\data\books.db

ここで既存の書籍が表示されるのは、dataフォルダも一緒に移動したためです。

実行ファイルだけを移動すると、DLLやアイコンが不足したり、別のデータベースが作成されたりします。移動する場合も、フォルダ全体を扱ってください。

ショートカットから起動して確認する

前の記事では、データベースの保存先を実行ファイルの場所から決めるように変更しました。

その動作を確かめるために、実行ファイルとは別の作業フォルダを指定したショートカットを使います。

アプリを終了してから、次の操作を行います。

  1. エクスプローラーでbook-manager.exeのショートカットを作成する。
  2. ショートカットをデスクトップへ置く。
  3. ショートカットのプロパティを開く。
  4. 作業フォルダー欄に、実在する別のフォルダを指定する。
  5. ショートカットからアプリを起動する。

設定例は次のとおりです。

設定項目設定例
リンク先"C:\Users\Taro\Apps\配布 テスト\book-manager\book-manager.exe"
作業フォルダーC:\Users\Taro

リンク先には空白が含まれるため、パス全体を二重引用符で囲みます。

起動後も、保存先が次の場所になっていることを確認します。

C:\Users\Taro\Apps\配布 テスト\book-manager\data\books.db

作業フォルダーを変えても、実行ファイルのある場所を基準に保存されていれば、意図した動作です。

なお、テストのたびに既存のアプリを終了してください。起動済みのアプリがあると、新しく起動したつもりでも既存のウィンドウが表示され、条件を変えた確認にならない場合があります。

問題が起きたときの確認方法

問題が起きた場合は、エラーメッセージ、起動した実行ファイルの場所、表示されている保存先を記録します。

症状最初に確認すること
DLLが見つからないと表示されるフォルダ全体をコピーしたか、DLL収集が正常終了したか
エントリポイントが見つからないと表示されるDLLのバージョンが混在していないか
Windowsで実行できないと表示される対象OSと実行ファイルのアーキテクチャが合っているか
起動直後に終了するDLL、実行時データ、Windowsのエラー記録
アイコンが欠けるshare\icons、画像ローダー、loaders.cache
データベースを開けない表示された保存先、フォルダの書き込み権限、空き容量
登録した書籍が見つからない別の配布用フォルダを起動していないか
画面が真っ白になる、描画が乱れるグラフィックスドライバーや仮想マシンの表示環境
DLLの不足が報告された場合

エラーに表示されたDLL名を、そのまま記録します。

開発用パソコンへ戻り、VS Codeの統合ターミナルでDLL収集スクリプトを再確認してください。

DLL名だけを頼りに別の配布サイトからファイルを集めると、バージョンやアーキテクチャが混在する原因になります。今回使ったUCRT64環境のファイルでそろえます。

修正後は、古い確認用フォルダへ何度も上書きするよりも、修正した配布物を新しい確認用フォルダへコピーすると、修正前の余分なファイルが残るのを防げます。

アイコンや画像の表示がおかしい場合

前の記事で準備した次の内容を確認します。

  • share\iconsのフォルダ構成が保たれている。
  • 画像ローダーのDLLがコピーされている。
  • loaders.cacheが空になっていない。
  • loaders.cache内のローダー指定が、開発用パソコンの固定パスを参照していない。

ただし、今回のアプリで表示する画面だけでは、すべての画像形式やローダーの動作までは確認できません。今後、表紙画像の表示などを追加した場合は、その機能も配布先でテストします。

データベースへ書き込めない場合

まず、保存先として表示されたフォルダに、通常のユーザー操作でファイルを作成できるか確認します。

今回の構成では、books.dbだけでなく、その親フォルダにも書き込める必要があります。

アプリを管理者として起動して解決させるのではなく、ユーザーが書き込める場所へ配置して確認します。

また、books.dbの横にあるジャーナルなどの関連ファイルを、原因が分からないまま削除しないでください。異常終了後の復旧に必要な場合があります。

図3:保存場所を変えてもデータを引き継ぐ

この図から分かること

今回のアプリでは、実行に必要なファイルとデータベースが配布用フォルダ内にまとまっています。

アプリを終了してからフォルダ全体を移動すると、データを含めて別の場所へ持ち運べます。

動作確認の結果を記録する

最後に、確認した環境と結果を記録します。

次の表を使い、実際に確認できた項目へ結果を書き込みます。

項目記録内容
確認日実施した日付
Windowsエディション、バージョン、OSビルド
システムの種類x64など
確認環境実機、または仮想マシン
配布物ビルド日や識別用の名前
配置場所確認したフォルダのパス
起動成功、またはエラー内容
登録・入力チェック確認結果
選択・変更・クリア確認結果
削除のキャンセル・確定確認結果
再起動後の保存内容確認結果
日本語・空白を含む場所への移動確認結果
ショートカットからの起動確認結果

Windowsの情報は、設定のシステム内にあるバージョン情報で確認できます。

テストで作成した書籍を、空の状態で渡す配布物へ混ぜないようにしてください。確認用のデータは保管し、最終的に渡すフォルダには意図した初期データだけを含めます。

次の記事では、動作を確認した配布用フォルダをZIPファイルにまとめ、利用者へ渡せる形にします。

Follow me!