vanitasvitae/Smack
1
0
Fork 0
mirror of https://github.com/vanitasvitae/Smack.git synced 2024-11-30 07:52:06 +01:00
Code Issues Releases Wiki Activity
No description
3526 commits 61 branches 35 tags 39 MiB
Java 99.8%
Find a file
Paul Schaub 1f731f6318
Rework support for XEP-0384: OMEMO Encryption 
Changes:

    Rework integration tests
    New structure of base integration test classes
    bump dependency on signal-protocol-java from 2.4.0 to 2.6.2
    Introduced CachingOmemoStore implementations
    Use CachingOmemoStore classes in integration tests
    Removed OmemoSession classes (replaced with more logical OmemoRatchet classes)
    Consequently also removed load/storeOmemoSession methods from OmemoStore
    Removed some clutter from KeyUtil classes
    Moved trust decision related code from OmemoStore to TrustCallback
    Require authenticated connection for many functions
    Add async initialization function in OmemoStore
    Refactor omemo test package (/java/org/jivesoftware/smack/omemo -> /java/org/jivesoftware/smackx)
    Remove OmemoStore method isFreshInstallation() as well as defaultDeviceId related stuff
    FileBasedOmemoStore: Add cleaner methods to store/load base data types (Using tryWithResource, only for future releases, once Android API gets bumped)
    Attempt to make OmemoManager thread safe
    new logic for getInstanceFor() deviceId determination
    OmemoManagers encrypt methods now don't throw exceptions when encryption for some devices fails. Instead message gets encrypted when possible and more information about failures gets returned alongside the message itself
    Added OmemoMessage class for that purpose
    Reworked entire OmemoService class
    Use safer logic for creating trust-ignoring messages (like ratchet-update messages)
    Restructure elements/provider in order to prepare for OMEMO namespace bumps
    Remove OmemoManager.regenerate() methods in favor of getInstanceFor(connection, randomDeviceId)
    Removed some unnecessary configuration options
    Prepare for support of more AES message key types
    Simplify session creation
    Where possible, avoid side effects in methods
    Add UntrustedOmemoIdentityException
    Add TrustState enum
    More improved tests
2018-06-13 12:29:16 +02:00
config Enable trailing whitespace checkstyle check 2018-05-09 23:26:39 +02:00
documentation Rework support for XEP-0384: OMEMO Encryption 2018-06-13 12:29:16 +02:00
resources Smack 4.2.4 2018-04-15 14:48:22 +02:00
smack-android Add AndroidSmackInitializer.initialize(Context) 2018-05-06 13:38:22 +02:00
smack-android-extensions Add missing package-info descriptions. 2018-02-21 16:47:11 +01:00
smack-bosh Enable trailing whitespace checkstyle check 2018-05-09 23:26:39 +02:00
smack-compression-jzlib Enable trailing whitespace checkstyle check 2018-05-09 23:26:39 +02:00
smack-core Merge branch '4.3' 2018-06-12 15:49:43 +02:00
smack-debug Enable trailing whitespace checkstyle check 2018-05-09 23:26:39 +02:00
smack-debug-slf4j Change Element.toXml() to toXml(String enclosingNamespace) 2018-04-27 10:05:25 +02:00
smack-experimental Improve MamManager API 2018-06-12 08:53:18 +02:00
smack-extensions Merge remote-tracking branch 'ignite/4.3' into 4.3 2018-06-12 13:41:43 +02:00
smack-im Enable trailing whitespace checkstyle check 2018-05-09 23:26:39 +02:00
smack-integration-test Rework support for XEP-0384: OMEMO Encryption 2018-06-13 12:29:16 +02:00
smack-java7 Enable trailing whitespace checkstyle check 2018-05-09 23:26:39 +02:00
smack-jingle-old Enable trailing whitespace checkstyle check 2018-05-09 23:26:39 +02:00
smack-legacy Enable trailing whitespace checkstyle check 2018-05-09 23:26:39 +02:00
smack-omemo Rework support for XEP-0384: OMEMO Encryption 2018-06-13 12:29:16 +02:00
smack-omemo-signal Rework support for XEP-0384: OMEMO Encryption 2018-06-13 12:29:16 +02:00
smack-omemo-signal-integration-test Add CustomImportOrder checkstyle rule 2017-06-14 17:12:43 +02:00
smack-repl Change Element.toXml() to toXml(String enclosingNamespace) 2018-04-27 10:05:25 +02:00
smack-resolver-dnsjava Bump MiniDNS to 0.3.0 2018-05-05 10:53:52 +02:00
smack-resolver-javax Enable trailing whitespace checkstyle check 2018-05-09 23:26:39 +02:00
smack-resolver-minidns Bump MiniDNS to 0.3.0 2018-05-05 10:53:52 +02:00
smack-sasl-javax Enable trailing whitespace checkstyle check 2018-05-09 23:26:39 +02:00
smack-sasl-provided Enable trailing whitespace checkstyle check 2018-05-09 23:26:39 +02:00
smack-tcp Enable trailing whitespace checkstyle check 2018-05-09 23:26:39 +02:00
.gitignore Add OMEMO support 2017-06-02 13:40:10 +02:00
.travis.yml Add AndroidSmackInitializer.initialize(Context) 2018-05-06 13:38:22 +02:00
build.gradle Rework support for XEP-0384: OMEMO Encryption 2018-06-13 12:29:16 +02:00
LICENSE Add Appendix to LICENSE 2017-04-24 15:12:27 +02:00
README.md README.md: Fix openhub.net link, remove Flattr 2018-05-13 21:21:49 +02:00
repl REPL: Add support to enable a JDWP debug link 2017-10-14 13:38:24 +02:00
settings.gradle Add OMEMO support 2017-06-02 13:40:10 +02:00
version.gradle Smack 4.4.0-alpha1-SNAPSHOT 2018-05-12 19:47:48 +02:00

README.md

Smack

Build Status Coverage Status Project Stats 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 Documentation 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.

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

Donate

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

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