《Nugget 项目安装与配置指南》

1. 项目基础介绍

Nugget 是一个开源项目，旨在为 iOS 设备提供一种方法来解锁其全部潜力。该项目可以通过利用 sparserestore 漏洞来写入系统文件，从而实现一些通常无法访问的功能或选项。主要功能包括但不限于启用动态岛、更改设备模型名称、启用或禁用各种系统功能等。该项目主要使用 Python 编程语言。

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

• Python: 主要的编程语言，用于编写项目的主要逻辑。
• PySide6: 一个用于创建桌面级用户界面的框架，基于 Qt。
• pymobiledevice3: 用于与 iOS 设备进行通信和文件操作的一个库。

3. 项目安装和配置准备工作

在开始安装之前，请确保您的系统满足以下要求：

• 操作系统: Windows 或 Linux。
• iOS 版本: 项目支持 iOS 17.0+。
• 必需软件:
  • Windows 用户需要安装 Apple Devices 或 iTunes。
  • Linux 用户需要安装 usbmuxd 和 libimobiledevice。

此外，您需要准备以下环境：

• Python: 版本 3.8 或更高。
• 虚拟环境: 建议使用虚拟环境来管理项目依赖。

安装步骤

步骤 1: 设置虚拟环境

# macOS/Linux:
python3 -m venv .env # 只需执行一次
source .env/bin/activate # 每次使用前执行

# Windows:
python3 -m venv .env # 只需执行一次
.env\Scripts\activate.bat # 每次使用前执行

步骤 2: 安装依赖

pip3 install -r requirements.txt # 只需执行一次

步骤 3: 编译 UI 和资源文件

# 编译 mainwindow.ui
pyside6-uic qt/mainwindow.ui -o qt/ui_mainwindow.py

# 编译 resources.qrc
pyside6-rcc qt/resources.qrc -o resources_rc.py

步骤 4: 运行程序

python3 main_app.py

注意事项

• 确保在运行程序前已经激活虚拟环境。
• 根据您的路径，python 和 pip 可能需要替换为 python3 和 pip3。

通过以上步骤，您应该能够成功安装并运行 Nugget 项目。请注意，该项目涉及系统级的操作，使用时请务必谨慎，并确保备份重要数据。