azooKey 项目常见问题解决方案

azooKey 项目常见问题解决方案

azooKey azooKey, Japanese Keyboard app for iOS, fully implemented in Swift 项目地址: https://gitcode.com/gh_mirrors/az/azooKey

项目基础介绍

azooKey 是一个完全使用 Swift 开发的日本语键盘 iOS 应用程序。该项目提供了独特的自定义功能，如自定义键、自定义标签、实时转换引擎等。azooKey 在 App Store 上发布，支持 iOS 和 iPadOS 设备。

主要编程语言

该项目主要使用 Swift 进行开发。

新手使用注意事项及解决方案

1. 项目克隆时未使用 --recursive 选项

问题描述：
azooKey 项目使用了子模块（submodule），如果克隆项目时未使用 --recursive 选项，子模块将不会被正确下载，导致项目无法正常编译。

解决步骤：

1. 删除当前克隆的项目目录。
2. 重新克隆项目，并确保使用 --recursive 选项：

   git clone https://github.com/ensan-hcl/azooKey.git --recursive
   

3. 进入项目目录，检查子模块是否正确下载：

   cd azooKey
   git submodule status
   

2. Xcode 版本不兼容

问题描述：
azooKey 项目要求使用最新版本的 Xcode 进行开发。如果使用旧版本的 Xcode，可能会导致编译错误或功能异常。

解决步骤：

1. 检查当前系统上安装的 Xcode 版本：

   xcodebuild -version
   

2. 如果版本不是最新的，前往 Apple Developer 下载并安装最新版本的 Xcode。
3. 安装完成后，重新打开项目并尝试编译。

3. 缺少 Apple Developer Account

问题描述：
azooKey 项目需要 Apple Developer Account 才能在设备上运行和测试。如果没有 Apple Developer Account，将无法进行开发和测试。

解决步骤：

1. 前往 Apple Developer 注册一个免费的 Apple Developer Account。
2. 注册完成后，在 Xcode 中配置你的 Apple ID：
   • 打开 Xcode，进入 Preferences。
   • 选择 Accounts 选项卡，点击左下角的 + 按钮，选择 Apple ID，然后输入你的 Apple ID 和密码。
3. 配置完成后，选择你的开发者账号，并确保项目中的签名配置正确。

通过以上步骤，新手可以顺利解决在使用 azooKey 项目时可能遇到的常见问题。

azooKey azooKey, Japanese Keyboard app for iOS, fully implemented in Swift 项目地址: https://gitcode.com/gh_mirrors/az/azooKey