{{man warn| This is work in progress... |Any files listed here is in development state and may be '''not suitable''' for normal every day use!<br/>Any coment and help are welcome. Josip}}

+

{{man warn| This is a work in progress... |Any files listed here may be '''not suitable''' for normal every day use! (My lawyer advised me to say that, but many people are using this and have reported no problems at all.)<br/>Any comments and help (e.g. on wiki pages) are welcome. Josip}}

−

Gramps software bundle is all-in-one aka "AIO" install package of Gramps that includes all dependencies for the Windows platform

+

The '''Gramps "software bundle" for Windows''' or '''GrampsAIO''' is an all-in-one (a.k.a. "AIO") installation package of Gramps which includes all dependencies for the Windows platform. (See also [[GRAMPS_and_Windows|GRAMPS and Windows]].)

−

Logic for AIO is that in Windows first search path is working directory (one in which program is started) so if any Gramps dependency is in same directory there is no need for him to look for them in system and possibly load incompatible one thus avoid dependency hell. This is reason why AIO must be started from AIO folder.

+

Not only are all dependencies included ("bundled"), so that users do not have to first manually install each one of them, but they are

+

installed in such a fashion that Gramps can easily find them.

−

In newer Windows version there my be security restriction with shell scripts so AIO does not use one.

+

(Technical details: The

+

logic for this bundle is that in Windows the first entry in the search path is the current working directory (the one in which the program is started), so if any Gramps dependency is in that same directory there is thus no need to look for that dependency in a system folder and possibly load an incompatible one -- thus "dependency hell" is avoided. This is also the reason why GrampsAIO must be started from its own folder. Also, in newer Windows versions there may be security restriction with shell scripts so GrampsAIO does not use one.)

−

It is rebuild-able, it contains install script which can make new setup program from installed one.

+

For the technically sophisticated, GrampsAIO is rebuild-able: it contains an install script which can make a new installable program from the installed one.

+

For example somebody might like to repackage Gramps with their code changes, or favorite addons, or even their own family trees, etc.

−

If for example somebody like to repackage Gramps with their code change, favorite addons, family trees etc.

+

==Installation folder==

+

This distribution is directory based, which means it loads all dependencies from the directory in which they have been installed.

−

This distribution is directory based, which means it loads all dependencies from the directory in which they have been installed so if you want to use it from console/terminal (dos/cmd.exe prompt) you must first go to their directory as: cd C:\GrampsAIO\bin; python -EO ..\share\gramps\gramps.py .

+

That folder's location depends on whether the person doing the installation has administrative rights on the Windows machine. If an administrator installs it the directory may be chosen, with the default suggestion being %ProgramFiles%\GrampsAIO (for example C:\Program Files\GrampsAIO). If a non-administrator installs it, it will be placed in the user's personal tree, in %APPDATA%\GrampsAIO (for example C:\Documents and Settings\Jones\Application Data\GrampsAIO).

−

==Why:==

+

So if you want to use it from the console/terminal (dos/cmd.exe prompt) you must first go to the directory where those dependencies were installed (GrampsAIO\bin); for example:

+

<code>

+

cd C:\GrampsAIO\bin; python -EO ..\share\gramps\gramps.py

+

</code>

+

(but the installation may have been put somewhere else and so you should probably first search for the GrampsAIO\bin folder to make sure).

+

+

==Why GrampsAIO was made==

* easy installation:

* easy installation:

−

** no searching web for appropriate package

+

** no searching web for appropriate packages

** one click install

** one click install

* no dependency hell:

* no dependency hell:

−

** all libraries can work one together

+

** all libraries work together

−

** on upgrade version of library rebuild all others with that version

+

** on upgrade of a library all other libraries are rebuilt with that version

Revision as of 15:14, 31 May 2012

This is a work in progress...

Any files listed here may be not suitable for normal every day use! (My lawyer advised me to say that, but many people are using this and have reported no problems at all.)Any comments and help (e.g. on wiki pages) are welcome. Josip

The Gramps "software bundle" for Windows or GrampsAIO is an all-in-one (a.k.a. "AIO") installation package of Gramps which includes all dependencies for the Windows platform. (See also GRAMPS and Windows.)

Not only are all dependencies included ("bundled"), so that users do not have to first manually install each one of them, but they are
installed in such a fashion that Gramps can easily find them.

(Technical details: The
logic for this bundle is that in Windows the first entry in the search path is the current working directory (the one in which the program is started), so if any Gramps dependency is in that same directory there is thus no need to look for that dependency in a system folder and possibly load an incompatible one -- thus "dependency hell" is avoided. This is also the reason why GrampsAIO must be started from its own folder. Also, in newer Windows versions there may be security restriction with shell scripts so GrampsAIO does not use one.)

For the technically sophisticated, GrampsAIO is rebuild-able: it contains an install script which can make a new installable program from the installed one.
For example somebody might like to repackage Gramps with their code changes, or favorite addons, or even their own family trees, etc.

Contents

Installation folder

This distribution is directory based, which means it loads all dependencies from the directory in which they have been installed.

That folder's location depends on whether the person doing the installation has administrative rights on the Windows machine. If an administrator installs it the directory may be chosen, with the default suggestion being %ProgramFiles%\GrampsAIO (for example C:\Program Files\GrampsAIO). If a non-administrator installs it, it will be placed in the user's personal tree, in %APPDATA%\GrampsAIO (for example C:\Documents and Settings\Jones\Application Data\GrampsAIO).

So if you want to use it from the console/terminal (dos/cmd.exe prompt) you must first go to the directory where those dependencies were installed (GrampsAIO\bin); for example:

cd C:\GrampsAIO\bin; python -EO ..\share\gramps\gramps.py

(but the installation may have been put somewhere else and so you should probably first search for the GrampsAIO\bin folder to make sure).

Why GrampsAIO was made

easy installation:

no searching web for appropriate packages

one click install

no dependency hell:

all libraries work together

on upgrade of a library all other libraries are rebuilt with that version

How GrampsAIO was made

put all software Gramps needs in one package:

all core non-python libraries and applications

any optional non-python libraries and applications

python bindings for core libraries

python bindings for optional libraries

use NSIS (Nullsoft Script-able Install System)

Software releases:

The preferred way to get the GrampsAIO bundle is
to download it from the official Gramps software
repository. See Download
for the current version and link to it.

Older versions or developmental versions are available
directly from the GrampsAIO bundle's author. See below.