Última actualización: 04 de diciembre de 2023

8.4. Distribución nativa

A menudo, necesitarás compartir tu aplicación con muchos usuarios. Más adelante deberás actualizar la aplicación y querrás asegurarte de que puedes hacerlo de forma que tus usuarios no técnicos no tengan problemas y que sea fácil para ti.

A diferencia de la distribución binaria, la distribución nativa se refiere a al instalador nativo al sistema operativo. Este instalador pudiera o no, incluir un archivo binario que compile todo el software generado en sus proyecto, incluir las dependencias de las librerías externas a la librería estándar de Python.

A continuación se presentan algunos casos librerías que pueden cumplir con esta función:

8.4.1. Paquete auto-py-to-exe

El paquete auto-py-to-exe le permite convertir archivos .py a archivos .exe usando una simple interfaz gráfica de usuario para sistemas operativos Windows/Mac OS X.

A continuación el siguiente comando le permite instalarlo:

> pip install auto-py-to-exe

Para ejecutar el programa, ejecute el siguiente comando:

> .\auto-py-to-exe.exe

Al ejecutar el comando previo, debe mostrarle la siguiente interfaz de usuario.

Aquí puede definir lo siguiente:

  • Elegir si es un archivo o un directorio.

  • Elegir si se ejecuta por consola de comando básica o por consola de Windows (Ocultar consola).

  • Elegir si personaliza el icono de la aplicación.

  • Elegir si incluye archivos de data.

  • Elegir la configuración avanzada.

auto-py-to-exe con la interfaz vacía.

Figura 8.2, Figura 8.2, auto-py-to-exe con la interfaz vacía.

Seguidamente rellene la interfaz indicando el modulo python que requiere generarle el instalador, y personalice los parámetros su necesidad.

auto-py-to-exe con la interfaz configurada.

Figura 8.3, Figura 8.3, auto-py-to-exe con la interfaz configurada.

Aquí puede definir lo siguiente:

  • Elegir si incluye archivos de data.

  • Elegir si incluye directorio de de la aplicación.

  • Elegir opciones avanzadas:

    • Opciones generales.

    • Que debe agrupar, donde lo debe buscar.

    • Como generar el .exe

    • Opciones especificas de Windows/Mac OS X.

    • Opciones especificas de Windows.

    • Opciones de búsqueda de ensamblaje en paralelo para Windows (avanzadas).

    • Opciones especificas de Mac OS X.

    • Opciones especiales raramente usadas.

    • Otros argumentos.

Luego después de configurar la interfaz, presione el botón Convert .py to .exe

auto-py-to-exe ejecutando la conversion.

Figura 8.4, Figura 8.4, auto-py-to-exe ejecutando la conversion.

El ejecutar el proceso de conversion se realizan varias tareas para generar el .exe

auto-py-to-exe completo el proceso de la conversion.

Figura 8.5, Figura 8.5, auto-py-to-exe completo el proceso de la conversion.

Al finalizar el proceso de la conversion, le indica el resultado de la tarea, si presiona el botón «Open Output Folder» accedes al directorio de generación del archivo .exe.

8.4.2. Paquete pyinstaller

El paquete pyinstaller le permite agrupar una aplicación de Python y todas sus dependencias en un solo paquete.

Para instalar el paquete pyinstaller se presenta el correspondiente comando de tu sistema operativo:

$ pip install pyinstaller

Para probar el funcionamiento del paquete pyinstaller requiere un modulo Python que convertir a nativo, para esto cree un modulo con el nombre hello.py con el siguiente código fuente:

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
 
from threading import Timer
from time import sleep


def hello():
    print("Hola mundo\n\n\tEste es un ejemplo de una distribución nativa\n")
    sleep(2)


tiempo = Timer(0.05, hello)
# Después de 0.05 segundos, el mensaje de la función hello sera mostrada
tiempo.start()

Este modulo usa las librerías threading y time para pausar la ejecución del modulo en dos veces distintas, asi poder apreciar el mensaje que se muestra por la linea de comando.

