Visual Studio 및 기타 IDE 사용

새로운 cBot/지표 생성

내장된 코드 편집기를 사용하는 대신 외부 IDE를 사용하여 새로운 cBot/지표를 생성할 수 있습니다. 외부 IDE를 사용하면 린터(linter) 및 자동 서식 지정 도구와 같은 맞춤형 IDE 확장 기능을 사용할 수 있다는 여러 가지 장점이 있습니다.

C# 및 .NET 작업에 적합한 IDE가 많이 있지만, Microsoft Visual Studio 또는 Visual Studio Code를 사용하는 것을 권장합니다. 이 두 IDE는 사용하기 쉽고 C# 및 .NET 작업을 용이하게 하는 다양한 맞춤형 설정을 제공합니다. 저희 문서는 이 두 IDE만 다룹니다.

Visual Studio

cTrader.Automate NuGet 패키지 설치

cBot 또는 지표를 생성하기 전에 cTrader.Automate NuGet 패키지를 설치하세요. 다음과 같은 방법으로 설치할 수 있습니다:

• Visual Studio에서 Project 메뉴를 열고 Manage NuGet packages를 선택하세요.
• 패키지 소스로 nuget.org를 선택하고 검색창에 cTrader를 입력하세요.
• cTrader.Automate 패키지를 클릭하고 Install을 선택하세요.

또는 Tools 메뉴를 열고 NuGet package manager를 선택한 후 Package Manager Console을 엽니다. 여기에 Install-Package cTrader.Automate를 입력하세요.

cTrader.Automate NuGet 패키지를 설치한 후, cBot/지표 프로젝트를 빌드할 때마다 Visual Studio는 프로젝트의 build 디렉토리에 .algo 파일을 자동으로 생성합니다. Windows에서 작업하는 경우, 패키지는 ../Documents/cAlgo/Sources/{Robots/Indicators} 폴더에 해당하는 .algo 파일도 생성합니다.

Visual Studio에서 새로운 cBot 및 지표 생성

새로운 cBot/지표를 생성하려면 Visual Studio 내부에서 새 프로젝트를 생성하고 Class library를 선택하세요. 프로젝트 이름은 cBot/확장 프로그램의 이름으로 지정하세요.

Class1.cs 파일에 cBot/지표 코드를 작성하세요. 그런 후 Build 메뉴를 열고 Build solution을 선택하세요. 또는 Ctrl+Shift+B를 누르세요. 성공적으로 빌드되면 위에서 지정한 디렉토리에 .algo 파일이 생성됩니다.

cTrader UI에서 새로운 cBot/지표가 보이지 않으면 cTrader 플랫폼을 다시 시작하면 다른 확장 프로그램과 함께 나타납니다.

Visual Studio에 대한 추가 정보는 이 문서를 참조하세요.

Visual Studio Code

Visual Studio에 비해 VS Code는 훨씬 더 가벼운 코드 편집기로, 개발자들 사이에서 급증하는 인기를 얻고 있습니다. VS Code를 통해 cBot/지표를 생성하려면 다음 전제 조건을 충족해야 합니다.

• .NET SDK를 설치하세요.
• VS Code 내부에 C# 확장 프로그램을 설치하세요.

적합한 확장 프로그램을 설치하려면 확장 프로그램 마켓플레이스를 열고 검색창에 C#을 입력한 후 공식 Microsoft 확장 프로그램 또는 기타 적합한 애드온을 선택하세요.

그런 후 .NET command-line interface (CLI)를 사용하여 cBot/지표를 포함한 솔루션 및 클래스 라이브러리 프로젝트를 생성해야 합니다.

지표 생성

