تنزيل COMTool - تنزيل كود مصدر COMTool

COMTool

فئات أخرى

v3.4.1

تنزيل

comTool

الإنجليزية | 中文

أدوات تصحيح الأخطاء التسلسلية عبر الأنظمة الأساسية المكتوبة بواسطة بايثون

ويندوز	لينكس	راسبيري بي	ماك

موضوع أبيض	موضوع مظلم	البرنامج المساعد للبروتوكول	تكب / يو دي بي	صالة	رسم بياني

ربما تكون لقطة الشاشة هي الإصدار القديم، وقد لا يكون الإصدار الأحدث هو نفسه تمامًا! لكن أداء أفضل وأكثر سهولة في الاستخدام وأكثر أناقة

سمات

تثبيت

هناك طريقتان لتثبيت COMTool:

قم بتنزيل الملفات الثنائية وتشغيلها: لنظام التشغيل Windows أو macOS ومستخدمي الاستخدام البسيط
التثبيت كحزمة python (كود المصدر): لنظام Linux، أو تحتاج إلى استخدام مستخدم المكونات الإضافية، أو المستخدمين الذين يعرفون عن python

تثبيت ثنائي

ويندوز

قم بتنزيل أحدث ملف bin من صفحة الإصدار أو sourceforge
قم بفك ضغط ملف .zip ، ثم انقر فوق comtool.exe للتشغيل

ويمكنك التثبيت عن طريق السبق الصحفي، الذي تتم صيانته بواسطة StudentWeis
 scoop bucket add Nightly https://github.com/StudentWeis/Nightly
scoop install comtool

لينكس

يحتوي Linux على عدد كبير جدًا من الإصدارات، لذلك نقوم فقط بتجميع الملفات الثنائية لنظام Ubuntu. التوزيعات الأخرى يرجى التثبيت من pypi أو كود المصدر. إذا كانت لديك أي فكرة لحزم الملفات الثنائية عبر الأنظمة الأساسية مثل flatpak أو appimage، فيمكنك المساهمة بطلب سحب أو إضافة مشكلة لإخباري بكيفية القيام بذلك

يمكن تثبيت Arch Linux والتوزيعات المشتقة منه من AUR (التي تتم صيانتها بواسطة taotieren) ：
 # Release version
yay -S python-comtool
# Development version
yay -S python-comtool-git

قم بتنزيل الإصدار في صفحة الإصدار، واستخرج الملفات من ملف .zip ، وانقر فوق comtool للتشغيل
أضف المستخدم الحالي إلى مجموعة الطلب الهاتفي لتجنب أمر sudo

sudo usermod -a -G dialout $USER
grep ' dialout ' /etc/group
reboot # must reboot to take effect

راسبيري بي

افتح المحطة الطرفية وقم بتثبيت التبعيات باستخدام مدير الحزم:

sudo apt install git python3-pyqt5 python3-numpy

استخدم مدير الحزم لتثبيت pyqt5 numpy وما إلى ذلك. بهذه الطريقة تجعل التثبيت أسهل. إذا واجهت بعض الأخطاء عند التثبيت باستخدام pip ، فيمكنك محاولة التثبيت باستخدام مدير الحزم أولاً. للعثور على اسم الحزمة، الحيلة هي استخدام sudo apt-cache search package_name | grep package_name للبحث عن اسم الحزمة، ثم تثبيته.

ثم قم بتثبيت الحزم الأخرى باستخدام pip :

 git clone https://github.com/Neutree/COMTool.git --depth=1
cd COMTool
pip3 install . --verbose
# 或者
# python setup.py bdist_wheel
# sudo pip3 install dist/COMTool-*.*.*-py3-none-any.whl --verbose

أضف المستخدم الحالي إلى مجموعة الطلب الهاتفي لتجنب أمر sudo

sudo usermod -a -G dialout $USER
grep ' dialout ' /etc/group
reboot # must reboot to take effect

ثم استمتع بالأمر

 comtool

ماك

