Odpravljanje zrušitve ob zagonu PyInstaller v aplikaciji Kivy z uporabo Python 3.10

Razumevanje zrušitev ob zagonu v aplikacijah Kivy, zgrajenih s PyInstaller

Izdelava aplikacije Kivy z uporabo PyInstallerja je običajen pristop za pakiranje aplikacij Python v samostojne izvršljive datoteke. Vendar kljub uspešnemu procesu gradnje razvijalci včasih naletijo na nepričakovane zrušitve pri zagonu pakirane aplikacije. Ta težava je lahko še posebej moteča, če ni na voljo podrobnega sporočila o napaki.

V tem primeru aplikacija deluje brezhibno v razvojnem okolju, kot je PyCharm, vendar ne uspe pri pakiranju s PyInstallerjem. Z odvisnostmi, kot so Kivy 2.3.0, Python 3.10, in knjižnicami, kot so numpy, scipy in pandas, postane prepoznavanje vira zrušitve ključnega pomena za rešitev težave.

Napake, kot je "nepričakovana napaka" brez jasne sledi, pogosto kažejo na manjkajoče odvisnosti, nepravilne konfiguracije datotek SPEC ali nedoslednosti navideznega okolja. Glede na to, kako pomembno je zagotoviti, da so vse potrebne datoteke pravilno združene, je pregled datoteke PyInstaller SPEC in odvisnosti od izvajalnega okolja ključni korak.

Ta članek raziskuje možne vzroke za zrušitev, pri čemer se osredotoča na izboljšanje vaše datoteke SPEC, upravljanje skritih uvozov in zagotavljanje pravilne obravnave potrebnih odvisnosti Kivy med gradnjo.

Odpravljanje napak pri zagonu aplikacije Kivy s programom PyInstaller

Zgoraj navedeni skripti so osredotočeni na reševanje zelo specifične težave: aplikacija Kivy, izdelana z uporabo PyInstaller, se ob zagonu zruši z "nepričakovano napako". Prvi skript obravnava morebitno težavo z manjkanjem skritega uvoza. To je pogosta težava pri uporabi PyInstallerja, saj ne zazna samodejno vseh odvisnosti, zlasti knjižnic, kot je numpy, pande, oz scipy. Z ročnim podajanjem teh skritih uvozov v Analiza v razdelku datoteke SPEC zagotovimo, da PyInstaller združi vse potrebne module in prepreči, da bi se aplikacija zrušila zaradi manjkajočih komponent.

Drugi pomemben korak v scenariju je vključitev Drevo () v ZBIRAJ faza. Ta ukaz zagotavlja, da so odvisnosti aplikacije, povezane s Kivy, kot sta knjižnici SDL2 in GLEW, pravilno vključene v gradnjo. Ti so bistveni za upodabljanje grafičnega vmesnika aplikacije. Če te datoteke niso vključene, se aplikacija Kivy ne bo pravilno zagnala, čeprav se postopek gradnje konča brez napak. Če zagotovite, da so te dvojiške datoteke vključene, se izognete težavam med izvajanjem, povezanim z manjkajočimi grafičnimi ali zvočnimi komponentami.

Skript obravnava tudi vključitev zunanjih datotek, kot je datoteka JSON, ki jo ustvari JsonStore v Kivyju. Medtem ko je ta datoteka JSON ustvarjena med izvajanjem, je ključnega pomena zagotoviti, da se z njo pravilno ravna med postopkom pakiranja. The podatki argument v Analiza omogoča, da to datoteko izrecno vključimo v priloženo aplikacijo. S tem se izognemo napaki, ko se aplikacija zruši zaradi manjkajočih zunanjih podatkovnih datotek med inicializacijo.

Na koncu vidimo tudi uporabo stiskanja UPX in trak možnost. Stiskanje UPX se uporablja za zmanjšanje velikosti priložene aplikacije, kar olajša distribucijo. Vendar pa omogočanje UPX včasih povzroči težave z združljivostjo, zato je seznanjen z strip=False da se izognete odstranjevanju simbolov za odpravljanje napak iz binarnih datotek. Če ohranimo simbole za odpravljanje napak, lahko bolje izsledimo vzrok morebitnih zrušitev ali napak med izvajanjem. Onemogočanje povratnega sledenja v oknu je še ena konfiguracija, ki pomaga pri diagnosticiranju težav, saj omogoča prikaz sporočil o napakah v konzoli, kar zagotavlja vpogled v morebitne težave ob zagonu.

