SwiftTerm

ระยะเวลาที่รวดเร็ว

SwiftTerm เป็นไลบรารี VT100/Xterm Terminal Emulator สำหรับแอปพลิเคชัน SWIFT ที่สามารถฝังลงใน MacOS, แอปพลิเคชัน iOS, แอปพลิเคชันข้อความ, แอปพลิเคชันที่ไม่มีหัวหรือสถานการณ์ที่กำหนดเองอื่น ๆ มันถูกใช้ในไคลเอนต์ SSH ที่มีวางจำหน่ายทั่วไปหลายรายรวมถึง Secure Shellfish, LA Terminal และ Codeedit

ตรวจสอบเอกสาร API

พื้นที่เก็บข้อมูลนี้มีทั้งเครื่องยนต์เทอร์มินัลอีมูเลเตอร์ซึ่งเป็นผู้ไม่เชื่อเรื่องพระเจ้า UI เช่นเดียวกับส่วนหน้าสำหรับเครื่องยนต์นี้สำหรับ iOS โดยใช้ UIKIT และ MACOS โดยใช้ AppKit ตัวจำลองเทอร์มินัลตามคำสาป (เพื่อเลียนแบบ XTERM ภายในแอปพลิเคชันคอนโซล) มีให้เป็นส่วนหนึ่งของไลบรารี TermKit

รหัสตัวอย่าง มีแอพตัวอย่างน้อยที่สุดสำหรับ Mac และ iOS แสดงวิธีใช้ไลบรารีภายในไดเรกทอรี TerminalApp

• แอปตัวอย่าง Mac มีฟังก์ชั่นการใช้งานของ macOS ของ Terminal.app แต่ไม่มี UI การกำหนดค่า
• แอปพลิเคชันตัวอย่าง iOS ใช้ไลบรารี SSH เพื่อเชื่อมต่อกับระบบระยะไกล (เนื่องจากไม่มีเชลล์ดั้งเดิมบน iOS ที่จะเรียกใช้) และตัวอย่างจะถูกเก็บไว้ในเครื่องที่บ้านของฉันคุณสามารถเปลี่ยนได้ในซอร์สโค้ด

App Companion SwiftMapp สร้างแอพ iOS จริงที่ใช้ไลบรารีนี้และสมบูรณ์กว่าแอพทดสอบในโมดูลนี้และให้ UI การกำหนดค่าที่เหมาะสม

นี่คือพอร์ตของ Xtermsharp ดั้งเดิมของฉันซึ่งขึ้นอยู่กับ xterm.js ณ จุดนี้ฉันพิจารณาว่า SwiftMer เป็นตัวจำลองเทอร์มินัลขั้นสูงมากกว่าทั้งสอง (การเลือกโมดูโล/การเข้าถึง) เนื่องจากมันจัดการ UTF, Unicode และกลุ่มกราฟที่ดีกว่าที่มีการครอบคลุมการจำลองเทอร์มินัลที่สมบูรณ์ยิ่งขึ้น โดยทั่วไป Xtermsharp พยายามติดตาม

คุณสมบัติ

• การเลียนแบบเทอร์มินัลที่ดีกว่าหรือดีกว่า Xtermsharp และ Xterm.js (และครอบคลุมมากขึ้นในหลาย ๆ ด้าน)
• การเรนเดอร์ Unicode (รวมถึงอิโมจิและการรวมตัวละครและอีโมจิ)
• เอ็นจิ้นที่นำกลับมาใช้ใหม่ได้และสามารถใช้งานได้ช่วยให้สามารถสร้างอินเทอร์เฟซผู้ใช้หลายตัวได้
• เอ็นจิ้นการเลือก (พร้อมรองรับ MacOS ในมุมมอง)
• รองรับสี (ANSI, 256, truecolor)
• สนับสนุนกิจกรรมเมาส์
• รองรับการดำเนินการปรับขนาดเทอร์มินัล (ควบคุมโดยโฮสต์ระยะไกลหรือในพื้นที่)
• การเชื่อมโยงหลายมิติในเอาต์พุตเทอร์มินัล
• appkit, uikit front-end; NCurses Front-end จัดแยกต่างหาก
• การรองรับการเชื่อมต่อกระบวนการในท้องถิ่นและ SSH (บางส่วนที่จำเป็นสำหรับอันสุดท้าย)
• การเรนเดอร์ coretext ที่เหมาะสมสามารถเคี้ยวผ่านชุดทดสอบ Unicode ที่แข็งตัว
• กราฟิก Sixel (ใช้ IMG2Sixel เพื่อทดสอบ)
• การแสดงผลกราฟิกสไตล์ ITERM2 (ใช้ IMGCAT เพื่อทดสอบ)
• ฟัซซี่และถูกทารุณกรรม
• ดูเหมือนจะค่อนข้างเร็วสำหรับฉัน