A continuación se explica la genera de la distribución binara para plataformas Windows y Linux:

8.4.2.1. Plataforma Windows

Para generar la distribución nativa del modulo hello.py para plataformas Windows, ejecute el siguiente comando:

> pyinstaller.exe --onefile hello.py

El comando anterior muestra la siguiente salida en la consola de comando:

5392 INFO: PyInstaller: 5.6.2
5393 INFO: Python: 3.9.13 (conda)
5416 INFO: Platform: Windows-10-10.0.19045-SP0
5417 INFO: wrote C:\Users\Macagua\AppData\Roaming\Python\Python39\Scripts\hello.spec
5463 INFO: UPX is not available.
5475 INFO: Extending PYTHONPATH with paths
['C:\\Users\\Macagua\\AppData\\Roaming\\Python\\Python39\\Scripts']
9994 INFO: checking Analysis
9994 INFO: Building Analysis because Analysis-00.toc is non existent
9995 INFO: Initializing module dependency graph...
10008 INFO: Caching module graph hooks...
10273 INFO: Analyzing base_library.zip ...
29637 INFO: Loading module hook 'hook-encodings.py' from 'C:\\Users\\Macagua\\AppData\\Roaming\\Python\\Python39\\site-packages\\PyInstaller\\hooks'...
38757 INFO: Loading module hook 'hook-pickle.py' from 'C:\\Users\\Macagua\\AppData\\Roaming\\Python\\Python39\\site-packages\\PyInstaller\\hooks'...
41365 INFO: Loading module hook 'hook-heapq.py' from 'C:\\Users\\Macagua\\AppData\\Roaming\\Python\\Python39\\site-packages\\PyInstaller\\hooks'...
45568 INFO: Caching module dependency graph...
45922 INFO: running Analysis Analysis-00.toc
46022 INFO: Adding Microsoft.Windows.Common-Controls to dependent assemblies of final executable
required by C:\ProgramData\Anaconda3\python.exe
47305 INFO: Analyzing C:\Users\Macagua\AppData\Roaming\Python\Python39\Scripts\hello.py
47305 INFO: Processing module hooks...
47336 INFO: Looking for ctypes DLLs
47336 INFO: Analyzing run-time hooks ...
47336 INFO: Including run-time hook 'C:\\Users\\Macagua\\AppData\\Roaming\\Python\\Python39\\site-packages\\PyInstaller\\hooks\\rthooks\\pyi_rth_subprocess.py'
47400 INFO: Looking for dynamic libraries
5334 INFO: Extra DLL search directories (AddDllDirectory): []
5335 INFO: Extra DLL search directories (PATH): ['C:\\Program Files (x86)\\Common Files\\Oracle\\Java\\javapath', 'C:\\Windows\\system32', 'C:\\Windows', 'C:\\Windows\\System32\\Wbem', 'C:\\Windows\\System32\\WindowsPowerShell\\v1.0\\', 'C:\\Windows\\System32\\OpenSSH\\', 'C:\\Program Files\\Microsoft VS Code\\bin', 'C:\\Program Files\\Git\\cmd', 'C:\\Program Files\\PuTTY\\', 'C:\\Program Files\\Meld\\', 'C:\\Users\\Macagua\\AppData\\Local\\Microsoft\\WindowsApps', 'C:\\ProgramData\\Anaconda3', 'C:\\ProgramData\\Anaconda3\\Scripts', 'C:\\ProgramData\\Anaconda3\\Library\\bin', 'C:\\ProgramData\\Anaconda3\\Library\\usr\\bin']
54417 INFO: Looking for eggs
54417 INFO: Using Python library C:\ProgramData\Anaconda3\python39.dll
54417 INFO: Found binding redirects:
[]
54432 INFO: Warnings written to C:\Users\Macagua\AppData\Roaming\Python\Python39\Scripts\build\hello\warn-hello.txt
54508 INFO: Graph cross-reference written to C:\Users\Macagua\AppData\Roaming\Python\Python39\Scripts\build\hello\xref-hello.html
54614 INFO: checking PYZ
54614 INFO: Building PYZ because PYZ-00.toc is non existent
54629 INFO: Building PYZ (ZlibArchive) C:\Users\Macagua\AppData\Roaming\Python\Python39\Scripts\build\hello\PYZ-00.pyz
55203 INFO: Building PYZ (ZlibArchive) C:\Users\Macagua\AppData\Roaming\Python\Python39\Scripts\build\hello\PYZ-00.pyz completed successfully.
55218 INFO: checking PKG
55218 INFO: Building PKG because PKG-00.toc is non existent
55218 INFO: Building PKG (CArchive) hello.pkg
60512 INFO: Building PKG (CArchive) hello.pkg completed successfully.
60517 INFO: Bootloader C:\Users\Macagua\AppData\Roaming\Python\Python39\site-packages\PyInstaller\bootloader\Windows-64bit\run.exe
60517 INFO: checking EXE
60518 INFO: Building EXE because EXE-00.toc is non existent
60519 INFO: Building EXE from EXE-00.toc
60540 INFO: Copying bootloader EXE to C:\Users\Macagua\AppData\Roaming\Python\Python39\Scripts\dist\hello.exe.notanexecutable
61087 INFO: Copying icon to EXE
61141 INFO: Copying icons from ['C:\\Users\\Macagua\\AppData\\Roaming\\Python\\Python39\\site-packages\\PyInstaller\\bootloader\\images\\icon-console.ico']
61257 INFO: Writing RT_GROUP_ICON 0 resource with 104 bytes
61257 INFO: Writing RT_ICON 1 resource with 3752 bytes
61259 INFO: Writing RT_ICON 2 resource with 2216 bytes
61261 INFO: Writing RT_ICON 3 resource with 1384 bytes
61262 INFO: Writing RT_ICON 4 resource with 37019 bytes
61265 INFO: Writing RT_ICON 5 resource with 9640 bytes
61266 INFO: Writing RT_ICON 6 resource with 4264 bytes
61266 INFO: Writing RT_ICON 7 resource with 1128 bytes
61272 INFO: Copying 0 resources to EXE
61273 INFO: Embedding manifest in EXE
61275 INFO: Updating manifest in C:\Users\Macagua\AppData\Roaming\Python\Python39\Scripts\dist\hello.exe.notanexecutable
61415 INFO: Updating resource type 24 name 1 language 0
61421 INFO: Appending PKG archive to EXE
61438 INFO: Fixing EXE headers
64723 INFO: Building EXE from EXE-00.toc completed successfully.

