= libpurple on Android =

This is the documentation to compile and use libpurple on Android.

The Android port of libpurple will be created during a Google Summer of Code project.  [[br]]
For more information see the [http://www.google-melange.com/gsoc/proposal/review/google/gsoc2012/michaelz/1 proposal on google melange]


== Compiling ==

There are many things you need to do in order to compile the libraries yourself, so there is an [wiki:GSoC2012/Android/compiling extra page] for it. You should plan about 1 hour for the setup and another one hour to compile.

There is also a tutorial to set up [wiki:GSoC2012/Android/debugging debugging].

== Using ==

If you just want to use libpurple in your application, you do not need to compile everything. Just use the precompiled binaries for ARM. 

There is a [wiki:GSoC2012/Android/new-client tutorial] on how to create an Android client.

At the end of the project I am planning to do a release, but for now just mail me if you want to have binaries. -- Michael

== Compiling for host ==

Even if the project is focused on Android, it is also possible to [wiki:GSoC2012/Android/hostbuild build the Java library on your host].

== List of things to do ==

This is the (incomplete) list of things that are missing in the library and/or in the testclient and need to be implemented. If you want to, you are welcome to help. Some of those things might also be a nice GSoC project.

 Chat::
  Currently, there is only support for IM sessions.
 More protocols::
  Only jabber is tested, other protocols may segfault, not connect, ...
 Status::
  Currently, you are just online.
 Plugin support::
  With the ability to install new protocols with a nice GUI and integreation of a plugin website.
 Account settings::
  Add more settings than the basic account settings, including setting account icons.
 Buddylist editing::
  Make the buddylist editable, regroupable, ...
 File transfers::
  Would be nice to have.
 Media support::
  Who would need that? Typing on a phone is so easy.
 UI::
  The UI is just for testing. Do a better one.
 Fix bugs::
  They are somewhere.

== Contact ==

This project is done by Michael Zangl. You can contract him per mail using michael (at) soc.pidgin.im.