39

安装与环境配置

简介

Known 是一个基于 Blazor 的轻量级、跨平台、极易扩展的插件开发框架。它提供了丰富的功能模块，包括权限管理、工作流、国际化支持等，适用于快速开发企业级应用。

项目结构

项目的主要目录结构如下：

├─Shared            -> Known与Known.Pure的代码共享项目，包含Excel接口、Database、微信、工作流等公用代码。
├─Known             -> 框架核心类库，定义统一的对象模型、接口、组件和扩展，内置权限、微信、工作流。
├─Known.Core        -> 基于Asp.Net Core的服务端类库。
├─Known.Pure        -> 无Blazor功能的纯净版Known类库。
├─Plugins           -> 插件项目
| ├─Known.Admin     -> 简易无代码设计器插件。
| ├─Known.Cells     -> 基于Aspose.Cells实现的Excel插件。
├─Sample            -> 示例项目
  ├─Sample.Maui     -> 框架MAUI示例。
  ├─Sample.Photino  -> 框架Photino.NET示例。
  ├─Sample.Wasm     -> 框架WebAssembly示例。
  ├─Sample.Web      -> 框架WebApp示例。
  ├─Sample.WinForm  -> 框架WinForm示例。

安装流程

软件环境要求

  • 操作系统：Windows、Linux 或 Mac。
  • 开发工具：Visual Studio 2022（推荐）或 JetBrains Rider。
  • .NET SDK：8.0 或 9.0 版本。
  • 数据库：支持 SQL Server、MySQL、SQLite 或 Oracle。

依赖项安装

  1. 安装 .NET SDK
    从 .NET 官方网站 下载并安装最新版本的 .NET SDK。

  2. 安装数据库驱动
    根据选择的数据库类型，安装对应的驱动：

    • SQLServer: 使用 Microsoft.Data.SqlClient NuGet 包。
    • MySQL: 使用 MySqlConnector NuGet 包。
    • SQLite: 使用 Microsoft.Data.Sqlite NuGet 包。
    • Oracle: 使用 Oracle.ManagedDataAccess.Core NuGet 包。
    • PgSQL: 使用 Npgsql NuGet 包。

  3. 安装插件依赖
    如果需要使用 Known.Cells 插件，需安装 Aspose.Cells NuGet 包。

项目初始化

  1. 克隆仓库
    运行以下命令克隆项目：

    git clone https://gitee.com/known/Known.git

  2. 还原 NuGet 包
    在项目根目录运行：

    dotnet restore

  3. 配置数据库连接
    修改 Known/Config.cs 文件中的数据库连接字符串：

    public static string ConnectionString = "Server=.;Database=KnownDB;User Id=sa;Password=123456;";

  4. 运行项目
    启动示例项目（如 Sample.Web）：

    dotnet run --project Sample/Sample.Web/Sample.Web.csproj

.NET 环境配置

  • 全局工具安装
    安装常用的 .NET 工具：

    dotnet tool install -g dotnet-ef

  • 环境变量设置
    确保 PATH 环境变量中包含 .NET SDK 的路径。

数据库准备

  1. 创建数据库
    使用 SQL 脚本或工具创建数据库（如 KnownDB）。

  2. 初始化表结构
    运行以下命令生成数据库迁移：

    dotnet ef migrations add InitialCreate
dotnet ef database update

插件依赖

  • Known.Admin
    提供无代码设计功能，无需额外依赖。

  • Known.Cells
    依赖 Aspose.Cells 库，需从 NuGet 安装：

    dotnet add package Aspose.Cells

常见问题与解决方案

  1. 数据库连接失败

    • 检查连接字符串是否正确。
    • 确保数据库服务已启动。

  2. NuGet 包还原失败

    • 检查网络连接。
    • 清除 NuGet 缓存： 
      dotnet nuget locals all --clear

  3. 插件功能异常

    • 确保所有依赖项已正确安装。
    • 检查插件配置是否正确。

总结

本文档详细介绍了 Known 项目的安装流程、环境配置和常见问题的解决方案。通过遵循上述步骤，您可以快速搭建开发环境并开始使用 Known 框架进行开发。