قم بتنزيل الإصدار على صفحة الإصدار أو sourceforge
تثبيت حزمة دي إم جي

إذا كنت تريد فتح عدة أدوات comtool، فما عليك سوى النقر بزر الماوس الأيمن فوق رمز الإرساء، ثم النقر فوق New Window .

أو يمكنك فتح المحطة واكتب

 open -n /Application/comtool.app

أو

 cd /Applicatioin/comtool.app/Contents/MacOS
./comtool

نظرًا لأن البرنامج غير موقع من قبل المطور، فسوف يتم تحذيرك عند فتحه لأول مرة. يلزمك الانتقال إلى Settings -> Security and Privacy -> General لرؤية comtool السريعة والنقر فوق Open anyway .

يظهر Windows Defender أن برنامج comtool الثنائي عبارة عن برنامج ضار؟

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

إذا كنت لا تزال تشعر بالقلق، فما عليك سوى تنزيل الكود المصدري لتشغيله مع بايثون أو حزمه بنفسك.

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

تثبيت حزمة بايثون

بالنسبة للمطورين أو الثنائي الذي لا يدعم النظام الأساسي الخاص بك، استخدم هذه الطريقة للتثبيت

قم بتثبيت Python3 أولاً
- إذا كان نظام التشغيل Windows أو macOS: قم بتنزيل python3
- إذا كان Linux: ubuntu على سبيل المثال sudo apt install python3 python3-pip ، macOS brew install python3 python3-pip
تأكد من حصولك على pip

pip3 --version
# or
pip --version

إذا لم يكن هناك هذا الأمر، قم بالتثبيت بواسطة

python3 -m ensurepip

ثم قم بالتثبيت من pypi:

pip3 install comtool
comtool

بالنسبة للغة الصينية، يمكنك استخدام مرايا التونة للتنزيل بشكل أسرع عن طريق:

pip install -i https://pypi.tuna.tsinghua.edu.cn/simple comtool

أو يمكنك التثبيت مباشرة من جيثب

 pip3 install git+https://github.com/Neutree/COMTool

أو يمكنك تنزيل الكود المصدري، ثم التثبيت من الكود المصدري
- قم بتنزيل الكود المصدري أو التنزيل في صفحة الويب أو git clone https://github.com/Neutree/COMTool.git
- ثَبَّتَ

 cd COMTool
pip install .

أو قم ببناء العجلة الثنائية الخاصة بك

 pip3 install wheel
python setup.py bdist_wheel
pip install dist/COMTool-*.*.*-py3-none-any.whl
comtool

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

 sudo apt install python3-pyqt5 python3-numpy cython3

للعثور على اسم الحزمة، الحيلة هي استخدام sudo apt-cache search package_name | grep package_name للبحث عن اسم الحزمة، ثم تثبيته.

بالمناسبة، يجب عليك إضافة المستخدم الحالي إلى مجموعة الطلب لتجنب أمر sudo

sudo usermod -a -G dialout $USER
grep ' dialout ' /etc/group
reboot # must reboot to take effect

قم بإضافة التطبيق يدويًا إلى قائمة البدء على Linux

انسخ الأداة/comtool.desktop إلى المجلد /usr/share/applications (قد يحتاج إلى مستخدم root للقيام بذلك)
قم بتحرير /usr/share/applications/comtool.desktop ، وقم بتغيير مسار الرمز Icon=/usr/local/COMTool/assets/logo.ico إلى مسار الرمز الفعلي، ويمكنك أيضًا استخدام رمز الحب الخاص بك
ثم يمكنك العثور على تطبيق comtool في قائمة البداية (أو مركز التطبيقات)

حزمة ثنائية

pip3 install pyinstaller
python pack.py
cd dist
ls

من الأفضل إنشاء بيئة افتراضية قبل الحزمة لتقليل حجم pip install virtualenv virtualenv venv source venv/bin/activate # linux venv/Scripts/activate # windows إذا واجهت running scripts is disabled on this system ، فيمكنك السماح بذلك مؤقتًا المحطة الحالية لتنفيذ البرامج النصية Set-ExecutionPolicy -Scope Process -ExecutionPolicy RemoteSigned ثم pip install pyinstaller و python pack.py