De esta forma genera dentro de la carpeta dist la distribución binaria hello.exe del modulo hello.py.

distribución binaria hello.exe generada.

Figura 8.6, Figura 8.6, distribución binaria hello.exe generada.

Puede ejecutar distribución binaria hello.exe generada, el cual mostrara la siguiente pantalla.

distribución binaria hello.exe ejecutada.

Figura 8.7, Figura 8.7, distribución binaria hello.exe ejecutada.

Asi de esta forma genera una distribución nativa para plataformas Windows.

8.4.2.2. Plataforma Linux

Para generar la distribución nativa del modulo hello.py para plataformas Linux, ejecute el siguiente comando:

$ pyinstaller --onefile hello.py

Asi de esta forma genera una distribución nativa para plataformas Linux.

Ver también

Consulte la sección de lecturas suplementarias del entrenamiento para ampliar su conocimiento en esta temática.

¿Cómo puedo ayudar?

¡Mi soporte está aquí para ayudar!

Mi horario de oficina es de lunes a sábado, de 9 AM a 5 PM. GMT-4 - Caracas, Venezuela.

La hora aquí es actualmente 7:35 PM GMT-4.

Mi objetivo es responder a todos los mensajes dentro de un día hábil.

Contáctenos en la sección de soporte
Contrata mi increíble soporte profesional