Primeros pasos: Python
Comienza con nuestra biblioteca de Python.
Instala velopack desde el Python Package Index:
pip install velopack
Agrega el siguiente código a tu punto de entrada (p. ej., main.py) lo antes posible (antes de cualquier otro código de inicio de la aplicación):
import velopack
if __name__ == "__main__":
# Velopack builder needs to be the first thing to run in the main process.
# In some cases, it might quit/restart the process to perform tasks.
velopack.App().run()
# ... your other app startup code here
Velopack proporciona una forma sencilla de buscar actualizaciones y aplicarlas. A continuación se muestra cómo implementar una verificación de actualizaciones básica dentro de tu aplicación.
También puedes separar los distintos métodos para permitir que tus usuarios controlen cuándo buscar actualizaciones, descargarlas o aplicarlas.
La URL que se pasa a UpdateManager apunta al lugar donde alojas tus actualizaciones (un servidor web, un bucket de S3, versiones de GitHub, etc.).
def update_app():
manager = velopack.UpdateManager("https://the.place/you-host/updates")
update_info = manager.check_for_updates()
if not update_info:
return # no updates available
# Download the updates, optionally providing progress callbacks
manager.download_updates(update_info)
# Apply the update and restart the app
manager.apply_updates_and_restart(update_info)
Compila tu aplicación en un binario (p. ej., .exe en Windows). Ejemplo usando PyInstaller:
pyinstaller --onedir app.py
Asegúrate de usar la salida --onedir (carpeta) de PyInstaller, no --onefile. Velopack empaqueta y actualiza un directorio de archivos, por lo que el ejecutable autoextraíble único producido por --onefile no es compatible.
Velopack usa una herramienta de línea de comandos llamada vpk para empaquetar y publicar versiones.
Se distribuye como una herramienta global de .NET. Aunque Velopack puede usarse con aplicaciones escritas en varios lenguajes, se requiere el SDK de .NET para instalar y ejecutar vpk.
Puedes instalar el SDK de .NET desde la página de descarga de .NET.
Una vez instalado .NET, puedes instalar vpk ejecutando:
dotnet tool install -g vpk
Se recomienda usar la misma versión de vpk que el paquete Velopack referenciado en tu aplicación para garantizar la compatibilidad.
Alternativamente, puedes ejecutar vpk sin instalarlo globalmente usando el comando dnx. Usa la sintaxis @<version> para fijar la versión de la herramienta vpk:
dnx vpk@1.0.0
Reemplaza 1.0.0 con la versión del paquete Velopack que estás usando en tu aplicación.
Ahora estás listo para crear una versión de Velopack para tu aplicación.
El --packId puede ser cualquier identificador de aplicación único que desees utilizar. Dado que debe ser único entre todas las aplicaciones, recomendamos incluir el nombre de tu empresa: <CompanyName>.<AppName>.
La opción --mainExe solo es necesaria si el nombre de tu ejecutable es diferente al --packId de tu aplicación.
Consulta la referencia de CLI para obtener más detalles sobre las opciones disponibles.
vpk pack --packId YourAppId --packVersion 1.0.0 --packDir .\publish --mainExe yourMainApp.exe
✅ ¡Listo! Tu aplicación ahora tiene actualizaciones automáticas y un instalador.
Puedes subir tu release a tu sitio web, o usar el comando vpk upload para publicarla en el destino que elijas.
También puedes consultar nuestras Aplicaciones de ejemplo para ver ejemplos completos que usan Velopack.