PyInstaller-käynnistyskaaman korjaaminen Kivy-sovelluksessa Python 3.10:n avulla

PyInstallerilla rakennetun Kivy-sovelluksien käynnistyksen kaatumiset

Kivy-sovelluksen rakentaminen PyInstallerilla on yleinen lähestymistapa Python-sovellusten pakkaamiseen itsenäisiksi suoritettaviksi tiedostoiksi. Onnistuneesta rakennusprosessista huolimatta kehittäjät kohtaavat joskus odottamattomia kaatumisia käynnistäessään pakatun sovelluksen. Tämä ongelma voi olla erityisen turhauttava, jos yksityiskohtaista virheilmoitusta ei anneta.

Tässä tapauksessa sovellus toimii täydellisesti kehitysympäristössä, kuten PyCharm, mutta epäonnistuu, kun se on pakattu PyInstallerilla. Riippuvuuksien, kuten Kivy 2.3.0, Python 3.10, ja kirjastojen, kuten numpy, scipy ja pandas, ansiosta kaatumisen lähteen tunnistaminen on ratkaisevan tärkeää ongelman ratkaisemiseksi.

Virheet, kuten "odottamaton virhe", jossa ei ole selkeää jälkiä, viittaavat usein puuttuviin riippuvuuksiin, virheellisiin SPEC-tiedostokokoonpanoihin tai virtuaaliympäristön epäjohdonmukaisuuksiin. Koska on tärkeää varmistaa, että kaikki tarvittavat tiedostot on niputettu oikein, PyInstaller SPEC -tiedoston ja ajonaikaisten riippuvuuksien tarkistaminen on ratkaiseva askel.

Tässä artikkelissa tarkastellaan mahdollisia kaatumisen syitä keskittyen SPEC-tiedoston parantamiseen, piilotettujen tuontien hallintaan ja sen varmistamiseen, että tarvittavat Kivy-riippuvuudet käsitellään oikein rakennusprosessin aikana.

Komento	Esimerkki käytöstä
Analysis()	Tämä komento alustaa PyInstaller-analyysiprosessin ja määrittää, mikä Python-skripti niputetaan ja mistä riippuvuuksia etsitään. Se on välttämätöntä sovelluksen pakkaustavan määrittämiseksi, mukaan lukien piilotetut tuonnit ja ulkoiset tiedot, kuten binaarit ja JSON-tiedostot.
hiddenimports	Analysis():n sisällä oleva parametri, jota käytetään määrittämään manuaalisesti Python-paketit (esim. numpy, pandas jne.), joita PyInstaller ei välttämättä havaitse automaattisesti, mikä estää puuttuviin kirjastoihin liittyvät ajonaikaiset virheet.
Tree()	Tätä komentoa käytetään COLLECT-vaiheessa varmistamaan, että kokonaiset hakemistot, kuten sdl2.dep_bins ja glew.dep_bins, sisällytetään lopulliseen koontiversioon. Se varmistaa, että sovellus sisältää tarvittavat Kivy-riippuvuudet grafiikkaa ja ääntä varten.
COLLECT()	Kokoaa kaikki käännetyt tiedostot, binaarit ja riippuvuudet yhteen tuloshakemistoon. Se varmistaa, että kaikki resurssit, kirjastot ja tiedostot niputetaan oikein jakelua varten.
datas	Käytetään sisällyttämään tiettyjä tiedostoja (kuten luotu data.json) niputettuun sovellukseen. Tämä on tärkeää, kun työskentelet ulkoisten resurssien, kuten JsonStoren Kivy-sovelluksissa luomien JSON-tiedostojen, kanssa.
JsonStore()	Tietty Kivy-komento, jota käytetään tietojen tallentamiseen ja hallintaan JSON-muodossa. Kaikki luodut tiedostot on sisällytettävä nimenomaisesti PyInstaller-datakonfiguraatioon, jotta vältetään puuttuvat tiedostot pakkaamisen jälkeen.
upx=True	Tämä vaihtoehto mahdollistaa UPX-pakkauksen binääritiedostoille pakkausprosessin aikana. Vaikka se pienentää luodun suoritettavan tiedoston kokoa, se voi joskus aiheuttaa yhteensopivuusongelmia, joten se otetaan käyttöön varoen.
strip=False	Estää virheenkorjaussymbolien poistamisen binääritiedostoista. Se on hyödyllinen käynnistysongelmien diagnosoinnissa ja virheiden seurannassa ajon aikana, etenkin kun sovellus kaatuu minimaalisella virhetulolla.
bootloader_ignore_signals	Lippu, joka varmistaa, että PyInstallerin käynnistyslataaja jättää huomiotta käyttöjärjestelmän signaalit, kuten SIGTERM. Tämä voi estää sovelluksen ennenaikaisen sulkeutumisen käynnistyksen aikana, mikä voi olla yksi syy odottamattomiin kaatumisiin.

