تحويل سكربت بايثون إلى ملف تنفيذي يسهّل توزيعه وتشغيله على أجهزة ويندوز التي لا تحتوي بايثون. يشرح هذا الدليل الخطوات وحلول الأخطاء الشائعة.
!تحويل سكربت بايثون إلى exe%20File.png)
تحويل سكربت بايثون إلى ملف تنفيذي يسهّل توزيع تطبيقك وتشغيله على أجهزة ويندوز التي لا تحتوي بايثون. يأخذك هذا الدليل عبر الخطوات، مع حلول الأخطاء الشائعة.
الخطوة 1: ثبّت PyInstaller
افتح سطر الأوامر ونفّذ:
pip install pyinstaller
الخطوة 2: جهّز سكربت بايثون
احفظ السكربت الذي تريد تحويله (مثل sum_values.py)، وهذا مثال:
def main():
try:
# Ask the user how many numbers they want to sum
num_values = int(input("Enter the number of values you want to sum: "))
# Initialize an empty list to store the values
values = []
# Loop to get the values from the user
for i in range(num_values):
value = float(input(f"Enter value {i + 1}: "))
values.append(value)
# Calculate the sum of the values
total_sum = sum(values)
# Print the sum
print(f"The sum of the values is: {total_sum}")
except ValueError:
print("Invalid input. Please enter numeric values.")
# Wait for user input before closing
input("Press Enter to close...")
if __name__ == "__main__":
main()
الخطوة 3: أنشئ الملف التنفيذي بـ PyInstaller
انتقل في سطر الأوامر إلى مجلد السكربت، ثم نفّذ:
pyinstaller --onefile sum_values.py
الخيار --onefile يجمع كل شيء في ملف تنفيذي واحد.
الخطوة 4: حدد مكان الملف التنفيذي
بعد التنفيذ ينشئ PyInstaller عدة مجلدات وملفات، والملف التنفيذي يكون داخل مجلد dist، فإذا كان اسم السكربت sum_values.py ستجد الملف في dist/sum_values.exe.
الخطوة 5: شغّل الملف التنفيذي
يمكنك الآن توزيع ملف .exe الموجود في مجلد dist، ويستطيع المستلم تشغيله دون تثبيت بايثون.
حلول الأخطاء الشائعة
خطأ: حزمة 'pathlib' قديمة وغير متوافقة
إذا ظهر خطأ يفيد بأن حزمة pathlib غير متوافقة مع PyInstaller، أنشئ بيئة بايثون جديدة وثبّت فيها الحزم التي يحتاجها السكربت فقط، فتبقى بيئتك الأساسية دون تغيير.
خطوات حل مشكلة pathlib
- أنشئ بيئة بايثون جديدة: إذا كنت تستخدم
venv:
python -m venv pyinstaller_env
- فعّل البيئة الجديدة:
- على ويندوز:
pyinstaller_env\Scripts\activate
- على macOS ولينكس:
source pyinstaller_env/bin/activate
- ثبّت الحزم المطلوبة: PyInstaller وأي حزم أخرى مطلوبة (مثل
pywin32وpywin32-ctypes):
pip install pyinstaller pywin32 pywin32-ctypes
- تحقق من التثبيت: تأكد أنك تستطيع استيراد الحزم:
python -c "import pywintypes; import win32api"
- حوّل السكربت: انتقل إلى مجلد السكربت (
sum_values.py) وشغّل PyInstaller:
pyinstaller --onefile sum_values.py
- حدد مكان الملف: ستجده في
dist/sum_values.exe. - أوقف البيئة: بعد الانتهاء:
deactivate
خطأ: تعذر استيراد 'pywintypes' أو 'win32api' من 'win32ctypes.pywin32'
إذا ظهرت مشكلات تتعلق بـ pywintypes أو win32api فاتبع ما يلي:
- تأكد من تثبيت
pywin32:
pip install pywin32
- أعد تثبيت
pywin32-ctypes:
pip uninstall pywin32-ctypes
pip install pywin32-ctypes
- شغّل سكربت ما بعد التثبيت لـ
pywin32:
python -m pywin32_postinstall
- تحقق من التثبيت: افتح بايثون وتأكد أنك تستطيع الاستيراد دون أخطاء:
import pywintypes
import win32api
- أعد تشغيل PyInstaller:
pyinstaller --onefile sum_values.py
باتباع هذه الخطوات وحلول الأخطاء الشائعة تستطيع تحويل سكربت بايثون إلى ملف تنفيذي يعمل بسلاسة على أجهزة ويندوز التي لا تحتوي بايثون.