# ATS Plugin Template

**Repository Path**: ats-code/ats-plugin-template

## Basic Information

- **Project Name**: ATS Plugin Template
- **Description**: ATS插件开发的模板项目。
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-10-01
- **Last Updated**: 2025-10-01

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# ATS插件开发的模板项目

这是一个用于开发ATS插件的模板项目。该项目包含了一个简单的ATS插件示例，展示了如何创建和编译ATS插件。

## 项目配置

参考 **ATS.Plugins.Template.csproj** 文件中的配置。

> ATSPath 中的路径需要根据实际情况进行调整。

## 目录结构

- TemplateModule.cs: 插件配置
- SettingConfiguration.cs:  定义插件的配置项
- Permissions.cs: 定义插件的权限
- Views: 插件的视图文件夹
    - Main.xaml: 插件的主视图(页面)
    - Options.xaml: 插件的设置项视图(页面)，用于配置 **SettingConfiguration.cs** 定义的选项
- ViewModels: 插件的视图模型文件夹
    - MainViewModel.cs: 主视图的视图模型
    - OptionsViewModel.cs: 设置项视图的视图模型

## 插件初始化

插件的初始化逻辑位于 **TemplateModule.cs** 文件中。

## 编译

生成项目后，插件DLL会自动复制到ATS的插件目录中，路径配置在 **ATS.Plugins.Template.csproj** 文件中：

```xml
<Target Name="PostBuild" AfterTargets="PostBuildEvent">
    <Exec Command="xcopy $(ProjectDir)$(OutDir)$(AssemblyName).dll %LocalAppData%\ATS\Plugins\ /Q /A /Y" />
</Target>
```

## 调试
要调试插件，可以将ATS的可执行文件路径添加到项目属性的调试选项中。
在Visual Studio中，右键点击项目，选择“属性”，然后导航到“调试”选项卡。设置“可执行文件”为ATS的可执行文件路径（例如 `C:\Path\To\ATS.exe`），并设置“工作目录”。这样，当你按F5运行调试时，ATS会启动并加载你的插件。

```json
{
  "profiles": {
    "ATS.Plugins.Template": {
      "commandName": "Executable",
      "executablePath": "D:\\it\\202308_ATS\\src\\ATS\\out\\ATS\\ATS.exe",
      "workingDirectory": "D:\\it\\202308_ATS\\src\\ATS\\out\\ATS"
    }
  }
}
```
> 请根据实际情况调整路径。