SwiftTerm

SWIFTME

SWIFTTER adalah Perpustakaan Emulator Terminal VT100/Xterm untuk aplikasi Swift yang dapat disematkan ke dalam macOS, aplikasi iOS, aplikasi berbasis teks, aplikasi tanpa kepala atau skenario khusus lainnya. Ini telah digunakan di beberapa klien SSH yang tersedia secara komersial, termasuk kerang aman, terminal LA dan codeedit

Periksa dokumentasi API

Repositori ini berisi mesin emulator terminal yang merupakan Agnostik UI, serta front-end untuk mesin ini untuk iOS menggunakan Uikit, dan macOS menggunakan APPKIT. Emulator terminal berbasis kutukan (untuk meniru xterm di dalam aplikasi konsol) tersedia sebagai bagian dari perpustakaan Termkit.

Kode Sampel Ada beberapa aplikasi sampel minimal untuk Mac dan iOS yang menunjukkan cara menggunakan pustaka di dalam direktori TerminalApp .

• Contoh aplikasi Mac memiliki banyak fungsi terminal macOS.app, tetapi tanpa konfigurasi UI.
• Aplikasi sampel iOS menggunakan pustaka SSH untuk terhubung ke sistem jarak jauh (karena tidak ada shell asli pada iOS untuk dijalankan), dan sampel kebetulan hardcoded ke mesin rumah saya, Anda dapat mengubahnya dalam kode sumber.

Aplikasi pendamping SwifttermApp membangun aplikasi iOS yang sebenarnya yang menggunakan pustaka ini dan lebih lengkap daripada aplikasi pengujian dalam modul ini dan menyediakan UI konfigurasi yang tepat.

Ini adalah port Xtermsharp asli saya, yang sendiri didasarkan pada xterm.js. Pada titik ini, saya menganggap Swiftterm sebagai emulator terminal yang lebih canggih daripada keduanya (pemilihan modulo/aksesibilitas) karena menangani kluster UTF, Unicode dan Grapheme lebih baik daripada itu dan memiliki cakupan emulasi terminal yang lebih lengkap. Xtermsharp umumnya berusaha untuk mengikuti.

Fitur

• Emulasi terminal yang cukup baik, di atau lebih baik dari xtermsharp dan xterm.js (dan lebih komprehensif dalam banyak hal)
• Rendering unicode (termasuk emoji, dan menggabungkan karakter dan emoji)
• Mesin yang dapat digunakan kembali dan dapat dicolokkan memungkinkan beberapa antarmuka pengguna dibangun di atasnya.
• Mesin seleksi (dengan dukungan macOS di tampilan)
• Mendukung Warna (ANSI, 256, TrueColor)
• Mendukung acara mouse
• Mendukung Operasi Ulang Terminal (Dikontrol oleh Host Jarak Jauh, atau Lokal)
• Hyperlink dalam output terminal
• Appkit, front-end uikat; ncurses front-end disediakan secara terpisah
• Proses Lokal dan Dukungan Koneksi SSH (beberapa perakitan diperlukan untuk yang terakhir)
• Rendering coretext yang tepat dapat mengunyah suite uji unicode yang dikeraskan.
• Grafik Sixel (Gunakan IMG2SIXEL untuk menguji)
• Rendering grafis gaya ITERM2 (gunakan IMGCAT untuk menguji)
• Fuzzed dan disalahgunakan
• Sepertinya cukup cepat bagi saya

Perpustakaan Swiftter

Perpustakaan SWIFTMERT itu sendiri berisi kode sumber untuk mesin dan front-end. Front-end dikompilasi secara kondisional berdasarkan platform target.

Mesinnya ada di direktori ini, sedangkan kode untuk macOS hidup di bawah Mac , dan kode untuk iOS, hidup di bawah iOS . Mengingat bahwa keduanya memiliki banyak sifat umum, kode bersama berada di bawah Apple .

Menggunakan Swiftterm

Swiftter menggunakan Swift Package Manager untuk pembuatannya, dan Anda dapat menambahkan perpustakaan ke proyek Anda dengan menggunakan URL untuk proyek ini atau garpu.

MacOS NSVIEW

TerminalView Implementasi NSView MacOS APPKIT adalah kontrol NSVIEW yang dapat digunakan kembali yang dapat dihubungkan ke sumber apa pun dengan mengimplementasikan TerminalViewDelegate .
Saya mengantisipasi bahwa skenario umum akan menjadi tuan rumah perintah UNIX lokal, jadi saya telah memasukkan LocalProcessTerminalView yang merupakan implementasi yang menghubungkan TerminalView ke UNIX pseudo terminal dan menjalankan perintah di sana.

iOS UIVIEW

