Aus öffentlichen Paketdaten erstellte Orientierung.
release_updater ist ein Flutter/Dart-Paket, das den Prozess der automatischen Aktualisierung von Release- oder Installationsdateien in einem lokalen Verzeichnis vereinfacht. Es ermöglicht Entwicklern, versionierte Ressourcen wie App-Binärdateien oder Konfigurationsdateien durch Abrufen und Ersetzen aus einer entfernten Quelle zu verwalten. Ideal für Apps, die häufig ohne vollständige Neuinstallation aktualisiert werden müssen, unterstützt es mehrere Plattformen wie Android, iOS, macOS, Windows und Linux. Das Paket vereinfacht Bereitstellungsworkflows, indem es manuelle Dateiverwaltung reduziert und Konsistenz über verschiedene Umgebungen hinweg gewährleistet.
Anwendungsfälle
Automatisierung von App-Asset-Updates
Verwaltung versionierter Installationsdateien
Synchronisieren lokaler Builds mit Remote-Releases
CI/CD-Pipelines optimieren
Konfigurationsdateien nach der Bereitstellung aktualisieren
Hauptmerkmale
Automatische Dateiersetzung
Remote-Quell-Integration
Plattformübergreifende Unterstützung
Einfacher CLI-Befehl
Versionsbewusste Aktualisierungen
Geeignet für
Entwickler, die häufige App-Updates verwalten
Teams, die automatisierte Bereitstellungsworkflows verwenden
Projekte mit verteilten Build-Artefakten
CI/CD-Pipeline-Integrationen
Apps, die lokale Dateisynchronisierung erfordern
Hinweise
Benötigt Netzwerkzugriff für Updates
Manuelle Einrichtung für die Konfiguration einer Remote-Quelle
Beschränkt auf lokale Verzeichnisaktualisierungen
Nicht für Laufzeit-App-Updates vorgesehen
Abhängig von der Verfügbarkeit einer externen Datei
Original-README
Originaler README-Schnappschuss aus dem verknüpften Quell-Repository. Aktuelle Inhalte finden Sie im Repository.
release_updater
This package brings a simple way to automatically update release/installation files in a local directory.
It also comes with built-in CLI tools to easily generate a release bundle (Zip file) or
serve release files for multiple platforms.
Motivation
Since Dart can run in many native platforms (Linux/x64, macOS/x64/arm64, Windows/x86),
it's not simple to manage all the different releases+platforms files that a
compiled Dart application can have.
In the same way that modern Browsers, and many other applications,
can have automatic builds and updates for multiple platforms, this package
provides tools and an API to easily achieve that.
API Documentation
See the API Documentation for a full list of functions, classes and extension.
Usage
import'dart:io';
import'package:release_updater/release_updater_io.dart';
voidmain() async {
var storage = ReleaseStorageDirectory('appx', Directory('/install/path'));
var provider = ReleaseProviderHttp.baseURL('https://your.domain/appx/releases');
var releaseUpdater = ReleaseUpdater(storage, provider);
var version = await releaseUpdater.update();
print('» Updated to version: $version');
var runResult = await releaseUpdater.runReleaseProcess('run.exe', ['-a']);
var exitCode = runResult!.exitCode;
print('» Exit code: $exitCode');
print('» Result: ${runResult.stdout}');
exit(exitCode);
}
ReleaseProvider
You can implement your own ReleaseProvider or use just the built-in ReleaseProviderHttp class.
CLI Tools
release_updater: A CLI updater.
release_updater_server: A simple HTTP server to provide releases using the shelf package.
version_from: the JSON or YAML file to provide the field version (if the parameter field is not provided).
platform: is a RegExp string to match the building platform. See the ReleasePlatform class.
Command types:
dart_pub_get: performs a dart pub get.
dart_compile_exe: performs a dart compile exe %dart_script.
dart: performs a dart %command.
windows_gui: Changes an executable Windows Subsistem to GUI.
command: performs a shell %command.
rm: Deletes a file.
upload_release: uploads the generated release.
url: release server base URL.
authorization: HTTP basic authorization.
username: authentication username.
password: authentication password.
Command errors:
A command that fails aborts the build: the error is logged, the
remaining commands are NOT executed, and the release_packer CLI
exits with code 1. This avoids a silent error generating and
releasing an incomplete package/artifact.
Some commands are just ignored (skipped) when not applicable, and do
NOT abort the build:
rm of a file that doesn't exist.
windows_gui over a file that is not a Windows executable (the usual
case when building on another platform).
files: each entry of files can be:
A String with a file path:
"file/path.txt"
A Map with extra parameters:
A file with a renamed path and a specific platform.