1
0
Fork 0
mirror of https://codeberg.org/Mercury-IM/Smack synced 2024-11-16 12:12:06 +01:00
Smack/README.md

105 lines
6 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
2017-03-10 21:39:01 +01: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
2017-03-10 21:39:01 +01:00
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.
2017-01-03 08:55:14 +01:00
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, …).
2014-02-15 22:36:42 +01:00
More information are 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
-------
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 NOICE 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
---------------------
Smack is a collaborative effort of many open source, professionally and spare-time, paid and unpaid, contributors.
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.
We 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** in order 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
-------
2014-10-19 11:51:53 +02:00
The developers hang around in `#smack` (freenode, IRC) and `open_chat@conference.igniterealtime.org` (XMPP MUC room).
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/
2017-03-10 21:39:01 +01:00
- Nightly Unique Maven Snapshots: https://igniterealtime.org/repo/
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/