He/דביאן

From GnuCash
Revision as of 07:20, 24 April 2021 by Avma (talk | contribs) (→‎אודות שחרורי דביאן ושמות מהדורות)
Jump to: navigation, search
שפות Deutsch English Español Français עִברִית Português

כללי

דֶּבְּיאָן גְנוּ/לִינוֹקְס (באנגלית: Debian GNU/Linux) היא הפצת לינוקס קהילתית המפותחת על ידי קבוצה גדולה של מתנדבים מרחבי העולם. בנוסף לגרעין מערכת ההפעלה, כוללת המערכת אלפי חבילות תוכנה חופשיות נוספות, מיעוט התוכנות משולבות בבסיס המערכת ורובן ניתנות להתקנה לפי בחירת וצורך המשתמש מאתרי מקורות של דביאן. דביאן מתאפיינת בהיצמדותה לעקרונות יוּנִיקְס והתוכנה החופשית, בשיתוף הפעולה בפיתוח התוכנות ובתהליך בקרת האיכות שלה, ובאמנה החברתית העומדת במרכזה ומתווה את מטרותיה.

אודות שחרורי דביאן ושמות מהדורות

כל שמות הקוד של ההפצות נלקחו משמות הדמויות מסרטי צעצוע של סיפור של חברת פיקסאר, כגון "באז", "וודי", "רקס" ו"סלינק", וההפצה הלא יציבה מכונה "סיד", על שם דמותו של הילד השכן הורס הצעצועים. מסורת זו החלה מכיוון שברוס פרנס היה מעורב בשלבי הפיתוח הראשוניים של דביאן בעת עבודתו בפיקסאר. חבילות התוכנה בהפצה זו מתעדכנות באופן סדיר ובתדירות גבוהה. לכל חבילה יש מתחזק, אשר אחראי על הכנת חבילות deb מקוד המקור באתרי הפיתוח של התוכנות השונות. באחריות המפתח לוודא את תקינות קוד המקור, לדווח על בעיות למאגר באגים מרכזי, לתעד המידע בחבילה עבור מערכת ניהול החבילות, לוודא פתרון של תלויות בין החבילה ותוכנות אחרות ועוד.

חבילות ומהדורות דביאן עוברות בדיקות פרוצדוראליות ואיכות נוקשות. להלן תאור מילולי קצר של תהליך הפתוח של דביאן:

  • המהדורה הנוכחית היציבה מכילה חבילות שעמדו בכמה וכמה בדיקות ושההו לפחות פרק זמן מסוים בתיבת הבדיקות.
  • תיבת הבדיקות הופכת לשם השחרור של המהדורה הבאה, לאחר שתוכנה מוקפא לשחרור. חבילות שיכנסו לתיבת הבדיקות הנוכחית, שהגיעו מתיבת דביאן לא יציב (המכונה גם סיד על שם הדמות בצעצוע של סיפור שהרס צעצועים באופן קבוע).
  • חבילות חדשות ששוחררו מתקבלות לסיד על ידי אנשי תמיכת דביאן מוסמכים.
  • נהלים נוספים מטפלים בחבילות שנתגלו בהן בעיות אבטחה או "שאינן מתוחזקות באופן פעיל.
באקפורטס
באקפורטים הם חלקים שנלקחו מגרסה חדשה יותר של מערכת תוכנה או רכיב תוכנה ווהחדרתם לגרסה ישנה יותר של אותה תוכנה. במקרה של דביאן, אלו חלקים או חבילות שנלקחו מהמהדורה הבאה של דביאן (המכונה "בדיקות"), והותאמו והודרו לשימוש בגירסת דביאן יציבה. על מנת להשתמש בבאקפורט הרשמי של דביאן-בוסטר, נא להוסף את השורה הבאה לקובץ רשימת המקורות sources.list:
 deb http://deb.debian.org/debian buster-backports main
Current state
Debian 10 "Buster," the "stable" release July 2019, shipped with Gnucash version 3.4, but you can use Backports.

Wikipedia has a handy chart showing Debian's past, current and future releases.

About Debian Repositories

