KWave - Příručka: 2. Instalace

2. Instalace

Jakým způsobem získat Kwave

Kwave má vlastní domovskou stránku na adrese http://kwave.sourceforge.net/. Zde najdete další informace k projektu, a stejně tak i informace o aktuální stabilní a nejnovější vývojářské verzi.
Pokud chcete získat Kwave vydání, můžete navštívit http://kwave.sourceforge.net/download.html http://kwave.sourceforge.net/download.html a
  • stáhnout si binární balíček poslední stabilní verze. Pokud se tam nachází nějaký určený pro vaši distribuci,
  • stáhnout si zdrojový RPM balíček poslední stabilní verze,
  • sestavit si program vlastními silami z .tar.bz2 archivu obsahujícího zdrojový kód poslední stabilní verze,
  • sestavit si program vlastními silami z poslední Git verze.
Nebojte se, protože kompilace Kwave by měla být celkem jednoduchou záležitostí i v případě, že nejste programátorem. Je jenom potřeba mít nainstalovány některé vývojářské balíčky.

Požadavky

Abyste program mohl úspěšně používat Kwave, potřebujete:
  • počítač, na němž běží Linux (Kwave může být spouštěn i pod některými dalšími operačními systémy, ale nikdy jsme tuto možnost nezkoušeli. Dejte nám, prosím, vědět, jestliže se vám podaří spustit Kwave na jiné platformě/pod jiným operačním systémem)
  • Pracující přehrávání zvuku (pro použití programu není ve skutečnosti vyžadováno, ale co byste asi tak dělal s editorem zvuku, kdybyste si nemohl poslechnout výsledek vaší práce?)
  • KDE ve verzi 4.5 nebo vyšší (alespoň knihovny. V případě, že jste fonouškem prostředí GNOME, můžete program spouštět také,Kwave pokud jsou nainstalovány ty správné knihovny).
  • qt ve verzi 4.7 nebo vyšší (normálně je k dispozici s KDE4)
  • ALSA ve verzi 1.0.14 nebo vyšší (kvůli nahrávání a přehrávání)
  • PulseAudio ve verzi 4.0 nebo vyšší (kvůli nahrávání a přehrávání)
  • id3lib ve verzi 1.0.14 nebo vyšší (kvůli ID3 značkám)
  • mad ve verzi 0.15 nebo vyšší (volitelně kvůli zavedení/vyvedení MP3)
  • flac ve verzi 1.2.0 nebo vyšší (kvůli importu FLAC)
  • libsamplerate-0.1.3 nebo vyšší (převod kmitočtu)
Kvůli úplnějšímu a nejnovějšímu seznamu požadavků se, prosím, poraďte se souborem README. který je zahrnut ve zdrojové distribuci, nebo jej lze najít zde: http://sourceforge.net/p/kwave/code/ci/HEAD/tree/README. Tento soubor obsahuje také některé zvláštní tipy, jak program Kwave pod některými distribucemi Kwave spustit a/nebo sestavit.
Pokud máte v úmyslu kompilovat program Kwave ze zdrojových souborů, budete alespoň potřebovat:
  • cmake-2.4.6 nebo novější
  • Nedávný překladač C/C++. GCC-4.x pracuje dobře, některé starší a některé novější verze (jako gcc-4.8 a novější) pracují rovněž.
  • Vývojové prostředí glibc2 (libc-6). Na systémech se SUSE se tento balíček nazývá "libc", na jiných systémech může být nazván "libc-devel".
  • KDE4 vývojové prostředí: "kdelibs4-devel", "kdemultimedia4-devel", "kdesdk4".
  • Qt4 vývojové prostředí, balíček se obyčejně nazývá "qt4-devel" nebo podobně.
  • pulseaudio-4.0 nebo vyšší
  • id3lib-devel-3.8.1 nebo vyšší
  • fftw-3.0 nebo vyšší
  • mad-devel-0.15 nebo vyšší (pokud máte oprávnění používat kód MP3)
  • flac-devel-1.2.0 nebo vyšší
  • Pokud máte v úmyslu získat Kwave zdrojové soubory prostřednictvím Git, budete také potřebovat aktuální balíček "Git".
  • ...a mnoho dalších balíčků. Podívejte se, prosím, na "README" soubor je zahrnut ve zdrojovém balíčku.

