Skip to content

Commit 9d79508

Browse files
committed
English README.md
Signed-off-by: jiaxianhua <jiaxianhua@gmail.com>
1 parent 80f2eff commit 9d79508

File tree

3 files changed

+325
-322
lines changed

3 files changed

+325
-322
lines changed

README.md

Lines changed: 110 additions & 107 deletions
Original file line numberDiff line numberDiff line change
@@ -1,147 +1,150 @@
11
# Hash
2+
---
3+
4+
[简体中文](README_CN.md)
25

3-
一个简洁高效的 macOS 哈希值计算工具,支持多种哈希算法和文件批量处理。
6+
A concise and efficient macOS hash calculation tool that supports multiple hash algorithms and batch file processing.
47

5-
## 功能特性
8+
## Features
69

7-
- 🔐 **多种哈希算法支持**MD5SHA-1CRC32
8-
- 📁 **批量文件处理**:支持同时计算多个文件的哈希值
9-
- 🎯 **拖拽操作**:直接拖拽文件到应用程序窗口即可开始计算
10-
- 📋 **一键复制**:点击即可复制哈希值到剪贴板
11-
- 📊 **文件信息显示**:显示文件大小、版本信息、修改日期等
12-
- 🌍 **多语言支持**:支持 22 种语言,包括中文、英文、日文、韩文、德文、法文、西班牙文、俄文、阿拉伯文等
13-
- 🎨 **现代化界面**:基于 SwiftUI 构建的原生 macOS 应用
14-
-**高性能计算**:异步处理,支持大文件计算
10+
- 🔐 **Multiple Hash Algorithm Support**: MD5, SHA-1, CRC32
11+
- 📁 **Batch File Processing**: Calculate hash values for multiple files simultaneously
12+
- 🎯 **Drag & Drop Operation**: Simply drag files to the application window to start calculation
13+
- 📋 **One-Click Copy**: Click to copy hash values to clipboard
14+
- 📊 **File Information Display**: Shows file size, version info, modification date, etc.
15+
- 🌍 **Multilingual Support**: Supports 22 languages including Chinese, English, Japanese, Korean, German, French, Spanish, Russian, Arabic, etc.
16+
- 🎨 **Modern Interface**: Native macOS app built with SwiftUI
17+
-**High Performance Computing**: Asynchronous processing with support for large files
1518

16-
## 应用截图
19+
## Screenshots
1720

18-
![Hash 应用程序界面](Screenshots/hash.png)
21+
![Hash Application Interface](Screenshots/hash.png)
1922

20-
*Hash 应用程序的主界面,展示了文件选择、哈希计算和结果显示功能*
23+
*Main interface of the Hash application, showcasing file selection, hash calculation, and result display features*
2124

22-
## 系统要求
25+
## System Requirements
2326

24-
- macOS 11.0 或更高版本
25-
- Xcode 13.0 或更高版本(开发环境)
27+
- macOS 11.0 or later
28+
- Xcode 13.0 or later (for development)
2629

27-
## 安装
30+
## Installation
2831

29-
### 从源码构建
32+
### Build from Source
3033

31-
1. 克隆仓库:
34+
1. Clone the repository:
3235
```bash
33-
git clone git@github.com:iOSDevLog/Hash.git
36+
git clone https://github.com/iOSDevLog/Hash
3437
cd Hash
3538
```
3639

37-
2. 使用 Xcode 打开项目:
40+
2. Open the project with Xcode:
3841
```bash
3942
open Hash.xcodeproj
4043
```
4144

