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
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:
| Syntax | Bedeutung | Beispiel |
|---|---|---|
| ^1.1.0 | Kompatibel mit 1.1.0 bis 2.0.0 (exklusiv) | Am häufigsten verwendet, empfohlen |
| 1.1.0 | Exakte Version | Nicht sehr flexibel |
| >=1.1.0 <1.5.0 | Versionsbereich | Verwenden, wenn präzise Kontrolle erforderlich ist |
| any | Beliebige Version | Nicht 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:
| Paket | Zweck | Beschreibung |
|---|---|---|
| http | HTTP-Anfrage | Offiziell gepflegter HTTP-Client |
| path | Pfadoperationen | Plattformübergreifendes Werkzeug zur Pfadverarbeitung |
| test | Unit-Testing | Offizielles Testframework |
| json_serializable | JSON-Serialisierung | JSON-Konvertierungscode automatisch generieren |
| dio | HTTP-Client | Eine leistungsfähigere Drittanbieter-HTTP-Bibliothek als http. |
| riverpod | Zustandsverwaltung | Beliebte State-Management-Lösung für Flutter-Projekte |
Beispiel
Füge das http-Paket hinzu und verwende es:
// 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
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
import 'package:http/http.dart';
import 'package:path/path.dart' as p;
Lokale Dateien importieren
Beispiel
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
| Modifizierer | Syntax | Zweck |
|---|---|---|
| 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' 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:
// 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
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
// 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:
// 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:
// 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
| Bibliotheksname | Importmethode | Hauptfunktionen |
|---|---|---|
| dart:core | Automatischer Import | Grundlegende Typen, Sammlungen, Ausnahmen usw. |
| dart:math | import 'dart:math'; | Mathematische Konstanten und Funktionen |
| dart:convert | import 'dart:convert'; | JSON-, UTF-8-, Base64-Kodierung/-Dekodierung |
| dart:io | import 'dart:io'; | Datei-, Netzwerk- und Prozessoperationen |
| dart:async | import 'dart:async'; | Asynchrone Werkzeuge wie Future, Stream usw. |
| dart:collection | import 'dart:collection'; | Weitere Sammlungstypen (Queue usw.) |
| dart:developer | import '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