Vlastnoruční kompilace a instalace

Od verze 0.7.10 Kwave používá cmake, "make" systém, který je používán také prostředím KDE. Takže pokud můžete sestavit jiné KDE aplikace, měl byste moci sestavit i Kwave. Jestliže se setkáte s problémy, nahlašte je, prosím, do Kwave poštovního seznamu.
Při kompilaci a instalaci Kwave na váš systém je nejlepší na zkoušku udělat sestavení programu "mimo adresářový strom". To znamená, že držíte zdrojové soubory od Kwave v jednom oadresáři, a balíček sestavujete v jiném (dočasném) adresáři.
Například v případě, že vaše zdrojové soubory jsou již rozbaleny v $HOME/src/kwave-0.8.12, můžete udělat následující:
% mkdir /tmp/kwave-build
% cd /tmp/kwave-build
% cmake $HOME/src/kwave-0.8.12 [build options]
% make
% su root -c "make install"
(Určení voleb pro sestavení programu je způsobem, jak umožnit, nebo znemožnit zvláštní funkce. Kvůli jejich popisu si prohlédněte následující sekci.)

Volby pro sestavení programu

Určením voleb pro sestavení programu můžete povolit nebo nepovolit některé funkce Kwave, např. vyloučení některých částí nebo přídavných modulů z vytvořeného balíčku. Seznam dostupných voleb je zde:
  • WITH_ALSA povolit přehrávání/nahrávání prostřednictvím ALSA [on: zapnuto/off: vypnuto, default=: výchozí=on: zapnuto]
  • WITH_DEBUG sestavit verzi ladění [on: zapnuto/off: vypnuto, default=: výchozí=off: vypnuto]
  • WITH_DOC sestavit dokumentaci na internetu [on: zapnuto/off: vypnuto, default=: výchozí=on: zapnuto]
  • WITH_FLAC povolit podporu souborů FLAC [on: zapnuto/off: vypnuto, default=: výchozí=on: zapnuto]
  • WITH_MP3 povolit podporu souborů mp3 [on: zapnuto/off: vypnuto, default=: výchozí=on: zapnuto] Všimněte si, prosím, že pro použití kódu zahrnutého do patentů k počítačovým programům potřebujete svolení!
  • WITH_OGG_OPUS povolit podporu souborů Ogg/Opus [on: zapnuto/off: vypnuto, default=: výchozí=on: zapnuto]
  • WITH_OGG_VORBIS povolit podporu souborů Ogg/Vorbis [on: zapnuto/off: vypnuto, default=: výchozí=on: zapnuto]
  • WITH_OPTIMIZED_MEMCPY použít vyladěnou verzi memcpy, dostupná pro platformy X86, X86_64 a PPC [zapnuto/vypnuto, výchozí=zapnuto]
  • WITH_OSS povolit přehrávání/nahrávání prostřednictvím OSS [on: zapnuto/off: vypnuto, default=: výchozí=on: zapnuto]
  • WITH_PHONON povolit přehrávání prostřednictvím Phonon (pouze kvůli zkoušení) [on: zapnuto/off: vypnuto, default=: výchozí=off: vypnuto]
  • WITH_PULSEAUDIO povolit přehrávání/nahrávání prostřednictvím PulseAudio [on: zapnuto/off: vypnuto, default=: výchozí=on: zapnuto]