ห้องสมุด Swiftterm

ไลบรารี SwiftTerm มีซอร์สโค้ดสำหรับทั้งเครื่องยนต์และส่วนหน้า ส่วนหน้าจะถูกรวบรวมอย่างมีเงื่อนไขตามแพลตฟอร์มเป้าหมาย

เครื่องยนต์อยู่ในไดเรกทอรีนี้ในขณะที่รหัสสำหรับ MacOS อาศัยอยู่ภายใต้ Mac และรหัสสำหรับ iOS อาศัยอยู่ภายใต้ iOS เนื่องจากทั้งสองมีลักษณะร่วมกันจำนวนมากรหัสที่ใช้ร่วมกันอยู่ภายใต้ Apple

ใช้ SwiftTmer

SwiftMerm ใช้ Swift Package Manager สำหรับการสร้างและคุณสามารถเพิ่มไลบรารีลงในโครงการของคุณโดยใช้ URL สำหรับโครงการนี้หรือส้อม

macos nsview

การใช้งาน MacOS AppKit NSView TerminalView เป็นตัวควบคุม NSVIEW ที่นำกลับมาใช้ใหม่ได้ซึ่งสามารถเชื่อมต่อกับแหล่งใด ๆ ได้โดยการใช้ TerminalViewDelegate
ฉันคาดว่าสถานการณ์ทั่วไปจะเป็นโฮสต์คำสั่ง UNIX ท้องถิ่นดังนั้นฉันจึงรวม LocalProcessTerminalView ซึ่งเป็นการดำเนินการที่เชื่อมต่อ TerminalView กับ UNIX Pseudo-terminal และเรียกใช้คำสั่งที่นั่น

iOS uiview

มีการใช้งาน UIVIEW UIView ที่เทียบเท่าสำหรับ TerminalView ซึ่งเหมือนกับ NSVIEW Companion เป็นมุมมองแบบฝังและนำกลับมาใช้ใหม่ได้ซึ่งสามารถเชื่อมต่อกับแอปพลิเคชันของคุณได้โดยใช้ TerminalViewDelegate เดียวกัน ซึ่งแตกต่างจากกรณี NSVIEW ที่ทำงานบน MAC ซึ่งสถานการณ์ทั่วไปจะเรียกใช้คำสั่งท้องถิ่นเนื่องจาก iOS ไม่ได้เสนอการเข้าถึงกระบวนการสถานการณ์ที่พบบ่อยที่สุดคือการเชื่อมต่อเทอร์มินัลนี้ไปยังโฮสต์ระยะไกล และวิธีที่ปลอดภัยที่สุดในการเชื่อมต่อกับระบบระยะไกลคือ SSH

รหัสที่ใช้ร่วมกันระหว่าง macOS และ iOS

รหัส iOS และ UIKIT แบ่งปันรหัสจำนวนมากรหัสนั้นอาศัยอยู่ภายใต้ไดเรกทอรี Apple

ใช้ SSH

ปัจจุบันห้องสมุดหลักไม่ได้ให้วิธีที่สะดวกในการเชื่อมต่อกับ SSH อย่างหมดจดเพื่อหลีกเลี่ยงการพึ่งพาเพิ่มเติม แต่โมดูล Git นี้อ้างอิงโมดูลที่ดึงไคลเอนต์ SSH ที่คอมไพล์ precompiled (Swiftsh ของ Frugghi) พร้อมกับ UIKitSsshTerminalView ในตัวอย่าง iOS ที่เชื่อมต่อ TerminalView สำหรับ iOS กับการเชื่อมต่อ SSH

ทำงานกับ SwiftTmer

หากคุณใช้ XCode มีสองโครงการ toplevel หนึ่งโครงการสำหรับ Mac และอีกหนึ่งสำหรับ iOS ในไดเรกทอรี TerminalApp หนึ่งเรียกว่า "iosterminal.xcodeproj" และอีกหนึ่งเรียกว่า "macterminal.xcodeproj"

สิ่งนี้จำเป็นเพราะ XCode ไม่ได้ให้รหัสเสร็จสมบูรณ์สำหรับ iOS หากคุณมีโครงการ MAC ในโครงการ ดังนั้นฉันต้องแยกพวกเขาขึ้น ทั้งสองโครงการอ้างอิงแพ็คเกจ SwiftMer เดียวกัน

