يعد هذا المستودع جزءًا من الكود المصدري لـ Wire. يمكنك العثور على مزيد من المعلومات على wire.com أو عن طريق الاتصال بـ [email protected].
يمكنك العثور على كود المصدر المنشور على github.com/wireapp/wire، وملف APK لأحدث إصدار على https://wire.com/en/download/.
للحصول على معلومات الترخيص، راجع ملف الترخيص المرفق وقائمة تراخيص الجهات الخارجية على wire.com/legal/licenses/.
إذا قمت بتجميع البرامج مفتوحة المصدر التي نوفرها من وقت لآخر لتطوير تطبيق الهاتف المحمول أو سطح المكتب أو الويب الخاص بك، وتسببت في اتصال هذا التطبيق بخوادمنا لأي غرض، فإننا نشير إلى هذا التطبيق الناتج باسم "مفتوح المصدر" برنامج". تخضع جميع التطبيقات مفتوحة المصدر، ولا يجوز استخدامها و/أو تسويقها إلا وفقًا لشروط الاستخدام المطبقة على تطبيق Wire، والتي يمكن العثور عليها على https://wire.com/legal/#terms. بالإضافة إلى ذلك، إذا اخترت إنشاء تطبيق مفتوح المصدر، فسيتم تطبيق قيود معينة، على النحو التالي:
أ. أنت توافق على عدم تغيير طريقة اتصال التطبيق مفتوح المصدر وتفاعله مع خوادمنا؛ ب. أنت توافق على عدم إضعاف أي من ميزات الأمان الخاصة بالتطبيق مفتوح المصدر؛ ج. أنت توافق على عدم استخدام خوادمنا لتخزين البيانات لأغراض أخرى غير الوظيفة المقصودة والأصلية للتطبيق مفتوح المصدر؛ د. أنت تقر بأنك المسؤول الوحيد عن أي وجميع التحديثات لتطبيقك مفتوح المصدر.
للتوضيح، إذا قمت بتجميع البرامج مفتوحة المصدر التي نوفرها من وقت لآخر لتطوير تطبيق الهاتف المحمول أو سطح المكتب أو الويب الخاص بك، ولم تتسبب في اتصال هذا التطبيق بخوادمنا لأي غرض، فلن يتم استخدام هذا التطبيق يعتبر تطبيقًا مفتوح المصدر ولن ينطبق ما سبق على هذا التطبيق.
لا يتم منح أي ترخيص للعلامة التجارية Wire والشعارات المرتبطة بها، والتي ستظل جميعها مملوكة حصريًا لشركة Wire Swiss GmbH. يُحظر صراحة أي استخدام للعلامة التجارية Wire و/أو الشعارات المرتبطة بها دون الحصول على موافقة كتابية صريحة مسبقة من Wire Swiss GmbH.
يحتوي المشروع الموجود في هذا المستودع على مشروع عميل Wire for Android. يمكنك بناء المشروع بنفسك. ومع ذلك، هناك بعض الاختلافات مع عميل Wire الثنائي المتوفر على متجر Play. هذه الاختلافات هي:
من أجل إنشاء Wire لنظام Android محليًا، من الضروري تثبيت الأدوات التالية:
هذه هي مهام gradle
المتاحة عبر سطر الأوامر:
./gradlew compileApp
: يجمع عميل Wire Android./gradlew assembleApp
: يقوم بتجميع عميل Wire Android./gradlew runApp
: يقوم بتجميع وتشغيل Wire Android Client في الجهاز المتصل../gradlew runUnitTests
: تشغيل جميع اختبارات الوحدة../gradlew runAcceptanceTests
: يقوم بتشغيل جميع اختبارات القبول في الجهاز المتصل../gradlew testCoverage
: يُنشئ تقريرًا لتغطية كود الاختبار./gradlew staticCodeAnalysis
: يقوم بتشغيل تحليل التعليمات البرمجية الثابتة على قاعدة بيانات Wire Android قم باستيراد المشروع كمشروع مهد من خلال تصفح المسار الجذري لملف build.gradle.kts
الخاص بدليل مشروعك.
ربما بعد استنساخ مشروع Android، تظهر بعض مشكلات البناء على IDE الخاص بك (IntelliJ أو Android studio). لتجنب معظم هذه الأمور، تأكد من:
git submodule update --init --recursive
(لبدء أي تكوين مطلوب داخل مشروع وحدة Kalium الفرعية المضمن)local.properties
و kalium/local.properties
الخاصة بك والتي تشير إلى مجلد Android SDK. في نظام التشغيل Mac، يمكن عادةً العثور على هذا المجلد ضمن sdk.dir=/Users/YOUR_USER_FOLDER/Library/Android/sdk
. لن يقوم IDE بإنشاء kalium/local.properties
تلقائيًا، لذا قد ترغب في نسخ/لصق الملف الموجود في جذر المشروعkalium
الفرعية عن طريق تشغيل: git submodule update --remote --merge
لدينا عدد قليل من نكهات التطبيقات المختلفة ذات الاستخدامات المقصودة المختلفة. تحتوي كل نكهة تطبيق على لون خلفية رمز مختلف لتسهيل التمييز. لمعرفة كيفية تخصيصها بالتفصيل، تحقق من ملف تكوين النكهة.
ملحوظة
بالنسبة للبنيات المخصصة، نقوم بالكتابة فوق بعض العلامات والسلاسل والأيقونات. تحقق من CUSTOMIZATION.md للحصول على التفاصيل.
اسم | لون خلفية الأيقونة | الوصف / الاستخدام المقصود | تم تمكين التسجيل | الخلفية الافتراضية |
---|---|---|---|---|
ديف | ؟ | لتطوير ميزات جديدة. حافة النزيف. غير مستقر. التدريج الخلفية. يأكل ميزات تجريبية على الإفطار ويشرب مطوري الدموع كحلوى. | ✅ | انطلاق الأسلاك |
التدريج | ؟ | بشكل أساسي بالنسبة لـ QA لاختبار تطبيق يشبه الإصدار مع واجهة خلفية مرحلية. يحاكي تطبيق الإنتاج/الإصدار، مع وجود علامات ميزات تتبع تطبيق Prod/White أدناه، ولكن مع أدوات تطوير إضافية. | ✅ | انطلاق الأسلاك |
داخلي | ؟ | غير مستخدم حاليا (؟). لقد تم استخدامه في الماضي وربما يجب حذفه في أي وقت قريب. | ✅ | منتج الأسلاك |
بيتا | ؟ | يتم استخدامه من قبل المستخدمين الداخليين داخل الشركة كطعام تجريبي. قد يتم اختبار بعض الميزات التي ليست جاهزة بعد للعامة هنا أولاً. | ✅ | منتج الأسلاك |
همز | ⚪ | تطبيق الإنتاج متاح لعامة الناس. | ✖️ | منتج الأسلاك |
F-الروبوت | ⚪ | أيضًا تطبيق إنتاج متاح لعامة الناس. تم نشره على متجر F-Droid، ولكن بدون أي برامج مغلقة المصدر. | ✖️ | منتج الأسلاك |
مهم
سيتم تحميل السجلات الخاصة بجميع الإصدارات باستثناء Prod وF-Droid إلى خدمة خارجية لتحليلها من قبل المطورين.
يمكن تمكين السجلات الموجودة على Prod وF-Droid داخل التطبيق، ولكن لا يتم تحميلها في أي مكان. يمكن للمستخدمين تصدير وقراءة ملفات السجل يدويًا من التطبيق.
نحن لا نسجل المحتوى الحساس (مثل محتوى الرسائل ومفاتيح التشفير وما إلى ذلك) بأي شكل من الأشكال. وأشياء مثل المعرفات الفريدة غامضة.
يمكن إنشاء التطبيقات للإصدار أو التصحيح. قد تحتوي إصدارات تصحيح الأخطاء على أدوات تصحيح أخطاء إضافية، ولم يتم تصغيرها، ويمكن تخصيصها إذا لزم الأمر. بشكل عام، تعمل عمليات تصحيح الأخطاء بشكل أبطأ بسبب عدم وجود تصغير.
إذا كنت تريد المساهمة في Wire for Android، يرجى الرجوع إلى ملف CONTRIBUTING.md لمزيد من المعلومات.