Orientação gerada a partir de informações públicas. Apenas para referência.
release_updater é um pacote Flutter/Dart que simplifica o processo de atualização automática de arquivos de lançamento ou instalação em um diretório local. Ele permite que desenvolvedores gerenciem ativos com versão, como binários do aplicativo ou arquivos de configuração, buscando e substituindo-os a partir de uma fonte remota. Ideal para aplicativos que exigem atualizações frequentes sem reinstalação completa, suporta múltiplas plataformas, incluindo Android, iOS, macOS, Windows e Linux. O pacote simplifica fluxos de implantação ao reduzir a gestão manual de arquivos e garantir consistência entre ambientes.
Casos de uso
Automatizando atualizações de ativos do aplicativo
Gerenciando arquivos de instalação com versão
Sincronizando builds locais com lançamentos remotos
Simplificando pipelines de CI/CD
Atualizando arquivos de configuração após o deploy
Principais recursos
Substituição automática de arquivos
Integração de fonte remota
Suporte multiplataforma
Comando simples de CLI
Atualizações conscientes da versão
Indicado para
Desenvolvedores gerenciando atualizações frequentes de aplicativos
Equipes usando fluxos de trabalho de implantação automatizados
Projetos com artefatos de construção distribuídos
integrações de pipeline CI/CD
Aplicativos que exigem sincronização de arquivos locais
Considerações
Requer acesso à rede para atualizações
Configuração manual para fonte remota
Limitado a atualizações do diretório local
Não destinado a atualizações de aplicativos em tempo de execução
Depende da disponibilidade de arquivo externo
README original
Snapshot do README original do repositório-fonte vinculado. Consulte o repositório para o conteúdo mais recente.
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.