esl/Smack

A highly modular and portable open source XMPP client library written in Java for JVMs and Android http://www.igniterealtime.org/projects/smack/

Download

Step 1. Add the JitPack repository to your build file

Add it in your root settings.gradle at the end of repositories:

	dependencyResolutionManagement {
		repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS)
		repositories {
			mavenCentral()
			maven { url 'https://jitpack.io' }
		}
	}

Add it in your settings.gradle.kts at the end of repositories:

	dependencyResolutionManagement {
		repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS)
		repositories {
			mavenCentral()
			maven { url = uri("https://jitpack.io") }
		}
	}

Add to pom.xml

	<repositories>
		<repository>
		    <id>jitpack.io</id>
		    <url>https://jitpack.io</url>
		</repository>
	</repositories>

Add it in your build.sbt at the end of resolvers:

 
    resolvers += "jitpack" at "https://jitpack.io"

Add it in your project.clj at the end of repositories:

 
    :repositories [["jitpack" "https://jitpack.io"]]

Step 2. Add the dependency

	dependencies {
		implementation 'com.github.esl:Smack:'
	}
	dependencies {
		implementation("com.github.esl:Smack:")
	}
	<dependency>
	    <groupId>com.github.esl</groupId>
	    <artifactId>Smack</artifactId>
	    <version></version>
	</dependency>

                            
    libraryDependencies += "com.github.esl" % "Smack" % ""
        
        

                            
    :dependencies [[com.github.esl/Smack ""]]

Readme

Smack

Build Status Coverage Status Project Stats Flattr this git repo Visit our IRC channel

About

Smack is an open source, highly modular, easy to use, XMPP client library written in Java for Java SE compatible JVMs and Android.

A pure Java library, it can be embedded into your applications to create anything from a full XMPP instant messaging client to simple XMPP integrations such as sending notification messages and presence-enabling devices. Smack and XMPP allows you to easily exchange data, in various ways e.g. fire-and-forget, publish-subscribe, between human and non-human endpoints (M2M, IoT, …).

More information are provided by the Overview.

Getting started

Start with having a look at the Docmentation and the Javadoc.

Instructions how to use Smack in your Java or Android project are provided in the Smack 4.2 Readme and Upgrade Guide.

Bug Reporting

Only a few users have access for for filling bugs in the tracker. New users should:

  1. Read "How to ask for help or report an issue"
  2. Create a forums account (only e-mail is a requirement, you can skip all the other fields).
  3. Login to the forum account
  4. Press New in your toolbar and choose Discussion
  5. Choose the Smack Developers Forum of Smack and add the tag 'bug_report' to your new post

Please search for your issues in the bug tracker before reporting.

Contact

The developers hang around in #smack (freenode, IRC) and open_chat@conference.igniterealtime.org (XMPP MUC room). Remember that it may take some time (~hours) to get a response.

You can also reach us via the Smack Users Forum if you have questions or need support, or the Smack Developers Forum if you want to discuss Smack development.

Contributing

If you want to start developing for Smack and eventually contribute code back, then please have a look at the Guidelines for Smack Developers and Contributors. The guidelines also contain development quickstart instructions.

Resources

  • Bug Tracker: https://issues.igniterealtime.org/browse/SMACK
  • JaCoCo Coverage Reports: https://www.igniterealtime.org/builds/smack/dailybuilds/jacoco/html/
  • Nightly Builds: http://www.igniterealtime.org/downloads/nightly_smack.jsp
  • Nightly Javadoc: http://www.igniterealtime.org/builds/smack/dailybuilds/javadoc/
  • Nightly Documentation: http://www.igniterealtime.org/builds/smack/dailybuilds/documentation/
  • User Forum: https://community.igniterealtime.org/community/support/smack-support
  • Dev Forum: http://community.igniterealtime.org/community/developers/smack
  • Maven Releases: https://oss.sonatype.org/content/repositories/releases/org/igniterealtime/smack/
  • Maven Snapshots: https://oss.sonatype.org/content/repositories/snapshots/org/igniterealtime/smack/
  • Nightly Unique Maven Snapshots: https://igniterealtime.org/repo/

Donate

If you find Smack useful and feel like donating, then you can use one of the following systems:

Ignite Realtime

Ignite Realtime is an Open Source community composed of end-users and developers around the world who are interested in applying innovative, open-standards-based Real Time Collaboration to their businesses and organizations. We're aimed at disrupting proprietary, non-open standards-based systems and invite you to participate in what's already one of the biggest and most active Open Source communities.

Smack - an Ignite Realtime community project.