
KeyboardKit هي Swiftui SDK تتيح لك إنشاء ملحقات لوحة مفاتيح قابلة للتخصيص بالكامل مع بضعة أسطر من التعليمات البرمجية.
يمتد KeyboardKit واجهات برمجة تطبيقات لوحة المفاتيح المحدودة من Apple مع المزيد من القدرات ، ويوفر وظائف إضافية ، للسماح لك ببناء لوحات مفاتيح مخصصة متميزة مع القليل من الجهد.

لوحة المفاتيح مفتوحة المصدر وخالية تمامًا. يمكن تمديده باستخدام لوحة المفاتيح Pro لإلغاء قفل ميزات Pro ، مثل لوحات المفاتيح المترجمة ، والإكمال التلقائي والتصحيح التلقائي ، ودعم AI ، ولوحة مفاتيح الرموز التعبيرية ، والموضوعات ، والإملاء ، وأكثر من ذلك.
يمكن تثبيت لوحة المفاتيح مع مدير الحزمة Swift:
https://github.com/KeyboardKit/KeyboardKit.git
لاستخدام لوحة المفاتيح في امتداد لوحة المفاتيح ، ما عليك سوى استيراد KeyboardKit ودع KeyboardController الخاصة بك ترث KeyboardInputViewController بدلاً من UIInputViewController :
import KeyboardKit
class KeyboardController : KeyboardInputViewController { } يتيح لك هذا الوصول إلى وظائف دورة الحياة مثل viewWillSetupKeyboardView ، حالة يمكن ملاحظتها ، الخدمات ، إلخ.
أسهل طريقة لإعداد لوحة المفاتيح هي إنشاء قيمة KeyboardApp تحدد المعلومات لتطبيقك:
extension KeyboardApp {
static var keyboardKitDemo : Self {
. init (
name : " KeyboardKit " ,
licenseKey : " keyboardkitpro-license-key " ,
bundleId : " com.keyboardkit.demo " ,
appGroupId : " group.com.keyboardkit.demo " ,
deepLinks : . init ( app : " kkdemo:// " )
)
}
} لإعداد لوحة المفاتيح الخاصة بك ، ما عليك سوى تجاوز viewDidLoad setup(for:) مع قيمة KeyboardApp الخاصة بك:
class KeyboardViewController : KeyboardInputViewController {
override func viewDidLoad ( ) {
super . viewDidLoad ( )
setup ( for : . keyboardKitDemo )
}
} لاستبدال أو تخصيص لوحة مفاتيح KeyboardView القياسية ، ما عليك سوى تجاوز viewWillSetupKeyboardView و Call setupKeyboardView مع العرض الذي تريد استخدامه:
class KeyboardViewController : KeyboardInputViewController {
override func viewWillSetupKeyboardView ( ) {
super . viewWillSetupKeyboardView ( )
setupKeyboardView { [ weak self ] controller in // <-- Use weak or unknowned self!
KeyboardView (
state : controller . state ,
services : controller . services ,
buttonContent : { $0 . view } ,
buttonView : { $0 . view } ,
collapsedView : { $0 . view } ,
emojiKeyboard : { $0 . view } ,
toolbar : { _ in MyCustomToolbar ( ) }
)
}
}
} لإعداد تطبيقك الرئيسي بنفس التكوين ، ما عليك سوى لف عرض محتوى الجذر في KeyboardAppView :
import SwiftUI
import KeyboardKit
@ main
struct MyApp : App {
var body : some Scene {
WindowGroup {
KeyboardAppView ( for : . keyboardKitDemo ) {
ContentView ( )
}
}
}
} سيؤدي إعداد التطبيق ولوحة المفاتيح باستخدام KeyboardApp إلى جعل الإعدادات متزامنة بين الاثنين إذا تم تعريف appGroupId ، وتسجيل ترخيص لوحة المفاتيح الخاصة بك إذا تم تعريف licenseKey ، أو إعداد الإملاء ، أو الروابط العميقة ، وما إلى ذلك.
لمزيد من المعلومات ، راجع دليل البدء.
تدعم لوحة المفاتيح 71 لغات خاصة بالوحة المفاتيح:
؟ ؟ ؟ ؟ ؟ ؟ ؟ ؟ ️؟ ️ ؟؟
؟ ؟ ؟ ؟ ؟ ؟ ؟ ؟ ؟ ؟
؟ ؟ ؟ ؟ ؟ ؟ ؟ ؟ ؟ ؟
؟ ؟ ؟ ؟ ؟ ؟ ️ ؟؟ ؟ ؟ ؟
؟ ؟ ؟ ؟ ؟ ؟ ؟ ؟ ؟ ؟ ️
؟ ؟ ؟ ؟ ؟ ؟ ؟ ؟ ؟ ؟
؟ ؟ ؟ ؟ ؟ ؟ ؟ ؟ ؟ ؟
؟؟؟؟؟؟؟
تتضمن لوحة المفاتيح فقط سلاسل محلية ، بينما تقوم لوحة المفاتيح Pro بإلغاء تأمين لوحات المفاتيح المترجمة والتخطيطات والرسالة الشرقية والسلوكيات لجميع اللغات المدعومة.
لوحة المفاتيح مليئة بميزات لمساعدتك في بناء لوحات مفاتيح مخصصة مذهلة:
تمتد لوحة المفاتيح Pro
UITextDocumentProxy بقراءة المستند الكامل.تحتوي الوثائق عبر الإنترنت على مقالة مفصلة لكل ميزة ، ودليل شامل للبدء ، وعينات رمز ، وما إلى ذلك ، يمكنك أيضًا إنشاءها من الرمز المصدر للحصول على تنسيق أفضل.
يحتوي المجلد Demo على تطبيق تجريبي يوضح كيفية إعداد تطبيق لوحة المفاتيح الرئيسية ، وإظهار حالة لوحة المفاتيح ، وتوفير إعدادات في التطبيق ، وربط إعدادات النظام ، وتطبيق الأنماط المخصصة ، إلخ.
يحتوي التطبيق على لوحين مفاتيح - Keyboard تستخدم لوحة المفاتيح KeyboardPro التي تستخدم لوحة المفاتيح Pro. لاحظ أنك تحتاج إلى تمكين الوصول الكامل لبعض الميزات للعمل ، مثل التعليقات Haptic.
مهم
لم يكن العرض التوضيحي موقّعًا ، وبالتالي لا يمكنه استخدام مجموعة تطبيقات لمزامنة الإعدادات بين التطبيق ولوحات المفاتيح الخاصة به. على هذا النحو ، تحتوي لوحة مفاتيح KeyboardPro على شاشات إعدادات في لوحة المفاتيح أيضًا.
إذا كنت ترغب في تجربة KeyboardKit دون الحاجة إلى كتابة أي رمز أو إنشاء تطبيق تجريبي من XCode ، يتيح لك تطبيق لوحة المفاتيح تجربة العديد من الميزات بمجرد تنزيله من متجر التطبيقات.
KeyboardKit مفتوحة المصدر ومجانية تمامًا ، ولكن يمكنك دعم المشروع من خلال أن تصبح راعي Github ، أو الترقية إلى لوحة المفاتيح Pro أو الاتصال بالعمل المستقل ، والدعم المدفوع ، إلخ.
لا تتردد في التواصل إذا كان لديك أسئلة أو إذا كنت تريد المساهمة بأي شكل من الأشكال:
لوحة المفاتيح متوفرة تحت رخصة معهد ماساتشوستس للتكنولوجيا. انظر ملف الترخيص لمزيد من المعلومات.