Kivy App -käynnistysvirheiden vianetsintä PyInstallerilla

Yllä annetut skriptit keskittyvät ratkaisemaan hyvin erityistä ongelmaa: PyInstallerilla rakennettu Kivy-sovellus kaatuu käynnistyksen yhteydessä "odottamattomalla virheellä". Ensimmäinen komentosarja puuttuu mahdolliseen ongelmaan . Tämä on yleinen ongelma käytettäessä PyInstalleria, koska se ei tunnista automaattisesti kaikkia riippuvuuksia, etenkään kirjastoja, kuten , , tai scipy. Määrittämällä nämä piilotetut tuonnit manuaalisesti SPEC-tiedoston osiossa varmistamme, että PyInstaller niputtaa kaikki tarvittavat moduulit, mikä estää sovellusta kaatumasta puuttuvien komponenttien vuoksi.

Toinen tärkeä vaihe käsikirjoituksessa on sisällyttäminen in vaihe. Tämä komento varmistaa, että Kivyyn liittyvät sovelluksen riippuvuudet, kuten SDL2- ja GLEW-kirjastot, sisällytetään oikein koontiversioon. Nämä ovat välttämättömiä sovelluksen graafisen käyttöliittymän renderöimiseksi. Jos näitä tiedostoja ei ole mukana, Kivy-sovellus ei toimi kunnolla, vaikka rakennusprosessi päättyy ilman virheitä. Näiden binäärien sisällyttämisen varmistaminen auttaa välttämään ajonaikaisia ​​ongelmia, jotka liittyvät puuttuviin grafiikkaan tai äänikomponentteihin.

Skripti käsittelee myös ulkoisten tiedostojen, kuten JSON-tiedoston, jonka on luonut Kivyssä. Vaikka tämä JSON-tiedosto luodaan suorituksen aikana, on erittäin tärkeää varmistaa, että sitä käsitellään oikein pakkausprosessin aikana. The argumentti -toiminnon avulla voimme sisällyttää tämän tiedoston nimenomaisesti mukana tulevaan sovellukseen. Näin vältämme virheen, jossa sovellus kaatuu, koska ulkoiset datatiedostot puuttuvat alustuksen aikana.

Lopuksi näemme myös UPX-pakkauksen käytön ja vaihtoehto. UPX-pakkausta käytetään niputetun sovelluksen koon pienentämiseen, mikä helpottaa jakelua. UPX:n käyttöönotto aiheuttaa kuitenkin joskus yhteensopivuusongelmia, minkä vuoksi se on yhdistetty välttääksesi virheenkorjaussymbolien poistamisen binääritiedostoista. Säilyttämällä virheenkorjaussymbolit voimme paremmin jäljittää kaatumisten tai virheiden syyt ajon aikana. Ikkunoidun jäljityksen poistaminen käytöstä on toinen määritys, joka auttaa ongelmien diagnosoinnissa, koska se mahdollistaa virheilmoitusten näyttämisen konsolissa, mikä antaa käsityksen mahdollisista ongelmista käynnistyksen yhteydessä.

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

