HowTo install rmagick gem on Windows » History » Version 5

Dmitry Popov, 2015-03-03 13:01

1 1 Etienne Massip
h1. HowTo install @rmagick@ gem on Windows
2 1 Etienne Massip
3 1 Etienne Massip
{{>toc}}
4 1 Etienne Massip
5 1 Etienne Massip
h2. Prerequisite
6 1 Etienne Massip
7 1 Etienne Massip
You need to have the "DevKit":http://rubyinstaller.org/add-ons/devkit installed.
8 1 Etienne Massip
9 1 Etienne Massip
h2. Installation of "ImageMagick":http://www.imagemagick.org
10 1 Etienne Massip
11 1 Etienne Massip
Download last setup package from http://www.imagemagick.org/script/binary-releases.php#windows and run it.
12 1 Etienne Massip
13 4 Dmitry Popov
However, according to "RMagick wiki":https://github.com/rmagick/rmagick/wiki/Installing-on-Windows, the last known version to work is 6.7.9.9. Legacy binary versions are available at ftp://ftp.sunet.se/pub/multimedia/graphics/ImageMagick/binaries/.
14 4 Dmitry Popov
15 1 Etienne Massip
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:
16 1 Etienne Massip
17 1 Etienne Massip
!ImageMagick_setup_options.png!
18 1 Etienne Massip
19 3 John Pankowicz
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. 
20 3 John Pankowicz
21 1 Etienne Massip
h2. Installation of the @rmagick@ gem
22 1 Etienne Massip
23 4 Dmitry Popov
* Open a new command prompt
24 4 Dmitry Popov
* Change current directory to the Redmine installation directory
25 4 Dmitry Popov
* 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)
26 1 Etienne Massip
27 4 Dmitry Popov
<pre>
28 4 Dmitry Popov
set CPATH=C:\Program Files (x86)\ImageMagick-6.7.9-Q16\include
29 4 Dmitry Popov
set LIBRARY_PATH=C:\Program Files (x86)\ImageMagick-6.7.9-Q16\lib
30 4 Dmitry Popov
</pre>
31 1 Etienne Massip
32 4 Dmitry Popov
* Actually install the gem, e.g. with @gem install rmagick@ or @bundle install --without=development test@, etc.
33 1 Etienne Massip
34 5 Dmitry Popov
!rmagick_install_gif!
35 1 Etienne Massip
36 4 Dmitry Popov
h2. Result
37 4 Dmitry Popov
38 4 Dmitry Popov
Check if the installation was successful on the Information page.
39 4 Dmitry Popov
40 5 Dmitry Popov
!rmagick_information.gif!