aSmack - buildsystem for Smack on Android
=========================================

*This repository doesn't contain much code, it's a build environment!*

Tracking trunk can be hard. Doing massive changes on top of trunk can
be near impossible. We are mixing 6 open source projects to provide a
working xmpp library for Android. All trunk-based.

This repository contains a source fetching, patching and building
script.  As well as all the minor changes to make an Android version
fly.  See the patches/ folder for a detailed list of changes and
scripts.

Compiled JARs
=============

Can be found @ http://asmack.freakempire.de/ 

Make sure to [*read the
README*](https://github.com/Flowdalic/asmack/blob/master/README.asmack)
for every release.

Support
=======
[![Flattr this git repo](http://api.flattr.com/button/flattr-badge-large.png)](https://flattr.com/submit/auto?user_id=Flowdalic&url=https://github.com/flowdalic/asmack&title=asmack&language=&tags=github&category=software)

Compiling aSmack
================

1. copy local.properties.example to local.properties and set the
Android SDK path (e.g. sdk-location=/opt/android-sdk-update-manager/
on a gentoo system)

2. Run build.bash

aSmack uses a [special fork of
smack](https://github.com/Flowdalic/smack). You can read about the
results you will get when using one of the various branches provides
in the
[README](https://github.com/Flowdalic/smack/blob/master/README.markdown).

Apps that use this fork of aSmack
=================================
- [GTalkSMS](http://code.google.com/p/gtalksms/) uses many features of Smack and XMPP on Android:
    - File Transfer
    - DNS SRV
    - MUC
    - Entity Caps
    - and many more 

- [yaxim](https://github.com/ge0rg/yaxim)
- your app?

Contribution
============

If possible, please base patches on smack, not on aSmack. You can use
the 'upstream' branch from [smack @
github](https://github.com/Flowdalic/smack). Only in some cases the
'master' branch should be used.

If your code follows [Smack's contributor guidelines](
http://community.igniterealtime.org/docs/DOC-1984), is good documented
and comes with some testcases, then it's possible to commit it
upstream. Simply join ##smack @ freenode and ask for a code review.

Contributors
============

We do not keep a seperate CONTRIBUTORS file, and we discourage @author
tags.  However you're free to add your full name to every git commit,
and we will preserver this. Let us know if you've helped on
non-technical stuff and we'll find a way to give you the deserved
credit.

Contact
=======

Join ##smack @ freenode

Licences / Used libraries
=========================

We only accept Apache and BSD-like licences.
We are currently using code from

 * Apache Harmony (sasl/xml) (Apache Licence)
 * smack (xmpp) (Apache Licence)
 * novell-openldap-jldap (sasl) ([OpenLDAP Licence][1])
 * Apache qpid (sasl) (Apache Licence)
 * jbosh (BOSH) (Apache Licence)
 * dnsjava (dns srv lookups) (BSD)
 * custom code (various glue stuff) (WTFPL | BSD | Apache)

This should work for just about every project. Contact us if you have
problems with the licence.

  [1]: http://www.openldap.org/devel/cvsweb.cgi/~checkout~/LICENSE?rev=1.23.2.1&hideattic=1&sortbydate=0  "OpenLDAP Licence"