The name of the GnuCash package in Debian and Ubuntu is gnucash. You can find up-to-date development information about the package using the Debian Package Tracker.

The tracker will contain links to whichever package versions are frozen into the three most recent Debian releases, plus the version in testing, and the version in unstable as of that moment. For example, in April 2020,

  • Debian unstable (sid) has GnuCash 3.10 (the version in sid)
  • Debian testing (bullseye) has GnuCash 3.10 (until the next version in sid progresses to bullseye)
  • Debian 10 (buster) contains GnuCash 3.4 (will not change, but you can use Backports)
  • Debian 9 (stretch) contains GnuCash 2.6.15 (will not change)
  • Debian 8 (jessie) contains GnuCash 2.6.4 (will not change)

(The most recent GnuCash version should normally be in Debian testing, but in October 2018 the sole volunteer maintaining the Debian GnuCash package indicated needing help. If you might assist with the packaging, including helping "triage" bugs, use the information on the tracker page for details.)

About Debian's GnuCash packages

Debian splits the GnuCash installation into 4 packages:

  • gnucash
  • gnucash-common
  • python-gnucash
  • gnucash-docs

(The python-gnucash package includes bindings to link GnuCash to python. The gnucash-docs package contains the documentation in multiple languages and gets built separately from a separate source package.)

In addition, to activate the (optional) ability to store GnuCash data in a database, you will need to install the two packages:

  • libdbi1
  • libdbi-dev

Plus you will need to install the libdbd package for whichever supported database(s) you want to use (choose one or all):

  • libdbd-sqlite3
  • libdbd-mysql
  • libdbd-pgsql

Although all the database backends are still considered experimental in GnuCash 3.x, the SQLite3 database backend is the best tested and supported.

התקנת חבילת גנוקאש תחת דביאן

הדרך הקלה והפשוטה ביותר להתקנת גנוקאש על ידי הרצת הפקודה הבאה ממסוף: 

 $ sudo apt install gnucash

ככל שברירות המחדל נשמרו, הפקודה apt תתקין באופן אוטומטי גם את החבילות הבאות: gnucash-common, gnucash-docs ו- python-gnucash.

על מנת להתקין באופן מפורש את כל החבילות (ולא להסתמך על ברירית המחדל), ניתן להקיש לתוך שורת הפקודה במסוף, את הפקודה הבאה: 

 $ sudo apt install gnucash gnucash-common gnucash-docs python-gnucash libdbi1 libdbi-dev libdbd-sqlite3 libdbd-mysql libdbd-pgsql

שימוש בארכיב דביאן

GnuCash individual packages can be downloaded from http://ftp.us.debian.org/debian/pool/main/g/gnucash/ which is an archive used by old distributions of Debian but usually also includes fairly recent versions of GnuCash.

See http://ftp.us.debian.org/debian/README.html.

אודות GetDeb

In this wiki and archived discussions you may see references to "GetDeb," which once held unofficial backported Debian packages of popular applications including GnuCash. The site was maintained by a small group of private volunteers. Sometime before 2018 the site became stale and ultimately disappeared. In 2019 someone bought the domain and seems to be using it as a news site.

בנקאות מקוונת

על מנת לספק יכולות של בנקאות מקוונת, גנוקאש משתמשת בספרית AqBanking. בגלל בעיות תאימות ברישוי, חבילות דביאן ואובונטו לא אפשרו פעילות בנקאות מקוונת בחבילת הגנוקאש הפועלת עליהן. אך החל מגרסת גנוקאש 2.2.6 ו- AqBanking גרסה 3.0 אי ההתאמה הזו באה לפתרונה.

Debian Lenny and Ubuntu 8.10 Intrepid now have gnucash packages with online banking enabled. So for Debian Lenny and Ubuntu Intrepid, the gnucash package included in the distribution can be installed.

For Ubuntu Hardy, a backport of gnucash 2.2.6 are available from https://launchpad.net/~gnucash/+archive For Debian Etch, a backport of gnucash is available in etch-backports. http://packages.debian.org/etch-backports/gnucash

