Kadu
Klient Gadu-Gadu dla Linuxa

Autorzy:
Tomasz "tomee" Jarzynka
Tomasz "chilek" Chiliński
Adrian "adrians" Smarzewski
Dariusz "mast3r" Jagodzik
Roman "Ron_K" Krzystyniak

[ str. główna | screenshot-y | lista zmian | instrukcja | nowości | forum | pobierz ]


Instrukcja obsługi


HOWTO - Czyli jak zainstalować Kadu ze źródeł.

Ten dokument opisuje jak zainstalować program Kadu od wersji 0.3.2 do najnowszych.

Spis treści:

  1. Wstęp
  2. Wymagane pakiety
  3. Jak to zrobić - instalacja
  4. Jak to zrobić - ustawianie zmiennej QTDIR i KDEDIR
  5. Jak to zrobić - wysyłanie sms
  6. Jak to zrobić - patch KaduBis aby obrazków było więcej
  7. Jak to zrobić - Szyfrowanie rozmów

1. Wstęp


W dokumencie tym postaram się wyjaśnić jak zainstalować z pakietu źródłowego program Kadu. System bazowy to dystrybucja Mandrake 9.0. W innych dystrybucjach może to wyglądać podobnie ale nie koniecznie. Dotyczy on wersji 0.3.2 i nowszych. Starsze wersje nie będą omawiane.


2. Wymagane pakiety:


  • Glibc 2.2.5-16mdk
  • Glibc-devel 2.2.5-16mdk
  • glibc_lsb 2.2.90-11mdk
  • kdelibs 3.0.3-30mdk
  • kdelibs-devel 3.0.3-30mdk
  • kdebase 3.0.3-30mdk
  • kdebase-devel 3.0.3-30mdk
  • libarts-devel 1.0.3-7mdk
  • freetype2 2.0.9-3mdk
  • freetype2-devel 2.0.9-3mdk
  • libgcc1 3.3-1mdk
  • XFree86-libs 4.2.1-3mdk
  • XFree86-devel 4.2.1-3mdk
  • libjpeg62 6b-25mdk
  • libjpeg62-devel 6b-25mdk
  • liblcms1 1.09-1mdk
  • libmng1 1.0.3-2mdk
  • libpng3 1.2.4-3mdk
  • libpng3-devel 1.2.4-3mdk
  • libqt3 3.0.5-7mdk
  • libqt3-devel 3.0.5-7mdk
  • libstdc++5 3.2-1mdk
  • libstdc++5-devel 3.2-1mdk
  • zlib1 1.1.4-3mdk
  • zlib1-devel 1.1.4-3mdk

Większość z tych pakietów na pewno będzie już zainstalowane w twoim systemie. Niektóre będą wymagały spełnienia innych zależności. Jednak że chciałbym uczulić na obecność w systemie pakietów developerskich czyli pakietów z bibliotekami nagłówkowymi. Częste pytania typu: "./configure nie znajduje Qt lub KDE" to brak nie wspomnianych programów ale właśnie bibliotek nagłówkowych. Więcej szczegółów znajdziesz w rozdziale poniżej.

Z powrotem na górę dokumentu

3. Jak To Zrobić - instalacja


