0Pricing
React Academy · Lektion

Gemeinsame Libraries und interne Packages

Erstellen Sie gemeinsame UI- und Utility-Libraries und importieren Sie sie mit TypeScript-Pfad-Aliases in mehrere Apps.

Gemeinsame Libraries und interne Packages ist eine kostenlose React Academy-Lektion auf CoddyKit. Dies ist Lektion 2 von 4. Du kannst die komplette Lektion unten kostenlos lesen – dann übst du sie direkt im Browser mit einem integrierten Code-Editor und einem KI-Tutor rund um die Uhr. Sie ist Teil des React Academy-Lernpfads, und dein Fortschritt wird über Web und CoddyKit-App synchronisiert. Der React Academy-Kurs umfasst insgesamt 4 Lektionen.

Warum gemeinsame Bibliotheken?

Statt Komponenten, Hooks und Hilfsfunktionen in mehreren Apps zu duplizieren, extrahieren Sie sie in gemeinsame Bibliotheksprojekte, die von jeder App im Monorepo verwendet werden können.

Eine Bibliothek generieren

Verwenden Sie Nx-Generatoren, um typisierte, buildbare Bibliotheksprojekte zu erstellen.

# UI component library:
npx nx generate @nx/react:library ui --directory=libs/ui --importPath=@myorg/ui

# Utility library:
npx nx generate @nx/js:library utils --directory=libs/utils --importPath=@myorg/utils

# Data access library (hooks, API calls):
npx nx generate @nx/react:library data-access --importPath=@myorg/data-access

Öffentliche API der Bibliothek

Exportieren Sie alles aus einer einzigen index.ts (der öffentlichen API). Verbraucher sollten nur aus @myorg/ui importieren, nicht aus tief verschachtelten internen Pfaden.

// libs/ui/src/index.ts
export { Button } from './lib/Button';
export { Card } from './lib/Card';
export { Input } from './lib/Input';
export type { ButtonProps } from './lib/Button';

// Consumer in apps/web:
import { Button, Card } from '@myorg/ui';
// NOT: import { Button } from '@myorg/ui/src/lib/Button'; // internal path

Bibliothekstypen: publishable vs. buildable

Buildable-Bibliotheken werden inkrementell kompiliert und ermöglichen schnellere Monorepo-Builds. Publishable-Bibliotheken erzeugen zusätzlich ein npm-kompatibles Paket für die externe Verwendung.

# Buildable (monorepo internal use only):
npx nx generate @nx/react:library ui --buildable

# Publishable (for npm too):
npx nx generate @nx/react:library ui --publishable --importPath=@myorg/ui

Modulgrenzen durchsetzen

Verwenden Sie die ESLint-Regel @nx/enforce-module-boundaries, um zirkuläre Abhängigkeiten zu verhindern und einzuschränken, welche Projekte voneinander importieren dürfen.

// nx.json or .eslintrc
"depConstraints": [
  // Apps can only import from libs:
  { "sourceTag": "type:app", "onlyDependOnLibsWithTags": ["type:lib"] },
  // Feature libs can't import other feature libs (via shared libs only):
  { "sourceTag": "type:feature", "notDependOnLibsWithTags": ["type:feature"] }
]

Storybook für gemeinsame Bibliotheken

Führen Sie Storybook für die UI-Bibliothek aus, um Komponenten unabhängig von jeder App isoliert zu dokumentieren.

# Generate Storybook config for the ui lib:
npx nx generate @nx/storybook:configuration ui

# Run Storybook:
npx nx storybook ui

Bibliotheken testen

Jede Bibliothek verfügt über ein eigenes Test-Target. Führen Sie die Tests der Bibliothek und aller betroffenen Apps aus, wenn die Bibliothek geändert wird.

# Test specific library:
npx nx test ui

# Test all affected by a change:
npx nx affected --target=test

Versionsverwaltung in Monorepos