تطوير

قم بتثبيت python(>=3.8) وpip3

لينكس:

 sudo apt install python3 python3-pip

ويندوز: تنزيل بايثون3

تثبيت الحزم مثل pyserial و PyQt5 وما إلى ذلك (القائمة في ملف require.txt)

 cd COMTool
pip3 install -r requirements.txt

على Raspberry، يمكن تثبيت python3-pyqt5 عن طريق الأمر apt :

 sudo pip3 install --upgrade pyserial
sudo apt install python3-pyqt5

مشروع استنساخ

 git clone https://github.com/Neutree/COMTool.git

التعليمات البرمجية أو حل الأخطاء أو إضافة ميزات جديدة

يوصى باستخدام PyCharm IDE أو vscode للبدء

كيفية التشغيل: إنشاء ترجمة الملفات الثنائية أولاً ( .mo )

 python COMTool/i18n.py finish

ثم قم بتنفيذ البرنامج الرئيسي

 python COMTool/Main.py

طلب سحب

اكتب المكونات الإضافية الخاصة بك في دقائق

راجع docs/plugins.md

أضف ترجمة

تثبيت البيئة أولاً (حزم python pip في ملف requirments.txt)

apt install python3 python3-pip
pip3 install -r requirements.txt

إذا كنت بحاجة إلى إضافة لغة جديدة، أو تخطي

أضف لغة في i18n.py

 locales=["en", "zh_CN", "zh_TW", "ja"]

قم بإلحاق لغتك بهذه القائمة، ويمكن العثور على اللغات المحلية هنا أو في ويكيبيديا، zh_CN على سبيل المثال تعني البر الرئيسي للصين، واللغة المقابلة هي أحرف صينية مبسطة، zh_TW تعني الصين تايوان، واللغة هي أحرف صينية تقليدية، ويمكنك أيضًا استخدام zh فقط لاستخدام الحروف المبسطة الشخصيات الصينية.

إنشاء ملفات الترجمة

python i18n.py prepare

سيقوم هذا الأمر بإنشاء ملفات .po في المجلد المحلي

ترجمة يدويا

ثم قم بترجمة ملفات .po ، وهذا هو تنسيق ملف الترجمة القياسي الذي يسمى gettext

إنشاء ملفات ترجمة ثنائية

لجعل قراءة البرنامج أسرع، يجب تحويل الملفات النصية .po إلى ملف ثنائي .mo ، فقط قم بتشغيل الأمر:

python i18n.py finish

وبعد ذلك يمكنك رؤية ملف locales/<locale>/LC_MESSAGES/messages.mo

امتحان

قم بتشغيل التطبيق، وسترى الترجمة الجديدة

طلب سحب

قم بإنشاء علاقات عامة لدمج تغييراتك في هذا الريبو

تخصيص الموضوع

في دليل assets/qss ضمن الكود المصدري أو دليل البرنامج الثنائي، انسخ ملفًا من style-dark.qss أو style-light.qss ، اسم الملف هو style-xxx.qss ، هنا xxx هو اسم السمة، حتى يتمكن البرنامج من اكتشاف الموضوع. ثم قم بتعديل ملف qss حسب تفضيلاتك. بناء جملة qss مشابه لـ css ، لكن الدعم غير كامل. ما إذا كان يمكن استخدام بناء جملة css يعتمد على التأثير الفعلي، هاها. إضافة رمز الموضوع هو موضع ترحيب!(العلاقات العامة)

بالإضافة إلى ذلك، لم يتم تحسين البرنامج بشكل متعمد للموضوع، وربما تمت كتابة الفئة والمعرف بشكل عرضي، لذلك ليس هناك ما يضمن أن الرموز المستقبلية ستكون متوافقة تمامًا مع QSS الحالي.