تسجيل

يقوم CLI بتسجيل الرسائل داخلياً لمساعدتك في تشخيص المشاكل.

تشخيص المشاكل باستخدام السجلات

إذا لم ينتج عن استدعاء الأمر النتائج المرجوة، يمكنك تشخيص المشكلة من خلال فحص السجلات. تقوم CLI بإعادة توجيه السجلات إلى [OSLog] (https://developer.apple.com/documentation/os/oslog) ونظام الملفات.

في كل عملية تشغيل، ينشئ ملف سجل على $ XDG_STATE_HOME/UIST/logs/{uuid}.log حيث $ XDG_STATE_HOME يأخذ القيمة ~/.local/state إذا لم يتم تعيين متغير البيئة. ويمكنك أيضًا استخدام $ TUIST_XDG_STATE_STATE_HOME لتعيين دليل حالة خاص بتويست، والذي يأخذ الأسبقية على $ XDG_STATE_HOME.

TIP

تعرف على المزيد حول تنظيم دليل تويست وكيفية تكوين الدلائل المخصصة في وثائق

الدلائل.

بشكل افتراضي، يقوم CLI بإخراج مسار السجلات عند خروج التنفيذ بشكل غير متوقع. إذا لم يفعل ذلك، يمكنك العثور على السجلات في المسار المذكور أعلاه (أي أحدث ملف سجل).

WARNING

لا يتم تنقيح المعلومات الحساسة، لذا كن حذراً عند مشاركة السجلات.

التكامل المستمر

في CI، حيث تكون البيئات قابلة للتصرف، قد ترغب في تكوين خط أنابيب CI لتصدير سجلات Tuist. تصدير القطع الأثرية هي إمكانية مشتركة عبر خدمات CI، ويعتمد التكوين على الخدمة التي تستخدمها. على سبيل المثال، في GitHub Actions، يمكنك استخدام الإجراء actions/upload-artifact لتحميل السجلات كقطعة أثرية:

name: Node CI

on: [push]

env:
  TUIST_XDG_STATE_HOME: /tmp

jobs:
  build:
    runs-on: ubuntu-latest
    steps:
      - name: Checkout repository
        uses: actions/checkout@v4
      # ... other steps
      - run: tuist generate
      # ... do something with the project
      - name: Export Tuist logs
        if: failure()
        uses: actions/upload-artifact@v4
        with:
          name: tuist-logs
          path: /tmp/tuist/logs/*.log

تصحيح أخطاء البرنامج الخفي للتخزين المؤقت

لتصحيح المشاكل المتعلقة بذاكرة التخزين المؤقت، يسجل تويست عمليات البرنامج الخفي لذاكرة التخزين المؤقت باستخدام os_log مع النظام الفرعي dev.tuist.cache. يمكنك بث هذه السجلات في الوقت الفعلي باستخدام:

log stream --predicate 'subsystem == "dev.tuist.cache"' --debug

تظهر هذه السجلات أيضًا في Console.app عن طريق التصفية للنظام الفرعي .tuist.cache. يوفر هذا معلومات مفصلة حول عمليات ذاكرة التخزين المؤقت، والتي يمكن أن تساعد في تشخيص مشاكل التحميل والتنزيل والاتصال في ذاكرة التخزين المؤقت.