= 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 (incompleate) list of things that are missing in the library and in the testclient and need to be implemented. You are welcome to help, if you want to.

 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, functions and other neat stuff.
 Account settings::
  Add more settings than the basic account settings, including setting account icons.
 Buddylist editing::
  Make the buddylist editable, regroupable, ...
 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.