Project

General

Profile

HowTo install rmagick gem on Windows » History » Revision 9

Revision 8 (Dmitry Popov, 2015-03-03 13:15) → Revision 9/10 (Dmitry Popov, 2015-03-03 13:27)

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 

 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/. 

 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: 

 !imagemagick-setup.gif! 

 *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. 

 Change current directory to the Redmine installation directory 

 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) 

 <pre> 
 set CPATH=C:\Program Files (x86)\ImageMagick-6.7.9-Q16\include 
 set LIBRARY_PATH=C:\Program Files (x86)\ImageMagick-6.7.9-Q16\lib 
 </pre> 

 Install the gem by running @bundle install@. 

 !rmagick-install-cmd.gif! 

 *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. 

 <pre> 
 --- 
 BUNDLE_WITHOUT: development:test 
 </pre> 

 h2. Result 

 Check if the installation was successful on the Information page. 

 !rmagick-information.gif!