In einem Monorepo verwenden alle Pakete dieselbe package.json und Version. Verwenden Sie für publishable Bibliotheken Tools wie @jscutlery/semver oder Changesets, um eine unabhängige Versionsverwaltung zu ermöglichen.

Bestehenden Code in Bibliotheken migrieren

Verschieben Sie gemeinsamen Code schrittweise in eine Bibliothek: Erstellen Sie die Bibliothek, verschieben Sie die Dateien, aktualisieren Sie die Importe und überlassen Sie den TypeScript-Pfad-Aliasen den Rest.

# Move a component:
# 1. Copy src/components/Button.tsx → libs/ui/src/lib/Button.tsx
# 2. Export from libs/ui/src/index.ts
# 3. Update imports across apps from relative paths to '@myorg/ui'
# 4. Delete the original file

Dokumentation mit Compodoc oder Storybook Docs

Verwenden Sie das autodocs-Tag von Storybook oder Compodoc, um API-Dokumentation aus TypeScript-Typen und JSDoc-Kommentaren in Bibliotheksdateien zu generieren.

Kurztest

Was sollte der einzige Einstiegspunkt für Verbraucher sein, die aus einer gemeinsamen Nx-Bibliothek importieren?

Zusammenfassung

Generieren Sie Bibliotheken mit nx generate, exportieren Sie alles aus einer einzigen index.ts und setzen Sie Modulgrenzen mit ESLint-Regeln durch. Verwenden Sie buildable Bibliotheken für schnellere inkrementelle Builds und publishable Bibliotheken, wenn Sie Pakete in npm veröffentlichen möchten. Führen Sie Storybook für UI-Bibliotheken aus, um eine isolierte Dokumentation zu erstellen.

Häufig gestellte Fragen

Ist die Lektion „Gemeinsame Libraries und interne Packages“ kostenlos?

Ja — der vollständige Text von „Gemeinsame Libraries und interne Packages“ ist hier im Web kostenlos zu lesen. Um sie interaktiv zu üben (integrierter Code-Editor und 24/7 KI-Tutor) und den Rest des React Academy-Kurses freizuschalten, upgrade auf CoddyKit PRO. Der React Academy-Kurs umfasst insgesamt 4 Lektionen.

Was lerne ich in „Gemeinsame Libraries und interne Packages“?

Erstellen Sie gemeinsame UI- und Utility-Libraries und importieren Sie sie mit TypeScript-Pfad-Aliases in mehrere Apps. Du übst React Academy mit praktischem Code, den du direkt im Browser ausführst, und ein 24/7 KI-Tutor beantwortet deine Fragen während du die Lektion bearbeitest.

Brauche ich Erfahrung, um React Academy zu starten?

Keine Vorkenntnisse erforderlich. React Academy auf CoddyKit ist für Anfänger bis fortgeschrittene Lernende strukturiert, sodass du hier starten oder von Anfang an beginnen und in deinem eigenen Tempo voranschreiten kannst. Dies ist Lektion 2 von 4.

Wie lange dauert die Lektion „Gemeinsame Libraries und interne Packages“?

Die meisten CoddyKit-Lektionen dauern etwa 5–10 Minuten. Jede ist kompakt und interaktiv, sodass du stetig Fortschritte machst und genau dort weitermachst, wo du aufgehört hast – im Web und in der App.

Kann ich in dieser React Academy-Lektion Code schreiben und ausführen?

Ja. Jede React Academy-Lektion enthält einen integrierten Code-Editor, sodass du echten Code direkt in deinem Browser schreibst und ausführst und sofort KI-Feedback erhältst — ohne lokale Einrichtung erforderlich.

Alle Lektionen in diesem Kurs

  1. Ein Nx-Monorepo mit React-Apps erstellen
  2. Gemeinsame Libraries und interne Packages
  3. Nx-Affected-Befehle und Caching
  4. Code-Generatoren und Workspace-Automatisierung
← Zurück zu React Academy