﻿========================================================================

    VBE Forge Diff  Version 1.0.0

    VBAプロジェクトのソースを、フォルダや別のプロジェクトと比較するVBEアドイン

                        ラピッド・アプリケーションズ有限会社
                                                    藤原英司
========================================================================


■ ソフトの概要
------------------------------------------------------------------------

VBE（Visual Basic Editor）の［アドイン］メニューから、現在開いている
VBAプロジェクトのソースを、次のどちらかと比較して違いを表示するツールです。

    ・フォルダにある .bas / .cls / .frm ファイル
      （VBE Forge Export の出力先など）
    ・Excelで開いている別のブックのVBAプロジェクト

インポートする前に、フォルダとブックの違いを確かめたい方、
本番用と開発中のブックの違いを確かめたい方に向いています。

比較はプロジェクトもファイルも一切変更しません。

【主な機能】

    ・VBEの［アドイン］メニューから実行
    ・比較相手はフォルダか、開いている別のプロジェクトから選択
    ・モジュールごとに「変更あり／種別が異なる／現在のみ／相手のみ／同一」を一覧表示
    ・行単位の差分を色分けして表示（左右に並べる／上下1列を切り替え）
    ・［前の差分］［次の差分］で変更箇所へ移動
    ・差分の行をダブルクリックすると、VBEでその行を開く
    ・行末の空白や、大文字小文字の違いを無視するオプション
    ・差分を unified diff 形式でコピー、または .diff ファイルに保存
    ・前回の比較相手を記憶（初回は Export の出力先を初期値にします）
    ・動作ログを %LOCALAPPDATA%\VBEForge\Logs に記録


■ 取り扱い種別
------------------------------------------------------------------------

フリーソフト（無償）

個人・法人・商用を問わず、台数の制限なく無償でご使用いただけます。
送金や登録は不要です。

ライセンスは MIT License です。詳細は同梱の LICENSE.txt をご覧ください。


■ 動作環境
------------------------------------------------------------------------

    OS          Windows 10 / Windows 11
    アプリケーション  Microsoft Excel 2016 以降（Microsoft 365 を含む）
                     32bit版・64bit版のどちらでも動作します
    ランタイム   .NET Framework 4.8
                （Windows 10 バージョン1903以降には標準搭載されています）

Excel以外のホスト（Word、Access等）のVBEでは動作確認していません。


■ インストール方法
------------------------------------------------------------------------

1. ダウンロードしたZIPファイルを、任意のフォルダへ展開します。

     例）C:\Tools\VBEForge.Diff\

   ※ インストール後にこのフォルダを移動しないでください。
      移動した場合は install.bat を再度実行してください。

2. Excelをすべて終了します。

3. 展開したフォルダの「install.bat」をダブルクリックします。

   黒い画面が開きますので、案内に従ってEnterキーを押してください。
   「インストールが完了しました。」と表示されたら成功です。

   管理者権限は不要です。
   レジストリは現在のユーザー配下（HKEY_CURRENT_USER）のみを使用し、
   システム領域には一切書き込みません。

4. Excelを起動し、Alt+F11でVBEを開きます。
   ［アドイン］メニューに［VBE Forge Diff］が追加されています。


■ アンインストール方法
------------------------------------------------------------------------

1. Excelをすべて終了します。

2. 展開したフォルダの「uninstall.bat」をダブルクリックします。

3. 展開したフォルダごと削除してください。

4. 設定とログが下記のフォルダに残ります。不要であれば削除してください。
   （VBE Forge シリーズの他の製品と共用です。他の製品も使っている場合は
     残してください）

     %LOCALAPPDATA%\VBEForge\

レジストリはインストール時に書き込んだキーのみを削除します。
他のソフトウェア（VBE Forge シリーズの他の製品を含む）には影響しません。


■ ご使用前の設定
------------------------------------------------------------------------

VBAプロジェクトのコードを読み取るために、Excel側で下記の設定が必要です。

    ［ファイル］
      → ［オプション］
        → ［トラストセンター］
          → ［トラストセンターの設定］
            → ［マクロの設定］
              → 「VBAプロジェクトオブジェクトモデルへのアクセスを信頼する」
                 にチェックを入れる

設定後、Excelを再起動してください。

この設定が無効の場合、本ソフトは上記の手順を案内するメッセージを
表示して安全に終了します。