PyInstallerin optimointi Kivy-sovelluksille käynnistysvirheiden estämiseksi

PyInstallerin ja Kivyn kanssa työskennellessä yksi keskeinen huomioitava näkökohta on ulkoisten riippuvuuksien ja kirjastojen hallinta. PyInstallerin oletuskäyttäytyminen jättää joskus huomiotta tietyt kirjastot tai tiedostot, varsinkin kun työskentelet monimutkaisempien asetusten, kuten virtuaaliympäristöjen tai tieteellisten kirjastojen, kuten esim. ja . Varmista, että kaikki piilotetut tuonnit on määritetty parametri on kriittinen. PyInstaller ei myöskään välttämättä sisällä automaattisesti graafisia ja multimediariippuvuuksia, kuten riippuvuuksia sdl2 tai , jotka molemmat ovat välttämättömiä Kivy-sovelluksille.

Toinen näkökohta, jonka kehittäjät usein jättävät huomiotta, liittyy virtuaaliympäristöihin. Kun rakennat Kivy-sovellusta PyInstallerilla virtuaaliympäristössä, on tärkeää varmistaa, että kaikki riippuvuudet niputetaan oikein. Tämä sisältää säätämisen -asetus osoittaa oikeisiin hakemistoihin, joihin kirjastot on asennettu. Jos näin ei tehdä, pakattu sovellus voi toimia hyvin kehitysympäristössä, mutta kaatua tuotannon käynnistyessä. Tämä ongelma voidaan usein välttää tutkimalla koontikokoonpanon perusteellisesti ja varmistamalla, että kaikki polut ja riippuvuudet ovat oikein.

Lopuksi resurssien, kuten kuvien, fonttien ja datatiedostojen, asianmukainen käsittely on ratkaisevan tärkeää odottamattomien käynnistysvirheiden estämisessä. Kivy-sovelluksissa tarvitaan usein ulkoisia resursseja, ja jos niitä ei ole erikseen sisällytetty PyInstalleriin -osiossa, sovellus saattaa kaatua alustuksen aikana yrittäessään käyttää puuttuvia tiedostoja. On tärkeää varmistaa, että kaikki sovelluksen suoritusaikana tarvitsemat tiedostot sisältyvät oikein lopulliseen koontiversioon.

1. Miksi Kivy-sovellukseni kaatuu PyInstallerilla rakentamisen jälkeen?
2. Yleisin syy on riippuvuuksien puuttuminen. Varmista kaikki tarvittavat kirjastot, kuten , , ja , sisältyvät piilotettuihin tuontituotteisiin PyInstaller SPEC -tiedostossa.
3. Kuinka sisällytän sdl2- ja glew-riippuvuudet koontiversiooni?
4. Käytä toimintoa vaihe sdl2- ja glew-binäärien sisällyttämiseksi. Näitä tarvitaan Kivyn graafisiin toimintoihin.
5. Pystyykö PyInstaller käsittelemään virtuaaliympäristöjä oikein?
6. Kyllä, mutta sinun on asetettava oikea SPEC-tiedostossa osoittamaan ympäristöön, johon riippuvuudet on asennettu, tai muuten sovellus ei ehkä löydä niitä.
7. Mitä minun pitäisi tehdä, jos sovellukseni toimii PyCharmissa, mutta kaatuu pakattuna?
8. Varmista, että kaikki ajonaikaiset riippuvuudet ovat mukana, ja varmista, että SPEC-tiedoston osio sisältää kaikki sovelluksesi tarvitsemat tiedostot, kuten fontit, kuvat tai JSON-tiedot.
9. Kuinka voin tehdä "odottamaton virhe" -viestin vianmäärityksen ilman jäljitystä?
10. Aseta parametrille in askel. Tämä tulostaa virheet päätteelle, jolloin voit jäljittää kaatumisen syyn.