הערה: In Debian the gwenhywfar library is split into a number of packages see https://packages.debian.org/testing/source/libgwenhywfar.

Old Build Instructions (Ubuntu Gutsy and below, Debian sarge and below)

These instructions apply to version 2.0.1-2 of Debian's gnucash package, running on Debian 4.0 ("etch"). They also apply to Ubuntu Edgy gnucash version 2.0.1-3ubuntu3, but please consult the Ubuntu page for Ubuntu specific instructions. As time marches on, and the package is updated, the specific details of these instructions will become outdated, so be prepared to search for newer packages (e.g., libaqbanking17-dev instead of libaqbanking-16.dev) or use higher version numbers (e.g., 2.0.2 instead of 2.0.1) as necessary.

Additionally you need to recompile libaqbanking.

הורדת חבילות דרישות קדם

To begin with, install the packages that are required to build any Debian package, the packages that are required to build the gnucash package, the package for the AqBanking development library and a couple of other packages that we will make use of in the instructions below: 

# sudo aptitude install build-essential devscripts fakeroot libaqbanking16-dev aqbanking16-qt-wizard
# sudo aptitude build-dep gnucash libaqbanking


If libaqbanking16-dev can not be found, try asking apt to install libaqbanking-dev. Apt should then tell you which package you really need. Or try searching for libaqbanking on packages.debian.org or packages.ubuntu.com to find the correct version. Try [1] or [2].

Make a directory to work in and download and extract the gnucash source code: 

$ mkdir gnucash
$ cd gnucash
$ apt-get source gnucash libaqbanking

גנוקאש

תצור

The source code for gnucash will now be extracted to a directory named gnucash-2.x.x. Now, we enable HBCI support. To do this, edit the debian/rules file: 

 $ cd gnucash-2.*
 $ editor debian/rules

This is a makefile that specifies how to build the gnucash packages. Find where gnucash's configure script is invoked, and add --enable-hbci to the configure script's arguments. When I did this I found it on line 24. I changed the line to read: 

env LDFLAGS="-L/usr/X11R6/lib" GUILE=/usr/bin/guile-1.6 CFLAGS="$(CFLAGS)" ./configure 
--disable-static --sysconfdir=/etc --prefix=/usr --mandir=/usr/share/man 
--infodir=/usr/share/info --libexecdir=/usr/lib --libdir=/usr/lib/gnucash --enable-ofx 
--disable-error-on-warning --enable-hbci || cat config.log

Note: --enable-mt940 is no longer required as of 2.2.0; it is included in --enable-hbci. For pre-2.2.0 builds, add --enable-mt940 after --enable-hbci if that functionality is needed.

Optional, but strongly recommended: make a note of the changes you have made in the package's changelog. The devscripts package contains a utility to automate the process: 

$ debchange --nmu 'Enable HBCI support'

This enables a few nice behaviors for your package.

  1. When you wonder in six months time, "what changes did I make to that package?", you can check by examining the /usr/share/doc/gnucash/changelog.Debian.gz file.
  2. The version of the package you are building will be slightly higher than the version of the packages in the Debian or Ubuntu archive. This will prevent apt from overwriting the new package with the old package from the archives. If a new version of gnucash is packaged by the Debian or Ubuntu package maintainers, it will be installed over the package we are building here. (You would then have to repeat these instructions.)

If this is not the desired result, you can apply a hold to the gnucash package. See below for more information.

בניה

כעת אנחנו מוכנים לבנית החבילה. 

 $ dpkg-buildpackage -b -us -uc -rfakeroot

זה הזמן להכין כוס תה (או אם יש לכם מחשב איטי במיוחד, לכו וצפו בנחת בטרילוגיית שר הטבעות). כדי לוודא שהכל בוצע נכון, הפקודה תפיק פלט, ממש בהתחלה, עם מלא שורות שמתחילותבמילים "בדיקת המצאות ..." (checking for ...) . חפשו את השורות 

