Dart-Paket- und Bibliotheksverwaltung

Wenn der Projektumfang wächst, ist die Aufteilung des Codes in mehrere Dateien und Module unerlässlich.

Dieses Kapitel führt in das Paketverwaltungssystem pub von Dart, die Abhängigkeitskonfigurationsdatei pubspec.yaml, die Import/Export-Syntax und die Erstellung eigener Bibliotheken ein.


pubspec.yaml-Konfiguration

pubspec.yaml ist die zentrale Konfigurationsdatei für jedes Dart-Projekt und deklariert die Metadaten und Abhängigkeiten des Projekts.

Eine typische Struktur einer pubspec.yaml-Datei sieht wie folgt aus:

Beispiel

# Dateipfad: pubspec.yaml
name
: my_dart_app              # Projektname (erforderlich, Kleinbuchstaben + Unterstrich)
description
: Ein Dart-Beispielprojekt# Projektbeschreibung
version
: 1.0.0                 # Versionsnummer
# publish_to: none # Wenn du nicht auf pub.dev veröffentlichen möchtest, kommentiere diese Zeile aus

environment
:
  sdk
: '>=3.0.0 <4.0.0'      # Dart SDK-Versionsbereich

dependencies
:
 # Von Drittanbietern stammende Pakete, von denen das Projekt zur Laufzeit abhängt
  http
: ^1.1.0                # HTTP-Client
  path
: ^1.8.0                # Pfad-Dienstprogramme

dev_dependencies
:
 # Abhängigkeiten, die nur während der Entwicklung benötigt werden (Testen, Linting usw.)
  test
: ^1.24.0               # Test-Framework
  lints
: ^2.0.0               # Offizielle Lint-Regeln

# Optional: ausführbarer Einstiegspunkt
# executables:
# my_app: main

Erklärung der Syntax von Versionsnummern:

SyntaxBedeutungBeispiel
^1.1.0Kompatibel mit 1.1.0 bis 2.0.0 (exklusiv)Am häufigsten verwendet, empfohlen
1.1.0Exakte VersionNicht sehr flexibel
>=1.1.0 <1.5.0VersionsbereichVerwenden, wenn präzise Kontrolle erforderlich ist
anyBeliebige VersionNicht empfohlen

Das Caret-Symbol (^) ist Darts Standardmethode für Versionsbeschränkungen. ^1.1.0 ist äquivalent zu >=1.1.0 <2.0.0. Das bedeutet, Minor- und Patch-Versionen können automatisch aktualisiert werden, aber Major-Versionen können nicht aktualisiert werden (Major-Versions-Upgrades können Breaking Changes enthalten).

Abhängigkeiten installieren

$ dart pub get           # 安装依赖
$ dart pub upgrade       # 升级依赖到最新兼容版本
$ dart pub outdated      # 查看哪些依赖有更新

Abhängigkeiten auf pub.dev finden

pub.dev ist das offizielle Paket-Repository für Dart und Flutter, ähnlich wie npm (JavaScript) oder PyPI (Python).

Du kannsthttps://pub.devZehntausende von Dart-Paketen suchen und durchstöbern.

Beispiele für gängige Drittanbieter-Pakete:

PaketZweckBeschreibung
httpHTTP-AnfrageOffiziell gepflegter HTTP-Client
pathPfadoperationenPlattformübergreifendes Werkzeug zur Pfadverarbeitung
testUnit-TestingOffizielles Testframework
json_serializableJSON-SerialisierungJSON-Konvertierungscode automatisch generieren
dioHTTP-ClientEine leistungsfähigere Drittanbieter-HTTP-Bibliothek als http.
riverpodZustandsverwaltungBeliebte State-Management-Lösung für Flutter-Projekte

Beispiel

Füge das http-Paket hinzu und verwende es:

// Zuerst zu den Abhängigkeiten in pubspec.yaml hinzufügen:
// http: ^1.1.0
// Dann ausführen: dart pub get

import 'package:http/http.dart' as http;

void main() async {
  // GET-Anfrage senden
  var url = Uri.parse('https://www.example.com');
  var response = await http.get(url);

  print('Statuscode: ${response.statusCode}');
  print('Länge des Antwortinhalts: ${response.body.length} Zeichen');
}

import-Syntax

