C言語GUI入門|インストーラーによる配布を知る

これまでに、GUI電卓を開発環境の外でも実行できるようにし、ZIP形式の配布ファイルを作成しました。

ZIP形式は手軽に配布できる便利な方法ですが、利用者は自分でファイルを展開し、calculator.exeを探して起動する必要があります。

インストーラーを利用すると、GUI電卓を指定した場所へ配置したり、スタートメニューへ登録したり、不要になったときにアンインストールしたりできます。

この記事では、次の内容を解説します。

  • ポータブル版とインストール版の違い
  • インストーラーが行う処理
  • スタートメニューへ登録する目的
  • アンインストールの仕組み
  • GTKウィジェットと配布ファイルの関係
  • 初学者がZIP形式から始める理由

この記事では、インストーラーの仕組みを理解することを目標にします。実際のインストーラー作成は、GUI電卓の配布に慣れてから取り組んでも大丈夫です。

ポータブル版とは

ZIPファイルを展開し、その中にあるcalculator.exeを直接起動する配布方法をポータブル版と呼びます。

これまでに作成したGUI電卓の配布ファイルは、ポータブル版に当たります。

配布先のディレクトリは、次のような構成になっています。

calculator
├─ calculator.exe
├─ GTK 4の実行に必要なDLL
├─ share
├─ etc
├─ README.txt
└─ LICENSES

GResourceを使用しているため、calculator.cssとimages\calculator.pngはcalculator.exeに埋め込まれています。そのため、この2つを外部ファイルとして配置する必要はありません。

ポータブル版には、次の特徴があります。

  • ZIPファイルを展開するだけで使える
  • インストール操作が必要ない
  • USBメモリーなどへコピーしやすい
  • 配置する場所を利用者が自由に決められる
  • 不要になったときはディレクトリごと削除できる
  • スタートメニューには自動登録されない
  • アンインストールの項目は作成されない

インストール版とは

インストール版では、setup.exeなどのインストーラーを利用してアプリを配置します。

利用者がインストーラーを起動すると、一般的には次のような画面が順番に表示されます。

  • 使用許諾や注意事項
  • インストール先の選択
  • スタートメニューへの登録
  • デスクトップショートカットの選択
  • インストール内容の確認
  • インストール完了

インストーラーは、単にcalculator.exeをコピーするだけではありません。GTK 4に必要なDLLやディレクトリも、決められた場所へまとめて配置します。

図1:ポータブル版とインストール版の違い

この図から分かること

ポータブル版では、ZIPファイルを展開してcalculator.exeを直接起動します。

インストール版では、インストーラーが必要なファイルの配置やショートカットの作成を行います。利用者にとっては、インストール版のほうが一般的なWindowsアプリに近い操作になります。

ポータブル版とインストール版を比較する

両者の違いを整理すると、次のようになります。

比較項目ポータブル版インストール版
配布ファイルcalculator.zipsetup.exeなど
使用開始までの操作ZIPを展開するインストーラーを実行する
アプリの配置利用者が決めるインストーラーが決める
スタートメニュー通常は登録されない登録できる
デスクトップショートカット利用者が作成する選択して作成できる
アンインストールディレクトリを削除するアンインストーラーを実行する
更新新しいZIPへ入れ替える更新用インストーラーを実行する
作成の難しさ比較的簡単設定や動作確認が必要
配布前の確認比較的少ないインストールと削除の確認も必要

ポータブル版とインストール版のどちらが優れているということではありません。アプリの規模や利用者に合わせて選びます。

今回のGUI電卓のような小さなアプリでは、ポータブル版でも十分に配布できます。

インストーラーの役割

インストーラーの主な役割は、アプリを利用できる状態に整えることです。

一般的なインストーラーは、次の処理を行います。

  • アプリのファイルを決められた場所へコピーする
  • 必要なディレクトリを作成する
  • スタートメニューへショートカットを登録する
  • 必要に応じてデスクトップへショートカットを作成する
  • アプリの名前やバージョンをWindowsへ登録する
  • アンインストーラーを作成する
  • アンインストール時に削除するファイルを記録する
  • インストールに必要な権限を確認する

GUI電卓の場合、インストーラーへ渡す元データは、ZIPを作成するときに確認したcalculatorディレクトリ一式です。

calculator.exeだけをインストーラーへ登録しても、GTK 4に必要なDLLがなければ起動できません。

インストーラーへ含めるファイル

GUI電卓のインストーラーには、基本的に次のファイルを含めます。

種類内容
実行ファイルcalculator.exe
DLLGTK 4とその関連ライブラリ
shareディレクトリGTKが使用する共有データ
etcディレクトリGTK関連の設定ファイル
説明書README.txt
ライセンス情報LICENSESディレクトリ

