Skip to main content

How to Install NDMerge

NDMerge is automatically installed in the Next Design installation folder when Next Design is installed.
If you want to use NDMerge without installing Next Design, please install it using the following procedure. Because Git settings are saved per user, perform this procedure for each user who will use NDMerge.

Installation Procedure​

Git (the git command) must be installed before performing the following procedure.

  1. This program requires .NET 10.0 Runtime to run.
    If Next Design is not installed, download and install the runtime. (If Next Design is installed, the runtime is already installed.)

  2. Download the NDMerge file set (zip file) from the support site below.

https://www.nextdesign.app/support/auth/downloads/#ndmerge

Note

After downloading the zip file, please remove the security protection as follows before extracting the files.
(1) Right-click the zip file and select [Properties]. (2) Read the explanation for [Security] at the bottom of the [General] tab, check the [Allow] checkbox on the right, and click the [OK] button.

  1. Extract the zip file to your desired installation folder.

  2. In the following command, replace <installation folder> with the path to the folder where NDMerge was extracted. Launch Terminal, navigate to that folder, and execute the command:

    cd "<installation folder>"
    .\ndmerge git-setup install

For details on this command, please refer to here.

Post-Installation Verification​

  • Executing the ndmerge git-setup install command configures the gitconfig for the global environment (per OS login user).

  • You can verify the configured settings by running the following command in the installation folder:

./ndmerge git-setup list

  • If the merge.NDMerge.driver item is added to the configuration, it is configured correctly.

  • Example of execution on Windows

> ./ndmerge git-setup list
exec: git config merge.NDMerge.name
nd diff merge application
exec: git config merge.NDMerge.driver
'[Absolute path for each user environment]/ndmerge.exe' merge -o %A -t %B -b %O -m %A -p %P -l warn
Note
  • If the path set in gitconfig and the location of the storage folder are different, NDMerge will not work.
    If you move the storage folder, run the ndmerge git-setup install command again to update the gitconfig settings.

Configuring Git attributes​

Configure the file extensions in the Git attributes file so that NDMerge runs when Git needs to merge the target files.

  1. To edit the configuration file, open cmd.exe and execute the following command.

    for /f "delims=" %F in ('git var GIT_ATTR_GLOBAL') do (mkdir "%~dpF" 2>nul & notepad "%~fF")

  2. Append the following configuration lines to the file. If these configuration lines are already present, there is no need to append them.

    # NDMerge
    *.nproj merge=NDMerge
    *.nmdl  merge=NDMerge
    *.nprof merge=NDMerge
    *.iproj merge=NDMerge
    *.imdl  merge=NDMerge
    *.iprof merge=NDMerge

  3. Confirm that the encoding is set to UTF-8, and save the file.

Update Procedure​

If NDMerge is already installed, follow these steps to update to the new version of NDMerge.

  1. Download the complete set of NDMerge files (zip file) for the new version from the support site below.

https://www.nextdesign.app/support/auth/downloads/#ndmerge

Note

After downloading the zip file, remove the security protection as follows before extracting the files.
(1) Right-click the zip file and select [Properties].
(2) Read the explanation of [Security] displayed at the bottom of the [General] tab, check the [Allow] checkbox on the right, and click the [OK] button.

  1. Delete all existing files in the installation folder.
  2. Extract the new version's zip file to the installation folder.
  3. Launch Terminal and navigate to the installation folder.
  4. Run the following command to confirm that you have updated to the new version.
.\ndmerge --version

Uninstallation Procedure​

  1. Open a terminal and navigate to the NDMerge installation folder.

  2. Execute the following command:

./ndmerge git-setup uninstall
  1. Execute the following command to check the path of the user-global attributes file referenced by Git.
git var GIT_ATTR_GLOBAL

Open the output file in a text editor and delete the NDMerge-related lines added in Configuring Git attributes.

  1. Delete all files in the installation folder.
Last updated on