Ada implementasi UIView UIKIT yang setara untuk TerminalView yang seperti NSView Companion -nya adalah tampilan yang dapat disematkan dan dapat digunakan kembali yang dapat dihubungkan ke aplikasi Anda dengan menerapkan terminalViewDelegate yang sama. Berbeda dengan kasus NSVIEW yang berjalan pada Mac, di mana skenario umum adalah menjalankan perintah lokal, mengingat bahwa iOS tidak menawarkan akses ke proses, skenario yang paling umum adalah dengan menangani terminal ini ke host jarak jauh. Dan cara teraman untuk menghubungkan ke sistem jarak jauh adalah dengan SSH.

Kode bersama antara macOS dan iOS

Kode iOS dan UIKIT berbagi banyak kode, kode itu hidup di bawah direktori Apple.

Menggunakan ssh

Perpustakaan inti saat ini tidak memberikan cara yang nyaman untuk terhubung ke SSH, murni untuk menghindari ketergantungan tambahan. Tetapi modul git ini merujuk pada modul yang menarik klien SSH yang sudah dikompilasi (Swiftsh Frugghi), bersama dengan UIKitSsshTerminalView dalam sampel iOS yang menghubungkan TerminalView untuk iOS ke koneksi SSH.

Bekerja pada Swiftterm

Jika Anda menggunakan XCODE, ada dua proyek Toplevel, satu untuk Mac dan satu untuk iOS di direktori TerminalApp, satu disebut "iosterminal.xcodeproj" dan satu yang disebut "macterminal.xcodeproj".

Ini diperlukan karena Xcode tidak memberikan penyelesaian kode untuk iOS jika Anda memiliki proyek Mac di proyek. Jadi saya harus membaginya. Kedua proyek merujuk paket cepat yang sama.

Saat bekerja dengan proyek -proyek ini, jika Anda memilih aplikasi terminal, itu akan menjalankan yang ini. Untuk menjalankan test suite, pilih target 'Swiftterm' sebagai gantinya, dan Anda dapat menggunakan 'SwifttermFuzz' untuk menjalankan fuzzer.

Anda dapat menggunakan swift build untuk membangun paket, dan swift test untuk menjalankan test suite - tetapi berhati -hatilah bahwa suite tes mengharapkan direktori esctest akan diperiksa untuk dijalankan. Anda dapat melihat bagaimana saya menjalankan ini pada tindakan github dalam file .github/workflows/swift.yml jika Anda ingin melakukan ini secara lokal.

Jika menggunakan XCODE, Anda dapat memilih proyek "Swiftterm", dan kemudian menggunakan Command-U untuk menjalankan test suite.

Pekerjaan yang tertunda

Masalah GitHub memiliki daftar fitur dan peningkatan yang diinginkan

Rencana jangka panjang

Dalam jangka panjang, saya juga ingin menambahkan TVOS UIVIEW, front-end SwiftGTK untuk Linux.

Tangkapan layar

24 bit warna

Komandan tengah malam

Dukungan UTF-8 yang solid, rendering yang sangat baik:

Mendukung hyperlink yang dipancarkan oleh aplikasi modern:

Dukungan iOS:

Dukungan Sixel:

Sumber daya

• Panduan Pengguna Digital VT100
• Panduan Terminal - Sangat bagus dan visual, tetapi tidak normatif
• Urutan kontrol xterm
• Informasi Programmer Terminal Video VT510

Dokumen tambahan dan berguna:

• VT330/VT340 Programmer Referensi Manual Volume 2: Pemrograman Grafis
• Parser untuk terminal video yang kompatibel dengan ANSI DEC
• Kode dan Standar
• Linux Console Docs Mereka adalah subset dari VT100, tetapi seringkali mudah diikuti.
• Grafik Sixel

Test suites:

• Vttest - tua, tapi masih bagus
• Esctest - Fantastic: George Nachman, penulis ITERM, menciptakan suite tes ini, dan menjadi standar Freedesktop. Sejak itu, Thomas E. Dickey, pemelihara xterm dan pemeliharaan banyak aplikasi teks telah berkontribusi pada upaya ini.

Penulis

• Terima kasih kepada pengembang Xterm.JS yang awalnya menulis emulator terminal yang dilisensikan di bawah lisensi yang memungkinkan penggunaan kembali maksimal.
• Marcin Krzyzanowski yang mahir meningkatkan dan mengkuratori mesin rendering di Appkit/coretext menjadi renderer yang mulia seperti sekarang ini - dan untuk kontribusinya pada mesin rendering
• Greg Munn yang melakukan banyak pekerjaan di Xtermsharp untuk mendukung kebutuhan Visual Studio untuk Mac
• Anders Borum telah menyumbangkan perbaikan keandalan, parser Sixel dan perubahan yang diperlukan untuk menggunakan Swiftter untuk digunakan dalam produksi.
• Miguel de Icaza -Me- yang telah mencari alasan untuk menulis beberapa kode cepat.