PyInstaller startēšanas avārijas novēršana lietotnē Kivy, izmantojot Python 3.10

Izpratne par startēšanas avārijām Kivy lietotnēs, kas izveidotas ar PyInstaller

Lietotnes Kivy izveide, izmantojot PyInstaller, ir izplatīta pieeja Python lietojumprogrammu iesaiņošanai atsevišķos izpildāmos failos. Tomēr, neskatoties uz veiksmīgu veidošanas procesu, izstrādātāji dažkārt saskaras ar negaidītām avārijām, palaižot iepakoto lietotni. Šī problēma var būt īpaši nomākta, ja netiek sniegts detalizēts kļūdas ziņojums.

Šajā gadījumā lietojumprogramma darbojas nevainojami izstrādes vidē, piemēram, PyCharm, bet neizdodas, ja iesaiņota, izmantojot PyInstaller. Izmantojot tādas atkarības kā Kivy 2.3.0, Python 3.10 un bibliotēkas, piemēram, numpy, scipy un pandas, avārijas avota noteikšana kļūst ļoti svarīga problēmas risināšanai.

Kļūdas, piemēram, "negaidīta kļūda" bez skaidrām pēdām, bieži norāda uz trūkstošām atkarībām, nepareizām SPEC failu konfigurācijām vai virtuālās vides neatbilstībām. Ņemot vērā to, cik svarīgi ir nodrošināt, lai visi nepieciešamie faili būtu pareizi apvienoti, PyInstaller SPEC faila un izpildlaika atkarību pārskatīšana ir ļoti svarīgs solis.

Šajā rakstā ir apskatīti iespējamie avārijas cēloņi, koncentrējoties uz SPEC faila uzlabošanu, slēpto importu pārvaldību un vajadzīgās Kivy atkarību pareizas darbības nodrošināšanai veidošanas procesa laikā.

Kivy App startēšanas kļūdu novēršana, izmantojot PyInstaller

Iepriekš sniegtie skripti ir vērsti uz ļoti specifiskas problēmas risināšanu: lietotne Kivy, kas izveidota, izmantojot PyInstaller, startēšanas laikā avarē ar "negaidītu kļūdu". Pirmais skripts pievēršas iespējamai problēmai ar pazušanu slēptais imports. Šī ir izplatīta problēma, izmantojot PyInstaller, jo tā automātiski neatklāj visas atkarības, īpaši tādas bibliotēkas kā nejutīgs, pandas, vai scipy. Manuāli norādot šos slēptos importus sadaļā Analīze SPEC faila sadaļā mēs nodrošinām, ka PyInstaller apvieno visus nepieciešamos moduļus, novēršot lietotnes avāriju trūkstošu komponentu dēļ.

Otrais svarīgais solis skriptā ir iekļaušana koks () sadaļā VĀC fāze. Šī komanda nodrošina, ka ar Kivy saistītās lietotnes atkarības, piemēram, SDL2 un GLEW bibliotēkas, ir pareizi iekļautas būvniecībā. Tie ir būtiski, lai renderētu lietotnes grafisko interfeisu. Ja šie faili nav iekļauti, lietotne Kivy nedarbosies pareizi, lai gan veidošanas process tiek pabeigts bez kļūdām. Šo bināro failu iekļaušanas nodrošināšana palīdz izvairīties no izpildlaika problēmām, kas saistītas ar trūkstošām grafikas vai skaņas komponentiem.

Skripts attiecas arī uz ārējo failu iekļaušanu, piemēram, JSON failu, ko izveidojis JsonStore Kivijā. Lai gan šis JSON fails tiek ģenerēts izpildlaikā, ir ļoti svarīgi nodrošināt, lai tas tiktu pareizi apstrādāts iepakošanas procesā. The datiem arguments Analīze funkcija ļauj mums skaidri iekļaut šo failu komplektētajā lietotnē. Šādi rīkojoties, mēs izvairāmies no kļūdas, kad lietotne avarē, jo inicializācijas laikā trūkst ārējo datu failu.

Visbeidzot, mēs redzam arī UPX saspiešanas izmantošanu un sloksne opciju. UPX saspiešana tiek izmantota, lai samazinātu komplektētās lietojumprogrammas lielumu, atvieglojot izplatīšanu. Tomēr UPX iespējošana dažkārt rada saderības problēmas, tāpēc tas ir savienots pārī strip=False lai izvairītos no atkļūdošanas simbolu noņemšanas no binārajiem failiem. Saglabājot atkļūdošanas simbolus, mēs varam labāk izsekot avāriju vai kļūdu cēloni izpildlaikā. Logu izsekošanas atspējošana ir vēl viena konfigurācija, kas palīdz diagnosticēt problēmas, jo tā ļauj konsolē parādīties kļūdu ziņojumiem, sniedzot ieskatu par iespējamām problēmām startēšanas laikā.

# 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')

PyInstaller optimizēšana Kivy Apps, lai novērstu startēšanas kļūdas

Strādājot ar PyInstaller un Kivy, viens no galvenajiem aspektiem, kas jāņem vērā, ir ārējo atkarību un bibliotēku pārvaldība. PyInstaller noklusējuma darbība dažkārt ignorē noteiktas bibliotēkas vai failus, it īpaši, strādājot ar sarežģītākiem iestatījumiem, piemēram, virtuālo vidi vai zinātniskām bibliotēkām, piemēram, nejutīgs un pandas. Nodrošinot, ka visi slēptie importi ir norādīti hiddenimports parametrs ir kritisks. Turklāt PyInstaller var automātiski neiekļaut grafiskās un multivides atkarības, piemēram, no sdl2 vai glew, kas abi ir būtiski Kivy lietotnēm.

Vēl viens aspekts, ko izstrādātāji bieži aizmirst, ir saistīts ar virtuālo vidi. Veidojot Kivy lietotni, izmantojot PyInstaller virtuālajā vidē, ir svarīgi nodrošināt, lai visas atkarības būtu pareizi sagrupētas. Tas ietver regulēšanu pathex iestatījumu, lai norādītu uz pareizajiem direktorijiem, kuros ir instalētas bibliotēkas. Ja tas netiks izdarīts, iepakotā lietotne var darboties labi izstrādes vidē, bet avarēs, startējot ražošanā. No šīs problēmas bieži var izvairīties, pilnībā pārbaudot būvējuma konfigurāciju un nodrošinot, ka visi ceļi un atkarības ir pareizi.

Visbeidzot, pareiza resursu, piemēram, attēlu, fontu un datu failu apstrāde ir ļoti svarīga, lai novērstu neparedzētas startēšanas kļūdas. Kivy lietotnēs bieži ir nepieciešami ārēji resursi, un, ja tie nav skaidri iekļauti PyInstaller datas sadaļā, programma var avarēt inicializācijas laikā, mēģinot piekļūt trūkstošajiem failiem. Ir svarīgi pārbaudīt, vai visi faili, kas nepieciešami lietojumprogrammai izpildlaikā, ir pareizi iekļauti galīgajā versijā.