Exceptionless.NET 开源项目安装与使用指南

目录结构及介绍

核心目录解析

在克隆 https://github.com/exceptionless/Exceptionless.git 的仓库后, 你会看到以下关键目录:

• devcontainer: 包含用于Visual Studio Code远程开发容器的配置。
• samples: 提供示例应用程序以演示如何使用 Exceptionless.
• src: 存放核心源码, 分为多个子项目, 如 Exceptionless.Core, Exceptionless.Windows, 和 Exceptionless.Client.
• test: 测试相关的目录, 包括单元测试和集成测试。

文件说明

Solution Files

• Exceptionless.Net.NonWindows.sln: 针对非Windows系统的解决方案文件.
• Exceptionless.Net.Windows.sln: 专为Windows系统准备的解决方案.

Configuration Files

• global.json: 为所有NET项目定义全局工具版本以及SDK信息.
• .gitattributes、.gitignore、.editorconfig: 版本控制及编辑器配置文件.

项目的启动文件介绍

Startup Project: Exceptionless.SampleConsole

在 src/samples 下的 Exceptionless.SampleConsole 是一个典型的.NET控制台应用程序, 用于演示如何初始化和使用 Exceptionless. 启动这个项目可以通过以下方式实现:

使用Visual Studio

1. 打开 src/solutions/Exceptionless.Net.sln 或者对应的解决方案文件(NonWindows 或 Windows)。
2. 设置 Exceptionless.SampleConsole 为启动项目。
3. 按下 F5 开始调试或者选择“启动”按钮。

使用Visual Studio Code (VS Code)

如果你倾向于在VS Code环境中工作, 并在macOS 或Linux上进行开发:

1. 安装必要的开发工具如 NET Core 6.x 和 VS Tooling.
2. 打开 Exceptionless.Net 文件夹。
3. 运行 Exceptionless.SampleConsole 项目, 通常按下F5即可。

项目的配置文件介绍

虽然 Exceptionless 本身没有特定的配置文件来存储运行时设定（大多数配置都可在代码中动态设置）, 但其使用依赖于诸如日志框架NLog等其他配置文件.

例如, 为了集成 Exceptionless 与 NLog, 你需要修改你的 app.config 或 web.config 文件中的NLog部分, 添加指向 Exceptionless 的目标(target). 配置文件应包括连接字符串等细节, 以便 NLog 能够正确地将事件转发到 Exceptionless.

有关具体如何配置和整合 Exceptionless 与流行日志框架的更多信息, 参考官方网站和官方文档:

• 官网
• 官方文档