Postępuj zgodnie z instrukcją podaną poniżej.

  1. Pierwszym krokiem będzie rozpakowanie źródeł. Oczywiście można to zrobić poleceniem:
    	 gunzip kadu-nr_wersji.tar.gz
    	 tar -xf kadu-nr_wersji.tar
    ale można oczywiście prościej np.: w Midnight Commander lub w X-ach ark-iem. Wybór należy do użytkownika.
  2. Logujemy się w systemie z uprawnieniami administratora poleceniem:
    	 su
  3. W powstałym katalogu wydajemy polecenia:
    	./configure
    	make
    	make install
    lub korzystamy ze skryptu "Instaluj" lub jego angielskiej wersji "setup", który w większości przypadków jest najlepszym rozwiązaniem. Dla RedHata 8 i Auroxa 8, przygotowałem specjalna wersję skryptu "Instaluj" o nazwie Instaluj-RH8. Napisany jest w unikodzie z uwzglednieniem struktury katalogów RedHat 8.
  4. Kadu wersja 0.3.3-pre1 domyślnie zainstalowana w usr/local/. Instalacja przebiega pomyślnie, natomiast próba startu powoduje wyrzucenie błędu: nieznaleziono libgadu.so2
    Lekarstwo: zrobić link symboliczny do libgadu.so.2, które zainstalowało się w /usr/local/lib/, w katalogu /usr/lib w następujący sposób:
     	ln -s /usr/local/lib/libgadu.so2 /usr/lib/
  5. Pomocnym rozwiązaniem jest też wydanie polecenia:
    	 ./configure --help |less
     
    i przeczytanie wszystkich możliwych opcji konfiguracyjnych.
  6. A to nie które z nich:
    * instalacja do wybranego przez siebie katalogu
    	 ./configure --prefix=/twoj_podany_katalog
    * możliwość wyłączenia instalacji dokumentacji wraz z Kadu
    	 ./configure --disable-doc
    * symbole dla debugera nie są wkompilowywane aby je włączyć
    	 ./configure --enable-debug
    * możliwość wyłączenia kompilacji libgadu i zlinkowania z już istniejącą w systemie instalacją
    	 ./configure --with-existing-libgadu
    * wkompilowywana informacja o typie dystrybucji, np. źródła, paczka dla określonego systemu itp.
    	 ./configure --enable-dist-info=DIST
    *eksperymentalne szyfrowanie wiadomości w ssl
    	 ./configure --with-openssl

Z powrotem na górę dokumentu

4. Jak To Zrobić - ustawianie zmiennej QTDIR i KDEDIR


OD WESJI KADU 0.3.3 rc1 ZMIENNA KDEDIR JEST POTRZEBNA TYLKO DO INSTALACJI POD KDE. SAMO KADU JUZ KDE NIE WYMAGA

Często zdażają się problemy ze zmienną QTDIR i KDEDIR (zwłaszcza w RedHat lub Mandrake) co skutkuje nieznalezieniem albo biblioteki Qt albo KDE lub nie przekopiowaniu przy instalacji wszystkich plików. Dotyczy to w szczególności polskich locali, co skutkuje brakiem polskiej wersji językowej. Zakładam ze masz zainstalowane zarówno QT3.0.x jak i odpowiednie pakiety(lub całość) KDE3.0.X

Oto przykładowe rozwiązanie tego problemu. Jako root w /etc/profile dopisać na końcu pliku:

##################################################################
# QT
##################################################################

QTDIR=/usr/local/qt
PATH=$QTDIR/bin:$PATH
MANPATH=$QTDIR/doc/man:$MANPATH
LD_LIBRARY_PATH=$QTDIR/lib:$LD_LIBRARY_PATH
export QTDIR PATH MANPATH LD_LIBRARY_PATH

##################################################################
# KDE OD WERSJI 0.3.3-rc1 nie wymagane dla instalacji innej niż do KDE
##################################################################

KDEDIR=/usr/local/kde
PATH=$KDEDIR/bin:$PATH
export KDEDIR PATH

Oczywiście takie katalogi muszą istnieć jeżeli są gdzie indziej ścieżka musi prowadzić do nich

Jeżeli już mamy zainstalowane Kadu i nie ma polskiej wersji to doraźnie można zrobić to przekopiowując ze źródeł plik kadu/po/pl/kadu.mo do katalogu z localami, np. w Mandrake 9.0 jest to /usr/share/locale/pl/LC_MESSAGES/kadu.mo

Z powrotem na górę dokumentu

5. Jak to zrobić - wysyłanie sms


Program Kadu ma możliwość wysyłania sms-ów. W tym celu należy skompilować program sms, który się znajduje w paczce ze źródłami. Aby tego dokonać w katalogu sms wydajemy dwa polecenia:

  1. make, i jeżeli wszystko przebiegnie pomyślnie tzn. nie będzie błędów,
  2. make install.

W większości przypadków to działa jednakże program ten nie jest tworzony przez zespół Kadu i nie bierzemy odpowiedzialności za jego kompilacje. W razie problemów w katalogu sms znajduje się szczątkowa dokumentacja autora.

