Kiwix for iOS & macOS 安装和配置指南

Kiwix for iOS & macOS 安装和配置指南

apple Kiwix for offline access on iOS and macOS 项目地址: https://gitcode.com/gh_mirrors/ap/apple

1. 项目基础介绍和主要编程语言

项目基础介绍

Kiwix for iOS & macOS 是一个开源项目，旨在为苹果设备（iOS 和 macOS）提供离线阅读 Wikipedia 和其他 ZIM 文件内容的功能。该项目通过 App Store 和 Mac App Store 发布，支持最新的 iOS 和 macOS 版本。

主要编程语言

该项目主要使用 Swift 编程语言进行开发，Swift 是苹果公司推出的一种现代编程语言，专为 iOS、macOS、watchOS 和 tvOS 开发。

2. 项目使用的关键技术和框架

关键技术和框架

• SwiftUI: 用于构建用户界面的现代框架。
• Xcode: 苹果官方的集成开发环境（IDE），用于开发和调试 iOS 和 macOS 应用。
• Homebrew: macOS 的包管理器，用于安装和管理开发工具和依赖项。
• XcodeGen: 用于生成 Xcode 项目文件的工具，确保项目文件的一致性和可维护性。
• CoreKiwix: 一个包含 libkiwix 和 libzim 的 xcframework，提供核心的 Kiwix 功能。

3. 项目安装和配置的准备工作和详细安装步骤

准备工作

在开始安装和配置之前，请确保你已经完成以下准备工作：

1. Apple Developer 账户：虽然不需要会员资格，但你需要一个 Apple Developer 账户。
2. Xcode：确保你已经安装了最新版本的 Xcode。
3. Xcode 命令行工具：运行 xcode-select --install 安装 Xcode 命令行工具。
4. Homebrew：如果你还没有安装 Homebrew，可以通过以下命令安装：

   /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
   

详细安装步骤

1. 克隆项目仓库

首先，你需要从 GitHub 克隆 Kiwix for iOS & macOS 项目仓库：

git clone https://github.com/kiwix/apple.git

2. 安装依赖项

进入项目目录并运行以下命令，使用 Homebrew 安装项目所需的依赖项：

cd apple
brew bundle

3. 生成 Xcode 项目文件

使用 XcodeGen 生成 Xcode 项目文件：

xcodegen

4. 打开项目

在终端中运行以下命令，使用 Xcode 打开生成的项目文件：

open Kiwix.xcodeproj

5. 配置 Xcode 设置

在 Xcode 中，你需要进行以下配置：

• 更改 Bundle Identifier：在 Signing & Capabilities 中更改 Bundle Identifier。
• 选择签名证书/配置文件：选择适当的签名证书或配置文件。
• 启用自动修剪尾部空格：在 Xcode 设置 > Text Editing > Editing 中，启用 Automatically trim trailing whitespace 和 Include whitespace-only lines。

6. 编译和运行项目

完成上述配置后，你可以在 Xcode 中编译并运行项目。你可以选择在 iOS 模拟器或 macOS 设备上运行。

调试 WebView

在开发环境中，你可以通过 Safari 的开发菜单调试 WebView。如果 Kiwix 运行在设备上，你需要通过 USB 连接设备到 macOS 设备。如果运行在模拟器中，则可以直接使用。

部署和发布

项目支持自动化的部署流程，包括每晚的 FTP 上传和每周的 TestFlight 上传。你也可以手动触发 TestFlight 构建，并通过 GitHub Release 发布应用。

报告 Bug

如果你在使用过程中遇到问题，可以通过 GitHub 提交 Bug 报告或功能请求。在 macOS 上，如果需要，你可以打包 Kiwix 应用容器并提供给维护者进行进一步分析。

许可证

该项目采用 GPLv3 或更高版本的许可证，详细信息请参阅 LICENSE 文件。

通过以上步骤，你应该能够成功安装和配置 Kiwix for iOS & macOS 项目，并开始进行开发和调试。

apple Kiwix for offline access on iOS and macOS 项目地址: https://gitcode.com/gh_mirrors/ap/apple