NDMerge のインストール方法
NDMergeは、Next Design 本体のインストール時に、Next Design のインストールフォルダに自動的にインストールされます。
以下は、CI/CD環境などに NDMerge を単体でインストールする場合の方法です。
Next Design をインストールせずに、NDMerge を利用する場合は、以下の手順でインストールしてください。
なお、Git の設定はユーザーごとに保存されるため、本手順は NDMerge を利用するユーザーごとに実施してください。
インストール手順
以下の手順を実施するには、あ らかじめ Git(git コマンド)がインストールされている必要があります。
- Windows版
- Linux版
-
このプログラムを動作させるには .NET 10.0 Runtime のインストールが必要です。
Next Design をインストールしていない場合は、ダウンロードしてインストールしてください。(Next Design がインストールされていれば、既にインストール済みです) -
下記サポートサイトより NDMerge ファイル一式(zip ファイル)をダウンロードしてください。
zip ファイルをダウンロード後、次のようにセキュリティ保護を解除してからファイルを展開してください。
(1) zip ファイル を右クリックして [プロパティ] を表示します。
(2) [全般] タブの下部に表示される [セキュリティ] の説明を読み、右の [許可する] チェックボックスをチェックして [OK] ボタンを押下します。
-
zip ファイルを任意のインストール先フォルダに展開してください。
-
ターミナルを起動し、次のコマンドの
<インストール先フォルダ>を NDMerge を展開した実際のフォルダパスに置き換えて実行してください。cd "<インストール先フォルダ>"
.\ndmerge git-setup installこのコマンドの詳細については こちら を参照してください。
-
下記サポートサイトより NDMerge ファイル一式(zip ファイル)をダウンロードしてください。
-
zip ファイルを任意のインストール先フォルダに展開してください。
-
次のコマンドの
<インストール先フォルダ>を NDMerge を展開した実際のフォルダパスに置き換えて実行してください。cd "<インストール先フォルダ>"
chmod +x ndmerge
./ndmerge git-setup installndmerge のコマンドの詳細 については こちら を参照してください。
インストール後の確認
NDMergeのgit-setupコマンドを実行すると、グローバル環境(OSログインユーザー毎)のgitconfigに設定されます。-
設定された内容はインストール先フォルダで下記コマンドを実行することで確認できます。
./ndmerge git-setup list -
設定内容に、
merge.NDMerge.driverの項目が追加されていれば正しく設定されています。 -
Windows 版での実行例
> ./ndmerge git-setup list
exec: git config merge.NDMerge.name
nd diff merge application
exec: git config merge.NDMerge.driver
'[ユーザー環境毎の絶対パス]/ndmerge.exe' merge -o %A -t %B -b %O -m %A -p %P -l warn
-
gitconfigに設定されたパスと格納フォルダの場所が異なる場合、NDMergeが動作しません。
格納フォルダを移動した場合は、再度ndmerge git-setup installコマンドを実行し、gitconfigの設定を更新してください。
Git attributes の設定
Git で対象ファイルのマージ処理が必要になったときに NDMerge が実行されるよう、対象ファイルの拡張子を Git の attributes ファイルに設定します。
- Windows版
- Linux版
-
設定ファイルを編集するために、
cmd.exeを起動して次のコマンドを実行してください。for /f "delims=" %F in ('git var GIT_ATTR_GLOBAL') do (mkdir "%~dpF" 2>nul & notepad "%~fF") -
ファイル中に次の設定行を追記してください。すでにこれらの設定行がある場合は、追記する必要はありません。
# NDMerge
*.nproj merge=NDMerge
*.nmdl merge=NDMerge
*.nprof merge=NDMerge
*.iproj merge=NDMerge
*.imdl merge=NDMerge
*.iprof merge=NDMerge -
エンコードに UTF-8 が指定されていることを確認して、ファイルを保存してください。
-
次のコマンドを実行し、attributes ファイルの内容を確認してください。
git_attributes_file="$(git var GIT_ATTR_GLOBAL)"
cat "$git_attributes_file"attributes ファイルが存在しない場合はエラーが表示されますが、問題ありません。
-
出力内容に NDMerge の設定行がない場合は、次のコマンドを実行して追記してください。すでにこれらの設定行がある場合は、追記する必要はありません。
git_attributes_file="$(git var GIT_ATTR_GLOBAL)"
mkdir -p "$(dirname "$git_attributes_file")"
cat <<'EOF' >> "$git_attributes_file"
# NDMerge
*.nproj merge=NDMerge
*.nmdl merge=NDMerge
*.nprof merge=NDMerge
*.iproj merge=NDMerge
*.imdl merge=NDMerge
*.iprof merge=NDMerge
EOF
アップデート手順
すでに NDMerge がインストール済みの場合、新しいバージョンの NDMerge にアップデートするには以下の手順を実施します。
- Windows版
- Linux版
-
下記サポートサイトより新しいバージョンの NDMerge ファイル一式(zip ファイル)をダウンロードしてください。
zip ファイルをダウンロード後、次のようにセキュリティ保護を解除してからファイルを展開してください。
(1) zip ファイルを右クリックして [プロパティ] を表示します。
(2) [全般] タブの下部に表示される [セキュリティ] の説明を読み、右の [許可する] チェックボックスをチェックして [OK] ボタンを押下します。
-
インストール先フォルダ内の既存ファイルをすべて削除してください。
-
新しいバージョンの zip ファイルをインストール先フォルダに展開してください。
-
ターミナルを起動して、インストール先フォルダに移動してください。
-
次のコマンドを実行して、新しいバージョンにアップデートできたことを確認してください。
.\ndmerge --version
-
下記サポートサイトより新しいバージョンの NDMerge ファイル一式(zip ファイル)をダウンロードしてください。
-
インストール先フォルダ内の既存ファイルをすべて削除してください。
-
新しいバージョンの zip ファイルをインストール先フォルダに展開してください。
-
インストール先フォルダに移動して、次のコマンドを実行してください。
chmod +x ndmerge -
次のコマンドを実行して、新しいバージョンにアップデートできたことを確認してください。
./ndmerge --version
アンインストール手順
-
ターミナルを起動して、
NDMergeのインストール先フォルダに移動してください。 -
下記のコマンドを実行してください。
./ndmerge git-setup uninstall -
次のコマンドを実行して、Git が参照するユーザーグローバルの attributes ファイルのパスを確認してください。
git var GIT_ATTR_GLOBAL出力されたファイルの内容を確認し、本ページの「Git attributes の設定」で追記した NDMerge 関連の行を削除してください。
-
インストール先フォルダのファイルをすべて削除してください。