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.
Can be found @ http://asmack.freakempire.de/
Make sure to read the README for every release.
-
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)
-
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.
-
GTalkSMS uses many features of Smack and XMPP on Android:
- File Transfer
- DNS SRV
- MUC
- Entity Caps
- and many more
-
your app?
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.
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.
Join ##smack @ freenode
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.