1
0
Fork 0
mirror of https://github.com/vanitasvitae/Smack.git synced 2024-12-24 19:47:58 +01:00
No description
Find a file
Florian Schmaus 1e5d34eacf Bump to Gradle 8.10.2, require Java 11
Bump Gradle from 6.8.3 to 8.10.2 and increase the minimum required
Java version from 8 to 11 (SMACK-953).

The switch from Java 8 to 11 caused some Bytecode portability issues
regarding NIO Buffers. Java changed with version 9 the return type of
some subclasses of Buffer to return the specific Buffer type instead
of the Buffer superclass [JDK-4774077]. For example, ByteBuffer.filp()
previously returned Buffer, while it does return ByteBuffer now.

This sensible change was not reflected by the Android API [1], which
means that AnimalSniffer rightfully started to complain that there is
no method "ByteBuffer ByteBuffer.flip()" in Android, there is only
"Buffer ByteBuffer.flip()", and those are incompatible methods on
Java's Bytecode layer.

As workaround, this changes

    return charBuffer.flip().toString();

to

    ((java.nio.Buffer) charBuffer).flip();
    return charBuffer.toString();

to restore the Bytecode portability between Android and Java.

Errorprone also got new checks, of which JavaUtilDate and JdkObsolete
are wroth mentioning.

JavaUtilData basically strongly recommends to use Java's newer time
API over java.util.Date. But since Smack was Java 8 until now,
j.u.Date is widely used.

Similar JdkObsolete mentions obsolete JDK APIs, like data structures
like Vector and Stack. But mostly LinkedList, which should usually be
replaced by ArrayList. And this is what this commit largely does.