Tyto volby mohou být předány cmake s -Dvolba=hodnota. Pokud například chcete zavedení souboru MP3, můžete předat odpovídající volbu, jak následuje:
% cmake [zdrojový adresář] -DWITH_MP3=ON [další volby...]

Vytvoření balíčků RPM z archivů tar.bz2

S pracujícím rpmbuild -ta

Jestliže používáte systém s podporou RPM, bude upřednostňovaným způsobem Kwave instalace na vašem systému vytvoření hezkého RPM balíčku. Nejprve byste měl získat aktuální zdrojový soubor z Kwave, buď jako archiv tar.bz2 ze stránky Kwave určené pro stahování, nebo se mrknout na nejnovější kopii prostřednictvím Git (jak je to popsáno v kapitole o Git) a přečíst si další kapitolu.
Jestliže jste si stáhl archiv tar.bz2 z Kwave, vytvořte a instalujte RPM provedením následujících kroků (kde [arch] představuje platformu, pro kterou jste balíček vytvořil a může vypadat nějak takto i586, i686, sparc nebo i jinak, XXX představuje číslo verze, kterou jste si stáhl).
Vytvořit Kwave balíček a instalovat jej do:
% rpmbuild -ta kwave-XXX.tar.bz2
% rpm -i /usr/src/redhat/RPMS/[arch]/kwave-XXX.[arch].rpm

Note

Poznámka pro uživatele SuSE: musíte určit adresář /usr/src/packages namísto /usr/src/redhat !
Pokud jste neuviděli nějaké chyby, pak je vše v pořádku a vy můžete přeskočit zbytek této kapitoly. Pokud rpm nebylo schopno balíčky vytvořit a říká něco jako "spec file not found", potom pokračujte ve čtení zbytku tohoto oddílu.

S pokaženou podporou rpmbuild -ta

Pokud se vám nedaří zajistit, aby příkaz rpmbuild -ta pracoval, tady jsou nezbytné kroky pro vlastnoruční provedení tohoto úkonu (složitější způsob):
  1. Jděte do svého RPM "topdir". Obvykle se nachází v /usr/src/redhat v případě distribuce redhat nebo /usr/src/packages jestliže máte distribuci SuSE.
    % cd /usr/src/redhat
    
  2. Zkopírujte tar.bz2 archiv do SOURCES podadresáře (samozřejmě musíte nahradit "kdekoli" skutečným adresářem, v němž jsou soubory).
    % cp /kdekoli/kwave-XXX.tar.bz2 SOURCES
    
  3. Získejte z archivu soubor spec a vložte jej do podadresáře SPEC
    % tar -xOzf SOURCES/kwave-XXX.tar.bz2 \*.spec 
    > SPECS/kwave.spec
    
  4. Nechte rpm provést kompilaci a vytvořte rpm z Kwave. Pokud chcete pouze udělat binární balíček, můžete přesně určit -bb namísto -ba, nebo jen -bs
    % rpmbuild -ba SPECS/kwave.spec
    
  5. Pokud vše proběhlo dobře, můžete nainstalovat binární rpm z Kwave, bude v adresáři BUILD. Pokud již máte nainstalovánu verzi Kwave odstraňte,prosím, nejprve ji, nebo použijte pomocnou proměnnou -U namísto -i kvůli aktualizaci místo instalace.
    % rpm -ivh BUILD/[arch]/kwave-XXX.[arch].rpm
    

Tvoření RPM balíčků z Git

Stažení zdrojů