checking whether to use OFX... yes -- failure is fatal
checking for libofx version >= 0.7.0... found 0.8.0
checking for libofx/libofx.h... yes
checking for libofx... yes
configure: WARNING: MT940 importing support is enabled but is totally experimental!
checking for aqbanking >= "1.3.0"... yes
checking HBCI_CFLAGS...  
checking HBCI_LIBS... -laqbanking  
checking for aqbanking >= "1.0.0"... yes
checking HBCI_CFLAGS...  
checking HBCI_LIBS... -laqbanking

כמו כן, בתום כל הבדיקות, 'configure' ייצר פלט דוח סיכום. שימו לב ל- ofx, hbci ו- mt940 בשורת הרכיבים האופציונליים. 

Options detected/selected
  -------------------------
  gnucash version ...... : 2.0.1
  Build for host ....... : i686-pc-linux-gnu
  Optional components....: ofx hbci mt940

Completing the install

$ cd ..
# sudo dpkg --install gnucash_*.deb gnucash-common_*.deb

Finally, free up a few hundred MB of disk space (after verifying that gnucash works as expected) by removing the directory where the package was built: 

$ rm -r gnucash-2.0.1

If you want to hold the package at the current version and prevent new upstream package versions from being installed, apt allows you to apply a hold to a package. This will prevent apt from doing anything with the package. One way to apply a hold (it can also be done in the various package manager guis) is by running: 

$ echo "gnucash hold" | sudo dpkg --set-selections

More information about this can be found at debian-administration.org and The APT Howto

libaqbanking

תצור

קוד המקור של ספריית libaqbanking יחולץ לתקיה בשם libaqbanking-2.x.x. Now, we enable aqofxconnect support. To do this, we reverse these changes.

במיוחד:

עריכת קובץ debian/rules: 

$ cd libaqbanking-2.*
$ editor debian/rules

And add aqofxconnect to the list of backends.

כלומר מ: 

DEB_CONFIGURE_EXTRA_FLAGS := --disable-static --with-backends="aqhbci aqdtaus aqgeldkarte" --with-frontends="cbanking g2banking qbanking kbanking"

ל: 

DEB_CONFIGURE_EXTRA_FLAGS := --disable-static --with-backends="aqhbci aqdtaus aqgeldkarte aqofxconnect" --with-frontends="cbanking g2banking qbanking kbanking"

Create the file debian/libaqbanking-ofx0.install: 

$ editor debian/libaqbanking-ofx0.install

And put this text in it: 

usr/lib/aqbanking/plugins/16/imexporters/ofx.*
usr/lib/aqbanking/plugins/16/providers/aqofxconnect.*
usr/lib/aqbanking/plugins/16/frontends/qbanking/cfgmodules/aqofxconnect.*
usr/lib/libaqofxconnect.so.*
$ edit debian/control

And add this (notice the single space at the start of some lines): 

Package: libaqbanking-ofx0
Provides: libaqbanking-backend
Enhances: libaqbanking0c2a
Section: libs
Architecture: any
Depends: ${shlibs:Depends}
Conflicts: libaqofxconnect4
Description: library for OFX online banking
 AqBanking provides a middle layer between the applications
 and online banking libraries implementing various file formats and protocols.
 Plugins supporting OFX, DTAUS, and HBCI are available. For the latter,
 AqHBCI is required.
 .
 This package provides support for Open Financial Exchange (OFX) in AqBanking.
 OFX is a specification for the electronic exchange of financial data between
 financial institutions, business and consumers via the Internet.
 .
 Homepage: http://www.aquamaniac.de/aqbanking/

debchange --nmu 'Enable aqofxconnect'

בניה

$ dpkg-buildpackage -b -us -uc -rfakeroot

Look for aqofxconnect: 

Summary
----------------------------------------------------
AqBanking version  : 2.2.3.0-stable
Supported backends : aqhbci aqdtaus aqgeldkarte aqofxconnect
Supported frontends: cbanking g2banking qbanking kbanking

התקנה

 $ cd ..
 # sudo dpkg --install libaqbanking-ofx0_*.deb

לחילופין: 

 $ rm -r libaqbanking-2.*
 $ echo "libaqbanking-ofx0 hold" | sudo dpkg --set-selections

Enabling debugging symbols

