Project

General

Profile

HowTo install rmagick gem on Windows » History » Version 9

Dmitry Popov, 2015-03-03 13:27

1 1 Etienne Massip
h1. HowTo install @rmagick@ gem on Windows
2
3
{{>toc}}
4
5
h2. Prerequisite
6
7
You need to have the "DevKit":http://rubyinstaller.org/add-ons/devkit installed.
8
9
h2. Installation of "ImageMagick":http://www.imagemagick.org
10
11 8 Dmitry Popov
You can try to download last setup package from http://www.imagemagick.org/script/binary-releases.php#windows, but according to "RMagick wiki":https://github.com/rmagick/rmagick/wiki/Installing-on-Windows, the last known version to work is 6.7.9.9. ImageMagick legacy binary versions are available at ftp://ftp.sunet.se/pub/multimedia/graphics/ImageMagick/binaries/.
12 1 Etienne Massip
13 8 Dmitry Popov
Run the setup package. 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:
14 1 Etienne Massip
15 7 Dmitry Popov
!imagemagick-setup.gif!
16 1 Etienne Massip
17 8 Dmitry Popov
*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.
18 1 Etienne Massip
19 3 John Pankowicz
h2. Installation of the @rmagick@ gem
20
21 8 Dmitry Popov
Open a new command prompt.
22 1 Etienne Massip
23 8 Dmitry Popov
Change current directory to the Redmine installation directory
24
25
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
27 4 Dmitry Popov
<pre>
28
set CPATH=C:\Program Files (x86)\ImageMagick-6.7.9-Q16\include
29
set LIBRARY_PATH=C:\Program Files (x86)\ImageMagick-6.7.9-Q16\lib
30
</pre>
31 1 Etienne Massip
32 8 Dmitry Popov
Install the gem by running @bundle install@.
33 1 Etienne Massip
34 6 Dmitry Popov
!rmagick-install-cmd.gif!
35 1 Etienne Massip
36 9 Dmitry Popov
*Note:* bundler remembers the list of groups to skip set with @--without@ option. If you have already run @bundler install --without rmagick@, you'll need to modify @redmine\.bundle\config@ file.
37
38
<pre>
39
---
40
BUNDLE_WITHOUT: development:test
41
</pre>
42
43 4 Dmitry Popov
h2. Result
44
45
Check if the installation was successful on the Information page.
46
47 6 Dmitry Popov
!rmagick-information.gif!