Bỏ qua

Sử dụng Visual Studio và các IDE khác

Tạo cBot/chỉ báo mới

Bạn có thể chọn sử dụng các IDE bên ngoài để tạo cBot/chỉ báo mới thay vì sử dụng trình soạn thảo mã tích hợp. Việc sử dụng các IDE bên ngoài mang lại một số lợi thế như có thể sử dụng các tiện ích mở rộng IDE tùy chỉnh bao gồm các công cụ kiểm tra lỗi và định dạng tự động.

Các IDE bên ngoài

Dưới đây là danh sách đầy đủ các IDE bên ngoài hiện được cTrader hỗ trợ.

  • Visual Studio
  • Visual Studio Code
  • Rider
  • Sublime Text

Bạn có thể sử dụng bất kỳ IDE nào ở trên để chỉnh sửa một thuật toán nếu bạn có quyền truy cập vào mã nguồn của nó. Chọn thuật toán đó trong danh sách và mở menu thả xuống Edit in... ở đầu cửa sổ trình soạn thảo mã. Trong menu, chọn IDE mà bạn muốn mở thuật toán.

Mặc dù có rất nhiều IDE phù hợp để làm việc với C# và .NET, chúng tôi khuyên bạn nên sử dụng Microsoft Visual Studio hoặc Visual Studio Code. Cả hai IDE này đều dễ sử dụng và cung cấp nhiều cài đặt có thể tùy chỉnh để hỗ trợ làm việc với C# và .NET. Tài liệu của chúng tôi chỉ đề cập đến các IDE này.

Visual Studio

Cài đặt gói NuGet cTrader.Automate

Trước khi tạo cBot hoặc chỉ báo, hãy cài đặt gói NuGet cTrader.Automate. Bạn có thể làm điều này bằng cách thực hiện các thao tác sau:

  • Mở menu Project trong Visual Studio và chọn Manage NuGet packages.
  • Chọn nuget.org làm nguồn gói và nhập cTrader vào thanh tìm kiếm.
  • Nhấp vào gói cTrader.Automate và chọn Install.

Image title

Ghi chú

Nếu bạn đang làm việc với phiên bản Visual Studio cũ hơn (2015 trở về trước), bạn cũng cần cài đặt NuGet Package Manager. Để biết thêm thông tin, hãy tham khảo tài liệu này.

Ngoài ra, mở menu Tools, chọn NuGet package manager, và mở Package Manager Console. Trong đó, nhập Install-Package cTrader.Automate.

Sau khi cài đặt gói NuGet cTrader.Automate, mỗi khi bạn xây dựng một dự án cBot/chỉ báo, Visual Studio sẽ tự động tạo một tệp .algo cho dự án của bạn trong thư mục build. Khi làm việc trên Windows, gói này cũng sẽ tạo một tệp .algo tương ứng trong thư mục ../Documents/cAlgo/Sources/{Robots/Indicators}.

Tạo cBot và chỉ báo mới trong Visual Studio

Để tạo một cBot/chỉ báo mới, hãy tạo một dự án mới trong Visual Studio và chọn Class library. Đặt tên cho dự án của bạn theo cách bạn muốn đặt tên cho cBot/tiện ích mở rộng của mình.

Image title

Trong tệp "Class1.cs", viết mã cho cBot/chỉ báo của bạn. Sau đó, mở menu Build và chọn Build solution. Hoặc, nhấn Ctrl+Shift+B. Sau khi xây dựng thành công, bạn sẽ thấy một tệp .algo trong các thư mục đã chỉ định ở trên.

Nếu bạn không thấy cBot/chỉ báo mới của mình trong giao diện người dùng cTrader, hãy khởi động lại nền tảng cTrader và nó sẽ xuất hiện trong số các tiện ích mở rộng khác.

Để biết thêm thông tin về Visual Studio, hãy tham khảo tài liệu này.

Visual Studio Code

