/asmack

A build environment for the XMPP library Smack on android

Primary LanguageJavaOtherNOASSERTION

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 for every release.

Support

Flattr this git repo

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. You can read about the results you will get when using one of the various branches provides in the README.

Apps that use this fork of aSmack

  • GTalkSMS uses many features of Smack and XMPP on Android:

    • File Transfer
    • DNS SRV
    • MUC
    • Entity Caps
    • and many more
  • yaxim

  • your app?

Contribution

If possible, please base patches on smack, not on aSmack. You can use the 'upstream' branch from smack @ github. Only in some cases the 'master' branch should be used.

If your code follows Smack's contributor guidelines, 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)
  • 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.