# Step 1: Modify the SPEC file to include hidden imports manually
# Import necessary dependencies from Kivy, sdl2, and glew
from kivy_deps import sdl2, glew
# Add numpy, pandas, scipy to hidden imports manually
a = Analysis([r'path_to_your_app.py'],
             pathex=['.'],
             binaries=[],
             datas=[],
             hiddenimports=['numpy', 'pandas', 'scipy'],
             hookspath=[],
             runtime_hooks=[],
             excludes=[],
             noarchive=False)
# Add Tree() for all Kivy dependencies to the collect step
coll = COLLECT(exe, Tree('C:\\path_to_project'),
               a.binaries, a.zipfiles, a.datas,
               *[Tree(p) for p in (sdl2.dep_bins + glew.dep_bins)],
               strip=False, upx=True, name='Prototype')

# Step 2: Ensure that the generated JSON file from kivy.storage.jsonstore is included
from kivy.storage.jsonstore import JsonStore
# If JSONStore is used, manually add the JSON file to the build
store = JsonStore('data.json')
# Create the SPEC file to explicitly include the JSON data
datas=[('data.json', '.')],
a = Analysis([r'path_to_your_app.py'],
             pathex=['.'],
             binaries=[],
             datas=[('data.json', '.')],
             hiddenimports=[],
             hookspath=[],
             runtime_hooks=[],
             excludes=[],
             noarchive=False)
coll = COLLECT(exe, Tree('C:\\path_to_project'),
               a.binaries, a.zipfiles, a.datas,
               *[Tree(p) for p in (sdl2.dep_bins + glew.dep_bins)],
               strip=False, upx=True, name='Prototype')

Optimiziranje PyInstallerja za aplikacije Kivy za preprečevanje napak pri zagonu

Pri delu s PyInstallerjem in Kivyjem je treba upoštevati enega ključnih vidikov upravljanje zunanjih odvisnosti in knjižnic. Privzeto vedenje PyInstallerja včasih spregleda določene knjižnice ali datoteke, zlasti pri delu z bolj zapletenimi nastavitvami, kot so virtualna okolja ali znanstvene knjižnice, kot je npr. numpy in pande. Zagotavljanje, da so vsi skriti uvozi navedeni v hiddenimports parameter je kritičen. Poleg tega PyInstaller morda ne bo samodejno vključil grafičnih in večpredstavnostnih odvisnosti, kot so tiste iz sdl2 oz glew, ki sta bistvena za aplikacije Kivy.

Drugi vidik, ki ga razvijalci pogosto spregledajo, je povezan z virtualnimi okolji. Ko gradite aplikacijo Kivy z uporabo PyInstallerja v virtualnem okolju, je pomembno zagotoviti, da so vse odvisnosti pravilno združene. To vključuje prilagajanje pathex nastavitev, ki kaže na pravilne imenike, kjer so nameščene knjižnice. Če tega ne storite, lahko zapakirana aplikacija deluje dobro v razvojnem okolju, vendar se zruši ob zagonu v proizvodnji. Tej težavi se je pogosto mogoče izogniti tako, da v celoti pregledate konfiguracijo gradnje in zagotovite, da so vse poti in odvisnosti pravilne.

Nazadnje je pravilno ravnanje z viri, kot so slike, pisave in podatkovne datoteke, ključnega pomena za preprečevanje nepričakovanih napak pri zagonu. V aplikacijah Kivy so pogosto potrebni zunanji viri in če ti niso izrecno vključeni v PyInstaller datas se lahko aplikacija zruši med inicializacijo, ko poskuša dostopati do manjkajočih datotek. Bistveno je preveriti, ali so vse datoteke, ki jih aplikacija potrebuje med izvajanjem, pravilno vključene v končno gradnjo.