GResourceで埋め込んだcalculator.cssとcalculator.pngは、calculator.exeの内部に保存されています。そのため、外部ファイルとしてインストーラーへ追加する必要はありません。

ただし、GResourceへ埋め込まれていることを確認せずに外部ファイルを削除すると、画像やCSSが読み込めない場合があります。配布前には、外部のcalculator.cssとimagesディレクトリがない状態で動作を確認しておきましょう。

インストール先を決める

インストーラーを作成するときは、アプリをどこへ配置するか決めます。

代表的な方法は、次の2つです。

インストール方法配置先の例特徴
すべての利用者向けC:\Program Files\SimpleCalculator管理者権限が必要になることがある
現在の利用者向けC:\Users\ユーザー名\AppData\Local\Programs\SimpleCalculator管理者権限なしで導入できる場合がある

学習用のGUI電卓では、現在の利用者だけを対象にする方法が比較的扱いやすいでしょう。

ただし、インストール先はインストーラー作成ツールの設定によって変わります。アプリ側で絶対パスを決め打ちしないことも重要です。

今回のGUI電卓では、CSSと画像をGResourceへ埋め込んでいるため、インストール先が変わってもリソースの読み込みには影響しません。

インストーラーとウィジェットの関係

ウィジェットとは、GUIアプリの画面を構成する部品のことです。

GUI電卓では、次のようなGTKウィジェットを使用しています。

ウィジェットGUI電卓での役割
GtkApplicationWindow電卓全体のウィンドウ
GtkEntry数値を入力する欄
GtkButton+、-、×、÷、クリアのボタン
GtkLabel入力欄の説明や計算結果の表示
GtkGrid入力欄やボタンを並べるレイアウト
GtkBox画像と電卓部分を縦方向へ並べる
GtkPicturecalculator.pngの表示

インストーラーがウィジェットを個別にWindowsへ登録するわけではありません。

calculator.exeが起動すると、プログラムからGTK 4の機能が呼び出され、GtkEntryやGtkButtonなどのウィジェットが作られます。ウィジェットの表示や操作にはGTK 4のDLLが必要です。

つまり、インストーラーを使ってもGTK 4のDLLが不要になるわけではありません。

図2:インストーラーがGUI電卓を配置する流れ

この図から分かること

インストーラーは、calculator.exeだけでなく、GTK 4の実行に必要なファイルをまとめて配置します。

さらに、スタートメニューのショートカットやアンインストール情報も作成します。これにより、利用者はインストール先の細かな構成を意識せずにGUI電卓を使用できます。

スタートメニューへ登録する

インストーラーを使うと、WindowsのスタートメニューへGUI電卓を登録できます。

スタートメニューには、calculator.exeそのものではなく、calculator.exeを起動するショートカットが配置されます。

ショートカットには、主に次の情報が保存されます。

  • 表示するアプリ名
  • 起動するcalculator.exeの場所
  • 使用するアイコン
  • 必要に応じて指定する起動時の引数

GUI電卓の場合は、スタートメニューに簡単なGUI電卓という名前のショートカットを作成すると分かりやすいでしょう。

デスクトップショートカットも作成できますが、必ず作成しなければならないものではありません。インストール時に利用者が選択できるようにする方法もあります。

Windowsのスタートメニューでは、インストールされたアプリへ簡単にアクセスできます。Inno Setupなどのインストーラー作成ツールには、スタートメニューやデスクトップへショートカットを作成する機能があります。

アンインストールとは

アンインストールとは、インストールしたアプリをパソコンから削除し、できるだけインストール前の状態へ戻す処理です。

インストーラーでGUI電卓を配置した場合、ディレクトリを手作業で削除するのではなく、インストーラーが用意したアンインストーラーを使用します。

アンインストーラーは、一般的に次の処理を行います。

  • calculator.exeを削除する
  • GTK関連のDLLを削除する
  • shareディレクトリとetcディレクトリを削除する
  • README.txtとライセンス情報を削除する
  • スタートメニューのショートカットを削除する
  • デスクトップショートカットを削除する
  • Windowsへ登録したアプリ情報を削除する
  • 不要になったインストール先ディレクトリを削除する

Windows Installerでは、インストール済みアプリの名前、バージョン、発行元、インストール場所、アンインストール方法などの情報がWindowsへ登録されます。

削除してよいファイルを区別する

アンインストーラーは、インストーラー自身が配置したファイルを削除するのが基本です。

利用者がアプリを使って作成したファイルまで、確認なしに削除してはいけません。

例えば、将来GUI電卓へ計算履歴の保存機能を追加した場合は、次のファイルを区別する必要があります。

  • インストーラーが配置したプログラム
  • GTK 4のDLL
  • 設定ファイル
  • 利用者が保存した計算履歴
  • 利用者が作成した独自データ

現在のGUI電卓には計算履歴の保存機能がないため、アンインストールの処理は比較的単純です。

