مساحة عمل Nx

# استكشاف مساحة عمل Nx

توفر هذه المهارة استكشافا للقراءة فقط لمساحات عمل Nx. استخدمها لفهم هيكل مساحة العمل، وتكوين المشروع، والأهداف المتاحة، والتبعيات.

ضع في اعتبارك أنك قد تحتاج إلى إضافة بادئة للأوامر ب `npx`/`pnpx`/`yarn` إذا لم يكن Nx مثبتا عالميا. تحقق من ملف lockfile لتحديد مدير الحزم المستخدم.

## سرد المشاريع

استخدم `nx show projects` لسرد المشاريع في مساحة العمل.

يعمل بناء جملة تصفية المشاريع (`-p`/`--projects`) عبر العديد من أوامر Nx بما في ذلك `nx run-many`، و`nx release`، و`nx show projects`، والمزيد. تدعم الفلاتر الأسماء الصريحة، وأنماط glob، ومراجع العلامات (مثل `tag:name`)، والدلائل، والنفي (مثل `!project-name`).

```bash # List all projects nx show projects

# Filter by pattern (glob) nx show projects --projects "apps/*" nx show projects --projects "shared-*"

# Filter by tag nx show projects --projects "tag:publishable" nx show projects -p 'tag:publishable,!tag:internal'

# Filter by target (projects that have a specific target) nx show projects --withTarget build

# Combine filters nx show projects --type lib --withTarget test nx show projects --affected --exclude="*-e2e" nx show projects -p "tag:scope:client,packages/*"

# Negate patterns nx show projects -p '!tag:private' nx show projects -p '!*-e2e'

# Output as JSON nx show projects --json ```

## تكوين المشروع

استخدم `nx show project <name> --json` للحصول على التكوين الكامل المحلل للمشروع.

**هام**: لا تقم بقراءة `project.json` مباشرة - فهو يحتوي فقط على تكوين جزئي. يعيد الأمر `nx show project --json` التكوين الكامل المحلل بما في ذلك الأهداف المستنتجة من المكونات الإضافية (plugins).

يمكنك قراءة مخطط المشروع الكامل في `node_modules/nx/schemas/project-schema.json` لفهم خيارات تكوين مشروع Nx.

```bash # Get full project configuration nx show project my-app --json

# Extract specific parts from the JSON nx show project my-app --json | jq '.targets' nx show project my-app --json | jq '.targets.build' nx show project my-app --json | jq '.targets | keys'

# Check project metadata nx show project my-app --json | jq '{name, root, sourceRoot, projectType, tags}' ```

## معلومات الهدف (Target)

تحدد الأهداف المهام التي يمكن تشغيلها على المشروع.

```bash # List all targets for a project nx show project my-app --json | jq '.targets | keys'

# Get full target configuration nx show project my-app --json | jq '.targets.build'

# Check target executor/command nx show project my-app --json | jq '.targets.build.executor' nx show project my-app --json | jq '.targets.build.command'

# View target options nx show project my-app --json | jq '.targets.build.options'

# Check target inputs/outputs (for caching) nx show project my-app --json | jq '.targets.build.inputs' nx show project my-app --json | jq '.targets.build.outputs'

# Find projects with a specific target nx show projects --withTarget serve nx show projects --withTarget e2e ```

## تكوين مساحة العمل

اقرأ `nx.json` مباشرة للحصول على تكوين على مستوى مساحة العمل. يمكنك قراءة مخطط المشروع الكامل في `node_modules/nx/schemas/nx-schema.json` لفهم خيارات تكوين مشروع Nx.

```bash # Read the full nx.json cat nx.json

# Or use jq for specific sections cat nx.json | jq '.targetDefaults' cat nx.json | jq '.namedInputs' cat nx.json | jq '.plugins' cat nx.json | jq '.generators' ```

الأقسام الرئيسية في nx.json:

- `targetDefaults` - التكوين الافتراضي المطبق على جميع الأهداف ذات الاسم المحدد - `namedInputs` - تعريفات إدخال قابلة لإعادة الاستخدام للتخزين المؤقت - `plugins` - مكونات Nx الإضافية وتكوينها - ...والمزيد، اقرأ المخطط أو nx.json للحصول على التفاصيل

## المشاريع المتأثرة

إذا كان المستخدم يسأل عن المشاريع المتأثرة، فاقرأ [مرجع المشاريع المتأثرة](references/AFFECTED.md) للحصول على أوامر وأمثلة مفصلة.

## أنماط الاستكشاف الشائعة

### "ماذا يوجد في مساحة العمل هذه؟"

```bash nx show projects nx show projects --type app nx show projects --type lib ```

### "كيف أقوم ببناء/اختبار/فحص المشروع X؟"

```bash nx show project X --json | jq '.targets | keys' nx show project X --json | jq '.targets.build' ```

### "ماذا يعتمد على المكتبة Y؟"

```bash # Use the project graph to find dependents nx graph --print | jq '.graph.dependencies | to_entries[] | select(.value[].target == "Y") | .key' ```

## الإجابات البرمجية

عند معالجة نتائج Nx CLI، استخدم أدوات سطر الأوامر لحساب الإجابة برمجيا بدلا من العد أو تحليل الإخراج يدويا. استخدم دائما علامات `--json` للحصول على إخراج منظم يمكن معالجته باستخدام `jq` أو `grep` أو أي أدوات أخرى مثبتة لديك محليا.

### سرد المشاريع

```bash nx show projects --json ```

مثال على الإخراج:

```json ["my-app", "my-app-e2e", "shared-ui", "shared-utils", "api"] ```

العمليات الشائعة:

```bash # Count projects nx show projects --json | jq 'length'

# Filter by pattern nx show projects --json | jq '.[] | select(startswith("shared-"))'

# Get affected projects as array nx show pr ```