KeyboardKit Pro

KeyboardKit 让您只需几行代码，使用 Swift & SwiftUI 就能创建出令人惊叹的自定义键盘扩展。

KeyboardKit 通过更多功能扩展了 Apple 有限的键盘 API。 KeyboardKit Pro 通过解锁本地化键盘、自动完成、表情符号键盘、AI 支持、主题等等，进一步扩展了这些功能。

安装

KeyboardKit Pro 可以使用 Swift Package Manager 进行安装

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

使用 KeyboardKit Pro 需要许可证。您可以在 KeyboardKit 网站或 Gumroad 商店上注册。

重要提示

与 KeyboardKit 不同，KeyboardKit Pro 是一个二进制目标，必须仅链接到应用目标。

入门

设置 KeyboardKit 最简单的方法是首先为您的应用程序创建一个 KeyboardApp 值

extension KeyboardApp {

        static var keyboardKitDemo: KeyboardApp {
        .init(
            name: "KeyboardKit",
            licenseKey: "your-key-here",                // Sets up KeyboardKit Pro!
            appGroupId: "group.com.keyboardkit.demo",   // Sets up App Group data sync
            locales: .keyboardKitSupported,             // Sets up the enabled locales
            autocomplete: .init(                        // Sets up custom autocomplete  
                nextWordPredictionRequest: .claude(...) // Sets up AI-based prediction
            ),
            deepLinks: .init(app: "kkdemo://", ...)     // Defines how to open the app
        )
    }
}

接下来，让您的 KeyboardController 继承 KeyboardInputViewController 而不是 UIInputViewController

class KeyboardController: KeyboardInputViewController {}

这将解锁其他功能和特性，并将 services 和可观察的 state 注入到控制器。

接下来，覆盖 viewDidLoad() 并使用您的应用程序值调用 setupPro(for:)

class KeyboardViewController: KeyboardInputViewController {

    override func viewDidLoad() {
        super.viewDidLoad()
        
        setup(for: .keyboardKitDemo) { result in
            // If result is successful, KeyboardKit Pro is now active
            // You can now customize your keyboard and tweak features 
        }
    }
}

要替换或自定义标准的 KeyboardView 视图，只需覆盖 viewWillSetupKeyboardView() 并使用您想要使用的视图调用 setupKeyboardView(with:)

class KeyboardViewController: KeyboardInputViewController {

    override func 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: { $0.view }
            )
        }
    }
}

要使用相同的键盘配置来设置您的主应用程序，只需将内容视图包装在 KeyboardAppView 中

@main
struct MyApp: App {

    var body: some Scene {
        WindowGroup {
            KeyboardAppView(for: .keyboardKitDemo) {
                ContentView()
            }
        }
    }
}

有关更多信息，请参见入门指南和要点文章。

本地化

KeyboardKit 支持 71 个键盘特定的语言环境

🇺🇸 🇦🇱 🇦🇪 🇦🇲 🇧🇾 🇧🇬 🇦🇩 🏳️ 🏳️ 🇭🇷
🇨🇿 🇩🇰 🇳🇱 🇧🇪 🇦🇺 🇨🇦 🇬🇧 🇺🇸 🇪🇪 🇫🇴
🇵🇭 🇫🇮 🇫🇷 🇨🇦 🇧🇪 🇨🇭 🇬🇪 🇩🇪 🇦🇹 🇨🇭
🇬🇷 🇺🇸 🇮🇱 🇭🇺 🇮🇸 🏳️ 🇮🇩 🇮🇪 🇮🇹 🇰🇿
🇹🇯 🇹🇯 🇹🇯 🇱🇻 🇱🇹 🇲🇰 🇲🇾 🇲🇹 🇲🇳 🏳️
🇳🇴 🇳🇴 🇮🇷 🇵🇱 🇵🇹 🇧🇷 🇷🇴 🇷🇺 🇷🇸 🇷🇸
🇸🇰 🇸🇮 🇪🇸 🇦🇷 🇲🇽 🇸🇪 🇰🇪 🇹🇷 🇺🇦 🇺🇿
🏴󠁧󠁢󠁷󠁬󠁳󠁿