So với Visual Studio, VS Code là một trình soạn thảo mã nhẹ hơn nhiều, điều này lý giải cho sự phổ biến ngày càng tăng của nó trong giới lập trình viên. Để tạo cBot/chỉ báo thông qua VS Code, bạn phải đáp ứng các điều kiện tiên quyết sau.

  • Cài đặt .NET SDK.
  • Cài đặt tiện ích mở rộng C# trong VS Code.

Để cài đặt tiện ích mở rộng phù hợp, hãy mở thị trường tiện ích mở rộng, nhập C# vào thanh tìm kiếm và chọn tiện ích mở rộng chính thức của Microsoft hoặc bất kỳ tiện ích bổ sung phù hợp nào khác.

Image title

Sau đó, bạn sẽ phải sử dụng giao diện dòng lệnh .NET (CLI) để tạo một giải pháp và một dự án thư viện lớp chứa cBot/chỉ báo của bạn.

Ghi chú

Bạn chỉ nên sử dụng Documents\cAlgo\Sources nếu bạn đang sử dụng hệ thống Windows, nếu không bạn có thể tạo và xây dựng các dự án chỉ báo/cBot của mình trong bất kỳ thư mục nào.

Tạo một chỉ báo

Để tạo một chỉ báo qua VS Code, hãy mở một terminal PowerShell mới bằng cách chọn New terminal trong menu Terminal. Hoặc, nhấn Ctrl+Shift+`.

1. Trong terminal, mở thư mục Documents\cAlgo\Sources\Indicators của bạn.

cd Documents\cAlgo\Sources\Indicators\

2. Tạo một thư mục mới cho chỉ báo của bạn. Nó sẽ chứa giải pháp và dự án chỉ báo của bạn. Chuyển sang thư mục này.

mkdir MyIndicator
cd MyIndicator

3. Tạo một giải pháp .NET mới bên trong thư mục vừa tạo.

dotnet new sln

4. Tạo một dự án thư viện lớp .NET.

dotnet new classlib --name MyIndicator

Dự án này sẽ được tạo bên trong thư mục MyIndicator.

5. Thêm dự án vào giải pháp của bạn.

dotnet sln add .\MyIndicator\MyIndicator.csproj

6. Cài đặt gói NuGet cTrader.Automate.

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

7. Thêm một lớp chỉ báo. Để làm điều này, đổi tên tệp Class1.cs thành MyIndicator.cs và mở nó, sau đó thay thế nội dung của nó bằng mã giữ chỗ sau. Chỉnh sửa mã trong 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. Xây dựng dự án.

dotnet build --configuration Release

Bạn cũng có thể xây dựng dự án của mình với mã nguồn.

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

Bạn có thể thay đổi cấu hình xây dựng thành Debug nếu bạn muốn gỡ lỗi chỉ báo của mình.

Sau khi xây dựng thành công, bạn sẽ có tệp .algo của chỉ báo bên trong thư mục bin của dự án và cũng bên trong thư mục Documents\cAlgo\Sources\Indicators\ nếu bạn đang sử dụng Windows.

Tạo một cBot

Việc tạo một cBot tương tự như tạo một chỉ báo ngoại trừ việc bạn phải sử dụng lớp Robot thay vì lớp Indicator và thư mục Documents\cAlgo\Sources\Robots\ thay vì Documents\cAlgo\Sources\Indicators\.

Bạn có thể sử dụng mã mẫu dưới đây cho lớp cBot của mình:

 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
    }
}

Các IDE .NET khác

Nếu muốn, bạn có thể sử dụng các IDE khác để làm việc với cBot, plugin và chỉ báo. Làm theo các bước sau để tạo tiện ích mở rộng cTrader hợp lệ:

  1. Tạo một dự án thư viện lớp .NET.
  2. Cài đặt gói NuGet cTrader.Automate.
  3. Tạo một tệp lớp chứa mã nguồn cBot/chỉ báo của bạn. Các chỉ báo kế thừa từ lớp Indicator trong khi cBot phải kế thừa từ lớp Robot.
  4. Xây dựng tiện ích mở rộng của bạn. Để biết thêm thông tin về việc biên dịch/xây dựng, hãy xem phần liên quan của tài liệu này.