Skip to content
当前页大纲

快速上手

本教程会让您快速将后端项目运行起来。

准备工作

  • 使用 Git 工具从开源地址拉取最新代码 microi.net
  • 下载并安装 .NET 9 SDK.NET 9 SDK
  • 要使项目跑起来,至少需要【数据库 + Redis】两个环境,缺一不可

使用【Visual Studio Code】打开解决方案(推荐)

  • 下载并安装 Vs CodeVs Code
  • 打开 Vs Code,安装插件:C#、C# Dev Kit、.NET Install Tool三个组件
  • 在欢迎页打开 Microi 吾码开源版根目录文件夹,稍等几秒后会自动出现【解决方案资源管理器】,等待 Vs Code 自动还原 Nuget
  • 必须配置 /Microi.net.Api/appsettings.json 文件
csharp
"AppSettings": {
    "OsClient": "iTdos",//【必须】自定义SaaS引擎Key,与数据库【sys_osclient】表的【OsClient】字段值对应
    "OsClientType": "Product",//【必须】自定义程序运行环境,如:Product(正式环境)、Dev(测试环境)等
    "OsClientNetwork": "Internet",//【必须】自定义网络类型,如:Internet(公网)、Internal(内网)等
    "OsClientDbConn": "",//【必须】数据库连接字符串,建议使用源码提供的MySql。SqlServer、Oracle也支持,后期整理后提供数据库demo
    "IS4SigningCredential": "",//【必须】可以直接使用源码中的默认签名
    //Tips:若【OsClient + OsClientType + OsClientNetwork】在【sys_osclient】表中能匹配到数据,且数据中有Redis相关配置,则可以省略以下Redis配置
    "OsClientRedisHost" : "",//Redis Host,如:119.31.116.88
    "OsClientRedisPort" : "",//Redis端口,如:6379
    "OsClientRedisPwd" : ""//Redis密码,如:123456
    //其余配置分布式存储(如阿里云OSS、MinIO)、MQ消息队列、ES搜索引擎等,均在平台【SaaS引擎】中动态配置
  },
  • 右键【Microi.net.Api】项目,调试 --> 启动新实例
  • 访问地址:https://localhost:7266(端口在/Microi.net.Api/Properties/launchSettings.json配置)

使用【Visual Studio 2022】打开解决方案

  • 下载并安装 vs2022vs2022
  • 直接双击打开 /Microi.net.sln 文件,打开后稍等片刻右键 Microi.net.Api 项目重新生成
  • 若还原 nuget 包失败,请关闭 vs2022 并重新打开 Microi.net.sln 文件继续尝试,一般都是网络问题,也可尝试使用手机热点
  • 必须配置 /Microi.net.Api/appsettings.json文件,说明同上

环境配置注意事项

  • 若没有 MongoDB 环境,则无法使用系统日志功能
  • 若没有 MinIO、阿里云 OSS 等分布式存储环境,则无法使用文件/图片上传功能
  • 若没有 RabbitMQ 环境,则无法使用消息队列功能
  • 若没有 ES 环境,则无法使用搜索引擎功能

MIT License.