今後、設定や計算履歴を保存するようになった場合は、アンインストール時に利用者データを残すか、利用者へ確認してから削除する設計が必要になります。

更新にもインストーラーを利用できる

GUI電卓を修正した場合は、新しいバージョンのインストーラーを作成できます。

例えば、バージョンを次のように更新します。

1.0.0
1.0.1
1.1.0

インストーラーには、アプリ名だけでなく、アプリを識別するための一貫した識別情報とバージョンを設定します。

同じアプリとして正しく設定されていれば、新しいインストーラーを実行したときに、既存のGUI電卓を更新できるようになります。

更新版を作るときは、少なくとも次の動作を確認します。

  • 古いバージョンをインストールできる
  • 古いバージョンを起動できる
  • 新しいバージョンへ更新できる
  • 更新後のGUI電卓を起動できる
  • アンインストールできる
  • 古いDLLや不要なファイルが残っていない

インストーラー作成ツール

Windows向けのインストーラーを作成するには、専用のツールを利用するのが一般的です。

代表的な選択肢には、次のようなものがあります。

  • Inno Setup
  • NSIS
  • WiX Toolset
  • MSIX Packaging Tool

作成方法や設定形式はツールによって異なります。

例えばInno Setupは、Windowsアプリ向けのインストーラーを作成できるツールです。ファイルの配置、ショートカットの作成、管理者権限を使用しないインストール、アンインストールなどに対応しています。

最初から多くの機能を使う必要はありません。GUI電卓では、次の機能から始めれば十分です。

  • calculatorディレクトリ一式の配置
  • スタートメニューへの登録
  • 任意のデスクトップショートカット
  • アンインストーラーの作成
  • アプリ名とバージョンの設定

インストーラーを作れば必ず安全とは限らない

インストーラーへまとめても、元の配布ファイルに不足があればGUI電卓は起動できません。

インストーラーを作成する前に、ポータブル版が開発環境の外で正しく動作することを確認しておく必要があります。

確認する順番は、次のようになります。

  1. GUI電卓を配布用にビルドする
  2. GResourceへCSSと画像を埋め込む
  3. 必要なDLL、share、etcを配置する
  4. MSYS2を起動していない状態で動作確認する
  5. ZIP形式のポータブル版を作成する
  6. 別のWindows環境で動作確認する
  7. 確認済みの配布ディレクトリをインストーラーへ登録する
  8. インストールとアンインストールを確認する

ポータブル版で起動できない状態のままインストーラーを作成しても、問題の解決にはなりません。

初学者はZIP形式から始める

初学者には、まずZIP形式のポータブル版から配布を始める方法がおすすめです。

ZIP形式では、配布ディレクトリの内容がそのまま見えるため、必要なファイルを理解しやすくなります。

例えば、次のような問題を確認しやすくなります。

  • 必要なDLLが不足している
  • shareディレクトリが配置されていない
  • etcディレクトリが配置されていない
  • CSSがGResourceへ埋め込まれていない
  • 画像がGResourceへ埋め込まれていない
  • 開発環境のPATHに依存している

最初からインストーラーへまとめてしまうと、インストーラーの設定に問題があるのか、GUI電卓の配布ファイルに問題があるのかを判断しにくくなります。

まずポータブル版を完成させ、その後でインストーラー作成へ進むと、問題を切り分けやすくなります。

図3:ZIP配布からインストーラー配布へ進む流れ

この図から分かること

インストーラー作成は、配布作業の最初に行うものではありません。

まず配布用ディレクトリを完成させ、ZIP形式で正しく動作することを確認します。その確認済みのファイル一式をインストーラーへ登録することで、問題の少ないインストール版を作成できます。

インストーラーを作成するときの確認項目

実際にGUI電卓のインストーラーを作成するときは、次の項目を確認します。

  • calculator.exeがインストールされる
  • 必要なGTK関連DLLがすべてインストールされる
  • shareディレクトリが正しく配置される
  • etcディレクトリが正しく配置される
  • README.txtが配置される
  • ライセンス情報が配置される
  • スタートメニューから起動できる
  • デスクトップショートカットから起動できる
  • +、-、×、÷の各演算が正しく動作する
  • 入力エラーが正しく表示される
  • CSSが適用される
  • calculator.pngが表示される
  • Windowsのインストール済みアプリに表示される
  • アンインストールできる
  • アンインストール後に不要なファイルが残らない
  • 開発環境のPATHに依存していない
  • 可能であれば別のWindowsパソコンでも確認する

インストーラーは配布を便利にする仕組みですが、その中身になるのは、これまで作成してきたGUI電卓の配布ファイルです。

まずはZIP形式のポータブル版を確実に完成させ、その次の段階としてインストーラーによる配布へ進んでいきましょう。