■ 使い方
------------------------------------------------------------------------

1. 比較したいブックを開きます。
   別のブックと比べる場合は、そのブックも開いておきます。

2. Alt+F11 でVBEを開きます。

3. プロジェクトエクスプローラーで、比較元（基準）にするVBAプロジェクトを
   選択します。

4. ［アドイン］→［VBE Forge Diff］をクリックします。

5. 比較相手を選び、［比較］をクリックします。

     フォルダ                   比較するフォルダを指定します
     開いている別のプロジェクト  一覧から比較するブックを選びます

   「行末の空白を無視する」「大文字小文字の違いを無視する」は、
   どちらも最初はオンになっています。
   VBEは識別子の大文字小文字を自動で揃えるため、オンのままの使用を
   おすすめします。

6. モジュールごとの比較結果が一覧で表示されます。

   「差分があるものだけ表示」のチェックを外すと、同一のモジュールも
   表示します。

7. 行をダブルクリック（または［差分を表示］）すると、そのモジュールの
   差分が表示されます。

     赤い行   現在のプロジェクトにだけある行
     緑の行   比較相手にだけある行

   ［前の差分］［次の差分］で変更箇所へ移動できます。
   ［コピー］で、表示中のモジュールの差分をクリップボードへコピーします。

8. 現在のプロジェクト側の行をダブルクリックすると、画面を閉じて
   VBEでその行を開きます。

9. 一覧の［すべて保存...］で、すべての差分を1つの .diff ファイルに
   保存できます。


■ 制限事項・注意事項
------------------------------------------------------------------------

・比較元は、プロジェクトエクスプローラーで選択しているVBAプロジェクト
  1つです。左右を入れ替えることはできません。

・パスワードで保護（ロック）されたVBAプロジェクトは比較できません。
  比較相手の一覧にも表示されません。

・保存していないブックは、比較相手として選べません。

・Excelで開いていないブックとは比較できません。
  先にブックを開いてから実行してください。

・フォルダの直下のファイルだけを対象にします。サブフォルダは見ません。

・比較するのはコードだけです。UserFormのデザイン（.frx）、参照設定、
  プロジェクトのプロパティは比較しません。

・モジュールの先頭にある Attribute 行（VB_Name など）は比較しません。
  VBEのコードウィンドウに表示されない部分のためです。

・差分の反映（取り込み）は行いません。
  フォルダの内容をブックへ取り込むには「VBE Forge Import」をご利用ください。

・本ソフトの使用によって生じたいかなる損害についても、作者および
  著作権者は責任を負いません。


■ 作者への連絡先
------------------------------------------------------------------------

    作者         藤原英司（ふじわら えいじ）
    発行元       ラピッド・アプリケーションズ有限会社

    メール       info@rapid-apps.co.jp
    Webサイト    https://rapid-apps.co.jp
    お問い合わせ https://rapid-apps.co.jp/#contact

ご質問、不具合のご報告、ご要望などは上記までお寄せください。

不具合のご報告の際は、下記の情報を添えていただけると助かります。

    ・Windowsのバージョン
    ・Excelのバージョンとビット数（32bit / 64bit）
    ・本ソフトのバージョン
    ・下記のログファイル

      %LOCALAPPDATA%\VBEForge\Logs\VBEForge_YYYYMMDD.log


■ 著作権・ライセンス
------------------------------------------------------------------------

    Copyright (c) 2026 ラピッド・アプリケーションズ有限会社

本ソフトウェアは MIT License の下で公開されています。
無償で自由にご使用いただけます。改変・再配布も可能です。
その際は著作権表示とライセンス文を含めてください。

ライセンスの全文は同梱の LICENSE.txt をご覧ください。


■ 同梱ファイル
------------------------------------------------------------------------

    install.bat                インストール用（ダブルクリック）
    uninstall.bat              アンインストール用（ダブルクリック）
    install.ps1                インストール処理
    uninstall.ps1              アンインストール処理
    VbeForgeRegistration.psm1  登録処理の共通部品
    VBEForge.Diff.dll          本体
    VBEForge.Core.dll          共通ライブラリ
    README.txt                 このファイル
    LICENSE.txt                MIT License 全文


■ 更新履歴
------------------------------------------------------------------------

    Version 1.0.0
        初版公開


========================================================================