KeyboardKit 仅包含本地化字符串，而 KeyboardKit Pro 解锁了所有支持的语言环境的本地化键盘、布局、标注和行为。

功能

KeyboardKit 提供了一个免费的开源键盘引擎。 KeyboardKit Pro 解锁了更强大的专业功能。

开源

🌱 要点 - 必要的键盘实用程序、模型、服务和视图。
⌨️ Essentials-KeyboardView - 一个外观原生、可自定义的键盘。
💥 动作 - 触发和处理与键盘相关的动作。
📱 应用 - 设置您的应用程序、键盘、同步设置等。
🗯 标注 - 显示输入和辅助动作标注。
🖥️ 设备 - 识别设备类型、设备功能等。
😀 表情符号 - 表情符号、类别、版本、肤色等。
🔉 反馈 - 触发音频和触觉反馈。
👆 手势 - 处理任何键上的丰富手势集。
🔣 布局 - 定义和自定义动态键盘布局。
🌐 本地化 - 以 71 种语言环境本地化您的键盘。
🗺️ 导航 - 从键盘打开 URL 和其他应用程序。
👁 预览 - 广泛的 SwiftUI 预览支持。
📄 代理 - 使用更多功能扩展文本文档代理。
⚙️ 设置 - 提供键盘设置并链接到系统设置。
🩺 状态 - 检测键盘是否已启用，是否具有完全访问权限等。
🎨 样式 - 在很大程度上设置键盘的样式。

KeyboardKit Pro

🌱 要点 - 更多必要的工具、预览、工具栏等。
⌨️ Essentials-KeyboardView - 让键盘视图做更多的事情。
🤖 AI - AI 所需的功能。
📱 应用 - 应用特定的屏幕和视图。
💡 自动完成 - 本地和远程自动完成、下一个单词预测等。
🗯 标注 - 所有支持的语言环境的本地化标注操作。
🎤 听写 - 从键盘听写文本。
😀 表情符号 - 一个强大的表情符号键盘、搜索等。
⌨️ 外部 - 自动检测是否连接了外部键盘。
🏠 主机 - 识别并打开特定的宿主应用程序。
🔣 布局 - 更多输入集和所有支持的语言环境的布局。
🌐 本地化 - 所有支持的语言环境的服务和视图。
👁 预览 - 键盘和主题预览，供应用内使用。
📄 代理 - 允许 UITextDocumentProxy 读取完整文档。
📝 文本 - 允许用户在键盘中键入。
🍭 主题 - 一个具有许多预定义主题的主题引擎。

文档

在线文档具有详细的入门指南、每个功能的详细文章、代码示例等。您也可以从源代码构建它，以获得更好的格式。

演示应用

主存储库具有一个演示应用程序，展示了如何设置主键盘应用程序、显示键盘状态、提供应用程序内设置、链接到系统设置、应用自定义样式等。

该应用程序有两个键盘 - 一个使用 KeyboardKit 的 Keyboard 和一个使用 KeyboardKit Pro 的 KeyboardPro。

重要提示

该演示程序未进行代码签名，因此无法使用 App Group 在应用程序及其键盘之间同步设置。因此，KeyboardPro 键盘也在键盘中具有键盘设置。

KeyboardKit 应用

如果您想在无需编写任何代码或从 Xcode 构建演示应用程序的情况下尝试 KeyboardKit，则 KeyboardKit 应用程序允许您只需从 App Store 下载它即可试用许多功能。

联系方式

如果您有任何问题或想以任何方式做出贡献，请随时与我们联系

商业许可

使用 KeyboardKit Pro 需要许可证。您可以在 KeyboardKit 网站或 Gumroad 商店上注册。