הליך זהה לזה שמעל: 

# aptitude install build-essential fakeroot devscripts
# aptitude build-dep gnucash
$ mkdir gnucash
$ cd gnucash
$ apt-get source gnucash
$ cd gnucash-2.0.1
$ editor debian/rules

Now add the --enable-debug option to the arguments of the configure script. 

$ debchange --nmu 'Enable debugging'
$ DEB_BUILD_OPTIONS=nostrip dpkg-buildpackage -b -us -uc -rfakeroot
$ cd ..
# dpkg --install gnucash_*.deb gnucash-common_*.deb

Alternatively build a different version of Gnucash directly from source

גרסת גנוקאש >= 3.0

Gnucash from version 3.0 no longer uses autotools for configuring the build and uses CMake instead. Until Debian specific instructions are provided consider adapting the build instructions for Ubuntu distributions Building#Ubuntu

גרסת גנוקאש <= 2.6.21

This may be useful if you want to use a later version than the ones in Debian's repositories. Rather than building a Debian package I just used the instructions provided by Gnucash for any flavour of Linux. These notes are no more than confirmation that those instructions work. I don't know enough about building packages - integrating a build within a package would presumably be a better longer term solution but the following gets the job done. I performed this install of Gnucash 2.2.4 into Debian Etch - this was my first foray into compiling and it wasn't difficult. 

  $ sudo aptitude purge gnucash

First install all dependencies 

  $ sudo aptitude update
  $ sudo aptitude install build-essential
  $ sudo aptitude build-dep gnucash

(someone else may know if any of these are not essential for this task, but they are sufficient)

download source and docs from Gnucash web site (in my case to my desktop) 

	http://sourceforge.net/projects/gnucash/

move them to a new gnucash-source directory (obviously change "russell" to your own login name): 

  $ cd ~
  $ mkdir gnucash-source
  $ mv /home/russell/Desktop/gnucash* /home/russell/gnucash-source

unpack (creates 2 directories) - modify the file names as necessary (e.g. ...2.2.5 etc) 

  $ tar -xf gnucash-source/gnucash-2.2.4.tar.bz2
  $ tar -xf gnucash-source/gnucash-docs-2.2.0.tar.gz

Installation instructions are in /home/russell/gnucash-source/gnucash-2.2.4/INSTALL which you may wish to read.

Now move into the directory you are going to compile from: 

  $ cd ~/gnucash-2.2.4

First you run the ./configure script. I am advised that you can get a cleaner install if you add --prefix in order to install in a separate directory i.e. 

  $ ./configure --prefix=/opt/gnucash-2.2.4

This means that gnucash will install into /opt/gnucash-2.2.4 instead of the default /usr/local. The problem with the default is that it may be difficult to uninstall it if you want to upgrade the system with a later version or a Debian gnucash package, because there may also be other applications in /usr/local. However I didn't know about this at the time so I just used ./configure, next time I may try the --prefix 

  $ ./configure
  $ make
  $ make check
  (may not be necessary to do make check, but do it anyway in case it indicates a problem)
  $ sudo make install

Also you will need to build the docs as they are a separate package 

  $ cd ~/gnucash-docs-2.2.0
  $ ./configure
     (if you want to use the --prefix make sure you use the same directory as above i.e.
      ./configure --prefix=/opt/gnucash-2.2.4)
  $ make
  $ sudo make install

If you need to find the binary it should be in /opt/gnucash-2.2.4/bin or /usr/local/bin depending on whether or not you used the --prefix with ./configure.

When running Gnucash for the first time you will have to go through the setup - I chose default values

Optional cleanup: First you might want to archive the downloaded source if you want to be able to reinstall it later 

    $ mv /home/russell/gnucash-source/ whereever/

לאחר מכן ניתן להסיר את קובצי ההידור על ידי: 

    $ cd ~/gnucash-2.2.4
    $ make clean
    $ make distclean
    $ cd ~/gnucash-docs-2.2.0
    $ make clean
    $ make distclean
Retrieved from "https://code.gnucash.org/wiki/index.php?title=He/דביאן&oldid=19064"