Jeżeli wszystko przebiegło bez błędów należy tylko w oknie konfiguracyjnym Kadu podać ścieżkę dostępu do tego programu a wiec:

U mnie (a jest to domyślna ścieżka przy instalacji) ta ścieżka wygląda tak: /usr/local/bin/sms

Oczywiście ten program musi się tam znajdować jeżeli masz go zainstalowany gdzie indziej ścieżka musi prowadzić do niego

Do wersji 0.3.3-pre5 program ten kompiluje się wraz z programem Kadu i otrzymuje nazwę kadusms, ścieżka dostępu ustawia się samoczynnie istnieje jednak możliwość wyboru innego programu. Wtedy musimy podać do niego ścieżkę dostępu.

Domyślnie program jako adresata wpisuje nazwę użytkownika w formie: użytkownik@localhost.localdomain

Aby to zmienić w katalogu domowym tworzymy plik o nazwie: .smsrc w treści którego wpisujemy: mailaddr=moja_nazwa Od tej pory sms będzie podpisany tak jak tego sobie życzysz.

Od wersji 0.3.3-rc1 program do wysyłania sms jest już autorstwa Kadu Team i jest integralną częścią programu Kadu. Nie wymaga odrębnej kompilacji

Z powrotem na górę dokumentu

6. Jak to zrobić - patch KaduBis aby obrazków było więcej


Na wersję 0.3.2 został utworzony patch, dzięki któremu można mieć w Kadu więcej obrazków zwanych emotikonami. Można go pobrać stąd: http://kadu.net/kadubis.tar.gz

Aby się nim posłużyć należy pobrany plik rozpakować do katalogu ze źródłami Kadu, tak aby drzewo wyglądało następująco:

../Źródła_Kadu
	/kadu
	/kadubis
	kadu-gg3d_emotions.path

Plik kadu-gg3d_emotions.path jest wewnątrz katalogu kadubis. Należy go więc przenieść oczko wyżej aby wszystko się zgadzało z powyższym schematem

Użyć programu patch w następujący sposób:

# patch -p0 < kadu-gg3d_emotions.patch

  1. powinny pokazać się trzy linijki z informacją o pomyślnym patchowaniu plików
  2. następnie zbudować normalnie Kadu
  3. katalog images wraz z zawartością kopiujemy do katalogu (domyślny dla standardowej instalacji):

/usr/local/kde/share/apps/kadu/images

Po poprawnej instalacji pozostaje jeszcze tylko w okienku konfiguracyjnym podać ścieżkę do katalogu images, zrestartować Kadu i powinno działać

Od wersji 0.3.3 KaduBis jest już dostępny jako thems domyślny i nie jest potrzebny restart Kadu

!!! Patch KaduBis można nakładać tylko na wersję 0.3.2 !!!

Na stronie Kadu.net jest do pobrania thems kompatybilny z Gadu-Gadu 5.0. Wystarczy go rozpakować do katalogu z emotikonami

Z powrotem na górę dokumentu

7. Jak to zrobić - Szyfrowanie rozmów


Od wersji 0.3.3-pre3 jest dostępna opcja eksperymentalnego szyfrowania rozmów w ssl. Aby móc go używać musimy wykonać nastepujące czynności:

  • Kadu kompilujesz z opcja --with-openssl,
  • generujesz sobie klucz publiczny (w oknie konfiguracyjnym), Tylko długość1024 jest obsługiwana przez protokół, jeżeli jeszcze masz możliwość (która bedzie w najblizszym czasie zablokowana) kożystaj tylko z niej,
  • w menu kontekstowym w oknie listy kontaktów, dla konkretnego kontaktu z listy wybieramy opcje Wyślij mój klucz publiczny (taka z klodka). Twój klucz zostanie wysłany adresatowi.
  • jeśli masz czyjś klucz publiczny, to w oknie chat możesz manipulować klawiszem z kłódką. Jeśli jest zamknieta to wysyłasz wiadomość zaszyfrowaną,
  • teoretycznie szyfrowanie ssl jest kompatybilne z szyfrowaniem z PowerGG z pod Windows.

Z powrotem na górę dokumentu