XMPP

Fluxo XMPP

Fluux XMPP é um Chat SDK em Swift para iOS, MacOS e Linux. Implementa o protocolo XMPP , que é um padrão IETF.

Fluux XMPP é uma implementação limpa, com os seguintes objetivos em mente:

• Concentre-se na simplicidade, ocultando detalhes técnicos XMPP e expondo apenas métodos orientados para chat.
• Concentre-se no Swift moderno, na versão iOS recente e XMPP moderno. A biblioteca ignora recursos legados ou obsoletos propositalmente.
• Concentre-se na manutenção. XMPP é um protocolo complexo e a manutenibilidade deve ser o principal critério para a decisão do projeto ser sustentável no longo prazo. Pela mesma razão, também pretendemos limitar ao máximo as dependências.
• Concentre-se na eficiência e na escalabilidade, aproveitando apenas parte do protocolo XMPP que é escalável. Muitos XEPs são muito demorados para serem usados ​​em larga escala na produção.

Como resultado, no iOS, nosso alvo é a versão 12+ do iOS. No MacOS, nos concentramos no Mojave e superior (10.14+). No Linux, usamos BSD Socket com SwiftNIO, então ele deve funcionar de forma bastante ampla, desde que você tenha o Swift 5.0+ instalado.

Nota : Esta biblioteca está em desenvolvimento muito ativo e ainda não está pronta para produção.

Construindo biblioteca Fluux XMPP

Projetamos o sistema de construção com os seguintes princípios:

• O objetivo é ser multiplataforma (iOS, MacOS, Linux), ao mesmo tempo que utiliza os recursos mais recentes do iOS e MacOS.
• Queremos ser flexíveis e fáceis de integrar com todas as principais ferramentas de gerenciamento de dependências (SwiftPM, CocoaPods, Carthage). No entanto, o SwiftPM é nosso alvo principal.

Como tal, construímos a plataforma de forma diferente com base no sistema de destino/construção:

• Com Carthage e Cocoapods e SwiftPM no MacOS, usamos Apple Network.framework e, portanto, visamos iOS 12+ e MacOS 10.14+. Isso significa que para a versão padrão do iOS ou MacOS, não há outras dependências.
  • Com SwiftPM no Linux, usamos Swift-NIO, pois Network.framework está disponível apenas para plataformas Apple.

Esta decisão nos permite manter todo o sistema de construção muito simples, ao mesmo tempo em que temos um bom alcance de plataforma.

Usando o pacote Swift

Instale dependências do homebrew

Você precisa de uma implementação libxml2 e TLS (ou seja, libressl). Você pode instalá-los com HomeBrew:

brew install libxml2
brew install libressl

Adicionando Fluux XMPP como dependência em seu projeto

Você pode construir a biblioteca usando o Swift Package Manager, graças ao arquivo Package.swift fornecido.

Você também precisa definir explicitamente seu destino de compilação para MacOS 10.12, já que, no momento, o Swift PM usa MacOS 10.10 como um valor codificado para o destino de implantação (mais sobre isso aqui).

Para integrar o Fluux XMPP em seu projeto Swift PM, você pode adicioná-lo como uma dependência do seu projeto em seu arquivo Package.swift . Por exemplo:

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 " ] ) ,
    ]
)

Você pode modificar seu executável de linha de comando main.swift para iniciar um cliente XMPP . Por exemplo:

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 )

Para construir o projeto, você pode simplesmente usar o comando build padrão:

swift build

Você pode então executar seu cliente de console:

.build/debug/ XMPP Demo

Os testes podem ser executados com o comando:

swift test

Trabalhando no Linux com Docker

Você pode usar a imagem oficial do Docker para trabalhar no projeto Swift no Linux. Você também pode usar o Docker em MacOs para construir a versão Linux.

Você pode recuperar a imagem do Swift Docker com o seguinte comando:

docker pull swift

Você pode então abrir um shell Linux dentro do contêiner:

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

Você precisará então instalar os pacotes libxml2-dev e libssl-dev dev no contêiner com:

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

No shell do Docker, você pode construir o código com:

 swift build

Para executar o teste no Linux, você precisa habilitar explicitamente a descoberta de teste (consulte Swift Test Discovery):

 swift test --enable-test-discovery

Suporte TLS

No momento, a biblioteca suporta apenas conexão TLS padrão, não STARTTLS. A biblioteca Apple Networking não suporta (ainda?) comutação de criptografia após a conexão ter sido estabelecida, porque eles estão preocupados com possíveis problemas de segurança em torno das implementações de STARTTLS.

Dito isto, XMPP suporta TLS na porta 5223. É chamado de SSL "legado" porque o uso da porta 5223 foi descontinuado pela XMPP Standards Foundation há algum tempo. Dito isto, servidores XMPP modernos, como o ejabberd, suportam TLS de última geração na porta 5223. Para usar o TLS no momento, é perfeitamente adequado usar o TLS na porta 5223.