File: README-Windows.rdoc

package info (click to toggle)
ruby-pg 1.2.3-1
  • links: PTS, VCS
  • area: main
  • in suites: bullseye
  • size: 1,108 kB
  • sloc: ansic: 7,771; ruby: 5,753; makefile: 14
file content (56 lines) | stat: -rw-r--r-- 2,224 bytes parent folder | download | duplicates (3)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
= Compiling 'pg' on MS Windows

In order to build this extension on MS Windows you will need a couple things.

First, a compiler. For the one click installer this means you should use
the DevKit or the compiler that comes with cygwin if you're building on that
platform.

If you've built Ruby yourself, you should use the same compiler to build
this library that you used to build Ruby.

Second, PostgreSQL. Be sure you installed it with the development header
files if you installed it using the standard PostgreSQL installer for
Windows. If you didn't, you can run the installer again, select "modify",
and then select the 'development headers' option to install them.

I recommend making sure that 'pg_config.exe' is in your PATH. The PostgreSQL
installer for Windows does not necessarily update your PATH when it installs
itself, so you may need to do this manually. This isn't strictly necessary,
however.

In order to build ruby-pg, just run 'rake'. If the pg_config.exe executable
is not in your PATH, you'll need to explicitly point ruby-pg to where your
PostgreSQL headers and libraries are with something like this:

	rake --with-pg-dir=c:/progra~1/postgr~1/8.3

Adjust your path accordingly. BE SURE TO USE THE SHORT PATH NAMES! If you
try to use a path with spaces in it, the nmake.exe program will choke.


== Building binary 'pg' gems for MS Windows

Binary gems for windows can be built on Linux, OS-X and even on Windows
with the help of docker. This is how regular windows gems are built for
rubygems.org .

To do this, install boot2docker {on Windows}[https://github.com/boot2docker/windows-installer/releases]
or {on OS X}[https://github.com/boot2docker/osx-installer/releases] and make
sure it is started. A native Docker installation is best on Linux.

Then run:

	rake gem:windows

This will download a docker image suited for building windows gems, and it
will download and build OpenSSL and PostgreSQL. Finally the gem is built
containing binaries for all supported ruby versions.


== Reporting Problems

If you have any problems you can submit them via {the project's
issue-tracker}[https://github.com/ged/ruby-pg/issues]. And submit questions, problems, or
solutions, so that it can be improved.