Chromestatus.com هي الأداة الرسمية المستخدمة لتتبع ميزة إطلاقها في Blink (محرك المتصفح الذي يعمل على تشغيل Chrome والعديد من متصفحات الويب الأخرى). تتميز أدلة الأدوات هذه بمالكي عملية الإطلاق الخاصة بنا وتعمل كمصدر أساسي لمعلومات المطور التي تم دمجها في جميع أنحاء النظام الإيكولوجي لمطور الويب.
لإعداد نقرة واحدة يعزز DevContainers ، تحقق من DevContainer ReadMe. خلاف ذلك ، لمواصلة الإعداد محليًا:
git clone https://github.com/GoogleChrome/chromium-dashboard
gcloud initgcloud components install cloud-datastore-emulatorgcloud components install betanpm install --global gulp-clisudo apt install python3.11-venvnode -v للتحقق من إصدار العقدة الافتراضيةnvm use 18 للتبديل إلى العقدة 18cd chromium-dashboardnpm run setupnpm run clean-setup قمنا بإجراء تغييرات على package.json أو المتطلبات.إذا واجهت أي خطأ أثناء عملية التثبيت ، فقد يساعد القسم ملاحظات (لاحقًا في هذا readme.md).
لبدء الخادم الرئيسي والخلفي للمعلومات ، قم بتشغيل:
npm start ثم تفضل بزيارة http://localhost:7777/ .
لبدء مشاهدة رمز النهاية الأمامي (Sass ، JS Lint Check ، Babel ، Minify Files) ، قم بتشغيل
npm run watchلتشغيل Lint & Lit-analyzer:
npm run lintلتشغيل اختبارات الوحدة:
npm testسيؤدي ذلك إلى بدء محاكي مخزن بيانات محلي ، وتشغيل اختبارات الوحدة ، ثم أغلق المحاكي.
لتحديث test_html_rendering.html ، قم بتعديل طريقة test_html_rendering في ملف الاختبار المقابل ، وهو السطر الذي يشبه:
# TESTDATA.make_golden(template_text, 'test_html_rendering.html')ثم قم بإجراء الاختبار مرة أخرى (وربما مرة أخرى) ، وبعد ذلك يمكنك العودة إلى تغيير ملفات الاختبار.
لتشغيل الاختبارات المرئية للكاتب المسرحي (المعروف أيضًا باسم الاختبارات الشاملة) ، فإن الأمر الذي يجب استخدامه هو:
npm run pwtests إذا كانت هناك أخطاء ، فسيتم عرضها في وحدة التحكم. إذا كنت بحاجة إلى تحديث أي من صور شاشة لقطة الشاشة ، فسترى اختلافات في دليل packages/playwright/test-results ، وإذا كانت تبدو صحيحة ، فيمكنك تحديث جميع الصور لجميع الاختبارات مع:
npm run pwtests-updateتتم إضافة الصور المحدثة أيضًا إلى دليل لقطات الشاشة . الصور التي لا تحتاج إلى تحديث لا تظهر على أنها تم تغييرها. إذا قمت بتغيير أسماء ملفات الاختبار ، أو أسماء طريقة الاختبار ، أو أسماء ملفات صورة لقطة الشاشة ، فسيتم إنشاء ملفات جديدة ، وستحتاج إلى حذف الملفات القديمة يدويًا. يمكنك ببساطة حذف جميع لقطات الشاشة وتحديث كل شيء ، ولكن هذا سيستغرق وقتًا طويلاً إلى حد ما.
يمكنك تحديث الصور للحصول على ملف اختبار واحد فقط عن طريق إضافة- --filename=some_pwtest.js إلى أمر pwtests-update . لا يحتاج اسم some_pwtest.js إلى أن يكون مسارًا كاملاً.
إذا تم الإبلاغ عن خطأ في Github CI Cirewright Action ، فيمكنك النظر في سجل الأخطاء ، ولكن إذا كانت المشكلة عبارة عن فرق في بعض الصور ، فيجب عليك على الأرجح تنزيل ملف Artifact .zip الذي يحتوي على جميع الاختلافات.
هناك بعض المعلومات الإضافية للمطورين في الوثاق المطور.
لاختبار وظيفة هذا التطبيق محليًا يتفاعل مع البيانات من API Origin Trials ، يجب الحصول على مفتاح API. للقيام بذلك ، قم بتشغيل الأمر التالي:
npm run dev-ot-keyملاحظة: فقط المطورين الذين يتمتعون بالوصول إلى مشروع GCP CR-Status Scarged سيتمكنون من تشغيل هذا الأمر بنجاح. إذا كنت بحاجة إلى اختبار هذا ولم يكن لديك إمكانية الوصول ، فتح مشكلة.
ملحوظات
إذا حصلت على خطأ في قول No module named protobuf أو No module named six أو No module named enum ، فحاول تثبيتها محليًا مع pip install six enum34 protobuf .
عند تثبيت GAE SDK ، تأكد من الحصول على إصدار Python 3.
إذا قمت بتشغيل الخادم محليًا ، وبعد ذلك يتم فصلك عن نافذتك النهائية ، فقد تظل الوظائف قيد التشغيل والتي ستمنعك من بدء تشغيل الخادم مرة أخرى. للعمل حول هذا ، استخدم npm run stop-emulator; npm stop . أو ، استخدم ps aux | grep gunicorn و/أو ps aux | grep emulator ، ثم استخدم أمر UNIX kill -9 لإنهاء هذه الوظائف.
إذا كنت بحاجة إلى اختبار أو تصحيح أي شيء يتعلق بالتبعيات ، فيمكنك الحصول على بداية نظيفة عن طريق تشغيل npm run clean-setup .
في بعض الأحيان ، سيتطلب Google Cloud CLI تحديثًا ، سيؤدي إلى فشل عند محاولة تشغيل خادم التطوير مع npm start . Failed to connect to localhost port 15606 after 0 ms: Connection refused . سيتم تحديث تشغيل أمر gcloud components update حسب الحاجة وحل هذه المشكلة.
يحصل Chromestatus حاليًا على قائمة مكونات وميض من ملف hack_components.py .
تفضل بزيارة http: // localhost: 7777/admin/Blink/populate_blink لرؤية قائمة أصحاب مكونات Blink.
settings.py تحتوي على قائمة من Globals لتصحيح الأخطاء وتشغيل الموقع محليًا.
إذا كان لديك تغييرات محلية غير ملتزم بها ، فسيتم تنتهي اسم إصدار AppEngine بـ -tainted . لا بأس في اختبار التدريج مع الإصدارات الملوثة ، ولكن يجب ارتكاب كل شيء (وبالتالي غير ملوث) قبل تنظيم نسخة يمكن دفعها لاحقًا إلى Prod.
لاحظ أنك تحتاج إلى امتيازات المسؤول في مشاريع cr-status-staging و cr-status Cloud لتتمكن من نشر الموقع.
قم بتشغيل هدف NPM:
npm run staging
افتح وحدة التحكم في Google Developer لموقع التدريج وانقلب على الإصدار الجديد من خلال الاختيار من القائمة والنقر فوق Migrate Traffic . تأكد من القيام بذلك من أجل كل من الخدمة "الافتراضية" وكذلك لخدمة "Sotfier".
بدلاً من ذلك ، قم بتشغيل npm run staging-rc لتحميل نفس الرمز إلى إصدار يسمى rc لـ "مرشح الإصدار". هذا هو الإصدار الوحيد الذي يمكنك اختباره باستخدام تسجيل الدخول إلى Google على https://rc-dot-cr-status-staging.appspot.com rc-dot-cr-status targe.apppot.com.
إذا كان الاختبار اليدوي على خادم التدريج يبدو جيدًا ، فكرر نفس الخطوات للنشر إلى Prod:
npm run deploy
افتح وحدة التحكم في Google Developer لموقع الإنتاج
يجب أن يحتوي موقع الإنتاج على إصدارات تتطابق مع الإصدارات حول التدريج.
حقوق الطبع والنشر (C) 2013-2022 Google Inc. جميع الحقوق محفوظة.
ترخيص APACHE2.