KeyboardKit - SwiftUI框架下的iOS自定义键盘扩展开发工具

KeyboardKit标志

Swift 5.9 Swift UI MIT许可证

关于KeyboardKit

KeyboardKit是一个SwiftUI SDK，只需几行代码即可让您创建完全可定制的[键盘扩展][About]。

KeyboardKit扩展了Apple有限的键盘API，增强了输入控制器和代理的功能，并为您提供额外的功能、状态和视图，让您能够构建出色的自定义键盘。

KeyboardKit是开源的，完全免费。它可以通过[KeyboardKit Pro][Pro]进行扩展，解锁Pro功能，如68种语言环境、自动完成和自动纠错、表情符号键盘、AI支持、主题、听写等更多功能。

安装

KeyboardKit可以通过Swift包管理器安装：

https://github.com/KeyboardKit/KeyboardKit.git

安装KeyboardKit后，请确保将其链接到所有需要它的目标。

入门

安装KeyboardKit后，只需让您的KeyboardViewController继承KeyboardInputViewController而不是UIInputViewController：

import KeyboardKit

class KeyboardController: KeyboardInputViewController {}

这将使您的控制器可以访问新的生命周期函数，如viewWillSetupKeyboard，可观察的状态，如state.keyboardContext，以及服务，如services.actionHandler等。

如果您只想使用标准的KeyboardView，它模仿原生iOS键盘，您不需要做任何其他操作。KeyboardKit会为您设置好一切。

要替换或自定义标准的KeyboardView，只需重写viewWillSetupKeyboard并使用view构建器调用setup：

class KeyboardViewController: KeyboardInputViewController {

    override func viewWillSetupKeyboard() {
        super.viewWillSetupKeyboard()
        setup { [weak self] controller in // <-- 如果您在这里需要self，请使用[weak self]或[unowned self]。
            KeyboardView(
                state: controller.state,
                services: controller.services,
                buttonContent: { $0.view },
                buttonView: { $0.view },
                emojiKeyboard: { $0.view },
                toolbar: { _ in MyCustomToolbar() }
            )
        }
    }
}

有关更多信息，请参阅[入门指南][Getting-Started]。

支持的语言环境

KeyboardKit支持[68种键盘特定的语言环境][Localization]： 🇦🇱 🇦🇪 🇦🇲 🇧🇾 🇧🇬 🇦🇩 🏳️ 🇭🇷 🇨🇿 🇩🇰
🇳🇱 🇧🇪 🇺🇸 🇬🇧 🇺🇸 🇪🇪 🇫🇴 🇵🇭 🇫🇮 🇫🇷
🇨🇦 🇧🇪 🇨🇭 🇬🇪 🇩🇪 🇦🇹 🇨🇭 🇬🇷 🇺🇸 🇮🇱
🇭🇺 🇮🇸 🏳️ 🇮🇩 🇮🇪 🇮🇹 🇰🇿 🇹🇯 🇹🇯 🇹🇯
🇱🇻 🇱🇹 🇲🇰 🇲🇾 🇲🇹 🇲🇳 🏳️ 🇳🇴 🇳🇴 🇮🇷
🇵🇱 🇵🇹 🇧🇷 🇷🇴 🇷🇺 🇷🇸 🇷🇸 🇸🇰 🇸🇮 🇪🇸
🇦🇷 🇲🇽 🇰🇪 🇸🇪 🇹🇷 🇺🇦 🇺🇿 🏴󠁧󠁢󠁷󠁬󠁳󠁿

KeyboardKit提供基本的键盘布局和基本的弹出操作。[KeyboardKit Pro][Pro]为所有支持的区域提供本地化的布局、弹出窗口和行为。