Pro počáteční stažení zdrojů budete potřebovat prostor na disku (asi 25 MB) v adresáři dle vašeho výběru, git balíček vaší oblíbené distribuce a plný přístup na internet.Pokud obdržíte hlášení chyb o odmítnutém spojení, buď jste něco zadal nesprávně, nebo vám váš poskytovatel nedal plný přístup. Dobrým místem pro zdrojové soubory bude "$HOME/src".
  1. Nejprve vytvořte adresář, který přijme podadresář s Kwave zdroji, a přemístěte se do něj:
    % mkdir -p $HOME/src
    % cd $HOME/src
    
  2. Potom stáhněte poslední zdroje z Git serveru:
    % git clone git://git.code.sf.net/p/kwave/code kwave
    
    or you can check out a specific release with the following commands:
    % git clone git://git.code.sf.net/p/kwave/code kwave
    % cd kwave
    % git checkout tags/[release-tag] 
    
    You can look up the names of the release tags in the git web page at http://sourceforge.net/p/kwave/code/ref/master~/tags/. The release tags are always built out of the word Release- and the version number of the release, with underscores instead of dots. For example "Release-0_8_12" for v0.8.12.

Warning

Nesmí tu být žádný nazvaný kwave v adresáři, který chcete stahovat. Jinak si bude program Git stěžovat na již existující soubory a načtení nebude pracovat.

Aktualizace zdrojů z Git

Postup popsaný v předchozím oddíle je nezbytné provést pouze jednou. Při dalších aktualizacích je celá ta věc mnohem jednodušší. Pouze se přesuňte do adresáře, ve kterém máte stažené zdroje a proveďte následující kroky:
% git pull
Pak přejděte k dalšímu oddílu a kompilujte jako obvykle.

Note

Pokud máte dojem, že jste zmrvil obsah svých místní zdrojových adresářů kwave, nebo když jste během aktualizace zaznamenal konflikty, nebo chcete začít s čistým stavem, můžete pro zahození všech místních změn udělat následující a přepnout se zpět do poslední verze z hlavní větve:
% git clean --force -d
% git reset --hard
% git checkout master

Kompilace

Sestavení rpm balíčku ze snímku Git je docela jednoduché. Postup je téměř totožný s tím, který byl popsán v posledním oddíle, takže má naneštěstí také ten samý problém s příkazem rpmbuild -ta, který naše metoda uvnitř používá. Tak jako v předchozí kapitole, [arch] stojí na platformě, pro kterou jste balíček sestavil, a která může být např. i386, i586, sparc či jakákoli jiná, XXX zastupuje číslo verze, kterou jste stáhl.

Note

Poznámka pro uživatele SuSE: Zde musíte rovněž určit adresář /usr/src/packages namísto /usr/src/redhat!
Za předpokladu, že jste v kořenovém adresáři, kam jste se přepnul z Git, udělejte pro vytvoření Makefile následující, Kwave balíček a nainstalujte jej. Jestliže již máte verzi Kwave nainstalovánu, nejprve ji, prosím, odstraňte, nebo použijte rpm -U namísto rpm -i kvůli aktualizaci místo instalace.
% mkdir /tmp/kwave-build
% cd /tmp/kwave-build
% cmake $HOME/src/kwave
% make rpm
% rpm -ivh /usr/src/redhat/BUILD/[arch]/kwave-XXX.[arch].rpm

Note

Pokud máte stále problémy s make rpm, naleznete tar.bz2 archiv, který byl vytvořen v /tmp. Následujte, prosím, instrukce v předchozí kapitole.

Sestavení balíčku DEB pro zkoušení a osobní užití

Pokud chcete vytvořit balíček .deb Kwave, např. kvůli vyzkoušení verze, která ještě není dostupná přes oficiální úložiště balíčků, potom si svůj vlastní balíček můžete vytvořit docela snadno. Především musíte nainstalovat některé požadované nástroje.
% sudo apt-get install build-essential checkinstall
Potom můžete nainstalovat závislosti požadované pro sestavení, tím že budete předstírat, že instalujete závislosti pro oficiální verzi Kwave
% sudo apt-get build-dep kwave
Po nainstalování všech požadovaných balíčků můžete vytvořit Kwave, jak je to popsáno v předchozích kapitolách. Po sestavení můžete napsat toto pro získání souboru .deb ve vašem nynějším sestavovacím adresáři.
% make deb

