Redmine

h1. HowTo install @rmagick@ gem on Windows

{{>toc}}

h2. Prerequisite

You need to have the "DevKit":http://rubyinstaller.org/add-ons/devkit installed.

h2. Installation of "ImageMagick":http://www.imagemagick.org

Download last setup package from http://www.imagemagick.org/script/binary-releases.php#windows and run it.

In the ??Select Additional Tasks?? page of the wizard, make sure that  both ??Add application directory to your system path?? and ??Install development headers and libraries for C and C++?? options are checked:

!ImageMagick_setup_options.png!

Note: Both the ImageMagick application directory and the Windows System32 directory contain an executable named "convert.exe". Unless ImageMagick's directory is added the front of the system path, its copy will not be found. This will cause the test suggested at the completion of the installation to fail with a message "Invalid Drive Specification". Also note that Window's copy of "convert.exe" will not be found, if ImageMagick is placed first in the path. 

h2. Installation of the @rmagick@ gem

* open a new command prompt

* set @CPATH@ and @LIBRARY_PATH@ environment variables to point respectively to @ImageMagick@ installation directory @include@ and @lib@ subdirectories (so the DevKit will find them at build time)

For example:

 @set CPATH=C:\Program Files\ImageMagick-6.7.7-Q16\include@

@set LIBRARY_PATH=C:\Program Files\ImageMagick-6.7.7-Q16\lib@

* actually install the gem, e.g. with @gem install rmagick@ or @bundle install --without=development test@, etc.

Result:

!rmagick_installation_prompt.jpg!

!redmine_informations.png!