Hei.Captcha 项目安装与使用教程

Hei.Captcha 项目安装与使用教程

Hei.Captcha一个跨平台的图形验证码生成工具包/.net core项目地址:https://gitcode.com/gh_mirrors/he/Hei.Captcha

1. 项目目录结构及介绍

Hei.Captcha 项目的目录结构如下：

Hei.Captcha/
├── Demo/
│   ├── fonts/
│   ├── images/
│   ├── Hei.Captcha.Demo.csproj
│   └── Program.cs
├── Hei.Captcha/
│   ├── Hei.Captcha.csproj
│   ├── SecurityCodeHelper.cs
│   └── ...
├── .gitignore
├── Hei.Captcha.sln
├── LICENSE
└── README.md

目录结构介绍

• Demo/: 包含项目的演示代码和相关资源文件。

  • fonts/: 存放验证码生成所需的字体文件。
  • images/: 存放验证码生成的示例图片。
  • Hei.Captcha.Demo.csproj: 演示项目的项目文件。
  • Program.cs: 演示项目的入口文件。

• Hei.Captcha/: 包含核心库的代码。

  • Hei.Captcha.csproj: 核心库的项目文件。
  • SecurityCodeHelper.cs: 验证码生成的核心逻辑文件。

• .gitignore: Git 忽略文件配置。

• Hei.Captcha.sln: 项目的解决方案文件。

• LICENSE: 项目的开源许可证文件。

• README.md: 项目的说明文档。

2. 项目的启动文件介绍

项目的启动文件位于 Demo/Program.cs，该文件是演示项目的入口文件。以下是 Program.cs 的简要介绍：

using System;
using Microsoft.Extensions.DependencyInjection;
using Microsoft.Extensions.Hosting;
using Hei.Captcha;

namespace Hei.Captcha.Demo
{
    class Program
    {
        static void Main(string[] args)
        {
            var host = CreateHostBuilder(args).Build();
            host.Run();
        }

        public static IHostBuilder CreateHostBuilder(string[] args) =>
            Host.CreateDefaultBuilder(args)
                .ConfigureServices((hostContext, services) =>
                {
                    services.AddHeiCaptcha();
                });
    }
}

启动文件介绍

• Main 方法: 程序的入口点，负责启动应用程序。
• CreateHostBuilder 方法: 配置应用程序的主机，并注册 HeiCaptcha 服务。

3. 项目的配置文件介绍

项目的配置文件主要包括 Hei.Captcha.Demo.csproj 和 Hei.Captcha.csproj。以下是这两个文件的简要介绍：

Hei.Captcha.Demo.csproj

<Project Sdk="Microsoft.NET.Sdk.Web">

  <PropertyGroup>
    <TargetFramework>net5.0</TargetFramework>
  </PropertyGroup>

  <ItemGroup>
    <PackageReference Include="Hei.Captcha" Version="0.3.0" />
  </ItemGroup>

</Project>

Hei.Captcha.csproj

<Project Sdk="Microsoft.NET.Sdk">

  <PropertyGroup>
    <TargetFramework>netstandard2.0</TargetFramework>
  </PropertyGroup>

</Project>

配置文件介绍

• Hei.Captcha.Demo.csproj: 演示项目的项目文件，指定了目标框架为 net5.0，并引用了 Hei.Captcha 包的版本 0.3.0。
• Hei.Captcha.csproj: 核心库的项目文件，指定了目标框架为 netstandard2.0。

通过以上配置，项目可以正确编译和运行，并生成所需的验证码。

Hei.Captcha一个跨平台的图形验证码生成工具包/.net core项目地址:https://gitcode.com/gh_mirrors/he/Hei.Captcha