تحويل سكربت بايثون إلى ملف تنفيذي (.exe)

بقلم · نُشر في · آخر تحديث · 3 دقائق قراءة
باختصار

تحويل سكربت بايثون إلى ملف تنفيذي يسهّل توزيعه وتشغيله على أجهزة ويندوز التي لا تحتوي بايثون. يشرح هذا الدليل الخطوات وحلول الأخطاء الشائعة.

!تحويل سكربت بايثون إلى 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

باتباع هذه الخطوات وحلول الأخطاء الشائعة تستطيع تحويل سكربت بايثون إلى ملف تنفيذي يعمل بسلاسة على أجهزة ويندوز التي لا تحتوي بايثون.

هل تحتاج إلى شخص تتخلص معه من أعباء إدارة ومتابعة أعمالك اليومية؟

اقضِ وقتًا أقل في متابعة المهام، ووقتًا أكبر في تنمية أعمالك.

ليس عليك أن تتحمل وحدك مسؤولية كل التفاصيل التشغيلية والإدارية في شركتك.

سواء كنت تحتاج إلى دعم افتراضي مستمر، أو مساعدة في إدارة متجرك الإلكتروني، أو شخص يتولى تنسيق المشروعات ومتابعة المهام والمسؤوليات، يمكنني مساعدتك على تنظيم العمل وضمان استمراره.

أرسل لي رسالة عبر واتساب أو البريد الإلكتروني، وعرّفني باختصار على نشاطك التجاري وما تحتاج إليه. سنتفق على مكالمة قصيرة لمناقشة نطاق العمل وتحديد الأولويات والتوقعات، وبعدها أبدأ التنفيذ وفق خطة واضحة.

ويمكنك أيضًا توظيفي مباشرة من خلال منصة Upwork.