QuickAdmin.Net

开始使用

准备

  • 开发环境
    Visual Studio 2022open in new window，Sqlite/SqlServer/Oracle/PostgreSQL/MySql(8.0+)/Firebird/DM8(达梦)/KingbaseES(人大金仓)/openGauss(华为) 等等数据库。 若无数据库环境，可先用 Sqlite 起步(该数据库无需任何安装和配置)。

  • 获取 QuickAdmin.Net 开发版
    开发版已在 NuGetopen in new window可用，无需单独下载，可用来进行项目开发与调试。

  • 下载 FineUICore 社区版
    QuickAdmin.Net 内置管理页面采用 FineUICoreopen in new window 社区版构建，可在其官方社区免费下载。在编写自己的页面时，你可自行决定是否使用 FineUICore。
    从其官网进入(或 点击此处open in new window 直接进入) FineUI 免费社区并扫码加入，在置顶贴里找到 FineUICore 下载页面， 下载其中的空项目或示例项目压缩包并解压，需要的文件为项目 bin 目录下的FineUICore.dll和FineUICore.xml文件。
    为方便进行项目开发演示，建议在文件系统某个位置(例如D:盘根目录下)创建以下目录结构， 将以上两个文件放入FineUICore目录，创建 Visual Studio 项目时项目位置则选source目录：

├─QAdminDemos
  └─source
    └─FineUICore
  • 安装项目模板
    已在 NuGetopen in new window 提供了若干项目模板，用来快速生成相应项目。在命令行输入以下命令进行安装(若已安装将更新至最新版)：
dotnet new install QuickAdmin.Net.Templates

    用 Visual Studio 新建项目时，在搜索模板输入框内输入 "qadmin" 即可快速列出所提供的几个模板：
Templates

创建第一个项目

用 QuickAdmin.Net.Templates 里的 "QuickAdmin.Net Web App" 模板去创建一个项目，创建后手动更正一下项目对FineUICore.dll程序集的引用即可编译运行。
首次运行，将自动导航到创建系统表的页面：
CreateTables

QuickAdmin.Net 内置了分别与 Sqlite/SqlServer/Oracle/PostgreSQL/MySql 数据库对应的用来创建系统表的 SQL 脚本，对于这些数据库， 点击 "执行脚本创建系统表" 按钮，对于其它数据库点击 "用同步方法创建系统表" 按钮。

系统表创建好后，点击 "访问系统" 链接，即可进行登录(QuickAdmin.Net 还内置了手机号登录以及微信扫码登录，默认未启用)：
Login
上图为 QuickAdmin.Net 内置的登录页，输入超级管理员账户 "admin" 及其默认密码 "admin"，再输入验证码，登入系统：
Index
上图为 QuickAdmin.Net 内置的 Index 页，初次登录时会创建一些示例菜单项。点击 "系统菜单" 可去定制系统菜单项。点击 "内置页面总览" 去查看 QuickAdmin.Net 内置的功能页面有哪些。

内置的登录页、Index 页均可定制(无需编译，通过 json 配置文件进行)，如系统名称、系统 Logo 等等，也可改用你自己的登录页和 Index 页，具体在后边的章节中说明。

创建示例项目

现在用 QuickAdmin.Net.Templates 里的 "QuickAdmin.Net Solution" 模板去创建项目，该模板内有建好的示例数据库(Sqlite，有组织机构、用户数据)以及简单的示例页面，可利用此项目去熟悉 QuickAdmin.Net 内置的各项功能。

该模板的 Program.cs 里还附有详细的初始化注释说明，参考 AddQuickAdmin()open in new window 扩展方法和 QuickAdminInitializationOptionsopen in new window 选项类文档。
AddQuickAdmin()/UseQuickAdmin() 里默认会自动初始化 Session、FreeSql 以及 FineUI，你可通过选项参数对他们的初始化过程进行定制，执行你需要的配置操作。你也可以完全自行初始化 Session/FreeSql/FineUI 等。

创建项目时若项目位置选取了前边建议的目录(如：D:\QAdminDemos\source)，并选中了 "将解决方案和项目放在同一目录中"，可不用调整程序集引用，直接编译运行。

Demo 源码下载

点击此处open in new window下载 Demo 源码。 打开解决方案，按说明文档操作。其中还包含了用于在 Linux 下部署的服务文件以及命令简述。