Difference between revisions of "GnuCash Sources"

From GnuCash
Jump to: navigation, search
m (→‎Using a shell:: typo)
(Refine the Sourceforge down loads notes)
Line 1: Line 1:
 
== GnuCash Sources ==
 
== GnuCash Sources ==
 
===Stable Releases===
 
===Stable Releases===
−
Stable releases of the GnuCash source code are available for download from:
+
'''Note:''' The latest released version is '''{{Version}}'''.
 +
 
 +
The latest stable release of the GnuCash source code as zipped tar archives are available for download from:
 
* [https://www.gnucash.org/index.phtml Gnucash Website] Linux source link;
 
* [https://www.gnucash.org/index.phtml Gnucash Website] Linux source link;
 
* [https://www.gnucash.org/download.phtml Gnucash website Download] page, bzip2 compressed tarball link;
 
* [https://www.gnucash.org/download.phtml Gnucash website Download] page, bzip2 compressed tarball link;
 
* [https://sourceforge.net/projects/gnucash/?source=directory SourceForge GnuCash] page.
 
* [https://sourceforge.net/projects/gnucash/?source=directory SourceForge GnuCash] page.
−
These links all point to the SourceForge Download page and will download a zipped (compressed) tarball containing the sources for gnucash with a name of the form ''gnucash-<major>.<minor>-<packing>.tar.<bz2> '', e.g. ''gnucash-{{Version}}-1.tar.bz2''. Some earlier stable releases are also available from this page by expanding the See All Activity link and selecting the desired version from the drop down list.
+
These links all point to the SourceForge Download page and will download a zipped (compressed) tarball containing the sources for gnucash with a name of the form '''gnucash-<major>.<minor>-<packing>.tar.<bz2> ''', e.g. '''gnucash-{{Version}}-1.tar.bz2'''.  
  
−
You should save this file to a suitable location, e.g. Downloads directory in your home directory (/home/<user>/Downloads where <user> is your username.
+
All available stable releases are available from [https://sourceforge.net/projects/gnucash/?source=navbar | SourceForge] by selecting '''gnucash(stable) ''' from the Files tab then selecting the version you require. The page has downloads for Windows, Mac-OSX, and bzip2 and gz zipped sources. For Linux select the source code '''gnucash-<version>-1.tar.bz2''' or '''gnucash-<version>-1.tar.gz''' file depending upon which zip your distribution uses. You will find appropriate sha256sum values listed at the bottom of each <version> page which you can use to check the download integrity as described below.
 +
 
 +
You should save this file to a suitable location, e.g. Downloads directory in your home directory (/home/<user>/Downloads or $HOME/Downloads if the environment variable HOME is defined. Here <user> is your username on your system).
  
 
You should then extract the source code from the zipped archive to a suitable directory under your home directory where you will build gnucash, e.g. something like /home/<user>/Applications. The extracted top level source file usually has the same name as the archive.
 
You should then extract the source code from the zipped archive to a suitable directory under your home directory where you will build gnucash, e.g. something like /home/<user>/Applications. The extracted top level source file usually has the same name as the archive.
  
−
===Using a shell: ===
+
In a shell, enter the following commands to download and check the tarball:
 
<SyntaxHighlight lang="sh">
 
<SyntaxHighlight lang="sh">
−
export VERSION=3.1 # One place to adjust the version
+
export VERSION=3.1                                                                       # One place to adjust the version;
−
export TARBALL=gnucash-$VERSION-1.tar.bz2 # if you still have no bzip2 use ".gz" instead of ".bz2"
+
export TARBALL=gnucash-$VERSION-1.tar.bz2                                                 # if you still have no bzip2 use ".gz" instead of ".bz2";
−
export URL=https://sourceforge.net/projects/gnucash/files/gnucash%20%28stable%29/$VERSION
+
export URL=https://sourceforge.net/projects/gnucash/files/gnucash%20%28stable%29/$VERSION # ;
−
cd ~/Downloads # "~" short for "$HOME" = "/home/<user>"
+
cd ~/Downloads                                                                           # "~" short for "$HOME" = "/home/<user>";
−
wget $URL/$TARBALL # Download the tarball
+
wget $URL/$TARBALL                                                                       # Download the tarball;
−
sha256sum $TARBALL # Integrity check: Compare the output with the sha256sum from the URL
+
sha256sum $TARBALL                                                                       # Integrity check: Compare the output with the sha256sum from the URL;
−
tar -xjvf $TARBALL -C ~/Applications # extract the tarball below your personal Applications directory
+
tar -xjvf $TARBALL -C ~/Applications                                                     # extract the tarball below your personal Applications directory;
−
</SyntaxHighlight>
+
</SyntaxHighlight>.
−
'''Note:''' The latest released version is '''{{Version}}'''.
+
 
 +
=== Unstable Releases ===
 +
Unstable releases rae also available from the [https://sourceforge.net/projects/gnucash/?source=navbar | SourceForge] page by selecting '''gnucash(unstable)''' option from the Files tab and then selecting the release you require from that page. Substitue '''unstable''' for '''stable''' in the export defining URL to use the above commands to download unstable releases.
  
−
For the very latest source code, get the sources with [[Git]] or
+
=== Developers Source Code===
−
: use the latest release source file of type <tt>gnucash-<version>.tar.gz</tt> from [https://sourceforge.net/projects/gnucash/files/ Sourceforge].
+
The development source code is available from the GitHub repository using [[Git]]
 
: '''Do not attempt to use tarballs from GitHub.'''
 
: '''Do not attempt to use tarballs from GitHub.'''
−
Examine the [[Dependencies]] wiki page and the [https://github.com/Gnucash/gnucash/blob/master/README.dependencies README.dependencies] file for the list of build dependencies for your distribution, the [https://github.com/Gnucash/gnucash/blob/master/README.git README.git] file for notes on compiling gnucash, and the [https://github.com/Gnucash/gnucash/blob/master/HACKING HACKING] file for notes on hacking the code
+
Examine the [[Dependencies]] wiki page and the [https://github.com/Gnucash/gnucash/blob/master/README.dependencies README.dependencies] file for the list of build dependencies for your distribution, the [https://github.com/Gnucash/gnucash/blob/master/README.git README.git] file for notes on compiling gnucash, and the [https://github.com/Gnucash/gnucash/blob/master/HACKING HACKING] file for notes on hacking the code.
−
==== '''''Download tarball''''' ====
 
−
# Select the link '''bzip compressed tarball''' for GnuCash 3.x stable release on the page [https://www.gnucash.org/download.phtml | Gnucash Download]
 
−
# or Select either the maint branch or master branch as required then click the Download button and select Download ZIP to download the tarball.
 
−
# Save to a suitable directory within your home directory (e.g. /home/<user>/Downloads).
 
−
# Extract the gnucash-3.<x> directory to a suitable directory under your home directory (e.g. either Downloads as above or something like /home/<user>/Applications (create if required)).
 
−
# Substitute appropriate minor release number for <x> from  {0,1,2..} where it appears in the commands below.
 
−
==== '''''Using git''''' ====
 
  
 
In a shell enter
 
In a shell enter

Revision as of 23:19, 16 June 2018

GnuCash Sources

Stable Releases

Note: The latest released version is 5.6.

The latest stable release of the GnuCash source code as zipped tar archives are available for download from:

These links all point to the SourceForge Download page and will download a zipped (compressed) tarball containing the sources for gnucash with a name of the form gnucash-<major>.<minor>-<packing>.tar.<bz2> , e.g. gnucash-5.6-1.tar.bz2.

All available stable releases are available from | SourceForge by selecting gnucash(stable) from the Files tab then selecting the version you require. The page has downloads for Windows, Mac-OSX, and bzip2 and gz zipped sources. For Linux select the source code gnucash-<version>-1.tar.bz2 or gnucash-<version>-1.tar.gz file depending upon which zip your distribution uses. You will find appropriate sha256sum values listed at the bottom of each <version> page which you can use to check the download integrity as described below.

You should save this file to a suitable location, e.g. Downloads directory in your home directory (/home/<user>/Downloads or $HOME/Downloads if the environment variable HOME is defined. Here <user> is your username on your system).

You should then extract the source code from the zipped archive to a suitable directory under your home directory where you will build gnucash, e.g. something like /home/<user>/Applications. The extracted top level source file usually has the same name as the archive.

In a shell, enter the following commands to download and check the tarball: 

export VERSION=3.1                                                                        # One place to adjust the version;
export TARBALL=gnucash-$VERSION-1.tar.bz2                                                 # if you still have no bzip2 use ".gz" instead of ".bz2";
export URL=https://sourceforge.net/projects/gnucash/files/gnucash%20%28stable%29/$VERSION # ;
cd ~/Downloads                                                                            # "~" short for "$HOME" = "/home/<user>";
wget $URL/$TARBALL                                                                        # Download the tarball;
sha256sum $TARBALL                                                                        # Integrity check: Compare the output with the sha256sum from the URL;
tar -xjvf $TARBALL -C ~/Applications                                                      # extract the tarball below your personal Applications directory;
.

Unstable Releases

Unstable releases rae also available from the | SourceForge page by selecting gnucash(unstable) option from the Files tab and then selecting the release you require from that page. Substitue unstable for stable in the export defining URL to use the above commands to download unstable releases.

Developers Source Code

The development source code is available from the GitHub repository using Git

Do not attempt to use tarballs from GitHub.

Examine the Dependencies wiki page and the README.dependencies file for the list of build dependencies for your distribution, the README.git file for notes on compiling gnucash, and the HACKING file for notes on hacking the code.

In a shell enter 

git clone -b maint https://github.com/Gnucash/gnucash.git
  1. The to level directory downloaded by git will be named "gnucash" not "gnucash-3.<x>".
  2. Either rename it or subsitute "gnucash" where "gnucash-3.<x>" occurs in the following commands.
Retrieved from "https://wiki.gnucash.org/wiki/index.php?title=GnuCash_Sources&oldid=14081"