الصفحة الرئيسية>المتعلقة بالبرمجة>كود الذكاء الاصطناعي
تنزيل

فلوكس XMPP

Fluux XMPP عبارة عن Chat SDK في Swift لأنظمة iOS وMacOS وLinux. وهو يطبق بروتوكول XMPP ، وهو أحد معايير IETF.

يعد Fluux XMPP تطبيقًا نظيفًا، مع وضع الأهداف التالية في الاعتبار:

  • ركز على البساطة، من خلال إخفاء التفاصيل الفنية XMPP وكشف الأساليب الموجهة للدردشة فقط.
  • ركز على Swift الحديث وإصدار iOS الحديث و XMPP الحديث. تتجاهل المكتبة الميزات القديمة أو المهملة عن قصد.
  • التركيز على قابلية الصيانة. يعد XMPP بروتوكولًا معقدًا ويجب أن تكون قابلية الصيانة هي المعيار الرئيسي لقرار التصميم حتى يكون مستدامًا على المدى الطويل. لنفس السبب، نهدف أيضًا إلى الحد من التبعيات قدر الإمكان.
  • التركيز على الكفاءة وقابلية التوسع، والاستفادة فقط من جزء من بروتوكول XMPP القابل للتطوير. العديد من XEPs تستهلك الكثير من الوقت بحيث لا يمكن استخدامها على نطاق واسع في الإنتاج.

ونتيجة لذلك، نستهدف على نظام التشغيل iOS الإصدار 12+. في نظام التشغيل MacOS، نركز على Mojave والإصدارات الأحدث (10.14+). في نظام التشغيل Linux، نستخدم مقبس BSD مع 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.

يسمح لنا هذا القرار بالحفاظ على نظام البناء بأكمله بسيطًا للغاية، مع الوصول إلى منصة جيدة.

باستخدام حزمة سويفت

تثبيت تبعيات البيرة المنزلية

أنت بحاجة إلى libxml2 وتنفيذ TLS (أي libressl). يمكنك تثبيتها باستخدام HomeBrew: 

brew install libxml2
brew install libressl

إضافة Fluux XMPP باعتباره تبعية في مشروعك

يمكنك إنشاء lib باستخدام 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

يمكنك بعد ذلك تشغيل عميل وحدة التحكم الخاصة بك:

XMPPDemo">
.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 dev في الحاوية التي تحتوي على: 

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

من Docker Shell، يمكنك إنشاء التعليمات البرمجية باستخدام: 

 swift build

لتشغيل الاختبار على Linux، تحتاج إلى تمكين اكتشاف الاختبار بشكل صريح (راجع Swift Test Discovery): 

 swift test --enable-test-discovery

دعم TLS

في الوقت الحالي تدعم المكتبة فقط اتصال TLS القياسي، وليس STARTTLS. لا تدعم مكتبة Apple Networking (حتى الآن؟) تبديل التشفير بعد إنشاء الاتصال، لأنها قلقة بشأن مشكلات الأمان المحتملة حول تطبيقات STARTTLS.

ومع ذلك، يدعم XMPP TLS على المنفذ 5223. ويطلق عليه SSL "القديم" لأن استخدام المنفذ 5223 تم إهماله من قبل مؤسسة معايير XMPP منذ فترة. ومع ذلك، فإن خوادم XMPP الحديثة مثل ejabberd تدعم أحدث تقنيات TLS على المنفذ 5223. لاستخدام TLS في الوقت الحالي، من الجيد تمامًا استخدام TLS على المنفذ 5223.

يوسع
معلومات إضافية
تطبيقات ذات صلة
نوصي لك
أخبار ذات صلة الكل