PyInstalleri käivituskrahhi parandamine Kivy rakenduses Python 3.10 abil

PyInstalleriga loodud Kivy rakenduste käivituskrahhide mõistmine

Kivy rakenduse loomine PyInstalleri abil on levinud lähenemisviis Pythoni rakenduste pakkimiseks eraldiseisvateks käivitatavateks failideks. Kuid hoolimata edukast koostamisprotsessist kogevad arendajad pakendatud rakenduse käivitamisel mõnikord ootamatuid krahhi. See probleem võib olla eriti masendav, kui üksikasjalikku veateadet ei esitata.

Sel juhul töötab rakendus arenduskeskkonnas, näiteks PyCharmis, suurepäraselt, kuid PyInstalleri abil pakkimisel ebaõnnestub. Sõltuvuste, nagu Kivy 2.3.0, Python 3.10 ja teekide, nagu numpy, scipy ja pandas, puhul muutub krahhi allika tuvastamine probleemi lahendamisel kriitiliseks.

Vead nagu "ootamatu viga", millel pole selget jälge, viitavad sageli puuduvatele sõltuvustele, valedele SPEC-failide konfiguratsioonidele või virtuaalse keskkonna ebakõladele. Arvestades, kui oluline on tagada, et kõik vajalikud failid oleksid õigesti komplekteeritud, on PyInstaller SPEC-faili ja käitusaja sõltuvuste ülevaatamine ülioluline samm.

Selles artiklis uuritakse krahhi võimalikke põhjuseid, keskendudes teie SPEC-faili täiustamisele, peidetud importimise haldamisele ja selle tagamisele, et vajalikke Kivy sõltuvusi käsitletakse ehitusprotsessi ajal õigesti.

Kivy rakenduse käivitusvigade tõrkeotsing PyInstalleriga

Ülaltoodud skriptid on keskendunud väga spetsiifilise probleemi lahendamisele: PyInstalleri abil loodud rakendus Kivy jookseb käivitamisel kokku ootamatu veaga. Esimene skript käsitleb võimalikku puudujäägi probleemi varjatud import. See on PyInstalleri kasutamisel tavaline probleem, kuna see ei tuvasta automaatselt kõiki sõltuvusi, eriti selliseid teeke nagu tuim, pandad, või scipy. Määrates need peidetud impordid käsitsi jaotises Analüüs SPEC-faili jaotises tagame, et PyInstaller komplekteerib kõik vajalikud moodulid, vältides rakenduse kokkujooksmist puuduvate komponentide tõttu.

Teine oluline samm skripti on kaasamine puu () aastal KOGUDA faas. See käsk tagab, et Kivyga seotud rakenduse sõltuvused, nagu SDL2 ja GLEW teegid, on järgus õigesti kaasatud. Need on rakenduse graafilise liidese renderdamiseks hädavajalikud. Kui neid faile ei kaasata, ei tööta rakendus Kivy korralikult, kuigi koostamisprotsess lõpeb vigadeta. Nende binaarfailide kaasamise tagamine aitab vältida puuduvate graafika- või helikomponentidega seotud käitusaegseid probleeme.

Skript käsitleb ka väliste failide, näiteks loodud JSON-failide kaasamist Json Store Kivys. Kuigi see JSON-fail genereeritakse käitusajal, on ülioluline tagada, et seda pakkimisprotsessi ajal õigesti käsitletaks. The andmed argument aastal Analüüs funktsioon võimaldab meil selle faili selgesõnaliselt komplekteeritud rakendusse kaasata. Seda tehes väldime viga, kus rakendus jookseb lähtestamise ajal puuduvate väliste andmefailide tõttu kokku.

Lõpuks näeme ka UPX-i tihendamise kasutamist ja riba valik. UPX-i tihendamist kasutatakse komplekteeritud rakenduse suuruse vähendamiseks, muutes levitamise lihtsamaks. Kuid UPX-i lubamine põhjustab mõnikord ühilduvusprobleeme, mistõttu see on seotud strip=Vale et vältida silumissümbolite eemaldamist kahendfailidest. Silumissümboleid säilitades saame paremini jälgida käitusaegsete kokkujooksmiste või vigade põhjuseid. Akende jälgimise keelamine on veel üks konfiguratsioon, mis aitab probleeme diagnoosida, kuna see võimaldab konsoolis kuvada veateateid, mis annavad ülevaate võimalikest probleemidest käivitamisel.

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

PyInstalleri optimeerimine Kivy rakenduste jaoks käivitamisvigade vältimiseks

PyInstalleri ja Kivyga töötades on üks peamisi aspekte, mida tuleb arvesse võtta, väliste sõltuvuste ja teekide haldamine. PyInstalleri vaikekäitumine jätab mõnikord kahe silma vahele teatud teegid või failid, eriti kui töötate keerukamate seadistustega, nagu virtuaalsed keskkonnad või teaduslikud raamatukogud, näiteks tuim ja pandad. Tagada, et kõik peidetud impordid on dokumendis täpsustatud hiddenimports parameeter on kriitiline. Lisaks ei pruugi PyInstaller automaatselt sisaldada graafilisi ja multimeediumisõltuvusi, näiteks neid, mis pärinevad sdl2 või glew, mis mõlemad on Kivy rakenduste jaoks hädavajalikud.

Teine aspekt, mida arendajad sageli kahe silma vahele jätavad, on seotud virtuaalsete keskkondadega. Kivy rakenduse loomisel PyInstalleri abil virtuaalses keskkonnas on oluline tagada, et kõik sõltuvused oleksid õigesti komplekteeritud. See hõlmab reguleerimist pathex seadistus, mis osutab õigetele kataloogidele, kuhu teegid on installitud. Kui seda ei tehta, võib pakendatud rakendus arenduskeskkonnas hästi töötada, kuid tootmises käivitamisel kokku jookseb. Seda probleemi saab sageli vältida, kui uurite täielikult ehituskonfiguratsiooni ja veenduge, et kõik teed ja sõltuvused on õiged.

Lõpuks on ressursside, nagu piltide, fondide ja andmefailide õige käsitsemine ülioluline ootamatute käivitusvigade ärahoidmisel. Kivy rakendustes on sageli vaja väliseid ressursse ja kui need pole PyInstalleris selgesõnaliselt kaasatud datas jaotises, võib rakendus puuduvatele failidele juurde pääsemisel lähtestamise ajal kokku kukkuda. Oluline on kontrollida, kas kõik failid, mida rakendus vajab käitamise ajal, on lõplikus järgus õigesti kaasatud.