XMPP

Флюкс XMPP

Fluux XMPP — это Chat SDK на Swift для iOS, MacOS и Linux. Он реализует протокол XMPP , который является стандартом IETF.

Fluux XMPP — это реализация с чистого листа, преследующая следующие цели:

• Сосредоточьтесь на простоте, скрывая технические детали XMPP и предоставляя только методы, ориентированные на чат.
• Сосредоточьтесь на современном Swift, последней версии iOS и современном XMPP . Библиотека намеренно игнорирует устаревшие или устаревшие функции.
• Ориентируйтесь на ремонтопригодность. XMPP — это сложный протокол, и удобство обслуживания должно быть основным критерием принятия проектного решения, чтобы обеспечить устойчивость в долгосрочной перспективе. По той же причине мы также стремимся максимально ограничить зависимости.
• Сосредоточьтесь на эффективности и масштабируемости, используя только масштабируемую часть протокола XMPP . Многие XEP слишком энергозатратны, чтобы их можно было использовать в больших масштабах в производстве.

В результате на iOS мы ориентируемся на версию iOS 12+. В MacOS мы ориентируемся на Mojave и выше (10.14+). В Linux мы используем BSD Socket со SwiftNIO, поэтому он должен работать достаточно широко, если у вас установлен Swift 5.0+.

Примечание . Эта библиотека находится в стадии очень активной разработки и еще не готова к выпуску.

Создание библиотеки Fluux XMPP

Мы проектируем систему сборки, руководствуясь следующими принципами:

• Цель — стать мультиплатформенным (iOS, MacOS, Linux), используя при этом новейшие функции iOS и MacOS.
• Мы хотим быть гибкими и легко интегрируемыми со всеми основными инструментами управления зависимостями (SwiftPM, CocoaPods, Carthage). Однако SwiftPM является нашей основной целью.

Таким образом, мы строим платформу по-разному в зависимости от целевой системы/системы сборки:

• В Carthage, Cocoapods и SwiftPM на MacOS мы используем Apple Network.framework и, таким образом, ориентируемся на iOS 12+ и MacOS 10.14+. Это означает, что для стандартной сборки iOS или MacOS других зависимостей нет.
  • В SwiftPM в Linux мы используем Swift-NIO, поскольку Network.framework доступен только для платформ Apple.

Это решение позволяет нам сохранить всю систему сборки очень простой, сохраняя при этом хороший охват платформы.

Использование пакета Swift

Установите доморощенные зависимости

Вам нужна libxml2 и реализация TLS (т. е. libressl). Вы можете установить их с помощью HomeBrew:

brew install libxml2
brew install libressl

Добавление Fluux XMPP в качестве зависимости в ваш проект

Вы можете собрать библиотеку с помощью Swift Package Manager благодаря предоставленному файлу Package.swift .

Вам также необходимо правильно указать в качестве цели сборки MacOS 10.12, так как на данный момент Swift PM использует MacOS 10.10 в качестве жестко закодированного значения для цели развертывания (подробнее об этом здесь).

Чтобы интегрировать Fluux XMPP в ваш проект Swift PM, вы можете добавить его как зависимость вашего проекта в файл Package.swift . Например:

XMPPDemo", dependencies: [ // Dependencies declare other packages that this package depends on. .package(url: "https://github.com/FluuxIO/XMPP.git", from: "0.0.2"), ], targets: [ .target( name: " XMPP Demo", dependencies: [" XMPP "]), .testTarget( name: " XMPP DemoTests", dependencies: [" XMPP Demo"]), ] )">

// swift-tools-version:5.0

import PackageDescription

let package = Package (
    name : " XMPP Demo " ,
    dependencies : [
        // Dependencies declare other packages that this package depends on.
        . package ( url : " https://github.com/FluuxIO/XMPP.git " , from : " 0.0.2 " ) ,
    ] ,
    targets : [
        . target (
            name : " XMPP Demo " ,
            dependencies : [ " XMPP " ] ) ,
        . testTarget (
            name : " XMPP DemoTests " ,
            dependencies : [ " XMPP Demo " ] ) ,
    ]
)

Вы можете изменить исполняемый файл main.swift запускаемый из командной строки, для запуска клиента XMPP . Например:

XMPP guard let jid = JID("mremond@localhost/ XMPP Demo") else { print("Invalid JID"); exit(1) } var XMPP Config = Config(jid: jid, password: "mypass", useTLS: true) XMPP Config.allowInsecure = true XMPP Config.host = "MacBook-Pro-de-Mickael.local" XMPP Config.streamObserver = DefaultStreamObserver() let client = XMPP (config: XMPP Config) let semaphore = DispatchSemaphore(value: 0) client.connect { print("Disconnected !") semaphore.signal() } _ = semaphore.wait(timeout: DispatchTime.distantFuture)">

import Foundation
import XMPP


guard let jid = JID ( " mremond@localhost/ XMPP Demo " ) else { print ( " Invalid JID " ) ; exit ( 1 ) }
var XMPP Config = Config ( jid : jid , password : " mypass " , useTLS : true )
XMPP Config . allowInsecure = true
XMPP Config . host = " MacBook-Pro-de-Mickael.local "
XMPP Config . streamObserver = DefaultStreamObserver ( )

let client = XMPP ( config : XMPP Config )

let semaphore = DispatchSemaphore ( value : 0 )
client . connect {
  print ( " Disconnected ! " )
  semaphore . signal ( ) 
}

_ = semaphore . wait ( timeout : DispatchTime . distantFuture )

Для сборки проекта вы можете просто использовать стандартную команду сборки:

swift build

Затем вы можете запустить консольный клиент:

.build/debug/ XMPP Demo

Тесты можно запустить командой:

swift test

Работаем в Linux с Docker

Вы можете использовать официальный образ Docker для работы над проектом Swift в Linux. Вы также можете использовать Docker на MacOs для сборки версии Linux.

Вы можете получить образ Swift Docker с помощью следующей команды:

docker pull swift

Затем вы можете создать открытую оболочку Linux внутри контейнера:

docker run  -itv $( pwd ) :/code --name swiftcode -w /code swift /bin/bash

Затем вам нужно будет установить пакеты libxml2-dev и libssl-dev в контейнер с помощью:

apt-get update
apt-get install libxml2-dev libssl-dev

Из оболочки Docker вы можете собрать код с помощью:

 swift build

Чтобы запустить тест в Linux, вам необходимо явно включить обнаружение тестов (см. Swift Test Discovery):

 swift test --enable-test-discovery

Поддержка TLS

На данный момент библиотека поддерживает только стандартное соединение TLS, а не STARTTLS. Сетевая библиотека Apple не поддерживает (пока?) коммутационное шифрование после установления соединения, поскольку их беспокоят возможные проблемы безопасности, связанные с реализациями STARTTLS.

Тем не менее, XMPP поддерживает TLS на порту 5223. Он называется «устаревшим» SSL, поскольку использование порта 5223 некоторое время назад было признано устаревшим Фондом стандартов XMPP . Тем не менее, современные серверы XMPP , такие как ejabberd, поддерживают современный TLS на порту 5223. Чтобы использовать TLS в данный момент, вполне можно использовать TLS на порту 5223.