iOSclhswallpaper

iOS 交互式桌布

⚙️ Technical Overview / 技術原理

中文 | English

中文

運作流程

本專案使用 CAPlayground 製作 iOS 動態桌布，並透過 Nugget 安裝至支援的 iOS 裝置。

不同於傳統 Live Photo 桌布，本作品利用 Nugget 提供的系統配置修改能力，啟用 iOS 原本未公開的動態桌布功能，讓使用者能使用自製的互動式動畫桌布。

CAPlayground 負責建立桌布內容，包括：

• 圖片與多層圖層管理
• 動畫時間軸
• 透明度與位置變化
• 粒子效果
• 視差（Parallax）效果

匯出後會產生符合系統需求的桌布資源，再由 Nugget 協助安裝。

---

技術流程

CAPlayground
      │
      ▼
建立桌布專案
      │
      ▼
匯出桌布資源
      │
      ▼
Nugget
      │
      ├── SparseRestore
      ├── MobileGestalt 設定修改
      └── 桌布安裝
      │
      ▼
iOS Wallpaper Engine
      │
      ▼
互動式動態桌布

---

Nugget 安裝原理

Nugget 使用 SparseRestore 技術，在不進行越獄（Jailbreak）的情況下修改部分可寫入的系統資料。

透過調整 MobileGestalt 等系統設定，使 iOS 啟用原本限制於特定裝置或版本的功能。

此流程：

• ✅ 不需要 Jailbreak
• ✅ 不修改 Kernel
• ✅ 不注入系統程序
• ✅ 不修改系統分區

但由於依賴 Apple 系統漏洞與行為差異，因此支援版本可能隨 iOS 更新改變。

---

為什麼需要關閉「尋找我的 iPhone」？

在使用 Nugget 前，需要暫時停用「尋找我的 iPhone」。

原因是 Apple 的資料保護機制會限制部分系統資料修改操作，而 SparseRestore 需要在特定條件下寫入相關設定。

完成安裝後，通常可以重新啟用「尋找我的 iPhone」。

---

🇺🇸 English

Technical Overview

Workflow

This project uses CAPlayground to create animated iOS wallpapers and Nugget to install them on supported iOS devices.

Unlike traditional Live Photo wallpapers, this project uses Nugget's system configuration modification capabilities to enable custom animated wallpaper features that are normally unavailable to users.

CAPlayground is responsible for creating wallpaper content, including:

• Multi-layer composition
• Animation timeline
• Transform and opacity changes
• Particle effects
• Parallax effects

The exported wallpaper package is then processed and installed through Nugget.

---

Technical Pipeline

CAPlayground
      │
      ▼
Create Wallpaper Project
      │
      ▼
Export Wallpaper Package
      │
      ▼
Nugget
      │
      ├── SparseRestore
      ├── MobileGestalt Configuration
      └── Wallpaper Installation
      │
      ▼
iOS Wallpaper Engine
      │
      ▼
Interactive Animated Wallpaper

---

How Nugget Works

Nugget uses SparseRestore technology to modify supported system configurations without requiring a jailbreak.

By changing system configuration values such as MobileGestalt, Nugget can enable features that are normally restricted by iOS.

This process:

• ✅ Does not require Jailbreak
• ✅ Does not modify the iOS Kernel
• ✅ Does not inject system processes
• ✅ Does not modify the root filesystem

However, compatibility depends on Apple's security updates and supported iOS versions.

---

Why Disable Find My iPhone?

Before using Nugget, Find My iPhone must temporarily be disabled.

This is related to Apple's security and restore protection mechanisms, which restrict certain system data modifications while enabled.

After the installation process is completed, Find My iPhone can usually be enabled again.

---

Disclaimer / 免責聲明

This project is for educational and research purposes only.

本專案僅供學習與研究用途。

It does not provide jailbreak functionality, kernel modification, or security bypass methods.

本專案不提供越獄、Kernel 修改或安全機制繞過功能。

Compatibility depends on supported iOS versions and Nugget. 支援情況取決於 iOS 版本與 Nugget 支援狀態。