Zenn
🖥️

社内ツールを配布するときに迷わない！Windowsコンソールアプリを一貫性を持って提供する方法

に公開
.NET
Windows
社内ツール
タスクスケジューラ
innosetup
tech

社内ツールを配布するときに迷わない！Windowsコンソールアプリを一貫性を持って提供する方法

はじめに

ちょっとしたバッチ処理や補助ツールを Windowsコンソールアプリ として配布する場面は多いと思います。
そのとき「とりあえず任意のフォルダにコピーして使ってください」という形で配布してしまうと、こんな問題が起きがちです。

  • 環境ごとに配置場所がバラバラ → サポートしにくい
  • 自動実行設定が人ごとに違う → 運用トラブルの原因になる
  • ログ出力場所が統一されない → 調査が大変になる

こうした課題を避けるためには、一貫性を持った配布と実行の仕組み を整えるのが重要です。
本記事では、その基本的なアプローチを整理し、シンプルなサンプルを紹介します。

サンプルアプリの概要

今回用意したサンプルは以下の仕様です。

  • 名称: ConsistRunner
    （Consistent + Runner = 一貫性を持って実行するツール）
  • 開発環境: .NET Framework 4.7.2
  • 機能:
    • Main 実行ごとに Serilog でログ出力
    • Debug ビルド時は bin\Debug 配下にログを出力（開発者がすぐ確認できるように）
    • Release ビルド時は App.Release.config のプレースホルダを Inno Setup で差し替え、運用環境用の出力先を設定
    • Serilog 設定は App.config / App.Release.config で管理

👉 サンプルリポジトリ: ConsistRunner (GitHub)

ダウンロードする場合は、リポジトリページ右上の「Code」ボタン → Download ZIP を選んでください。

.NET Framework 4.7.2 を採用した理由

「なぜ .NET 6 や .NET 8 ではなく、古い 4.7.2 を選んだのか？」と思う方もいるかもしれません。
理由はシンプルで、Windows OS に組み込まれる形でセキュリティパッチが提供されるため です。

  • .NET Framework は OS の一部として扱われ、Windows Update 経由で自動的に更新される
  • 顧客環境でセキュリティ対応が漏れるリスクを減らせる
  • 新しい .NET ランタイムを別途インストールする手間を省ける
  • Windows 10 / Windows 11 では多くの場合 .NET Framework 4.7.2 が標準でインストール済み
    → 利用者が追加インストールをする必要がほとんどない

特に社内バッチや顧客環境向けの簡易ツールでは、運用時の安心感と導入の手軽さ を優先することが多いため、.NET Framework 4.7.2 を採用しています。

配布方法の整理

アプリの配布には Inno Setup を利用します。
単なるコピーではなく、以下のことを自動で実施します。

  1. アプリ配置フォルダを一貫した場所に作成
  2. XML をベースにタスクスケジューラへ自動実行タスクを登録
  3. Serilog のログ出力先を環境に応じて切り替え
  4. 事前に定義されたインストーラを使うことで、どのアプリがインストールされているかを明確に管理可能
  5. アンインストール時にはアプリ本体だけでなく、関連タスク（スケジューラ設定など）もまとめて削除可能

この流れを定型化しておけば、利用者は「インストーラを実行するだけ」で環境を整えられ、
また「不要になったらアンインストールするだけ」で環境をクリーンに戻せます。

文字コード対策

Inno Setup 2025/08 時点の最新版 (6.5.0) を用いて自身で検証したところ、
内部で文字列を Shift-JIS に変換していると考えられ、そのため文字化けのリスクがあると判断しています。

これを回避するために、簡易的な文字列リプレースツールを用意しました。

  • ツール名: InnoReplacer
  • 役割: UTF-8 および UTF-16 BOM 付きファイルを対象に文字列を置換し、安全にインストーラへ組み込む
    • 特にタスクスケジューラのテンプレートは UTF-16 BOM 付きで生成されるため、ここに含まれる「プログラム実行パス」を正しく差し替える用途でも利用します

自動実行の仕組み

自動実行は タスクスケジューラ を利用します。
インストーラが XML 定義に基づいてタスクを作成し、アプリを自動で起動できるようにします。

ユーザーが手動でタスク登録を行う必要がなく、設定漏れや入力ミスを防止できます。

まとめ

本記事では、Windowsコンソールアプリを一貫性を持って配布・自動実行するための基本アプローチ を紹介しました。

  • 配布には Inno Setup を活用して、配置場所やタスク登録を統一
  • ログ出力には Serilog を利用し、運用時の追跡性を確保
    • 特に ログローテーションを簡単に実現できる のが大きな利点
    • 顧客環境では長期運用が前提となるため、ログが永久に残るとストレージを圧迫してしまう
    • Serilog を使うことで、一定期間でのログ入れ替えやサイズ制御を容易にできる
  • Shift-JIS / UTF-16 BOM 問題は InnoReplacer で対応
  • ランタイムは .NET Framework 4.7.2 を採用し、OS アップデートでセキュリティを担保
    ＋ Windows 10/11 では標準で入っていることが多く、追加インストール不要
  • 全体像はサンプルアプリ ConsistRunner で確認可能

今後は、Inno Setup のスクリプト例やタスクスケジューラ XML の詳細などを別記事で掘り下げていく予定です。

👉 続編記事リンク

想定読者

  • 社内ツールやバッチアプリを Windows 環境へ配布している開発者
  • 「とりあえずコピー配布」から卒業して、配布・運用を整えたい方
  • Inno Setup やタスクスケジューラを使った自動化の全体像を知りたい方
  • 顧客環境に導入する際に「一貫性」と「安心感」を重視したいエンジニア

Discussion