42-
3. Xcode 中构建并运行项目(⌘+R
45+
3. Build and run the project in Xcode (⌘+R)
4346

44-
## 使用方法
47+
## Usage
4548

46-
### 基本操作
49+
### Basic Operations
4750

48-
1. **启动应用程序**:双击应用图标或从 Launchpad 启动
51+
1. **Launch the Application**: Double-click the app icon or launch from Launchpad
4952

50-
2. **添加文件**
51-
- 点击"选择文件"按钮选择文件
52-
- 或直接将文件拖拽到应用程序窗口
53+
2. **Add Files**:
54+
- Click the "Select Files" button to choose files
55+
- Or drag files directly to the application window
5356

54-
3. **选择哈希算法**
55-
- 在右侧面板中勾选需要计算的哈希算法
56-
- 支持 MD5SHA-1CRC32
57+
3. **Select Hash Algorithm**:
58+
- Check the desired hash algorithms in the right panel
59+
- Supports MD5, SHA-1, CRC32
5760

58-
4. **开始计算**
59-
- 点击"开始计算"按钮
60-
- 或添加文件后自动开始计算
61+
4. **Start Calculation**:
62+
- Click the "Start Calculation" button
63+
- Or calculation starts automatically after adding files
6164

62-
5. **复制结果**
63-
- 点击任意哈希值即可复制到剪贴板
64-
- 支持复制单个哈希值或所有结果
65+
5. **Copy Results**:
66+
- Click any hash value to copy to clipboard
67+
- Supports copying individual hash values or all results
6568

66-
### 高级功能
69+
### Advanced Features
6770

68-
- **批量处理**:可同时添加多个文件进行批量计算
69-
- **进度显示**:实时显示计算进度
70-
- **文件管理**:支持清除单个文件或清空所有文件
71-
- **结果导出**:可复制所有计算结果
71+
- **Batch Processing**: Add multiple files for simultaneous batch calculation
72+
- **Progress Display**: Real-time calculation progress display
73+
- **File Management**: Support for clearing individual files or all files
74+
- **Result Export**: Copy all calculation results
7275

73-
## 技术架构
76+
## Technical Architecture
7477

75-
### 核心技术
78+
### Core Technologies
7679

77-
- **SwiftUI**:现代化的用户界面框架
78-
- **CryptoKit**Apple 官方加密框架,用于 SHA-1 计算
79-
- **Foundation**:用于 MD5 和文件操作
80-
- **UniformTypeIdentifiers**:文件类型识别
80+
- **SwiftUI**: Modern user interface framework
81+
- **CryptoKit**: Apple's official cryptographic framework for SHA-1 calculation
82+
- **Foundation**: For MD5 and file operations
83+
- **UniformTypeIdentifiers**: File type identification
8184

82-
### 项目结构
85+
### Project Structure
8386

8487
```
8588
Hash/
8689
├── Hash/
87-
│ ├── ContentView.swift # 主界面视图
88-
│ ├── HashApp.swift # 应用程序入口
89-
│ ├── Assets.xcassets/ # 应用资源
90-
│ │ └── AppIcon.appiconset/ # 应用图标
91-
│ ├── Hash.entitlements # 应用权限配置
92-
│ └── *.lproj/ # 多语言本地化文件
93-
├── HashTests/ # 单元测试
94-
└── HashUITests/ # UI 测试
90+
│ ├── ContentView.swift # Main interface view
91+
│ ├── HashApp.swift # Application entry point
92+
│ ├── Assets.xcassets/ # Application resources
93+
│ │ └── AppIcon.appiconset/ # Application icon
94+
│ ├── Hash.entitlements # Application permissions
95+
│ └── *.lproj/ # Multilingual localization files
96+
├── HashTests/ # Unit tests
97+
└── HashUITests/ # UI tests
9598
```
9699

97-
### 哈希算法实现
100+
### Hash Algorithm Implementation
98101

99-
- **MD5**:使用 CommonCrypto 框架实现
100-
- **SHA-1**:使用 CryptoKit 框架实现
101-
- **CRC32**:自定义实现,使用标准 CRC32 多项式
102+
- **MD5**: Implemented using CommonCrypto framework
103+
- **SHA-1**: Implemented using CryptoKit framework
104+
- **CRC32**: Custom implementation using standard CRC32 polynomial
102105

103-
## 开发
106+
## Development
104107

105-
### 环境配置
108+
### Environment Setup
106109

107-
1. 安装 Xcode 13.0 或更高版本
108-
2. 确保 macOS 版本为 11.0 或更高
109-
3. 克隆项目并在 Xcode 中打开
110+
1. Install Xcode 13.0 or later
111+
2. Ensure macOS version is 11.0 or later
112+
3. Clone the project and open in Xcode
110113

111-
### 构建项目
114+
### Build Project
112115

113116
```bash
114-
# 使用 Xcode 命令行工具构建
117+
# Build using Xcode command line tools
115118
xcodebuild -project Hash.xcodeproj -scheme Hash -configuration Debug build
116119

117-
# 或在 Xcode 中使用快捷键 ⌘+B
120+
# Or use shortcut ⌘+B in Xcode
118121
```
119122

120-
### 运行测试
123+
### Run Tests
121124

122125
```bash
123-
# 运行单元测试
126+
# Run unit tests
124127
xcodebuild test -project Hash.xcodeproj -scheme Hash -destination 'platform=macOS'
125128

126-
# 或在 Xcode 中使用快捷键 ⌘+U
129+
# Or use shortcut ⌘+U in Xcode
127130
```
128131

129-
## 本地化
132+
## Localization
130133

131-
应用程序支持以下 22 种语言:
134+
The application supports the following 22 languages:
132135

133-
### 亚洲语言
134-
- 🇨🇳 中文(简体)
135-
- 🇹🇼 中文(繁体)
136-
- 🇯🇵 日本語
137-
- 🇰🇷 한국어
136+
### Asian Languages
137+
- 🇨🇳 中文(简体)(Chinese Simplified)
138+
- 🇹🇼 中文(繁体)(Chinese Traditional)
139+
- 🇯🇵 日本語 (Japanese)
140+
- 🇰🇷 한국어 (Korean)
138141
- 🇹🇭 ไทย (Thai)
139142
- 🇻🇳 Tiếng Việt (Vietnamese)
140143
- 🇮🇳 हिन्दी (Hindi)
141144
- 🇮🇩 Bahasa Indonesia (Indonesian)
142145
- 🇲🇾 Bahasa Melayu (Malay)
143146

144-
### 欧洲语言
147+
### European Languages
145148
- 🇺🇸 English
146149
- 🇩🇪 Deutsch (German)
147150
- 🇫🇷 Français (French)
@@ -167,49 +170,49 @@ xcodebuild test -project Hash.xcodeproj -scheme Hash -destination 'platform=macO
167170
- 🇷🇸 Српски (Serbian)
168171
- 🇷🇺 Русский (Russian)
169172

170-
### 中东语言
173+
### Middle Eastern Languages
171174
- 🇸🇦 العربية (Arabic)
172175
- 🇮🇱 עברית (Hebrew)
173176

174-
### 添加新语言
177+
### Adding New Languages
175178

176-
1. 在 Xcode 中选择项目
177-
2. "Localizations" 部分添加新语言
178-
3. 翻译 `Localizable.strings` 文件中的字符串
179+
1. Select the project in Xcode
180+
2. Add a new language in the "Localizations" section
181+
3. Translate the strings in the `Localizable.strings` file
179182

180-
## 贡献
183+
## Contributing
181184

182-
欢迎提交 Issue 和 Pull Request!
185+
Issues and Pull Requests are welcome!
183186

184-
### 贡献指南
187+
### Contribution Guidelines
185188

186-
1. Fork 项目
187-
2. 创建功能分支 (`git checkout -b feature/AmazingFeature`)
188-
3. 提交更改 (`git commit -m 'Add some AmazingFeature'`)
189-
4. 推送到分支 (`git push origin feature/AmazingFeature`)
190-
5. 创建 Pull Request
189+
1. Fork the project
190+
2. Create a feature branch (`git checkout -b feature/AmazingFeature`)
191+
3. Commit your changes (`git commit -m 'Add some AmazingFeature'`)
192+
4. Push to the branch (`git push origin feature/AmazingFeature`)
193+
5. Create a Pull Request
191194

192-
## 许可证
195+
## License
193196

194-
本项目采用 MIT 许可证 - 查看 [LICENSE](LICENSE) 文件了解详情。
197+
This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.
195198

196-
## 更新日志
199+
## Changelog
197200

198201
### v1.0.0
199-
-初始版本发布
200-
- 🔐 支持 MD5SHA-1CRC32 哈希算法
201-
- 📁 支持批量文件处理
202-
- 🎯 支持拖拽操作
203-
- 🌍 支持多语言界面
204-
- 🎨 现代化 SwiftUI 界面
202+
-Initial release
203+
- 🔐 Support for MD5, SHA-1, CRC32 hash algorithms
204+
- 📁 Support for batch file processing
205+
- 🎯 Support for drag & drop operations
206+
- 🌍 Support for multilingual interface
207+
- 🎨 Modern SwiftUI interface
205208

206-
## 联系方式
209+
## Contact
207210

208-
如有问题或建议,请通过以下方式联系:
211+
For questions or suggestions, please contact us through:
209212

210-
- 提交 Issue:[GitHub Issues](https://github.com/iOSDevLog/Hash/issues)
211-
- 项目主页:[GitHub Repository](https://github.com/iOSDevLog/Hash)
213+
- Submit Issues: [GitHub Issues](https://github.com/iOSDevLog/Hash/issues)
214+
- Project Homepage: [GitHub Repository](https://github.com/iOSDevLog/Hash)
212215

213216
---
214217

215-
**Hash** - 让文件哈希计算变得简单高效 🚀
218+
**Hash** - Making file hash calculation simple and efficient 🚀

0 commit comments

Comments
 (0)