เมื่อทำงานกับโครงการเหล่านี้หากคุณเลือกแอปพลิเคชันเทอร์มินัลมันจะเรียกใช้โครงการนี้ ในการเรียกใช้ชุดทดสอบให้เลือกเป้าหมาย 'Swiftterm' แทนและคุณสามารถใช้ 'SwiftTermFuzz' เพื่อเรียกใช้ฟัซเซอร์

คุณสามารถใช้ swift build เพื่อสร้างแพ็คเกจและ swift test เพื่อเรียกใช้ชุดทดสอบ - แต่ควรได้รับการเตือนว่าชุดทดสอบคาดว่าจะมีการตรวจสอบไดเรกทอรี esctest จะตรวจสอบให้ทำงาน คุณสามารถดูว่าฉันเรียกใช้สิ่งเหล่านี้ในการกระทำของ GitHub ในไฟล์ .github/workflows/swift.yml ได้อย่างไรหากคุณต้องการทำสิ่งนี้ในพื้นที่

หากใช้ XCode คุณสามารถเลือกโครงการ "Swiftterm" จากนั้นใช้ Command-U เพื่อเรียกใช้ชุดทดสอบ

รอทำงาน

ปัญหา GitHub มีรายการคุณสมบัติและการปรับปรุงที่ต้องการ

แผนระยะยาว

ในระยะยาวฉันต้องการเพิ่ม tvos uiview ซึ่งเป็น frontgtk front-end สำหรับ Linux

ภาพหน้าจอ

24 บิตสี

ผู้บัญชาการเที่ยงคืน

การสนับสนุน UTF-8 แบบแข็งการเรนเดอร์ที่ยอดเยี่ยม:

รองรับไฮเปอร์ลิงก์ที่ปล่อยออกมาโดยแอพที่ทันสมัย:

การสนับสนุน iOS:

Sixel Support:

ทรัพยากร

• คู่มือผู้ใช้ VT100 ของดิจิตอล
• Terminal Guide - ดีมากและเป็นภาพ แต่ไม่ใช่บรรทัดฐาน
• ลำดับการควบคุม xterm
• ข้อมูลโปรแกรมเมอร์วิดีโอ VT510

เอกสารเพิ่มเติมและมีประโยชน์:

• คู่มืออ้างอิงโปรแกรมเมอร์ VT330/VT340 เล่มที่ 2: การเขียนโปรแกรมกราฟิก
• ตัวแยกวิเคราะห์สำหรับเทอร์มินัลวิดีโอที่เข้ากันได้ของ ANSI ของ DEC
• รหัสและมาตรฐาน
• เอกสารคอนโซล Linux พวกเขาเป็นชุดย่อยของ VT100 แต่มักจะติดตามได้ง่าย
• กราฟิก Sixel

ชุดทดสอบ:

• Vttest - เก่า แต่ก็ยังดี
• Esctest - Fantastic: George Nachman ผู้เขียน Iterm สร้างชุดทดสอบนี้และกลายเป็นมาตรฐาน Freedesktop ตั้งแต่นั้นมาโทมัสอี. ดิกกี้ผู้ดูแลและผู้ดูแลแอพข้อความจำนวนมากได้มีส่วนร่วมในความพยายามนี้

ผู้เขียน

• ขอบคุณไปที่นักพัฒนา XTerm.js ที่ตอนแรกเขียนเครื่องจำลองเทอร์มินัลที่ได้รับใบอนุญาตภายใต้ใบอนุญาตที่อนุญาตให้นำกลับมาใช้ใหม่ได้สูงสุด
• Marcin Krzyzanowski ผู้ปรับปรุงและดูแลเครื่องยนต์การแสดงผลบน Appkit/Coretext เป็นผู้แสดงความยินดีที่เป็นอยู่ทุกวันนี้ - และสำหรับการมีส่วนร่วมของเขาในการแสดงผล
• Greg Munn ที่ทำงานจำนวนมากใน Xtermsharp เพื่อรองรับความต้องการของ Visual Studio สำหรับ Mac
• Anders Borum มีส่วนร่วมในการแก้ไขความน่าเชื่อถือตัวแยกวิเคราะห์ Sixel และการเปลี่ยนแปลงที่จำเป็นในการทำให้ Swiftter ใช้ในการผลิต
• Miguel de Icaza -me- ใครกำลังมองหาข้ออ้างในการเขียนโค้ดที่รวดเร็ว