Rocket.Chat.Electron

Rocket.Chat تطبيق سطح المكتب

تطبيق سطح المكتب لـ Rocket.Chat متاح لـ MacOs و Windows و Linux باستخدام الإلكترون.

---

التعامل معنا

شارك قصتك

نود أن نسمع عن تجربتك وربما عرضها على مدونتنا.

اشترك للحصول على التحديثات

مرة واحدة في الشهر ، يطلق فريق التسويق لدينا تحديثًا عبر البريد الإلكتروني مع الأخبار حول إصدارات المنتجات والمواضيع والأحداث والحالات ذات الصلة بالشركة. اشتراك!

---

تحميل

يمكنك تنزيل أحدث إصدار من صفحة الإصدارات.

ثَبَّتَ

قم بتشغيل المثبت واتبع الإرشادات المتمثلة في التثبيت.

خيارات Windows

على Windows ، يمكنك تشغيل تثبيت صامت عن طريق إضافة علامة /S . يمكنك أيضًا إضافة الخيارات أدناه:

• /S - تثبيت صامت
• /allusers - تثبيت لجميع المستخدمين (يتطلب المسؤول)
• /currentuser - قم بتثبيت المستخدم الحالي فقط (افتراضي)
• /disableAutoUpdates - تعطيل التحديثات التلقائية

تطوير

بداية سريعة

المتطلبات الأساسية:

• غيت
• node.js
• عقدة GYP
• ينصح الغزل بدلا من NPM.

الآن فقط استنساخ وابدأ التطبيق:

git clone https://github.com/RocketChat/Rocket.Chat.Electron.git
cd Rocket.Chat.Electron
yarn
yarn start

هيكل المشروع

يقع المصدر في مجلد src . سيتم بناء كل شيء في هذا المجلد تلقائيًا عند تشغيل التطبيق مع yarn start .

تقوم عملية الإنشاء بتجميع جميع الأشياء من مجلد src وتضعها في مجلد app ، لذلك بعد انتهاء الإنشاء ، يحتوي مجلد app الخاص بك على التطبيق الكامل القابل للتشغيل.

TypeScript

باتباع التغييرات المستمرة في Rocket.Chat Codebase ، تمت إعادة كتابة التطبيق في TypeScript 4 لمعالجة المشكلات المتعلقة بالقدرة على الصيانة.

خط أنابيب البناء

تأسست عملية البناء على Bundler Rollup. هناك ثلاثة ملفات دخول للرمز الخاص بك:

• src/main.ts ، البرنامج النصي الذي يعمل في عملية الإلكترون الرئيسية ، وتنظيم التطبيق بأكمله ؛

• src/rootWindow.ts ، البرنامج النصي الذي يجعل واجهة المستخدم الخاصة بنافذة الجذر ، النافذة الرئيسية للتطبيق ؛

• و src/preload.ts ، الذي يعمل في وضع متميز لتوصيل التطبيق و WebViews Rendering Rocket.Chat على الويب.

إضافة وحدات Node.js

تذكر أن تحترم الانقسام بين dependencies و devDependencies في ملف package.json . سيتم تضمين الوحدات النمطية المدرجة فقط في dependencies في تطبيق قابل للتوزيع.

استكشاف الأخطاء وإصلاحها

عقدة GYP

اتبع تعليمات التثبيت على Node-GYP README.

أوبونتو

ستحتاج إلى تثبيت الحزم التالية:

build-essential
libevas-dev
libxss-dev

فيدورا

ستحتاج إلى تثبيت الحزم التالية:

libX11
libXScrnSaver-devel
gcc-c++

Windows 7

في Windows 7 ، قد تضطر إلى اتباع الخيار 2 من دليل تثبيت Node-GYP وتثبيت Visual Studio.

الاختبار

اختبارات الوحدة

yarn test

نستخدم إطار اختبار Jest مع عداء الإلكترون Jest. يبحث عن جميع الملفات في دليل src الذي يتطابق مع نمط GLOB *.(spec|test).{js,ts,tsx} .

إصدار

لحزم تطبيقك في أمر استخدام التثبيت:

yarn release

ستبدأ عملية التغليف لنظام التشغيل الذي تقوم بتشغيله على هذا الأمر. سيتم إخراج ملف التوزيع إلى dist Directory.

يتم التعامل مع جميع إجراءات التغليف من قبل بناء الإلكترون. لديها الكثير من خيارات التخصيص.

الخوادم الافتراضية

سيحدد ملف servers.json الخوادم التي سيتصل بها العميل وستلول قائمة الخادم في الشريط الجانبي. يحتوي على قائمة من الخوادم الافتراضية التي سيتم إضافتها في المرة الأولى التي يقوم فيها المستخدم إلى تشغيل التطبيق (أو عند إزالة جميع الخوادم من القائمة). بناء جملة الملف كما يلي:

