aSmack README
=============

Version: $VERSION_TAG
Build date: $BUILD_DATE

Important Notes
===============

Read this, or aSmack won't work for you!

Static Code
-----------

In order to work correctly on Android, you need to register Smack's
XMPP Providers and Extensions manually and init some static code
blocks before you doing any XMPP activty. Calling
SmackAndroid.init(Context) (in org.jivesoftware.smack) will do this
for you.

ConnectionConfiguration
-----------------------

Please use the provided AndroidConnectionConfiguration class if
possible to create a new connection.

Compression
-----------

If you want compressed XMPP streams you have to add
[jzlib-1.0.7](http://www.jcraft.com/jzlib/) to your project. Note that
every version higher then 1.0.7 wont work.
More Info: https://github.com/Flowdalic/smack/issues/12

Problems / Debugging
==============================

aSmack Wiki
-----------

More information about XMPP File Transfers, SSL Certificates and other
stuff related to aSmack can be found in the wiki:
https://github.com/Flowdalic/asmack/wiki

How to debug your problem
-------------------------

We always provide source zips. Attach them to the jar in your favorite
IDE. Enable debugging mode with [BOSH|XMPP]Connection.DEBUG and
config.setDebug. See also:
http://www.igniterealtime.org/builds/smack/docs/latest/documentation/debugging.html

Reporting a bug
---------------

Your issue should contain
1. a logcat
2. a server to reproduce
3. the code you are using (for FOSS project we'll accept reposituroy URLs)

If you record a logcat and make sure to remove your credentials
(usually a base64 block inside <auth></auth>).

There is no guarantee that we will reply immediatly. But we will try
to investigate the problem. Feel free to join ##smack @ freenode and
ask for help (you may have to idle for some time before you get a
reply).

Component Revision Information for this Release
===============================================