wire webapp

سلك™

يعد هذا المستودع جزءًا من الكود المصدري لـ Wire. يمكنك العثور على مزيد من المعلومات على wire.com أو عن طريق الاتصال بـ [email protected].

يمكنك العثور على كود المصدر المنشور على github.com/wireapp/wire.

للحصول على معلومات الترخيص، راجع ملف الترخيص المرفق وقائمة تراخيص الجهات الخارجية على wire.com/legal/licenses/.

إذا قمت بتجميع البرامج مفتوحة المصدر التي نوفرها من وقت لآخر لتطوير تطبيق الهاتف المحمول أو سطح المكتب أو الويب الخاص بك، وتسببت في اتصال هذا التطبيق بخوادمنا لأي غرض، فإننا نشير إلى هذا التطبيق الناتج باسم "مفتوح المصدر" برنامج". تخضع جميع التطبيقات مفتوحة المصدر، ولا يجوز استخدامها و/أو تسويقها إلا وفقًا لشروط الاستخدام المطبقة على تطبيق Wire، والتي يمكن العثور عليها على https://wire.com/legal/#terms. بالإضافة إلى ذلك، إذا اخترت إنشاء تطبيق مفتوح المصدر، فسيتم تطبيق قيود معينة، على النحو التالي:

أ. أنت توافق على عدم تغيير طريقة اتصال التطبيق مفتوح المصدر وتفاعله مع خوادمنا؛ ب. أنت توافق على عدم إضعاف أي من ميزات الأمان الخاصة بالتطبيق مفتوح المصدر؛ ج. أنت توافق على عدم استخدام خوادمنا لتخزين البيانات لأغراض أخرى غير الوظيفة المقصودة والأصلية للتطبيق مفتوح المصدر؛ د. أنت تقر بأنك المسؤول الوحيد عن أي وجميع التحديثات لتطبيقك مفتوح المصدر.

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

لا يتم منح أي ترخيص للعلامة التجارية Wire والشعارات المرتبطة بها، والتي ستظل جميعها مملوكة حصريًا لشركة Wire Swiss GmbH. يُحظر صراحةً أي استخدام للعلامة التجارية Wire و/أو الشعارات المرتبطة بها دون الحصول على موافقة كتابية صريحة مسبقة من Wire Swiss GmbH.

كيفية بناء العميل مفتوح المصدر

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

1. قم بتثبيت Node.js
2. تثبيت الغزل

1. جلب التبعيات والتكوينات

1. تشغيل yarn

   • سيؤدي هذا إلى تثبيت جميع التبعيات وإحضار التكوين للتطبيق.

2. البناء والتشغيل

تطوير

1. أعد تسمية .env.localhost إلى .env لتكوين التطبيق. يمكن لهذا التكوين تجاوز/توسيع التكوين من الخطوة السابقة.
2. أضف الإدخالات التالية إلى ملف المضيفين الخاص بك (macOS / Linux: /etc/hosts ، Windows 10: %WINDIR%system32driversetchosts ):
   • 127.0.0.1 local.wire.com (للاتصال بالواجهة الخلفية للإنتاج)
   • 127.0.0.1 local.zinfra.io (للاتصال بالواجهة الخلفية)
3. قم بتشغيل yarn start وسيكون تطبيق الويب الخاص بـ Wire متاحًا على: https://local.zinfra.io:8081/auth/

قم بتثبيت الشهادة الموقعة ذاتيًا

إذا كنت تريد أن يثق متصفحك بالشهادة من "local.wire.com" أو "local.zinfra.io":

1. تحميل مكسيرت
2. قم بتعيين متغير بيئة CAROOT على <WebApp Dir>/server/certificate
3. قم بتشغيل mkcert -install

إنتاج

1. تشغيل yarn build:prod
2. تشغيل cd server && yarn start:prod

اختبار

لتشغيل مجموعة الاختبار الكاملة (فحص الأنواع + الفحص + اختبارات الخادم + اختبارات التطبيقات)، ما عليك سوى تشغيل:

yarn test

وبدلاً من ذلك، يمكنك اختبار أجزاء معينة من التطبيق:

yarn test:(server|types|app)

حالة سي آي

ترجمات

يتم الاستعانة بمصادر خارجية لجميع ترجمات Wire عبر Crowdin.

إضافة سلاسل جديدة

معلومات:

• لتنزيل الترجمات، نستخدم Crowdin API v1، وتحتاج إلى إعداد اسم المستخدم الخاص بك وapi_key (مفتاح واجهة برمجة تطبيقات الحساب).
• لتحميل الترجمات، نستخدم Crowdin CLI v3، وستحتاج إلى إعداد project_identifier وapi_token (رمز الوصول الشخصي).

يثبت:

قم بإنشاء keys/crowdin.yaml في هذا المستودع وأضف الإدخالات التالية:

 api_key : your-account-api-key
api_token : your-personal-access-token
project_identifier : wire-webapp
username : your-username

الاستخدام:

1. إضافة متغير السلسلة إلى "i18n/en-US.json"
2. إنشاء العلاقات العامة ودمجها بعد الموافقة عليها. عندما يتم دمج العلاقات العامة، سيتولى CI لدينا تحميل النصوص الإنجليزية إلى Crowdin.

إذا تعطل مسار CI الخاص بنا، فلا يزال لديك خيار تحميل سلاسل جديدة يدويًا. في هذه الحالة قم بما يلي:

1. قم بتثبيت Crowdin CLI v3
2. تأكد من وجود keys/crowdin.yaml في مكانها
3. تشغيل yarn translate:upload

بمجرد تحميل الترجمات على Crowdin، يمكن لمترجمينا (والخارجيين) ترجمة النصوص الجديدة على Crowdin. يوجد برنامج نصي سيتم تشغيله لإنشاء علاقات عامة مع تحديثات الترجمة. وكبديل، يمكن تنزيل الترجمات بالطريقة التالية:

1. تحقق من ظهور السلسلة الخاصة بك في مشروع Crowdin: wire-webapp
2. إضافة الترجمة على Crowdin
3. الموافقة على الترجمة على Crowdin
4. تشغيل yarn translate:download

المساهمة

المساهمات هي موضع ترحيب! لا تتردد في مراجعة صفحة القضايا لدينا.

ستساعدك الالتزامات التالية على البدء بسرعة باستخدام قاعدة التعليمات البرمجية الخاصة بنا:

• إظهار مشروط / المنبثقة
• إعداد المزامنة بين عبر الخلفية