Note

Soubor .deb, který dostanete pomocí tohoto kroku, nebude mít kvalitu, kterou má balíček z vašeho oficiálního úložiště. Je dost dobrý právě pro nainstalování, účely zkoušení, osobní užití a bezpečné odinstalování Kwave.

Sestavení balíčků optimalizovaných pro CPU

Pokud jste vlastníkem procesoru Pentium, AMD K6, Athlonu nebo Athlonu XP, je možné, že budete chtít použít optimalizace kompilátoru pro zkompilování své verze Kwave, která poběží o několik procent rychleji. Nárůst rychlosti bude u některých systémů až o 30 % , u nichž budou z toho mít zisk funkce, které mají co dělat s manipulací se signálem a se všemi funkcemi, které provádějí složité operace spojené s časem a kmitočtem (jako FFT a Sonagram).
Nemusíte toho o programování vědět mnoho, abyste mohli použít vyladěný kompilér pro sestavení Kwave, ale je možné, že budete potřebovat čas na uvedení kompiléru do provozu a předtím také na jeho nainstalování.

Vyladění RPM

Můžete snadno sestavit balíček RPM, který bude vyladěný pro Athlon, Athlon-XP, Pentium a Pentium Pro (a některé další procesory) pomocí některých vymezení ve vašem rpmrc souboru. Rovněž můžete upravit svůj systémový rpmrc soubor v /usr/lib/rpm nebo soubor.rpmrc ve svém domovském adresáři. Můžete přesně určit řádky s volbami, jako jsou tyto:
optflags: i586 -O2 -march=pentium -DNDEBUG -fomit-frame-pointer
optflags: i686 -O2 -march=pentiumpro -DNDEBUG -fomit-frame-pointer
optflags: athlon -O2 -march=athlon -DNDEBUG -fomit-frame-pointer
optflags: k6 -O3 -march=k6 -DNDEBUG -fomit-frame-pointer
optflags: k7 -O3 -march=athlon-xp -DNDEBUG -fomit-frame-pointer
(Tato hezká kouzla jsem našel na http://www.keywarrior.net/duesti/rpmopt.en.html. Díky Matthiasovi Düsterhöftovi!).
Znamená to, že na architektuře k7 bude balíček rpm sestaven pomocí -O3 -march=athlon-xp -DNDEBUG -fomit-frame-pointer jako volbou pro sestavení atd. Můžete ji rozšířit nebo přizpůsobit podle svých vlastních potřeb. Nastavení použijte předtím na všechny čísti na všechmístech, kde je použito rpmbuild -ta nebo, kde má být vytvořen RPM ze zdrojového rpm pomocí příkazu rpmbuild --rebuild.

Note

Pokud rpm odmítne instalaci vašeho balíčku, protože to vypadá, že nezapadá do architektury vašeho počítače, můžete obvykle nainstalovat pouze vyladěný balíček, a to zadáním dodatečného parametru --ignorearch, a dál si nedělejte starosti.

Jak předat překladač volby pro vyladění ručně

Vyvolání překladače je docela jednoduché. Obvykle stačí správným způsobem nastavit proměnné prostředí CFLAGS aCXXFLAGS a potom provést sestavení, jako obvykle. Kvůli nejlepšímu nastavení se, prosím, poraďte s dokumentací nebo na domovských stránkách odpovídajícího překladače.
Pokud sestavujete Kwave ze stromu zdroje (nezabalený tar.bz2 nebo z Git) je potřeba zadat příznaky před zavoláním. Například:
% CFLAGS="-O4 -march=athlon-xp -mcpu=athlon-xp -pipe" \
CXXFLAGS="-O4 -march=athlon-xp -mcpu=athlon-xp -pipe" \
cmake [source directory]
Pokud sestavujete znovu Kwave ze zdrojového rpm balíčku, následujte, prosím, pokyny v předchozím oddíle.