Smack/README.md

107 lines
6.3 KiB
Markdown
Raw Normal View History

2014-02-15 22:36:42 +01:00
Smack
=====
[![Build Status](https://github.com/igniterealtime/Smack/workflows/CI/badge.svg)](https://github.com/igniterealtime/Smack/actions?query=workflow%3A%22CI%22) [![Coverage Status](https://coveralls.io/repos/igniterealtime/Smack/badge.svg)](https://coveralls.io/r/igniterealtime/Smack) [![Project Stats](https://www.openhub.net/p/smack/widgets/project_thin_badge.gif)](https://www.openhub.net/p/smack) [![Link to XMPP chat smack@conference.igniterealtime.org](https://inverse.chat/badge.svg?room=smack@conference.igniterealtime.org)](https://inverse.chat/#converse/room?jid=smack@conference.igniterealtime.org)
2014-02-18 10:03:42 +01:00
About
-----
2014-02-15 22:36:42 +01:00
2021-04-15 10:19:05 +02:00
[Smack] is an open-source, highly modular, easy to use, XMPP client library written in Java for Java SE compatible JVMs and Android.
2015-03-13 16:27:50 +01:00
2021-04-15 10:19:05 +02:00
Being 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 allow you to easily exchange data in various ways e.g., fire-and-forget, publish-subscribe, between human and non-human endpoints (M2M, IoT, …).
2014-02-15 22:36:42 +01:00
2021-04-15 10:19:05 +02:00
More information is provided by the [Overview](documentation/overview.md).
2014-02-15 22:36:42 +01:00
2017-03-10 21:39:01 +01:00
Getting started
---------------
2017-09-15 22:28:30 +02:00
Start with having a look at the **[Documentation]** and the **[Javadoc]**.
Instructions on how to use Smack in your Java or Android project are provided in the [Smack Readme and Upgrade Guide](https://igniterealtime.org/projects/smack/readme).
2017-03-10 21:39:01 +01:00
License
-------
2021-03-25 15:00:07 +01:00
Most of Smack is governed by the Apache License 2.0 (SPDX License Identifier: Apache 2.0). This license requires that the contents of a NOTICE text file are shown "…within a display generated by the Derivative Works, if and wherever such third-party notices normally appear.".
Smack comes which such a NOTICE file. Moreover, since `smack-core` is licensed under the Apache License 2.0, the conditions apply to every project using Smack. The content of Smack's NOTICE file can conveniently be retrieved using `Smack.getNoticeStream()`.
Some subprojects of Smack are governed by other licenses. Please refer to the individual subprojects.
2017-10-29 09:11:26 +01:00
Professional Services
---------------------
2021-04-15 10:19:05 +02:00
Smack is a collaborative effort of many people.
Some are paid, e.g., by their employer or a third party, for their contributions.
But many contribute in their spare time for free.
While we try to provide the best possible XMPP library for Android and Java SE-compatible execution environments by following state-of-the-art software engineering practices, the API may not always perfectly fit your requirements.
Hence welcome contributions and encourage discussion about how Smack can be further improved.
We also provide **paid services** ranging from **XMPP/Smack related consulting** to **designing and developing features** to accommodate your needs.
2018-02-16 04:18:27 +01:00
Please contact [Florian Schmaus](mailto:flo@geekplace.eu) for further information.
2017-10-29 09:11:26 +01:00
2014-02-18 10:03:42 +01:00
Bug Reporting
-------------
2018-02-16 04:18:27 +01:00
Only a few users have access for filling bugs in the tracker. New
2014-02-18 10:03:42 +01:00
users should:
2017-01-03 08:55:14 +01:00
1. Read ["How to ask for help or report an issue"](https://github.com/igniterealtime/Smack/wiki/How-to-ask-for-help,-report-an-issue-and-possible-solve-the-problem-yourself)
2018-02-16 04:18:27 +01:00
2. [Create a discourse account](https://discourse.igniterealtime.org/signup) (you can also sign up with your Google account).
3. Login to the forum account
2017-10-29 09:11:26 +01:00
4. Press "New Topic" in your toolbar and choose the 'Smack Support' sub-category.
2014-02-18 10:03:42 +01:00
Please search for your issues in the bug tracker before reporting.
2017-10-29 09:11:26 +01:00
Donate
------
If you find Smack useful and feel like donating, then you can use one of the following systems:
- Donate via Bitcoin: 1LiU78z3498wu3jwRPKbvovKAHjTcpVbuK
2014-02-18 10:03:42 +01:00
Contact
-------
2020-11-09 12:26:51 +01:00
The developers hang around in [smack@conference.igniterealtime.org](xmpp:smack@conference.igniterealtime.org?join). You may use [this link](https://inverse.chat/badge.svg?room=smack@conference.igniterealtime.org) to join the room via [inverse.chat](https://inverse.chat).
2014-09-05 11:58:18 +02:00
Remember that it may take some time (~hours) to get a response.
2014-02-18 10:03:42 +01:00
2017-10-29 09:11:26 +01:00
You can also reach us via the [Smack Support Forum] if you have questions or need support, or the [Smack Developers Forum] if you want to discuss Smack development.
2014-02-18 10:03:42 +01:00
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](https://github.com/igniterealtime/Smack/wiki/Guidelines-for-Smack-Developers-and-Contributors).
The guidelines also contain development quickstart instructions.
2014-02-16 15:22:47 +01:00
Resources
---------
2017-10-29 09:11:26 +01:00
- Current Readme: https://igniterealtime.org/projects/smack/readme
2017-03-10 21:39:01 +01:00
- Bug Tracker: https://issues.igniterealtime.org/browse/SMACK
- JaCoCo Coverage Reports: https://www.igniterealtime.org/builds/smack/dailybuilds/jacoco/html/
- Nightly Javadoc: http://www.igniterealtime.org/builds/smack/dailybuilds/javadoc/
- Nightly Documentation: http://www.igniterealtime.org/builds/smack/dailybuilds/documentation/
- User Forum: https://discourse.igniterealtime.org/c/smack/smack-support
- Dev Forum: https://discourse.igniterealtime.org/c/smack/smack-dev
2014-05-25 11:01:52 +02:00
- 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://www.igniterealtime.org/archiva/repository/maven/
2014-02-16 15:22:47 +01:00
Ignite Realtime
===============
2014-02-15 22:36:42 +01:00
2018-02-16 04:18:27 +01:00
[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 RealTime Collaboration to their businesses and organizations.
2014-02-15 22:36:42 +01:00
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.
[Smack]: https://www.igniterealtime.org/projects/smack/index.jsp
2017-10-29 09:11:26 +01:00
[Ignite Realtime]: https://www.igniterealtime.org
[XMPP (Jabber)]: https://xmpp.org/
[Smack Developers Forum]: https://discourse.igniterealtime.org/c/smack/smack-dev
2017-10-29 09:11:26 +01:00
[Smack Support Forum]: https://discourse.igniterealtime.org/c/smack/smack-support
2017-09-15 22:28:30 +02:00
[Documentation]: https://download.igniterealtime.org/smack/docs/latest/documentation/
[Javadoc]: https://download.igniterealtime.org/smack/docs/latest/javadoc/