Quick to get started ​

This tutorial will get you up and running quickly with your back-end project.

Preparations ​

• UseGitThe tool pulls the latest code from an open source address microi.net.
• Download and install.NET 9 SDK:.NET 9 SDK
• To make the project run, at least [databaseRedis] Two environments, one is indispensable

Using Visual Studio Code to open a solution (recommend) ​

• Download and installVs Code:Vs Code
• OpenVs Code, install the plugin:C#、C# Dev Kit、.NET Install ToolThree components
• Open on welcome pageMicroiI code the open source version of the root directory folder, wait a few seconds will automatically appear [Solution Explorer], waitVs CodeAutomatic RestoreNugetLibrary
• Must be configured/Microi.net.Api/appsettings.jsonFile

"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引擎】中动态配置
  },

• Right-click the [Microi.net.Api] project, debug --> start a new instance
• Access Address:https://localhost:7266(Ports are configured in/Microi.net.Api/Properties/launchSettings.json)

Open the solution using Visual Studio 2022 ​

• Download and installvs2022:vs2022
• Double-click directly to open/Microi.net.slnFile, wait a moment after opening, right-clickMicroi.net.ApiProject Rebuild
• If restorenugetPackage failed, please closevs2022and reopenMicroi.net.slnThe file continues to try, usually network problems, or try to use mobile phone hotspots.
• Must be configured/Microi.net.Api/appsettings.jsonDocument, note ibid.

Environment Configuration Considerations ​

• If notMongoDBenvironment, you cannot use the system log feature
• If notMinIOAlibaba CloudOSSIn a distributed storage environment such as the file/image upload function, the file/image upload function cannot be used.
• If notRabbitMQenvironment, you cannot use the Message Queuing feature
• If notESenvironment, you cannot use the search engine feature