JDK-4774077: https://bugs.openjdk.org/browse/JDK-4774077
1: https://issuetracker.google.com/issues/369219141
2024-09-25 12:08:50 +02:00
.github Bump to Gradle 8.10.2, require Java 11 2024-09-25 12:08:50 +02:00
.idea Add icon to IntelliJ metadata 2023-10-05 10:31:41 +02:00
build-logic Bump to Gradle 8.10.2, require Java 11 2024-09-25 12:08:50 +02:00
config Add smack-examples 2023-11-28 10:46:16 +01:00
gradle/wrapper Bump to Gradle 8.10.2, require Java 11 2024-09-25 12:08:50 +02:00
resources Bump to Gradle 8.10.2, require Java 11 2024-09-25 12:08:50 +02:00
smack-android Bump to Gradle 8.10.2, require Java 11 2024-09-25 12:08:50 +02:00
smack-android-extensions Bump to Gradle 8.10.2, require Java 11 2024-09-25 12:08:50 +02:00
smack-bosh Bump to Gradle 8.10.2, require Java 11 2024-09-25 12:08:50 +02:00
smack-core Bump to Gradle 8.10.2, require Java 11 2024-09-25 12:08:50 +02:00
smack-debug Bump to Gradle 8.10.2, require Java 11 2024-09-25 12:08:50 +02:00
smack-debug-slf4j Bump to Gradle 8.10.2, require Java 11 2024-09-25 12:08:50 +02:00
smack-examples Bump to Gradle 8.10.2, require Java 11 2024-09-25 12:08:50 +02:00
smack-experimental Bump to Gradle 8.10.2, require Java 11 2024-09-25 12:08:50 +02:00
smack-extensions Bump to Gradle 8.10.2, require Java 11 2024-09-25 12:08:50 +02:00
smack-im Bump to Gradle 8.10.2, require Java 11 2024-09-25 12:08:50 +02:00
smack-integration-test Bump to Gradle 8.10.2, require Java 11 2024-09-25 12:08:50 +02:00
smack-java8 Bump to Gradle 8.10.2, require Java 11 2024-09-25 12:08:50 +02:00
smack-java8-full Bump to Gradle 8.10.2, require Java 11 2024-09-25 12:08:50 +02:00
smack-jingle-old Bump to Gradle 8.10.2, require Java 11 2024-09-25 12:08:50 +02:00
smack-legacy Bump to Gradle 8.10.2, require Java 11 2024-09-25 12:08:50 +02:00
smack-omemo Bump to Gradle 8.10.2, require Java 11 2024-09-25 12:08:50 +02:00
smack-omemo-signal Bump to Gradle 8.10.2, require Java 11 2024-09-25 12:08:50 +02:00
smack-omemo-signal-integration-test Bump to Gradle 8.10.2, require Java 11 2024-09-25 12:08:50 +02:00
smack-openpgp Bump to Gradle 8.10.2, require Java 11 2024-09-25 12:08:50 +02:00
smack-repl Bump to Gradle 8.10.2, require Java 11 2024-09-25 12:08:50 +02:00
smack-resolver-dnsjava Bump to Gradle 8.10.2, require Java 11 2024-09-25 12:08:50 +02:00
smack-resolver-javax Bump to Gradle 8.10.2, require Java 11 2024-09-25 12:08:50 +02:00
smack-resolver-minidns Bump to Gradle 8.10.2, require Java 11 2024-09-25 12:08:50 +02:00
smack-resolver-minidns-dox Bump to Gradle 8.10.2, require Java 11 2024-09-25 12:08:50 +02:00
smack-sasl-javax Bump to Gradle 8.10.2, require Java 11 2024-09-25 12:08:50 +02:00
smack-sasl-provided Bump to Gradle 8.10.2, require Java 11 2024-09-25 12:08:50 +02:00
smack-streammanagement Bump to Gradle 8.10.2, require Java 11 2024-09-25 12:08:50 +02:00
smack-tcp Bump to Gradle 8.10.2, require Java 11 2024-09-25 12:08:50 +02:00
smack-websocket Bump to Gradle 8.10.2, require Java 11 2024-09-25 12:08:50 +02:00
smack-websocket-java11 Bump to Gradle 8.10.2, require Java 11 2024-09-25 12:08:50 +02:00
smack-websocket-okhttp Bump to Gradle 8.10.2, require Java 11 2024-09-25 12:08:50 +02:00
smack-xmlparser Bump to Gradle 8.10.2, require Java 11 2024-09-25 12:08:50 +02:00
smack-xmlparser-stax Bump to Gradle 8.10.2, require Java 11 2024-09-25 12:08:50 +02:00
smack-xmlparser-xpp3 Bump to Gradle 8.10.2, require Java 11 2024-09-25 12:08:50 +02:00
.gitignore Add icon to IntelliJ metadata 2023-10-05 10:31:41 +02:00
.mailmap Add .mailmap 2020-11-05 12:52:17 +01:00
build.gradle Bump to Gradle 8.10.2, require Java 11 2024-09-25 12:08:50 +02:00
CHANGELOG.md Smack 4.4.8 2024-04-02 18:28:10 +02:00
DEVELOPING.md Migrate markdown documentation to javadoc 2023-02-03 09:50:35 +01:00
gradlew Bump to Gradle 8.10.2, require Java 11 2024-09-25 12:08:50 +02:00
gradlew.bat Bump to Gradle 8.10.2, require Java 11 2024-09-25 12:08:50 +02:00
LICENSE Add Appendix to LICENSE 2017-04-24 15:12:27 +02:00
Makefile Bump to Gradle 8.10.2, require Java 11 2024-09-25 12:08:50 +02:00
NOTICE Update NOTICE file 2021-10-25 17:00:14 +02:00
README.md [README] Fix MUC badge 2022-09-02 16:48:57 +02:00
repl Bump to Gradle 8.10.2, require Java 11 2024-09-25 12:08:50 +02:00
settings.gradle Bump to Gradle 8.10.2, require Java 11 2024-09-25 12:08:50 +02:00
version Smack 4.5.0-beta3-SNAPSHOT 2024-09-15 20:00:57 +02:00

Smack

Build Status Coverage Status Project Stats Link to XMPP chat smack@conference.igniterealtime.org

About

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

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, …).

More information is provided by the Overview.

Getting started

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.

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 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.

Professional Services

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. Please contact Florian Schmaus for further information.

Bug Reporting

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

  1. Read "How to ask for help or report an issue"
  2. Create a discourse account (you can also sign up with your Google account).
  3. Login to the forum account
  4. Press "New Topic" in your toolbar and choose the 'Smack Support' sub-category.

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

Contact

The developers hang around in smack@conference.igniterealtime.org. You may use this link to join the room via inverse.chat. Remember that it may take some time (~hours) to get a response.

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.

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

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 RealTime 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.