164 lines
3.9 KiB
Markdown
164 lines
3.9 KiB
Markdown
# App图标搜索器增强版
|
||
|
||
一个高效、现代的 App 图标搜索和下载工具，基于 iTunes Search API 开发。支持多种尺寸图标下载，具有响应式设计和用户友好的界面。
|
||
|
||
## 功能特点
|
||
|
||
- 实时搜索：支持即时搜索结果展示
|
||
- 多尺寸下载：支持 75px、100px、256px、512px 尺寸
|
||
- 图片预览：支持图标大图预览
|
||
- 响应式设计：完美适配移动端和桌面端
|
||
- 智能缓存：支持服务端和客户端双重缓存机制
|
||
- 用户友好：简洁的界面设计和流畅的交互体验
|
||
|
||
## 技术栈
|
||
|
||
### 前端
|
||
- HTML5 + CSS3
|
||
- 原生 JavaScript (ES6+)
|
||
- CSS Grid 和 Flexbox 布局
|
||
- Service Worker 离线缓存
|
||
|
||
### 后端
|
||
- PHP 7.4+
|
||
- iTunes Search API
|
||
- 文件系统缓存
|
||
|
||
### 服务器
|
||
- Apache/Nginx
|
||
- PHP-FPM
|
||
- 图片缓存系统
|
||
|
||
## 部署指南
|
||
|
||
### 环境要求
|
||
- PHP >= 7.4
|
||
- Apache/Nginx Web服务器
|
||
- 允许外部API访问
|
||
- PHP GD库（用于图片处理）
|
||
- 足够的磁盘空间用于缓存
|
||
|
||
### Apache 部署步骤
|
||
|
||
```
|
||
<VirtualHost *:80>
|
||
ServerName your-domain.com
|
||
DocumentRoot /path/to/icons-enhanced
|
||
|
||
<Directory /path/to/icons-enhanced>
|
||
Options -Indexes +FollowSymLinks
|
||
AllowOverride All
|
||
Require all granted
|
||
</Directory>
|
||
|
||
<FilesMatch "\.(jpg|jpeg|png|gif)$">
|
||
Header set Cache-Control "max-age=31536000, public"
|
||
</FilesMatch>
|
||
</VirtualHost>
|
||
```
|
||
|
||
### Nginx 部署步骤
|
||
|
||
```
|
||
server {
|
||
listen 80;
|
||
server_name your-domain.com;
|
||
root /path/to/icons-enhanced;
|
||
index index.php;
|
||
|
||
location / {
|
||
try_files $uri $uri/ /index.php?$query_string;
|
||
}
|
||
|
||
location ~ \.php$ {
|
||
fastcgi_pass unix:/var/run/php/php7.4-fpm.sock;
|
||
fastcgi_index index.php;
|
||
fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
|
||
include fastcgi_params;
|
||
}
|
||
|
||
location ~* \.(jpg|jpeg|png|gif)$ {
|
||
expires 1y;
|
||
add_header Cache-Control "public, no-transform";
|
||
access_log off;
|
||
}
|
||
}
|
||
```
|
||
### 配置权限
|
||
|
||
```
|
||
chmod -R 755 .
|
||
chmod -R 777 cache/images
|
||
```
|
||
|
||
## 自定义开发指南
|
||
### 前端定制
|
||
1. 样式修改
|
||
- 主题颜色：修改 css/styles.css 中的 CSS 变量
|
||
- 布局调整：修改 Grid 和 Flexbox 相关样式
|
||
- 响应式断点：调整 media queries 中的尺寸
|
||
2. 交互优化
|
||
- 搜索逻辑：修改 js/scripts.js 中的防抖函数
|
||
- 动画效果：调整 transition 和 transform 相关属性
|
||
- 预览功能：自定义模态框行为
|
||
### 后端定制
|
||
1. 缓存策略
|
||
- 修改缓存时间：调整 ImageCache.php 中的 cacheDuration
|
||
- 自定义缓存目录：更改 cacheDir 配置
|
||
- 添加缓存清理机制
|
||
2. API 调整
|
||
- 修改搜索参数：调整 iTunes API 请求参数
|
||
- 添加错误处理：完善异常处理机制
|
||
- 扩展搜索源：添加其他图标源支持
|
||
### 性能优化
|
||
1. 图片优化
|
||
- 实现图片懒加载
|
||
- 添加图片压缩功能
|
||
- 使用 WebP 格式支持
|
||
2. 缓存优化
|
||
- 实现浏览器缓存
|
||
- 添加 CDN 支持
|
||
- 优化缓存策略
|
||
## 常见问题
|
||
1. 图片加载失败
|
||
- 检查服务器权限设置
|
||
- 验证缓存目录权限
|
||
- 确认外部API访问是否正常
|
||
2. 搜索响应慢
|
||
- 调整防抖时间
|
||
- 优化数据请求策略
|
||
- 检查服务器性能
|
||
3. 移动端适配问题
|
||
- 检查视口设置
|
||
- 调整响应式断点
|
||
- 优化触摸交互
|
||
## 维护建议
|
||
1. 定期维护
|
||
- 清理过期缓存
|
||
- 更新依赖版本
|
||
- 检查API可用性
|
||
2. 性能监控
|
||
- 监控服务器负载
|
||
- 跟踪API响应时间
|
||
- 分析用户使用数据
|
||
## 贡献指南
|
||
欢迎提交 Pull Request 或 Issue。在提交之前，请确保：
|
||
|
||
1. 代码符合现有风格
|
||
2. 添加必要的注释和文档
|
||
3. 测试所有功能正常
|
||
## 许可证
|
||
MIT License - 详见根目录 LICENSE 文件
|
||
|
||
## 作者
|
||
[Snowz]
|
||
|
||
## 更新日志
|
||
### v1.0.0 (2025-03-31)
|
||
- 初始版本发布
|
||
- 基础搜索功能
|
||
### v1.1.0 (2025-04-12)
|
||
- 添加图片懒加载
|
||
- 多尺寸下载支持
|
||
- 优化搜索体验
|
||
- 改进缓存机制 |