Mit import wird Code aus anderen Bibliotheken in eine Dart-Datei importiert.

Dart unterstützt mehrere import-Stile, die jeweils für unterschiedliche Szenarien geeignet sind.

Integrierte Dart-Bibliotheken importieren

Beispiel

// Das dart:-Präfix kennzeichnet die integrierten Kernbibliotheken von Dart
import 'dart:math';    // Mathematikbibliothek (Zufallszahlen, trigonometrische Funktionen usw.)
import 'dart:convert'; // Bibliothek zur Kodierungsumwandlung (JSON, Base64 usw.)
import 'dart:io';      // I/O-Bibliothek (Dateien, Netzwerk usw.)

void main() {
  // Verwendung von Funktionen aus dart:math
  print('Pi: $pi');
  print('2 to the 10th power: ${pow(2, 10)}');

  // Verwendung von Funktionen aus dart:convert
  var jsonStr = '{"name": "example", "age": 10}';
  var decoded = jsonDecode(jsonStr);
  print('JSON geparst: $decoded');
  print('Benutzername: ${decoded['name']}');
}
圆周率: 3.141592653589793
2 的 10 次方: 1024
解析后的 JSON: {name: example, age: 10}
用户名: example

Drittanbieter-Pakete importieren

Beispiel

// Das Präfix package: kennzeichnet Drittanbieter-Pakete auf pub.dev
import 'package:http/http.dart';
import 'package:path/path.dart' as p;

Lokale Dateien importieren

Beispiel

// Relativer Pfadimport: andere Dart-Dateien im selben Projekt importieren
import 'src/utils.dart';          // Unterverzeichnis unter demselben Verzeichnis
import '../models/user.dart';    // Datei im übergeordneten Verzeichnis
import 'constants.dart';         // Datei im selben Verzeichnis

Modifikatoren des Imports

ModifiziererSyntaxZweck
Präfix (as)import 'lib.dart' as myLib;Der Bibliothek einen Alias geben, um Namenskonflikte zu vermeiden
Nur einen Teil importieren (show)import 'lib.dart' show foo, bar;Nur die angegebenen Namen importieren
Teil ausschließen (hide)import 'lib.dart' hide foo;Alles außer den angegebenen Namen importieren
Verzögertes Laden (deferred as)import 'lib.dart' deferred as lib;Bei Bedarf laden, um die Startzeit zu reduzieren

Beispiel

Praktische Verwendung verschiedener Import-Modifikatoren:

import 'dart:math';              // Standard-Import
import 'dart:math' as math;      // Präfix-Import: math.pow() statt pow() verwenden
import 'dart:math' show pi, sqrt;  // Nur pi und sqrt importieren
import 'dart:math' hide Random;    // Alles außer Random importieren

void main() {
  // Standard-Import
  print('sin(0) = ${sin(0)}');

  // Präfix-Import: Zugriff muss über das Präfix erfolgen
  print('cos(0) = ${math.cos(0)}');

  // show-Import: nur pi und sqrt können verwendet werden
  print('π = $pi');
  print('sqrt(16) = ${sqrt(16)}');
  // print(sin(0)); // Fehler: sin ist nicht importiert

  // hide import: Random ist nicht verfügbar, alles andere ist verfügbar
  print('max(3, 7) = ${max(3, 7)}');
  // Random(); // Fehler: Random ist ausgeschlossen
}
sin(0) = 0.0
cos(0) = 1.0
π = 3.141592653589793
sqrt(16) = 4.0
max(3, 7) = 7

show und hide sind nicht nur praktisch – sie sind auch Werkzeuge für die Codequalität. Die Verwendung von show macht Abhängigkeiten klarer: Man sieht auf einen Blick, welche Symbole aus der Bibliothek diese Datei verwendet.


export-Syntax

export wird verwendet, um die öffentlichen APIs anderer Bibliotheken erneut verfügbar zu machen, hauptsächlich zum Erstellen von Aggregatbibliotheken.

Angenommen, du hast die folgende Dateistruktur:

lib/
├── my_package.dart          # 入口文件(聚合导出)
├── src/
│   ├── models/
│   │   └── user.dart        # User 类
│   ├── services/
│   │   └── api_service.dart # API 服务
│   └── utils/
│       └── helpers.dart     # 工具函数

