# DeleteXcodeCache

**Repository Path**: HiHi_Peter/delete-xcode-cache

## Basic Information

- **Project Name**: DeleteXcodeCache
- **Description**: 删除缓存
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-10-27
- **Last Updated**: 2025-10-27

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Xcode 缓存清理工具

一款用于清理 Xcode 缓存的 macOS 应用程序，可以帮助释放大量磁盘空间。

## 功能特性

- 🔍 **自动扫描缓存** - 一键扫描所有 Xcode 缓存目录
- 📊 **详细大小显示** - 精确显示每个缓存目录占用的空间
- 🗑️ **安全清理** - 智能清理 DerivedData、Archives、DeviceSupport 等缓存
- 💻 **跨电脑使用** - 使用动态路径获取，可在任何 Mac 上运行
- 🎨 **简洁界面** - 中文界面，操作简单直观

## 清理的缓存类型

本工具会扫描并清理以下 Xcode 缓存：

1. **DerivedData (编译数据)** - 编译生成的数据，一般占用空间最大
2. **Archives (归档)** - Xcode 打包生成的归档文件
3. **iOS DeviceSupport (设备支持)** - iOS 设备支持文件
4. **Products (产品)** - 编译生成的产品文件
5. **Xcode Caches (缓存)** - Xcode 应用的缓存文件

## 使用方法

### 方法一：在 Xcode 中运行

1. 打开 `DeleteXcodeCache.xcodeproj`
2. 选择目标为 "DeleteXcodeCache" 和你的 Mac 设备
3. 点击运行按钮 (⌘R)
4. 应用会自动启动并开始扫描缓存

### 方法二：构建可分发的应用

1. 在 Xcode 中，选择 Product → Archive
2. 等待构建完成后，在 Organizer 中选择你的 Archive
3. 点击 "Distribute App"
4. 选择 "Development" 或 "Export"
5. 导出的 `.app` 文件可以分发给其他用户使用

### 方法三：导出给其他用户使用

如果你是开发者，想要分发给其他人：

1. **开发分发** (适合给团队内部成员使用):
   ```bash
   # 先构建 Release 版本
   # 在 Xcode 中: Product → Archive → Distribute App → Development
   ```

2. **无需签名的通用版本** (适合自己使用):
   - 在 Xcode 中构建应用
   - 找到生成的 `.app` 文件
   - 将 `.app` 拖拽到 Applications 文件夹
   - 右键点击应用，选择"打开"

## 安装在其他电脑上

### 方式一：通过代码构建

1. 将整个项目文件夹发送给对方
2. 对方在 Xcode 中打开项目
3. 直接运行或构建应用

### 方式二：导出为独立应用

1. 按照上面的"构建可分发的应用"步骤
2. 将生成的 `.app` 文件发送给对方
3. 对方双击安装即可使用

### 使用说明

**重要提示**：macOS 可能会阻止未签名的应用运行，如果遇到 "无法打开" 的提示：

1. 打开"系统设置" → "隐私与安全性"
2. 找到被阻止的应用
3. 点击"仍要打开"按钮

## 技术实现

- ✅ 使用 `NSHomeDirectory()` 动态获取用户主目录
- ✅ 支持所有 Mac 上的不同用户路径
- ✅ 异步扫描和删除，不阻塞 UI
- ✅ 显示详细的进度和结果信息
- ✅ 安全的文件操作，避免误删系统文件

## 注意事项

⚠️ 清理 DerivedData 会导致：
- Xcode 的代码补全会暂时变慢（首次使用）
- 已打开的项目需要重新编译

💡 建议：
- 在清理前先关闭所有 Xcode 窗口
- 清理后会释放大量磁盘空间
- 首次重新编译时间会稍长

## 兼容性

- macOS 15.2 或更高版本
- Xcode 14.0 或更高版本
- 支持 Intel 和 Apple Silicon Mac

## 开发信息

- 开发语言：Swift
- UI 框架：SwiftUI
- 最低系统版本：macOS 15.2

## 许可证

本项目仅供个人使用和学习。

## 更新日志

### Version 1.0 (2025/10/27)
- ✨ 初始版本
- 支持扫描和清理 Xcode 缓存
- 中文界面
- 跨电脑动态路径支持