From Amarok Wiki
Dansk | Deutsch | English | Castellano | Français | Português
O amaroK é fácil de instalar. A maioria das distribuições têm pacotes, mas se preferir ter a flexibilidade de escolher que componentes do amaroK quer contruir, irá ter que compilar o código fonte.
Contents |
Que Versão do amaroK Escolher?
O desenvolvimento do amaroK é rápido, e como resultado, as versões beta e de SVN tendem a não ser muito estáveis. No entanto dispendemos muito tempo a analisar os 'backtraces' (informação de erros) para que as versões estáveis sejam isso mesmo! Recomendamos instalar uma versão estável do amaroK, e experimentar com as versões beta e de SVN se aceitar uns ocasionais (ou mais frequentes) bloqueios.
Pacotes de Distribuições
Pode conseguir descarregar um pacote amaroK para a sua distribuição. Estão listados na página Download.
As distribuições seguintes tendem a oferecer a ultima versão do amaroK atravéz dos seus sistemas de gestão de pacotes:
- ArchLinux ('pacman -S amarok' or 'pacman -S amarok-devel' to get the last svn package)
- Ark Linux ( 'apt-get update; apt-get install amarok' )
- Gentoo
- mkdir -p /etc/portage
- echo "media-sound/amarok xine" >> /etc/portage/package.use
- emerge -av amarok
- Gentoo tende a demorar um pouco a considerar como "estável" um determinado pacote, pelo que é boa ideia adicionar primeiro:
media-sound/amarok ~x86
- ao ficheiro /etc/portage/package.keywords (crie-o se não existir). Também existe um Gentoo SVN ebuild disponível para instalar a versão de desenvolvimento.
- Fedora or Red Hat ('yum install amarok')
se a saída no configurador do motor de som da extensão GStreamer estiver vazia (p.ex.: não vê as opções esdsink, ossink, alsasink, etc), execute as seguintes linhas:
- yum install gstreamer-tools
- yum install gstreamer-plugins
- Kubuntu
- wget http://people.ubuntu.com/~jriddell/kubuntu-packages-jriddell-key.gpg
- sudo -s
- apt-key add kubuntu-packages-jriddell-key.gpg
- echo "deb http://kubuntu.org/packages/amarok-latest dapper main" >> /etc/apt/sources.list
- apt-get update
- apt-get install amarok amarok-engines
- exit
- Se usar uma distribuição RPM, existe um compreensivo e actualizado motor de busca RPM que pode ser útil se lhe faltarem algumas librarias.
Compilar o Código Fonte
- Descarregue o ficheiro source tarball, e extraia-o com:
tar xjf amarok-x.y.z.tar.bz2
- Obviamente deve substituir x.y.z pela versão descarregada do amaroK, p.ex.:
tar xjf amarok-1.4.3.tar.bz2
- Mude para a directoria para a qual foi estraído o ficheiro, deve ser da forma amarok-x.y.z, p.ex.:
cd amarok-x.y
- Leia o ficheiro README que está nessa directoria, pode conter informações específicas sobre como compilar e instalar o amaroK.
- Verifique se tem as dependências obrigatórias que o amaroK requer. Se não tem a certeza de ter estas dependências instaladas, o script configure o informará.
- Compile e instale o amaroK com os comandos seguintes:
cd amarok-x.y.z ./configure --prefix=`kde-config --prefix` make su -c "make install"
- Se estiver a compilar uma versão beta, considere usar o seguinte comando em substituição do respectivo anterior:
./configure --enable-debug=full --prefix=`kde-config --prefix`
- Se pretender suporte à base de dados mysql ou postgresql, inclua no comando anterior:
--enable-mysql --enable-postgresql
- NOTA: Para suporte às bases de dados, tem que ter instalado os pacotes de denvolvimento (dev) da respectiva base de dados.
- Para uma lista completa das opções do script configure, execute o seguinte comando:
./configure --help
- pois isto ajuda-nos a resolver os erros de bloqueio. Pode obter detalhes sobre todas as opções de configuração suportadas aqui.
- Fim! Basta escrever amarok para iniciar o amaroK.
Compilar o amaroK SVN
Pedimos-lhe para que compile o amaroK com:
./configure --enable-debug=full --prefix=`kde-config --prefix`
e que não "limpe" os binários resultantes. Isto ajuda-nos imensamente a resolver os erros de bloqueio! Muito obrigado. Informação sobre depuração pode ser encontrada em Debugging HowTo
A partir de Anonymous SVN
Nota: é necessário uma versão do SVN >= 1.1. As instruções seguintes criam uma directoria chamada multimedia e preenchem-na com o código fonte do amaroK. Pode renomear a directoria multimedia depois se assim preferir, mas caso contrário não precisa rearranjar o seu conteúdo (excepto se souber o que está a fazer!):
svn co -N svn://anonsvn.kde.org/home/kde/trunk/extragear/multimedia cd multimedia svn co svn://anonsvn.kde.org/home/kde/branches/KDE/3.5/kde-common/admin svn up amarok
To compile the sources (from the multimedia directory):
make -f Makefile.cvs ./configure --enable-debug=full --prefix=`kde-config --prefix` make
If you get a message to recheckout the module, then follow this procedure
cd .. svn up multimedia cd multimedia make -f Makefile.cvs
And all should be cookies and cream again!
Finally, install it!
su -c "make install"
When using the automake tools, it is important to clean the source tree before re-building. Unstable builds may result otherwise. If you do experience instability from a "dirty compile", try again from a clean source tree. Simply do the following:
make clean
Now start from "svn up amarok".
Erros
- If you get any "svn: 'amarok' is not under version control" or "svn: Working copy 'amarok' not locked" error message, make sure that you have the latest svn version.
- If you have more than one version of automake, you may get: "*** KDE requires automake 1.6.1 or newer", try putting:
AUTOMAKE=automake-1.6 make -f Makefile.cvs
- If you get the following error using Mandriva, make sure you have the libsvn_ra_svn package installed.
svn: Unrecognized URL scheme 'svn://anonsvn.kde.org/home/kde/trunk/extragear/multimedia'
Also, Mandriva LE2005 will error before the build completes because of a bug in their kdelibs package which does not export all of the symbols properly. This is because they backported -fvisibility from GCC 4.0 to their GCC (3.4.3) and used it for KDE. To fix this, you must install the updated kdelibs packages found in the Mandriva update mirrors.
Amarok-svn
Amarok-svn is an easy to use bash script that automates the SVN installation/upgrading process. One advantage is that it downloads and uses unsermake (only downloads if it's not installed already), the faster automake. This is useful because automake sometimes causes Amarok to be unstable if compiled without cleaning the source tree first.
All information (and the script itself) is available here.
kdesvn-build
kdesvn-build is a powerful Perl script designed to build the entire KDE project from Subversion, but can be adapted for Amarok. It downloads and uses unsermake, just like Amarok-svn.
- Download kdesvn-build and extract it with tar -xjvf.
- Edit the top of kdesvn-buildrc-sample to match the settings of your system (instructions are in the file itself and the online docs). Be sure to have the qtdir and kdedir lines set to the output of `dirname $(dirname $(which uic))` and `kde-config --prefix` respectively (if you plan on using your current Qt and KDE installs). For instance, on Gentoo it might be /usr/qt/3 and /usr/kde/3.4 .
- To install just Amarok, in the module section you need only the following:
# If you would like to use the sudo command to install then uncomment the
# make-install-prefix line in each module.
# If you want to use the TagLib library from Subversion you may uncomment the following module.
#module kdesupport
# checkout-only taglib
# make-install-prefix sudo # Use "sudo" to install TagLib
#end module
module extragear/multimedia
checkout-only amarok
#make-install-prefix sudo # Use "sudo" to install Amarok
#uncomment the next line to add ./configure options
#configure-flags --enable-mysql
end module
- Copy kdesvn-buildrc-sample to the ~/.kdesvn-buildrc of the user running the script. Be sure that user has rights to install in the kdedir and qtdir (likely only root, unless you have the sudo program setup, in which case you can use the make-install-prefix option).
- Run kdesvn-build whenever you want to upgrade to the current trunk version of Amarok.
amaroK no Solaris 10
Amarok 1.4.1 has been successfuly compiled and run by at least one loyal Amarok/Solaris x86-64 user.
Install a recent version of Solaris x86, I used Opensolaris B45.
Install the Blastwave package tools, then install the Amarok dependancies:
Kdelibs
- pkg-get -i kdelibs_gcc
Libxine
- pkg-get -i libxine
GCC
You must compile Taglib/Amarok using the Blastwave gcc, as this is the GCC toolchain that KDE was built with. Mixing with the SFW GCC will NOT work.
To build using the Blastwave GCC toolchain, you will need swap any references to the SFW version of GCC (installed in /usr/sfw/bin), with the Blastwave version (/opt/csw/gcc3/bin), in your $PATH.
Check your GCC is the Blastwave version:
- bash-3.00$ which gcc
- /opt/csw/gcc3/bin/gcc
Set make to use the Blastwave gmake
- export MAKE=/opt/csw/bin/gmake
unset your LD_LIBRARY_PATH
- bash-3.00$ unset LD_LIBRARY_PATH
Taglib
Download and extract the latest Taglib
- bash-3.00$ gtar xzf taglib-1.4.tar.gz
- cd taglib-1.4
Use ./configure to configure Taglib with any options you may want. In my case I wanted Taglib installed in /opt/taglib.
- bash-3.00$ ./configure --prefix=/opt/taglib
- checking build system type... i386-pc-solaris2.11
- checking host system type... i386-pc-solaris2.11
- checking target system type... i386-pc-solaris2.11
- .....
- config.status: executing depfiles commands
- Good - your configure finished. Start make now
If you see the above line, Taglib has compiled correctly. Double check that it HAS correctly linked with the Blastwave libraries:
- bash-3.00$ ldd taglib/.libs/libtag.so.1.4.0
- libz.so => /opt/csw/lib/libz.so
- libstdc++.so.6 => /opt/csw/lib/libstdc++.so.6 '''<== must be /opt/csw/lib, not the /usr/sfw/lib version'''
- libm.so.2 => /lib/libm.so.2
- libgcc_s.so.1 => /opt/csw/lib/libgcc_s.so.1 '''<== must be /opt/csw/lib, not the /usr/sfw/lib version'''
- libm.so.1 => /lib/libm.so.1
- libc.so.1 => /lib/libc.so.1
- bash-3.00$ gmake
Install it as root:
- /opt/csw/bin/gmake install
Test that Taglib is working by running taglib-config.
bash-3.00$/opt/taglib/bin/taglib-config --libs
-L/opt/taglib/lib -ltag
amaroK
Download and extract the Amarok-1.4.1 source:
- gtar xjf amarok-1.4.1.tar.bz2
- cd amarok-1.4.1
You will need to specify the QT, KDE, and Taglib paths, as they are not in the standard locations with the Blastwave packages.
Additionally you need to add taglib-config to your $PATH, or you will get an error about Taglib not being installed.
- export PATH=$PATH:/opt/taglib/bin
In my case I used the Libxine sound engine and disabled and XMMS plugin.
- ./configure --with-qt-dir=/opt/csw/kde-gcc --prefix=/opt/csw/kde-gcc --with-extra-includes=/opt/taglib/include --disable-debug --without-xmms
Compile
- bash-3.00$ gmake
Install as root
- gmake install
If you made it this far you should have a working install.
If you are having issues with the amarokapp binary, use ldd to check that it is linked against the correct libraries.
Enjoy Amarok on Solaris x86!
ebuild Gentoo
amarok subversion ebuilds are available to use at your own risk along with KDE split subversion ebuilds at http://genkdesvn.berlios.de
If you don't want to mess with updating the whole of KDE, you might also want to try the latest ebuild found here (not maintained anymore since 27-December-2005). Updated versions can be found here.
Como adicionar ebuilds Específicos
- Create a folder "media-sound/amarok-cvs" in your $PORTDIR_OVERLAY directory and put the ebuild there.
- cd to $PORTDIR_OVERLAY/media-sound/amarok-cvs/ and execute "ebuild amarok-cvs-1.4-r1.ebuild digest" (as root).
- Now (as root) do "echo media-sound/amarok-cvs ~arch" >> /etc/portage/package.keywords" [replace arch with your arch, probably x86]. If /etc/portage/package.keywords does not exist, create it.
- You can now "emerge amarok-cvs" to install the current development version of Amarok.
- If you would like to disable Amarok's Amazon features, do echo "media-sound/amarok-cvs noamazon" >> /etc/portage/package.use, then emerge.
- If you would like to enable debugging for Amarok, try echo "media-sound/amarok-cvs debug" and ensure that nostrip is set in your FEATURES="" (in make.conf)
For clarity and consistency we left the Gentoo conventions to the specialists here:
In addition if you would like to be able to debug Amarok and other packages under Gentoo, please ensure that "nostrip" is in your FEATURES, that "debug" is either in your global USE flags or set for Amarok in package.use and that both gdb and Amarok have been compiled with these settings in place. You can find more information about debugging here.
Klik
If klik is already installed on your computer you can klik Amarok stable.
Que Fazer Quando Surgem Problemas
- Leia o nosso FAQ.
- Verifique o amaroK Forum.
- Use os recursos (canais IRC, forums, listas de email) específicos da sua distribuição Unix ou Linux. Eles podem ser muito mais úteis se usar um pacote disponibilidado por eles ou estiver a tentar configurar um motor audio.
- Visite-nos no canal #amarok no irc.freenode.net
Please visit us in #amarok at irc.freenode.net if you're interested in helping us.