تيرا كور
- حزم
- المتصفحات المدعومة
- التدويل (I18N)
- المساهمة
- التنمية المحلية
- التطوير المحلي باستخدام Docker (حاويات DEV)
- رخصة
حزم
الإصدار
عندما يصل المكون إلى v1.0.0. ، فإنه يعتبر مستقرًا وسيتبع Semver للإصدار.
- تمثل الإصدارات الرئيسية تغييرات كسر
- تمثل الإصدارات البسيطة وظائف إضافية بطريقة متوافقة مع الوراء
- تمثل إصدارات التصحيح إصلاحات الأخطاء المتوافقة مع الخلف
راجع مكون changelogs ، والمشكلات ذات الصلة ، و PRS لمزيد من المعلومات.
ننظر إلى API Props React.js من مكوناتنا باعتبارها واجهة برمجة تطبيقات عامة لدينا. نستخدم هذا لإرشادنا عند الإصدار.
قبل أن تصل المكونات التي تصل إلى V1.0.0 ، يعتبر المكون في مرحلة تجريبية. قد تتضمن المكونات في مرحلة الإصدار التجريبي التغييرات والميزات الجديدة وإصلاحات الأخطاء في إصدارات V0.xx.
حالة
| حزمة تيرا | إصدار | حالة | التبعيات |
|---|
| terra-action-tooter | | | |
| تيرا العمل | | | |
| terra-alert | | | |
| terra-arrange | | | |
| terra-avatar | | | |
| تيرا بادج | | | |
| terra-base | | | |
| Terra Breakpoints | | | |
| تيرا بوت | | | |
| تيرا بوت مجموعة | | | |
| terra-card | | | |
| terra-containerer | | | |
| terra-demographics-banner | | | |
| تيرا ديالوج | | | |
| terra-divider | | | |
| terra-dropdown-butro | | | |
| terra-dynamic-grid | | | |
| terra-form-checkbox | | | |
| حقل تيرا | | | |
| terra-formeet | | | |
| terra-form | | | |
| terra-form-radio | | | |
| terra-form-select | | | |
| terra-form-textarea | | | |
| تيرا الشبكة | | | |
| الدير | | | |
| terra-hyperlink | | | |
| terra-i18n | | | |
| terra-icon | | | |
| تيرا صورة | | | |
| قائمة تيرا | | | |
| تيرا ميكسينات | | | |
| تيرا أوفراي | | | |
| terra-paginator | | | |
| terra-profile-image | | | |
| terra-progress-bar | | | |
| تيرا المستجيبة | | | |
| terra-scroll | | | |
| Terra-Search-Field | | | |
| تيرا قسم القسم | | | |
| terra-show-hide | | | |
| التوقيع تيرا | | | |
| terra-spacer | | | |
| terra-Status | | | |
| Terra-Status-View | | | |
| طاولة تيرا | | | |
| terra-tag | | | |
| terra-text | | | |
| terra-toggle | | | |
| terra-toggle-butro | | | |
| Terra-Toggle Header | | | |
| terra-visen-text-text | | | |
تم إهماله
| حزمة تيرا | إصدار | حالة | التبعيات |
|---|
| terra-form | | | |
| terra-i18n-plugin | | | |
| terra-legacy-theme | | | |
| terra-modal | | | |
المتصفحات المدعومة
| متصفح | إصدار |
|---|
| Chrome & Chrome لنظام Android | حاضِر |
| حافة | حاضِر |
| Firefox | حاضِر |
| Internet Explorer | 10 و 11 |
| Safari و Mobile Safari | حاضِر |
التدويل (I18N)
يرجى مراجعة وثائق تدويل تيرا لمزيد من المعلومات. وشملت الاتجاهات حول الاستهلاك وكيف يتم إعداد التدويل.
الحزم التي تتطلب i18n
- تيرا العمل
- terra-alert
- terra-demographics-banner
- تيرا ديالوج
- terra-form-checkbox
- حقل تيرا
- terra-form-radio
- terra-form-select
- terra-i18n
- تيرا أوفراي
- Terra-Search-Field
- terra-show-hide
- Terra-Status-View
المساهمة
يرجى قراءة إرشاداتنا المساهمة. يتم تضمين توجيهات لتقارير القضية وطلبات السحب.
التنمية المحلية
- تثبيت Node Version Manager (NVM) والعقدة. يحتوي دليل الجذر على ملف
.nvmrc يحدد إصدار عقدة Terra-Core. بمجرد تثبيت NVM وأنت داخل دليل الجذر ، سيتغير إصدار العقدة الخاص بك إلى هذا الإصدار. - تثبيت Docker https://www.docker.com/ لتشغيل اختبارات المتصفح.
- تثبيت التبعيات وتشغيل الاختبارات.
التطوير المحلي باستخدام Docker (حاويات DEV)
- تثبيت Rancher أو Docker.
- Rancher مجاني ومفتوح المصدر ويوصى به بشدة في حين أن Docker قد يتطلب ترخيصًا للاستخدام.
- تثبيت Microsoft vs Code.
- تثبيت امتداد حاوية DEV.
- انتقل إلى عرض-> امتداد-> ابحث عن حاويات DEV وتثبيتها (أو "MS-VScode-Remote.remote-containers")
- مزيد من المعلومات حول حاويات DEV
- بناء حاوية DEV:
- (الخيار 1) - فتح مساحة العمل المحلية في حاوية DEV
- استنساخ المستودع (أو الشوكة) محليًا وفتح المشروع في كود Visual Studio
- انتقل لعرض -> لوحة الأوامر وتشغيل حاويات DEV: مساحة عمل مفتوحة في الحاوية
- (الخيار 2) - موصى به لنظام التشغيل Windows من أجل التحميل الساخن للعمل أثناء التطوير وتحسين الأداء: إنشاء حاوية DEV باستخدام أحجام DEV (لمزيد من المعلومات والتوجيه ، انظر الدليل الرسمي)
- إذا كان لديك إعداد GIT ولديك ملف تكوين عالمي ~/.gitConfig محليًا ، يجب نقل هذه الإعدادات تلقائيًا إلى حاوية DEV
- انتقل إلى عرض -> لوحة الأوامر وتشغيل حاويات DEV: مستودع استنساخ في حجم الحاوية
- الصق عنوان URL github لهذا المستودع (أو الشوكة)
- سيقوم VS Code الآن بإعادة تحميل مساحة العمل وإنشاء/بدء تشغيل حاوية وحجم DEV
- يرجى ملاحظة: التغييرات التي تم إجراؤها باستخدام هذا الخيار ستقوم فقط بتحديث الملفات في وحدة تخزين Docker. يوصى بإلغاء التغييرات في كثير من الأحيان في حالة حذف حجم أو إزالة حاوية DEV.
- أنت تعمل الآن في حاوية DEV. استخدم محطة حاوية DEV في رمز Visual Studio لإصدار أي أوامر NPM أو BASH.
- قبل إجراء أي اختبارات WDIO ، تأكد من تنفيذ الخطوات التالية:
- افتح محطة جديدة (خارج حاوية DEV) وانتقل إلى ".DevContainer/" المسار في مستودعك.
- قم بتنفيذ الأمر
"docker compose -f docker-compose-wdio.yml up" . يجب أن يدور محور السيلينيوم. اترك هذا يعمل في الخلفية. إذا رأيت أخطاء تقول "اسم الحاوية موجود بالفعل" ، فقم بتشغيل "docker container prune" متبوعًا بالضغط على "Y" لمسح أي حاويات غير مستخدمة ومحاولة تشغيل الأمر السابق مرة أخرى. - يمكنك الآن تشغيل
npm run test:docker أو npm run wdio:docker لتشغيل اختبارات WDIO من داخل حاوية DEV. - ملاحظة: اختياريًا ، إذا كنت ترغب في تشغيل أوامر WDIO أخرى في حاوية DEV ، فيمكنك أيضًا تحرير Package.json File Scripts لتضمين
--disableSeleniumService=true Flag. سيؤدي ذلك إلى تعطيل خدمة السيلينيوم من الدوران مرة أخرى. على سبيل المثال: " scripts " : {
" wdio:lowlight " : " terra wdio --disableSeleniumService=true --themes clinical-lowlight-theme "
} - إذا تم تغيير أي من الملفات المكونة ، فيجب عليك تحديث حاوية Docker عن طريق حذف صور Docker الحالية المقابلة ، ثم تشغيل الأمر التالي:
docker compose -f < changed compose file name > .yml up
- لإنهاء حاوية ديف:
- استخدم سطر الأوامر أو سطح المكتب/Docker أو
- باستخدام رمز الاستوديو المرئي
- حدد أيقونة المستكشف عن بعد في شريط النشاط أو عرض -> لوحة الأوامر وتشغيل المستكشف البعيد: ركز على عرض الحاويات
- حدد موقع terra-core_devcontainer أو تشغيل حاوية dev حاليًا تحت "حاويات dev"
- انقر بزر الماوس الأيمن وحدد إيقاف حاوية وأغلق مساحة العمل
- يمكنك أيضًا تحديد حاوية إعادة بناء لإعادة تشغيل حاوية DEV
- لإعادة فتح حاوية ديف:
- مساحة عمل محلية موجودة (للخيار 1)
- افتح المشروع في Visual Studio Code
- تأكد من أن مساحة العمل تحتوي على مجلد .DevContainer
- انتقل لعرض -> لوحة الأوامر وتشغيل حاويات DEV: مساحة عمل مفتوحة في الحاوية
- حجم حاوية DEV المعزول (للخيار 2)
- افتح رمز الاستوديو المرئي
- استخدم أيقونة المستكشف عن بُعد في شريط النشاط أو عرض -> لوحة الأوامر وقم بتشغيل المستكشف البعيد: ركز على عرض الحاويات لعرض الحاويات
- حدد موقع terra-core_devcontainer تحت "حاويات dev"
- تحوم فوق حاوية Dev وانقر فوق أيقونة المجلد المسمى Open Folder في حاوية أو عن طريق النقر بزر الماوس الأيمن وتحديد مجلد مفتوح في الحاوية
رخصة
حقوق الطبع والنشر 2017 - 2024 Cerner Innovation ، Inc.
مرخصة بموجب ترخيص Apache ، الإصدار 2.0 ("الترخيص") ؛ لا يجوز لك استخدام هذا الملف إلا في الامتثال للترخيص. يمكنك الحصول على نسخة من الترخيص على
http://www.apache.org/licenses/license-2.0
ما لم يكن مطلوبًا بموجب القانون المعمول به أو الموافقة على الكتابة ، يتم توزيع البرامج الموزعة بموجب الترخيص على أساس "كما هي" ، دون ضمانات أو شروط من أي نوع ، إما صريحة أو ضمنية. راجع ترخيص الأذونات والقيود التي تحكم اللغة المحددة بموجب الترخيص.
