# YxzQrCode
**Repository Path**: itxz-repository/yxz-qr-code
## Basic Information
- **Project Name**: YxzQrCode
- **Description**: 一款功能完整的微信小程序二维码工具,支持扫码识别、生成二维码和条形码等功能
- **Primary Language**: JavaScript
- **License**: MIT
- **Default Branch**: develop
- **Homepage**: None
- **GVP Project**: No
## Statistics
- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-06-21
- **Last Updated**: 2025-06-21
## Categories & Tags
**Categories**: Uncategorized
**Tags**: None
## README
# 小籽二维码 - 微信小程序
扫码生成 · 简单便捷
一款功能完整的微信小程序二维码工具,支持扫码识别、生成二维码和条形码等功能
## ✨ 主要功能
### 🔍 扫码识别
- **智能识别**:支持二维码、条形码等多种格式
- **相册扫码**:可从相册选择图片进行识别
- **多种模式**:自定义摄像头和微信API两种扫码模式
- **结果处理**:自动识别URL、WiFi、联系人、电话等信息类型
### 📱 二维码生成
- **多类型支持**:文本、链接、WiFi、联系人信息
- **自定义样式**:支持多种样式和颜色设置
- **高清输出**:生成高质量二维码图片
- **保存分享**:可保存到相册或分享给好友
### 📊 条形码生成
- **多格式支持**:Code128、EAN13、Code39等标准格式
- **商品条码**:支持商品标准条形码生成
- **自定义配置**:可调整尺寸、颜色等参数
### 📝 扫码记录
- **历史记录**:自动保存所有扫码和生成记录
- **分类管理**:按类型和时间分类显示
- **快速操作**:支持复制、分享、删除等操作
- **数据统计**:显示使用统计和记录数量
## 🛠️ 技术特点
- **iOS风格界面**:采用现代化iOS设计风格,用户体验友好
- **响应式布局**:适配不同屏幕尺寸的设备
- **离线支持**:核心功能支持离线使用
- **性能优化**:采用懒加载和组件化开发
- **数据持久化**:使用本地存储保存用户数据
## 📁 项目结构
```
QrCode/
├── app.js # 应用入口文件
├── app.json # 应用配置文件
├── app.wxss # 全局样式文件
├── assets/ # 静态资源目录
│ ├── icons/ # 图标文件
│ └── js/ # 第三方JS库
├── config/ # 配置文件目录
│ └── api-config.js # API配置
├── pages/ # 页面目录
│ ├── index/ # 首页
│ ├── custom-scan/ # 自定义扫码页面
│ ├── generate-qr/ # 二维码生成页面
│ ├── generate-barcode/ # 条形码生成页面
│ ├── generate-result/ # 生成结果页面
│ └── history/ # 历史记录页面
└── utils/ # 工具类目录
├── api-service.js # API服务
├── history-manager.js # 历史记录管理
├── qrcode.js # 二维码工具
└── util.js # 通用工具函数
```
## 🚀 快速开始
### 环境要求
- 微信开发者工具
- Node.js (可选,用于开发工具)
### 安装步骤
1. **克隆项目**
```bash
git clone [项目地址]
cd QrCode
```
2. **配置项目**
- 复制 `config/api-config.js` 为 `config/api-config.local.js`
- 在 `config/api-config.local.js` 中填入您的API服务器地址和配置
- 在 `project.config.json` 中填入您的小程序AppID
> 💡 **配置说明**:项目会优先使用 `api-config.local.js`(不会上传到Git),如果不存在则使用默认的 `api-config.js`
3. **微信开发者工具导入**
- 打开微信开发者工具
- 选择"导入项目"
- 选择项目目录
- 确认AppID配置正确
4. **预览和调试**
- 点击"编译"按钮
- 使用"真机调试"测试摄像头功能
- 可使用"预览"功能在手机上体验
> ⚠️ **重要提醒**:首次使用前请仔细阅读 [DEPLOYMENT.md](DEPLOYMENT.md) 文件了解如何正确配置敏感信息。
## 📋 功能详情
### 扫码功能
- 支持QR码、Data Matrix、PDF417等二维码格式
- 支持EAN、UPC、Code128等条形码格式
- 自动识别内容类型(URL、文本、WiFi配置等)
- 提供历史记录和快速操作
### 生成功能
- **二维码生成**:支持文本、URL、WiFi、联系人信息
- **条形码生成**:支持商品码、自定义文本编码
- **样式自定义**:颜色、尺寸、边距等参数调整
- **批量操作**:支持批量生成和导出
### 历史管理
- 自动保存所有操作记录
- 按日期、类型分类展示
- 支持搜索和筛选
- 数据导出和备份功能
## 🎨 界面预览
- **首页**:功能导航和快速操作
- **扫码页**:实时摄像头预览和识别
- **生成页**:参数配置和实时预览
- **历史页**:记录列表和详情查看
## 🔧 自定义配置
### API配置
修改 `config/api-config.js` 文件来配置后端服务地址:
```javascript
module.exports = {
baseUrl: 'https://your-api-domain.com',
timeout: 10000,
// 其他配置...
}
```
### 功能开关
在 `app.js` 中可以配置功能开关:
```javascript
globalData: {
enableOfflineMode: true, // 离线模式
enableHistory: true, // 历史记录
enableShare: true, // 分享功能
}
```
## 📱 兼容性
- **微信版本**:要求微信7.0.0及以上版本
- **系统支持**:iOS 10.0+、Android 5.0+
- **功能权限**:需要摄像头、相册访问权限
## 🤝 贡献指南
欢迎提交Issue和Pull Request来帮助改进项目!
1. Fork 项目
2. 创建功能分支 (`git checkout -b feature/AmazingFeature`)
3. 提交更改 (`git commit -m 'Add some AmazingFeature'`)
4. 推送到分支 (`git push origin feature/AmazingFeature`)
5. 打开 Pull Request
## 📄 开源协议
本项目采用 MIT 协议开源 - 查看 [LICENSE](LICENSE) 文件了解详情。
## 👨💻 作者
- 如有疑问或建议,欢迎提交Issue
## 🙏 致谢
- 感谢微信小程序平台提供的开发框架
- 感谢开源社区提供的各种工具库和组件
- 感谢所有贡献者和用户的支持
---