SmtpClient-for-Qt 项目使用教程

SmtpClient-for-Qt 项目使用教程

SmtpClient-for-QtAn SMTP Client writen in C++ for Qt. Allows applications to send emails (MIME with text, html, attachments, inline files, etc.) via SMTP. Supports SSL and SMTP authentication.项目地址:https://gitcode.com/gh_mirrors/smt/SmtpClient-for-Qt

1. 项目的目录结构及介绍

SmtpClient-for-Qt 项目的目录结构如下：

SmtpClient-for-Qt/
├── demos/
├── src/
├── test/
├── .gitignore
├── .travis.yml
├── LICENSE
├── README.md

目录介绍：

• demos/: 包含示例代码，展示如何使用 SmtpClient 发送邮件。
• src/: 包含 SmtpClient 的核心代码。
• test/: 包含测试代码，用于验证 SmtpClient 的功能。
• .gitignore: Git 忽略文件配置。
• .travis.yml: Travis CI 配置文件。
• LICENSE: 项目许可证文件，采用 GNU LGPL version 2.1。
• README.md: 项目说明文档。

2. 项目的启动文件介绍

项目的启动文件通常位于 demos/ 目录下，例如 demos/sendemail.cpp。以下是一个示例启动文件的介绍：

#include <SmtpClient.h>
#include <EmailAddress.h>
#include <MimeText.h>

int main() {
    // 创建 SMTP 客户端
    SmtpClient smtp("smtp.example.com", 25, SmtpClient::TcpConnection);

    // 创建邮件消息
    MimeMessage message;
    message.setSender(new EmailAddress("your_email_address@gmail.com", "Your Name"));
    message.addRecipient(new EmailAddress("recipient@host.com", "Recipient's Name"));
    message.setSubject("SmtpClient for Qt - Demo");

    // 添加邮件正文
    MimeText text;
    text.setText("Hi,\nThis is a simple email message.\n");
    message.addPart(&text);

    // 发送邮件
    smtp.connectToHost();
    smtp.login();
    smtp.sendMail(message);
    smtp.quit();

    return 0;
}

启动文件介绍：

• SmtpClient.h: SMTP 客户端类头文件。
• EmailAddress.h: 邮件地址类头文件。
• MimeText.h: MIME 文本类头文件。
• main 函数: 程序入口，创建 SMTP 客户端实例，配置邮件信息并发送邮件。

3. 项目的配置文件介绍

项目的配置文件通常是 .travis.yml 和 README.md。

.travis.yml

language: cpp

script:
  - mkdir build
  - cd build
  - cmake ..
  - make
  - make test

README.md

# SmtpClient-for-Qt

SmtpClient-for-Qt 是一个用于 Qt 的小型库，允许应用程序通过 SMTP 协议发送复杂的电子邮件（纯文本、HTML、附件、内联文件等）。

## 特性

- 支持 TCP 和 SSL 连接
- 支持 SMTP 认证（PLAIN 和 LOGIN 方法）
- 发送 MIME 邮件（支持多个收件人）
- 支持纯文本和 HTML（带内联文件）内容
- 支持多个附件和内联文件

## 使用方法

1. 克隆项目：
   ```sh
   git clone https://github.com/bluetiger9/SmtpClient-for-Qt.git

2. 编译项目：

   mkdir build
   cd build
   cmake ..
   make
   

3. 运行示例：

   ./demos/sendemail
   

许可证

本项目采用 GNU LGPL version 2.1 许可证。

### 配置文件介绍：

- **.travis.yml**: 配置 Travis CI 自动构建和测试项目。
- **README.md**: 项目说明文档，包含项目介绍、特性、使用方法和许可证信息。

SmtpClient-for-QtAn SMTP Client writen in C++ for Qt. Allows applications to send emails (MIME with text, html, attachments, inline files, etc.) via SMTP. Supports SSL and SMTP authentication.项目地址:https://gitcode.com/gh_mirrors/smt/SmtpClient-for-Qt