Beispiel

Mit export einen Einstiegspunkt für eine Aggregatbibliothek erstellen:

// Datei: lib/my_package.dart
// Aggregierter Export: macht alle öffentlichen APIs einheitlich verfügbar

export 'src/models/user.dart';
export 'src/services/api_service.dart';
// Nur einen Teil der Inhalte in helpers exportieren
export 'src/utils/helpers.dart' show formatDate, validateEmail;

Auf diese Weise müssen Nutzer nur eine Datei importieren:

Beispiel

// Nutzer müssen nur die Einstiegsdatei importieren
import 'package:my_package/my_package.dart';

void main() {
  // Alle exportierten Klassen können direkt verwendet werden
  var user = User('example');
  var api = ApiService();
}

Erstellung benutzerdefinierter Bibliotheken

Das Erstellen einer benutzerdefinierten Bibliothek erfordert keine spezielle Syntax—jede Dart-Datei ist eine Bibliothek.

Sie können jedoch das Schlüsselwort library verwenden, um explizit einen Bibliotheksnamen zu deklarieren, und part/part of verwenden, um große Bibliotheken aufzuteilen.

library zum Deklarieren eines Bibliotheksnamens verwenden

Beispiel

// Datei: lib/calculator.dart
// library deklariert den Bibliotheksnamen (optional, aber hilfreich für die Dokumentation)
library calculator;

/// Additionsoperation
int add(int a, int b) => a + b;

/// Subtraktionsoperation
int subtract(int a, int b) => a - b;

/// Multiplikationsoperation
int multiply(int a, int b) => a * b;

/// Divisionsoperation, löst eine Ausnahme aus, wenn der Divisor 0 ist
double divide(int a, int b) {
  if (b == 0) {
    throw ArgumentError(Der Divisor darf nicht 0 sein);
  }
  return a / b;
}

Verwende part, um große Bibliotheken aufzuteilen

Wenn der Code einer Bibliothek zu lang ist, kannst du part verwenden, um ihn in mehrere physische Dateien aufzuteilen, die aber logisch weiterhin zur selben Bibliothek gehören.

Beispiel

Die Hauptdatei deklariert part:

// Datei: lib/user_system.dart
// Hauptdatei der Bibliothek
library user_system;

// Deklariere die anderen Dateien, aus denen diese Bibliothek besteht
part 'src/user_model.dart';
part 'src/user_service.dart';
part 'src/user_validator.dart';

// Öffentliche API auf Bibliotheksebene
String libraryVersion = '1.0.0';

Beispiel

part-Datei deklariert part of:

// Datei: lib/src/user_model.dart
// part of deklariert, zu welcher Bibliothek diese Datei gehört
part of '../user_system.dart';

// Auf libraryVersion kann in der Hauptbibliothek zugegriffen werden
class User {
  String name;
  User(this.name);

  void printVersion() {
    print('EXAMPLE User module version: $libraryVersion');
  }
}

part/part of wird in der modernen Dart-Entwicklung nicht häufig verwendet; die meisten Teams bevorzugen import/export, um Code zu organisieren. Der Nachteil von part ist, dass part-Dateien alle privaten Member teilen, was die Kapselung durchbricht. Wenn kein klarer Bedarf besteht, wird import/export empfohlen.


Überblick über die Dart-Kernbibliothek

BibliotheksnameImportmethodeHauptfunktionen
dart:coreAutomatischer ImportGrundlegende Typen, Sammlungen, Ausnahmen usw.
dart:mathimport 'dart:math';Mathematische Konstanten und Funktionen
dart:convertimport 'dart:convert';JSON-, UTF-8-, Base64-Kodierung/-Dekodierung
dart:ioimport 'dart:io';Datei-, Netzwerk- und Prozessoperationen
dart:asyncimport 'dart:async';Asynchrone Werkzeuge wie Future, Stream usw.
dart:collectionimport 'dart:collection';Weitere Sammlungstypen (Queue usw.)
dart:developerimport 'dart:developer';Werkzeuge zum Debuggen und zur Leistungsanalyse

dart:core wird automatisch importiert, daher müssen Sie nicht import 'dart:core' schreiben, um grundlegende Typen wie int, String, List, Map usw. zu verwenden.

Weitere Erweiterungen