ดาวน์โหลด COMTool - ดาวน์โหลดซอร์สโค้ด COMTool

COMTool

อังกฤษ | 中文

เครื่องมือดีบักแบบอนุกรมข้ามแพลตฟอร์มที่เขียนโดย Python

หน้าต่าง	ลินุกซ์	ราสเบอร์รี่ปี่	ระบบปฏิบัติการ macOS

ธีมสีขาว	ธีมสีเข้ม	ปลั๊กอินโปรโตคอล	TCP/UDP	เทอร์มินัล	กราฟ

ภาพหน้าจออาจเป็นเวอร์ชั่นเก่า ล่าสุดอาจไม่เหมือนเดิมโดยสิ้นเชิง! แต่ประสิทธิภาพดีกว่า ใช้งานง่ายกว่า และหรูหรากว่า

คุณสมบัติ

การติดตั้ง

มีสองวิธีในการติดตั้ง COMTool:

ดาวน์โหลดไฟล์ไบนารี่แล้วรัน : สำหรับ Windows หรือ macOS และผู้ใช้ที่ใช้งานง่าย
ติดตั้งเป็นแพ็คเกจ python (ซอร์สโค้ด) : สำหรับ Linux หรือจำเป็นต้องใช้ผู้ใช้ปลั๊กอินหรือผู้ใช้ที่รู้เกี่ยวกับ python

ติดตั้งไบนารี

หน้าต่าง

ดาวน์โหลดไฟล์ bin ล่าสุดได้ที่หน้าเผยแพร่หรือ sourceforge
แตกไฟล์ .zip แล้วคลิก comtool.exe เพื่อเรียกใช้

และคุณสามารถติดตั้งโดยscoop ดูแลโดย 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

ระบบปฏิบัติการ macOS

ดาวน์โหลดรุ่นได้ที่หน้าวางจำหน่ายหรือ sourceforge
ติดตั้งแพ็คเกจ dmg

หากคุณต้องการเปิดหลาย comtool เพียงคลิกขวาที่ไอคอน dock จากนั้นคลิก 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 binary เป็นมัลแวร์หรือไม่

หากโปรแกรมของคุณดาวน์โหลดจากที่นี่ ก็ไม่เป็นไร ข้อผิดพลาดที่เกิดจากปัญหาแพ็ก ซอร์สโค้ดและสคริปต์แพ็กทั้งหมดอยู่ที่นี่ แม้แต่ความคืบหน้าของแพ็กก็ยังเป็นแบบอัตโนมัติทั้งหมดด้วยการทำงานของ GitHub ไม่มีใครแพ็กด้วยตนเอง

หากคุณยังคงมีข้อกังวล เพียงดาวน์โหลดซอร์สโค้ดเพื่อรันด้วย Python หรือแพ็คเอง

แน่นอน หากคุณพบวิธีแพ็คที่ดีกว่า โปรดเปิดประเด็นเพื่อแจ้งให้เราทราบ

ติดตั้งแพ็คเกจหลาม

สำหรับนักพัฒนาหรือไบนารี่ที่ไม่รองรับแพลตฟอร์มของคุณ ให้ใช้วิธีนี้ในการติดตั้ง

ติดตั้ง 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

หรือคุณสามารถติดตั้งโดยตรงจาก github

 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

คัดลอก tool/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

Windows: ดาวน์โหลด python3

ติดตั้งแพ็คเกจเช่น pyserial และ PyQt5 เป็นต้น (รายการใน Requirements.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

ดึงคำขอ

เขียนปลั๊กอินของคุณเองภายในไม่กี่นาที

ดูเอกสาร/plugins.md

เพิ่มการแปล

ติดตั้งสภาพแวดล้อมก่อน (แพ็คเกจ python pip ใน requirments.txt)

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

หากคุณต้องการเพิ่ม lanuage ใหม่หรือข้ามไป

เพิ่มสถานที่ใน i18n.py

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

เพิ่มภาษาของคุณต่อท้ายรายการนี้ สามารถดูสถานที่ได้ที่นี่หรือในวิกิพีเดีย เช่น zh_CN หมายถึงจีนแผ่นดินใหญ่ ภาษาที่เกี่ยวข้องคืออักขระจีนตัวย่อ zh_TW หมายถึงจีนไต้หวัน และภาษาเป็นอักขระจีนดั้งเดิม คุณยังสามารถใช้ zh เพื่อใช้ตัวย่อได้เท่านั้น ตัวอักษรจีน

สร้างไฟล์แปล

python i18n.py prepare

คำสั่งนี้จะสร้างไฟล์ .po ในโฟลเดอร์ locales

แปลด้วยตนเอง

จากนั้นแปลไฟล์ .po ซึ่งเป็นรูปแบบไฟล์แปลมาตรฐานที่ชื่อว่า gettext

สร้างไฟล์แปลไบนารี

เพื่อให้โปรแกรมอ่านเร็วขึ้น ไฟล์ข้อความ .po ควรแปลงเป็นไฟล์ไบนารี .mo เพียงรันคำสั่ง:

python i18n.py finish

จากนั้นคุณจะเห็นไฟล์ locales/<locale>/LC_MESSAGES/messages.mo

ทดสอบ

เรียกใช้แอปพลิเคชัน คุณจะเห็นคำแปลใหม่

ดึงคำขอ

สร้าง PR เพื่อรวมการเปลี่ยนแปลงของคุณกับ repo นี้

ปรับแต่งธีม

ในไดเร็กทอรี assets/qss ภายใต้ซอร์สโค้ดหรือไดเร็กทอรีโปรแกรมไบนารี ให้คัดลอกไฟล์จาก style-dark.qss หรือ style-light.qss ชื่อไฟล์คือ style-xxx.qss โดยที่ xxx คือชื่อของธีม เพื่อให้ซอฟต์แวร์สามารถตรวจจับธีมได้ จากนั้นแก้ไขไฟล์ qss ตามความต้องการของคุณ ไวยากรณ์ของ qss คล้ายกับ css แต่การสนับสนุนไม่สมบูรณ์ จะสามารถใช้ไวยากรณ์ css ได้หรือไม่นั้นขึ้นอยู่กับเอฟเฟกต์จริง 555 ยินดีต้อนรับเพิ่มโค้ดธีม!(PR)

นอกจากนี้ ซอฟต์แวร์ยังไม่ได้รับการปรับให้เหมาะสมสำหรับธีมนี้โดยเจตนา และคลาสและ id อาจถูกเขียนแบบไม่เป็นทางการ ดังนั้นจึงไม่มีการรับประกันว่าโค้ดในอนาคตจะเข้ากันได้อย่างสมบูรณ์กับ qss ปัจจุบัน