VS Code를 통해 지표를 생성하려면 Terminal 메뉴에서 New terminal을 선택하여 새로운 PowerShell 터미널을 엽니다. 또는 Ctrl+Shift+`를 누르세요.

1. 터미널에서 Documents\cAlgo\Sources\Indicators 디렉토리를 엽니다.

cd Documents\cAlgo\Sources\Indicators\

2. 지표를 위한 새 디렉토리를 생성하세요. 이 디렉토리에는 지표 솔루션 및 프로젝트가 포함됩니다. 이 디렉토리로 이동하세요.

mkdir MyIndicator
cd MyIndicator

3. 새로 생성된 디렉토리 내부에 새로운 .NET 솔루션을 생성하세요.

dotnet new sln

4. 클래스 라이브러리 .NET 프로젝트를 생성하세요.

dotnet new classlib --name MyIndicator

이 프로젝트는 MyIndicator 디렉토리 내부에 생성됩니다.

5. 프로젝트를 솔루션에 추가하세요.

dotnet sln add .\MyIndicator\MyIndicator.csproj

6. cTrader.Automate NuGet 패키지를 설치하세요.

dotnet add .\MyIndicator\MyIndicator.csproj package cTrader.Automate

7. 지표 클래스를 추가하세요. Class1.cs 파일을 MyIndicator.cs로 이름을 변경하고 열어 다음 플레이스홀더 코드로 내용을 교체하세요. VS Code 내부에서 코드를 편집하세요.

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27

using cAlgo.API;

namespace cAlgo;

[Indicator(AccessRights = AccessRights.None)]
public class MyIndicator : Indicator
{
    [Parameter(DefaultValue = "Hello world!")]
    public string Message { get; set; }

    [Output("Main")]
    public IndicatorDataSeries Result { get; set; }

    protected override void Initialize()
    {
        // To learn more about cTrader Algo visit our Help Center:
        // https://help.ctrader.com/ctrader-algo

        Print(Message);
    }

    public override void Calculate(int index)
    {
        // Calculate value at specified index
        // Result[index] =
    }
}

8. 프로젝트를 빌드하세요.

dotnet build --configuration Release

소스 코드로 프로젝트를 빌드할 수도 있습니다.

dotnet build --configuration Release -p:IncludeSource=True

지표를 디버깅하려면 빌드 구성을 Debug로 변경할 수 있습니다.

성공적으로 빌드되면 프로젝트 bin 폴더 내부와 Windows를 사용하는 경우 Documents\cAlgo\Sources\Indicators\ 폴더 내부에 지표 .algo 파일이 생성됩니다.

cBot 생성

cBot 생성은 지표 생성과 유사하지만 Indicator 클래스 대신 Robot 클래스를 사용하고 Documents\cAlgo\Sources\Robots\ 디렉토리를 사용해야 합니다.

cBot 클래스에 대해 아래 샘플 코드를 사용할 수 있습니다:

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28

using cAlgo.API;

namespace cAlgo.Robots;

[Robot(AccessRights = AccessRights.None)]
public class MyRobot : Robot
{
    [Parameter(DefaultValue = "Hello world!")]
    public string Message { get; set; }

    protected override void OnStart()
    {
        // To learn more about cTrader Algo visit our Help Center:
        // https://help.ctrader.com/ctrader-algo

        Print(Message);
    }

    protected override void OnTick()
    {
        // Handle price updates here
    }

    protected override void OnStop()
    {
        // Handle cBot stop here
    }
}

다른 .NET IDE

원한다면 다른 IDE를 사용하여 cBots, 플러그인 및 지표를 작업할 수 있습니다. 유효한 cTrader 확장을 만들려면 다음 단계를 따르세요:

1. .NET 클래스 라이브러리 프로젝트를 생성합니다.
2. cTrader.Automate NuGet 패키지를 설치하세요.
3. cBot/지표 소스 코드를 포함하는 클래스 파일을 생성합니다. 지표는 Indicator 클래스를 상속해야 하며, cBots는 Robot 클래스를 상속해야 합니다.
4. 확장을 빌드합니다. 컴파일/빌드에 대한 자세한 정보는 이 문서의 관련 섹션을 확인하세요.