Python 3.10 Kullanarak Kivy Uygulamasında PyInstaller Başlangıç ​​Çökmesini Düzeltme

PyInstaller ile Oluşturulan Kivy Uygulamalarındaki Başlangıç ​​Çökmelerini Anlamak

PyInstaller'ı kullanarak bir Kivy uygulaması oluşturmak, Python uygulamalarını bağımsız yürütülebilir dosyalar halinde paketlemek için yaygın bir yaklaşımdır. Ancak başarılı bir derleme sürecine rağmen geliştiriciler bazen paketlenmiş uygulamayı başlatırken beklenmedik çökmelerle karşılaşıyor. Bu sorun, ayrıntılı bir hata mesajı verilmediğinde özellikle sinir bozucu olabilir.

Bu durumda uygulama, PyCharm gibi geliştirme ortamında mükemmel şekilde çalışır ancak PyInstaller kullanılarak paketlendiğinde başarısız olur. Kivy 2.3.0, Python 3.10 gibi bağımlılıklar ve numpy, scipy ve pandas gibi kitaplıklar nedeniyle, kilitlenmenin kaynağının belirlenmesi sorunun çözümü açısından kritik hale geliyor.

Açık bir iz bırakmayan "beklenmeyen hata" gibi hatalar genellikle eksik bağımlılıklara, yanlış SPEC dosya yapılandırmalarına veya sanal ortam tutarsızlıklarına işaret eder. Gerekli tüm dosyaların doğru şekilde paketlendiğinden emin olmanın önemi göz önüne alındığında, PyInstaller SPEC dosyasını ve çalışma zamanı bağımlılıklarını incelemek çok önemli bir adımdır.

Bu makale, SPEC dosyanızı iyileştirmeye, gizli içe aktarmaları yönetmeye ve derleme süreci sırasında gerekli Kivy bağımlılıklarının doğru şekilde işlenmesine odaklanarak çökmenin olası nedenlerini araştırıyor.

PyInstaller ile Kivy Uygulaması Başlatma Hatalarını Giderme

Yukarıda sağlanan komut dosyaları çok özel bir sorunu çözmeye odaklanmıştır: PyInstaller kullanılarak oluşturulan bir Kivy uygulaması başlangıçta "beklenmeyen bir hatayla" çöküyor. İlk komut dosyası, eksiklerle ilgili olası bir sorunu ele alıyor gizli ithalat. Bu, PyInstaller'ı kullanırken yaygın bir sorundur, çünkü tüm bağımlılıkları, özellikle de aşağıdaki kütüphaneleri otomatik olarak algılamaz: uyuşuk, pandalar, veya scipy. Bu gizli içe aktarmaları manuel olarak belirterek Analiz SPEC dosyasının bölümünde, PyInstaller'ın gerekli tüm modülleri bir araya getirerek uygulamanın eksik bileşenler nedeniyle çökmesini önlediğinden emin oluyoruz.

Senaryonun ikinci önemli adımı şunların dahil edilmesidir: Ağaç() içinde TOPLAMAK faz. Bu komut, SDL2 ve GLEW kitaplıkları gibi uygulamanın Kivy ile ilgili bağımlılıklarının derlemeye doğru şekilde dahil edilmesini sağlar. Bunlar uygulamanın grafik arayüzünü oluşturmak için gereklidir. Bu dosyalar dahil edilmezse oluşturma işlemi hatasız tamamlansa bile Kivy uygulaması düzgün çalışmaz. Bu ikili dosyaların dahil edildiğinden emin olmak, eksik grafik veya ses bileşenleriyle ilgili çalışma zamanı sorunlarının önlenmesine yardımcı olur.

Komut dosyası ayrıca, JSON dosyası gibi harici dosyaların dahil edilmesini de ele alır. JsonStore Kivy'de. Bu JSON dosyası çalışma zamanında oluşturulurken, paketleme işlemi sırasında uygun şekilde işlenmesinin sağlanması çok önemlidir. veriler içindeki argüman Analiz işlevi, bu dosyayı birlikte verilen uygulamaya açıkça eklememize olanak tanır. Bunu yaparak, başlatma sırasında eksik harici veri dosyaları nedeniyle uygulamanın çökmesine neden olan hatayı önlemiş oluyoruz.

Son olarak UPX sıkıştırmasının kullanımını da görüyoruz. şerit seçenek. UPX sıkıştırması, paketlenen uygulamanın boyutunu küçülterek dağıtımı kolaylaştırmak için kullanılır. Ancak UPX'in etkinleştirilmesi bazen uyumluluk sorunlarına neden olur; bu nedenle UPX'in eşleştirilmesi şerit=Yanlış hata ayıklama sembollerinin ikili dosyalardan kaldırılmasını önlemek için. Hata ayıklama sembollerini koruyarak, çalışma zamanı sırasında meydana gelen çökmelerin veya hataların nedenini daha iyi takip edebiliriz. Pencereli geri izlemeyi devre dışı bırakmak, hata mesajlarının konsolda görünmesine izin vererek başlangıçta olası sorunlara ilişkin öngörüler sağladığından sorunların tanılanmasına yardımcı olan başka bir yapılandırmadır.

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

Başlangıç ​​Hatalarını Önlemek amacıyla PyInstaller'ı Kivy Uygulamaları için Optimize Etme

PyInstaller ve Kivy ile çalışırken dikkate alınması gereken önemli hususlardan biri dış bağımlılıkların ve kitaplıkların yönetimidir. PyInstaller'ın varsayılan davranışı, özellikle sanal ortamlar veya bilimsel kitaplıklar gibi daha karmaşık kurulumlarla çalışırken, bazen belirli kitaplıkları veya dosyaları gözden kaçırır. uyuşuk Ve pandalar. Tüm gizli içe aktarmaların belirtildiğinden emin olmak hiddenimports parametre kritiktir. Ayrıca PyInstaller, aşağıdakiler gibi grafiksel ve multimedya bağımlılıklarını otomatik olarak içermeyebilir: sdl2 veya glew, her ikisi de Kivy uygulamaları için gereklidir.

Geliştiricilerin sıklıkla gözden kaçırdığı bir diğer husus da sanal ortamlarla ilgilidir. Sanal ortamda PyInstaller'ı kullanarak bir Kivy uygulaması oluştururken tüm bağımlılıkların doğru şekilde paketlendiğinden emin olmak önemlidir. Bu, pathex kitaplıkların kurulu olduğu doğru dizinleri işaret edecek ayar. Bunun yapılmaması, paketlenmiş uygulamanın geliştirme ortamında düzgün çalışmasına ancak üretim sırasında başlatma sırasında çökmesine neden olabilir. Bu sorun genellikle yapı yapılandırmasının tam olarak incelenmesi ve tüm yolların ve bağımlılıkların doğru olduğundan emin olunmasıyla önlenebilir.

Son olarak, resimler, yazı tipleri ve veri dosyaları gibi kaynakların doğru şekilde kullanılması, beklenmeyen başlatma hatalarının önlenmesi açısından çok önemlidir. Kivy uygulamalarında harici kaynaklara sıklıkla ihtiyaç duyulur ve bunlar açıkça PyInstaller'a dahil edilmemişse datas bölümünde eksik dosyalara erişmeye çalışırken uygulama başlatma sırasında çökebilir. Uygulamanın çalışma zamanında ihtiyaç duyduğu tüm dosyaların son yapıya uygun şekilde dahil edildiğini doğrulamak önemlidir.