{
  "Demo Rocket Chat" : " https://demo.rocket.chat " ,
  "Open Rocket Chat" : " https://open.rocket.chat "
}

تكوين ما قبل الإصدار

يمكنك تجميع servers.json package.json إذا تم العثور على الملف ، فسيتم تخطي شاشة "الاتصال بالخادم" الأولي وسيحاول الاتصال بالخادم الأول في الصفيف الذي تم تعريفه وإسقاط المستخدم مباشرة على شاشة تسجيل الدخول. لاحظ أنه سيتم فحص servers.json فقط إذا لم تتم إضافة أي خوادم أخرى بالفعل ، حتى لو قمت بإلغاء تثبيت التطبيق دون إزالة التفضيلات القديمة ، فلن يتم تشغيله مرة أخرى.

تكوين ما بعد التثبيت

إذا لم تتمكن (أو لا ترغب في ذلك) في حزمة الملف داخل التطبيق ، فيمكنك إنشاء servers.json . يجب أن يكون الملف موجودًا في %APPDATA%/Rocket.Chat/ Volder أو مجلد التثبيت في حالة تثبيت جميع المستخدمين (Windows فقط).

بالنسبة لنظام التشغيل Windows ، فإن المسارات الكاملة هي:

• ~Users<username>AppDataRoamingRocket.Chat
• ~Program FilesRocket.ChatResources

على MacOS ، المسار الكامل هو:

• ~/Users/<username>/Library/Application Support/Rocket.Chat/
• /Library/Preferences/Rocket.Chat/

على Linux ، المسارات الكاملة هي:

• /home/<username>/.config/Rocket.Chat/
• /opt/Rocket.Chat/resources/

الإعدادات المتجاوز

يمكنك تجاوز إعدادات المستخدم عن طريق إنشاء overridden-settings.json في مجلد تفضيلات المستخدم. يجب أن يكون الملف موجودًا في %APPDATA%/Rocket.Chat/ Volder أو مجلد التثبيت في حالة تثبيت جميع المستخدمين (Windows فقط).

سيقوم كل إعداد على الملف بتجاوز إعدادات المستخدم الافتراضية والإعداد. ثم يمكنك استخدامه لتعطيل الميزات الافتراضية مثل التحديث التلقائي وحتى إنشاء وضع خادم واحد.

الإعدادات التي يمكن تجاوزها هي:

جلسة	وصف
"isReportEnabled": true,	مجموعات إذا تم الإبلاغ عن الأخطاء للمطورين.
"isInternalVideoChatWindowEnabled": true,	سيتم فتح مكالمات الفيديو في نافذة داخلية.
"isFlashFrameEnabled": true,	مجموعات إذا تم تمكين إطار الفلاش.
"isMinimizeOnCloseEnabled": false,	مجموعات إذا كان سيتم تقليل التطبيق على قرب.
"doCheckForUpdatesOnStartup": true,	مجموعات إذا كان التطبيق سيتحقق من التحديثات على بدء التشغيل.
"isMenuBarEnabled": true,	مجموعات إذا تم تمكين شريط القائمة.
"isTrayIconEnabled": true,	يمكّن أيقونة الدرج ، وسيتم إخفاء التطبيق على الدرج على قرب. تجاوزات "isMinimizeOnCloseEnabled"
"isUpdatingEnabled": true,	مجموعات إذا كان يمكن للمستخدم تحديث التطبيق.
"isAddNewServersEnabled": true,	مجموعات إذا تمكن المستخدم من إضافة خوادم جديدة.

وضع خادم واحد

إذا كان الإعداد "isAddNewServersEnabled": false ، فلن يتمكن المستخدم من إضافة خوادم جديدة. سيتم تعطيل الأزرار والاختصارات. ثم سيتعين عليك إضافة الخادم إلى ملف servers.json . مع هذا ، يمكنك إنشاء وضع خادم واحد أو لا تدع المستخدم يضيف خوادم جديدة بمفرده.

مثال التكوين

ملف overridden-settings.json :

 {
   "isTrayIconEnabled": false,
   "isMinimizeOnCloseEnabled": false
}

عندما يتم تمكين isTrayIconEnabled ، سيتم إخفاء التطبيق على قرب. عندما يتم تمكين isMinimizeOnCloseEnabled ، سيتم تقليل التطبيق على قرب. عندما يتم تعطيل كلاهما ، سيتوقف التطبيق على إغلاق.

رخصة

صدر تحت رخصة معهد ماساتشوستس للتكنولوجيا.