172 lines
4.4 KiB
Markdown
172 lines
4.4 KiB
Markdown
|
# 键盘多语言/多布局功能 - 快速参考
|
|||
|
|
|
|||
|
|
## 🎯 核心功能
|
|||
|
|
|
|||
|
|
### 支持的语言和布局
|
|||
|
|
| 语言 | 布局选项 | ProfileId 示例 |
|
|||
|
|
|------|---------|---------------|
|
|||
|
|
| 英语 | QWERTY | `en_US_qwerty` |
|
|||
|
|
| 西班牙语 | QWERTY / AZERTY / QWERTZ | `es_ES_azerty` |
|
|||
|
|
| 葡萄牙语 | QWERTY | `pt_PT_qwerty` |
|
|||
|
|
| 繁体中文 | 拼音 / 注音全键盘 / 注音标准 | `zh_Hant_TW_bopomofo_full` |
|
|||
|
|
| 印尼语 | QWERTY | `id_ID_qwerty` |
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
## 📁 关键文件
|
|||
|
|
|
|||
|
|
### 新增文件（需要添加到 Xcode）
|
|||
|
|
```
|
|||
|
|
Shared/
|
|||
|
|
├── Resource/
|
|||
|
|
│ └── kb_input_profiles.json # 配置文件
|
|||
|
|
├── KBInputProfileManager.h # 管理器头文件
|
|||
|
|
└── KBInputProfileManager.m # 管理器实现
|
|||
|
|
|
|||
|
|
CustomKeyboard/
|
|||
|
|
└── Manager/
|
|||
|
|
├── KBKeyboardLayoutResolver.h # 解析器头文件
|
|||
|
|
└── KBKeyboardLayoutResolver.m # 解析器实现
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
### 修改文件
|
|||
|
|
```
|
|||
|
|
CustomKeyboard/
|
|||
|
|
├── Resource/
|
|||
|
|
│ └── kb_keyboard_layout_config.json # 新增布局配置
|
|||
|
|
├── View/
|
|||
|
|
│ ├── KBKeyboardView.h/m # 布局切换逻辑
|
|||
|
|
│ └── KBKeyBoardMainView.h/m # 布局重载方法
|
|||
|
|
├── Manager/
|
|||
|
|
│ └── KBSuggestionEngine.h/m # 联想引擎分流
|
|||
|
|
└── KeyboardViewController.m # 布局检查逻辑
|
|||
|
|
|
|||
|
|
keyBoard/
|
|||
|
|
└── Class/Me/VC/
|
|||
|
|
└── KBPersonInfoVC.m # 配置管理器集成
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
## 🔑 关键 API
|
|||
|
|
|
|||
|
|
### 主 App 侧
|
|||
|
|
```objc
|
|||
|
|
// 获取所有语言配置
|
|||
|
|
[[KBInputProfileManager sharedManager] allProfiles];
|
|||
|
|
|
|||
|
|
// 根据语言代码获取配置
|
|||
|
|
[[KBInputProfileManager sharedManager] profileForLanguageCode:@"es"];
|
|||
|
|
|
|||
|
|
// 根据 profileId 获取布局 JSON ID
|
|||
|
|
[[KBInputProfileManager sharedManager] layoutJsonIdForProfileId:@"es_ES_azerty"];
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
### 扩展侧
|
|||
|
|
```objc
|
|||
|
|
// 获取当前 profileId
|
|||
|
|
[[KBKeyboardLayoutResolver sharedResolver] currentProfileId];
|
|||
|
|
|
|||
|
|
// 获取布局 JSON ID
|
|||
|
|
[[KBKeyboardLayoutResolver sharedResolver] layoutJsonIdForProfileId:profileId];
|
|||
|
|
|
|||
|
|
// 获取联想引擎类型
|
|||
|
|
[[KBKeyboardLayoutResolver sharedResolver] suggestionEngineForProfileId:profileId];
|
|||
|
|
|
|||
|
|
// 重新加载布局
|
|||
|
|
[keyboardView reloadLayoutWithProfileId:profileId];
|
|||
|
|
|
|||
|
|
// 切换联想引擎
|
|||
|
|
[[KBSuggestionEngine shared] setEngineTypeFromString:@"pinyin_traditional"];
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
## 🔄 数据流
|
|||
|
|
|
|||
|
|
### 主 App → 扩展
|
|||
|
|
```
|
|||
|
|
用户选择语言/布局
|
|||
|
|
↓
|
|||
|
|
KBPersonInfoVC 写入 App Group
|
|||
|
|
↓
|
|||
|
|
AppGroup_SelectedKeyboardProfileId = "es_ES_azerty"
|
|||
|
|
AppGroup_SelectedKeyboardLanguageCode = "es"
|
|||
|
|
AppGroup_SelectedKeyboardLayoutVariant = "azerty"
|
|||
|
|
↓
|
|||
|
|
扩展读取 App Group
|
|||
|
|
↓
|
|||
|
|
KBKeyboardLayoutResolver 解析 profileId
|
|||
|
|
↓
|
|||
|
|
layoutJsonId = "letters_azerty"
|
|||
|
|
suggestionEngine = "latin"
|
|||
|
|
↓
|
|||
|
|
KBKeyboardView 加载布局
|
|||
|
|
KBSuggestionEngine 切换引擎
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
## 🧪 快速测试
|
|||
|
|
|
|||
|
|
### 1. 验证文件完整性
|
|||
|
|
```bash
|
|||
|
|
cd "/Users/mac/Desktop/项目/公司/KeyBoard"
|
|||
|
|
./check_files.sh
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
### 2. 验证 App Group 数据
|
|||
|
|
```objc
|
|||
|
|
NSUserDefaults *appGroup = [[NSUserDefaults alloc] initWithSuiteName:@"group.com.loveKey.nyx"];
|
|||
|
|
NSLog(@"ProfileId: %@", [appGroup stringForKey:@"AppGroup_SelectedKeyboardProfileId"]);
|
|||
|
|
NSLog(@"LanguageCode: %@", [appGroup stringForKey:@"AppGroup_SelectedKeyboardLanguageCode"]);
|
|||
|
|
NSLog(@"LayoutVariant: %@", [appGroup stringForKey:@"AppGroup_SelectedKeyboardLayoutVariant"]);
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
### 3. 验证布局切换
|
|||
|
|
1. 主 App 切换到"Español · AZERTY"
|
|||
|
|
2. 打开备忘录，调出键盘
|
|||
|
|
3. 检查第一行是否为: `a z e r t y u i o p`
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
## 🐛 快速排查
|
|||
|
|
|
|||
|
|
| 问题 | 检查项 | 解决方案 |
|
|||
|
|
|------|--------|---------|
|
|||
|
|
| 编译错误 | 文件是否添加到 target | 重新添加文件 |
|
|||
|
|
| 布局不切换 | App Group 数据是否写入 | 检查日志 |
|
|||
|
|
| 联想不工作 | 引擎类型是否切换 | 检查日志 |
|
|||
|
|
| 注音显示异常 | JSON 配置是否正确 | 检查配置文件 |
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
## 📊 实施进度
|
|||
|
|
|
|||
|
|
- [x] 代码实现
|
|||
|
|
- [ ] 添加文件到 Xcode
|
|||
|
|
- [ ] 编译验证
|
|||
|
|
- [ ] 基础测试
|
|||
|
|
- [ ] 完善联想引擎
|
|||
|
|
- [ ] 完整测试
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
## 📚 文档索引
|
|||
|
|
|
|||
|
|
| 文档 | 用途 |
|
|||
|
|
|------|------|
|
|||
|
|
| `final-implementation-guide.md` | 完整实施指南 |
|
|||
|
|
| `xcode-file-addition-guide.md` | Xcode 文件添加 |
|
|||
|
|
| `testing-checklist.md` | 完整测试清单 |
|
|||
|
|
| `keyboard-language-layout-implementation-summary.md` | 实现总结 |
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
## 💡 提示
|
|||
|
|
|
|||
|
|
- 优先完成 P0 任务（添加文件、编译、基础测试）
|
|||
|
|
- 联想引擎可以后续完善
|
|||
|
|
- 遇到问题先查看日志输出
|
|||
|
|
- 使用 `check_files.sh` 验证文件完整性
|