¿Cómo funciona PyInstaller?
Primero de todo, la forma en la que Pyinstaller crea el ejecutable es mediante un procedimeinto conocido como freezing (congelado). A grandes rasgos, lo que hace es empaquetar el interprete de Python, las bibliotecas necesarias, tu aplicación y todos los recursos (imágenes, archivos de datos, etc) de forma que pueda ejecutarse en otro sistema sin el intérprete y las dependencias instaladas.
Al crear un ejecutable con la opción --onefile
todo se empaqueta en un solo archivo comprimido junto a un bootloader. Cuando se ejecuta, el bootloader crea una carpeta temporal llamada _MEIxxxxxx
en la localización que el sistema operativo provee para ello (donde xxxxxx es un número aleatorio) y descomprime todo en ella.
Resolver rutas adecuadamente
Cuando se crea un ejecutable de esta forma, las rutas a los archivos externos que nuestra app usa quedan obviamente rotas. No obstante el bootloader también almacena en sys._MEIPASS
la ruta absoluta a la carpeta temporal creada (en el caso de --onefile
). Ver Run Time Information (PyInstaller Doc).
Por lo tanto, debemos resolver la ruta de forma dinámica en tiempo de ejecución en base a sys._MEIPASS
. Si queremos que la ruta se resuelva también adecuadamente cuando la app no se ejecuta desde el ejecutable de PyInstaller, por ejemplo cuando la ejecutamos localmente mientras la desarrollamos, debemos adaptar la ruta para cada caso. Típicamente esto se hace creando una función global para procesar las rutas a los recursos de la aplicación, por ejemplo (tomada de esta respuesta en SO):
import sys
import os
def get_resource_path(relative_path):
base_path = getattr(sys, '_MEIPASS', os.path.dirname(os.path.abspath(__file__)))
return os.path.join(base_path, relative_path)
Especificar a PyInstaller que recursos debe incluir
Además de resolver la ruta de forma adecuada a un recurso, se debe indicar a PyIstaller que archivos debe incluir en el ejecutable. Esto lo puedes hacer de dos formas:
Por ejemplo, imaginemos que tenemos esta estructura de archivos:
test
|_app.py
|_resources
|_python.png
con nuestro script app.py
:
import sys
import os
import tkinter as tk
def get_resource_path(relative_path):
base_path = getattr(sys, '_MEIPASS', os.path.dirname(os.path.abspath(__file__)))
return os.path.join(base_path, relative_path)
root = tk.Tk()
img = tk.PhotoImage(file=get_resource_path('resources/python.png'))
tk.Label(root, image=img).pack()
root.mainloop()
Creamos el ejecutable con:
$ cd ruta/a/carpeta/test
$ pyinstaller app.py --add-data="./resources/python.png:./resources" --onefile
o si queremos simplemente añadir todo el contenido de la carpata resources
:
$ pyinstaller app.py --add-data="./resources:./resources" --onefile