KTp/Packaging Guide: Difference between revisions

From KDE Community Wiki
< KTp
m (→‎Upstream Packages: url to point where 0.9.0 can be found)
No edit summary
Line 22: Line 22:
! Name !! Description !! Dependencies
! Name !! Description !! Dependencies
|-
|-
| [https://projects.kde.org/projects/playground/network/telepathy/telepathy-accounts-kcm telepathy-kde-accounts-kcm] || Account management KCM || telepathy-qt4, data from telepathy-kde-contact-list (at runtime)
| [https://projects.kde.org/projects/extragear/network/telepathy/ktp-accounts-kcm ktp-accounts-kcm] || Account management KCM || telepathy-qt, data from ktp-contact-list (at runtime)
|-
|-
| [https://projects.kde.org/projects/playground/network/telepathy/telepathy-approver telepathy-kde-approver] || KDED module that shows a notification when somebody starts a chat with you || telepathy-qt4, data from telepathy-kde-contact-list (at runtime)
| [https://projects.kde.org/projects/extragear/network/telepathy/ktp-approver ktp-approver] || KDED module that shows a notification when somebody starts a chat with you || telepathy-qt, data from ktp-contact-list (at runtime)
|-
|-
| [https://projects.kde.org/projects/playground/network/telepathy/telepathy-chat-handler telepathy-kde-text-ui] || Text chat application || telepathy-qt4, data from telepathy-kde-contact-list (at runtime)
| [https://projects.kde.org/projects/extragear/network/telepathy/ktp-text-ui ktp-text-ui] || Text chat application || telepathy-qt, data from ktp-contact-list (at runtime)
|-
|-
| [https://projects.kde.org/projects/playground/network/telepathy/telepathy-contact-list telepathy-kde-contact-list] || Contact list application - Also provides icons and other data files that are shared among the other applications || telepathy-qt4
| [https://projects.kde.org/projects/extragear/network/telepathy/ktp-contact-list ktp-contact-list] || Contact list application - Also provides icons and other data files that are shared among the other applications || telepathy-qt
|-
|-
| [https://projects.kde.org/projects/playground/network/telepathy/telepathy-kded-module telepathy-kde-integration-module] || Workspace integration module - provides several plugins like auto-away, the infamous 'Now listening to...' and also an '''error handler''' (important!!) || telepathy-qt4
| [https://projects.kde.org/projects/extragear/network/telepathy/ktp-kded-module ktp-integration-module] || Workspace integration module - provides several plugins like auto-away, the infamous 'Now listening to...' and also an '''error handler''' (important!!) || telepathy-qt
|-
|-
| [https://projects.kde.org/projects/playground/network/telepathy/telepathy-presence-dataengine telepathy-kde-presence-dataengine] || Plasma dataengine that provides telepathy data to plasmoids || telepathy-qt4
| [https://projects.kde.org/projects/extragear/network/telepathy/ktp-presence-applet ktp-presence-applet] || Plasma widget for setting your online presence - acts as the central system tray icon of traditional IM clients || telepathy-kde-presence-dataengine (at runtime), data from telepathy-kde-contact-list (at runtime)
|-
|-
| [https://projects.kde.org/projects/playground/network/telepathy/telepathy-presence-applet telepathy-kde-presence-applet] || Plasma widget for setting your online presence - acts as the central system tray icon of traditional IM clients || telepathy-kde-presence-dataengine (at runtime), data from telepathy-kde-contact-list (at runtime)
| [https://projects.kde.org/projects/extragear/network/telepathy/ktp-filetransfer-handler ktp-filetransfer-handler] || Background application for handling file tranfers || telepathy-qt
|-
|-
| [https://projects.kde.org/projects/playground/network/telepathy/telepathy-filetransfer-handler telepathy-kde-filetransfer-handler] || Background application for handling file tranfers || telepathy-qt4
| [https://projects.kde.org/projects/extragear/network/telepathy/ktp-auth-handler ktp-auth-handler] || Background application for handling passwords and ssl certificates || telepathy-qt
|-
|-
| [https://projects.kde.org/projects/playground/network/telepathy/telepathy-auth-handler telepathy-kde-auth-handler] || Background application for handling passwords and ssl certificates || telepathy-qt4
| [https://projects.kde.org/projects/extragear/network/telepathy/ktp-send-file ktp-send-file] || Dolphin/konqueror context menu plugin for sending files easily to contacts || telepathy-qt, ktp-filetransfer-handler (at runtime), data from ktp-contact-list (at runtime)
|-
|-
| [https://projects.kde.org/projects/playground/network/telepathy/telepathy-send-file telepathy-kde-send-file] || Dolphin/konqueror context menu plugin for sending files easily to contacts || telepathy-qt4, telepathy-kde-filetransfer-handler (at runtime), data from telepathy-kde-contact-list (at runtime)
| [https://projects.kde.org/projects/extragear/network/telepathy/ktp-contact-applet ktp-contact-applet] || Plasma applet for displaying contacts || telepathy-qt
|-
| [https://projects.kde.org/projects/playground/network/telepathy/telepathy-contact-applet telepathy-kde-contact-applet] || Plasma applet for displaying contacts || telepathy-qt4
|-
|-
|}
|}




'''Required components for basic functionality:''' telepathy-kde-accounts-kcm, telepathy-kde-contact-list, telepathy-kde-text-ui, telepathy-auth-handler, telepathy-kde-integration-module
'''Required components for basic functionality:''' ktp-accounts-kcm, ktp-contact-list, ktp-text-ui, telepathy-auth-handler, ktp-integration-module


'''Highly recommended components (should be installed by default):''' telepathy-kde-approver, telepathy-kde-presence-applet, telepathy-kde-presence-dataengine, telepathy-kde-filetransfer-handler
'''Highly recommended components (should be installed by default):''' ktp-approver, ktp-presence-applet, ktp-presence-dataengine, ktp-filetransfer-handler


'''Optional components:''' telepathy-kde-send-file, telepathy-kde-contact-applet
'''Optional components:''' ktp-send-file, ktp-contact-applet


===Experimental Components===
===Experimental Components===

Revision as of 23:44, 24 January 2012

Packaging KDE-Telepathy is complicated for two reasons: firstly, due to the modular nature of Telepathy, there are several distinct components in separate git repositories. Secondly, there are large numbers of runtime interdependencies to worry about. This page attempts to ease packaging KDE-Telepathy in a useful way by explaining these issues.

Upstream Packages

Two upstream packages are essential for KDE-Telepathy to work.

We're also using some bits from kdelibs 4.7.0 (Build and Runtime Dependency).

The IM networks that KDE-Telepathy can connect to are decided by which Telepathy Connection Managers are installed. These are runtime only dependencies, but which ones are installed will decide what IM networks KDE-Telepathy supports. The following are the ones we recommend - whether they are installed optionally or required is, of course, up to you.

  • telepathy-gabble 0.13.7 (for Jabber support, including Google Talk and Facebook, might very probably crash with earlier versions)
  • telepathy-haze (for all the other protocols, as supported by libpurple).

KDE-Telepathy Packages

The different components of KDE-Telepathy are housed in separate git repositories on projects.kde.org. Some of these components are currently recommended to use. Others are not yet ready to be installed by users.

Ready Components

These components have reached a level of maturity where they are interesting to users. We recommend providing these components at the current time.

Name Description Dependencies
ktp-accounts-kcm Account management KCM telepathy-qt, data from ktp-contact-list (at runtime)
ktp-approver KDED module that shows a notification when somebody starts a chat with you telepathy-qt, data from ktp-contact-list (at runtime)
ktp-text-ui Text chat application telepathy-qt, data from ktp-contact-list (at runtime)
ktp-contact-list Contact list application - Also provides icons and other data files that are shared among the other applications telepathy-qt
ktp-integration-module Workspace integration module - provides several plugins like auto-away, the infamous 'Now listening to...' and also an error handler (important!!) telepathy-qt
ktp-presence-applet Plasma widget for setting your online presence - acts as the central system tray icon of traditional IM clients telepathy-kde-presence-dataengine (at runtime), data from telepathy-kde-contact-list (at runtime)
ktp-filetransfer-handler Background application for handling file tranfers telepathy-qt
ktp-auth-handler Background application for handling passwords and ssl certificates telepathy-qt
ktp-send-file Dolphin/konqueror context menu plugin for sending files easily to contacts telepathy-qt, ktp-filetransfer-handler (at runtime), data from ktp-contact-list (at runtime)
ktp-contact-applet Plasma applet for displaying contacts telepathy-qt


Required components for basic functionality: ktp-accounts-kcm, ktp-contact-list, ktp-text-ui, telepathy-auth-handler, ktp-integration-module

Highly recommended components (should be installed by default): ktp-approver, ktp-presence-applet, ktp-presence-dataengine, ktp-filetransfer-handler

Optional components: ktp-send-file, ktp-contact-applet

Experimental Components

We have several other components under development, however, unless they are listed above we do not recommend packaging them. This is because they are subject to major changes/removal at any time, and are not ready for end users yet.

Note about accounts-kcm-plugins

Our 0.1.0 release had an extra package called telepathy-kde-accounts-kcm-plugins. These plugins have now been merged to the main telepathy-kde-accounts-kcm package and are no longer shipped separately.

Release Tarballs

The latest release is the 0.2.0 alpha release.

Tarballs can be found at the KDE ftp mirrors: http://download.kde.org/download.php?url=unstable/telepathy-kde/0.2.0/src/

Distributions

Here is a list of known packaging efforst for various distributions. If you are also doing packages for a distribution, add your information here.

Distro Packager Links
Debian George Kiagiadakis <[email protected]> http://anonscm.debian.org/gitweb/ (pkg-kde/kde-extras/telepathy-kde/* repos)
Ubuntu Michał Zając <[email protected]> Source: same as debian

Binaries: https://launchpad.net/~telepathy-kde/+archive/ppa (stable)
Binaries: https://launchpad.net/~telepathy-kde/+archive/daily-builds (latest)

openSUSE Christophe Giboudeaux (krop on irc #opensuse-kde) http://download.opensuse.org/repositories/KDE:/Unstable:/Playground/
Arch Linux Andrea Scarpino (bash) <[email protected]>

https://www.archlinux.org/groups/x86_64/telepathy-kde/

Gentoo KDE Herd <[email protected]>

http://git.overlays.gentoo.org/gitweb/?p=proj/kde.git

Chakra Anke Boersma (abveritas) <[email protected]>

http://www.chakra-project.org/packages/index.php?act=search&searchpattern=telepathy

FreeBSD Alberto Villa (avilla) <[email protected]>

http://area51.pcbsd.org/trunk/area51/PORTS/net-im (repository)
http://FreeBSD.kde.org/area51.php (instructions)