Gunakan Visual Studio dan IDE lain

Cipta cBot/indikator baharu

Anda boleh memilih untuk menggunakan IDE luaran untuk mencipta cBot/indikator baharu dan bukannya menggunakan editor kod terbina dalam. Penggunaan IDE luaran membawa beberapa kelebihan seperti keupayaan untuk menggunakan sambungan IDE tersuai termasuk linter dan auto-formatter.

Walaupun terdapat banyak IDE yang sesuai untuk bekerja dengan C# dan .NET, kami mengesyorkan penggunaan sama ada Microsoft Visual Studio atau Visual Studio Code. Kedua-dua IDE ini mudah digunakan dan menawarkan pelbagai tetapan yang boleh disesuaikan untuk memudahkan kerja dengan C# dan .NET. Dokumentasi kami hanya meliputi IDE ini.

Visual Studio

Pasang pakej NuGet cTrader.Automate

Sebelum mencipta cBot atau indikator, pasang pakej NuGet cTrader.Automate. Anda boleh melakukannya dengan melaksanakan tindakan berikut:

• Buka menu Project dalam Visual Studio dan pilih Manage NuGet packages.
• Pilih nuget.org sebagai sumber pakej anda dan taip cTrader ke dalam bar carian.
• Klik pada pakej cTrader.Automate dan pilih Install.

Sebagai alternatif, buka menu Tools, pilih NuGet package manager, dan buka Package Manager Console. Di dalamnya, taip Install-Package cTrader.Automate.

Selepas memasang pakej NuGet cTrader.Automate, setiap kali anda membina projek cBot/indikator, Visual Studio akan secara automatik mencipta fail .algo untuk projek anda dalam direktori build. Apabila bekerja dalam Windows, pakej tersebut juga akan mencipta fail .algo yang sepadan dalam folder ../Documents/cAlgo/Sources/{Robots/Indicators}.

Cipta cBot dan indikator baharu dalam Visual Studio

Untuk mencipta cBot/indikator baharu, cipta projek baharu dalam Visual Studio dan pilih Class library. Namakan projek anda mengikut nama yang anda inginkan untuk cBot/sambungan anda.

Dalam fail "Class1.cs", tulis kod untuk cBot/indikator anda. Selepas itu, buka menu Build dan pilih Build solution. Sebagai alternatif, tekan Ctrl+Shift+B. Selepas pembinaan berjaya, anda sepatutnya melihat fail .algo dalam direktori yang dinyatakan di atas.

Jika anda tidak melihat cBot/indikator baharu anda dalam antara muka cTrader, lancarkan semula platform cTrader, dan ia sepatutnya muncul di antara sambungan lain.

Untuk maklumat tambahan tentang Visual Studio, rujuk dokumentasi ini.

Visual Studio Code

Berbanding dengan Visual Studio, VS Code ialah editor kod yang lebih ringan, yang menjustifikasikan populariti yang meningkat di kalangan pembangun. Untuk mencipta cBot/indikator melalui VS Code, anda perlu memenuhi prasyarat berikut.

• Pasang .NET SDK.
• Pasang sambungan C# dalam VS Code.

Untuk memasang sambungan yang sesuai, buka pasaran sambungan, taip C# dalam bar carian dan pilih sama ada sambungan rasmi Microsoft atau mana-mana tambahan lain yang sesuai.

Selepas itu, anda perlu menggunakan antara muka baris arahan (CLI) .NET untuk mencipta penyelesaian dan projek perpustakaan kelas yang mengandungi cBot/indikator anda.

Cipta indikator

Untuk mencipta indikator melalui VS Code, buka terminal PowerShell baharu dengan memilih New terminal dalam menu Terminal. Sebagai alternatif, tekan Ctrl+Shift+`.

1. Dalam terminal, buka direktori Documents\cAlgo\Sources\Indicators anda.

cd Documents\cAlgo\Sources\Indicators\

2. Cipta direktori baharu untuk indikator anda. Ia akan mengandungi penyelesaian dan projek indikator anda. Beralih ke direktori ini.

mkdir MyIndicator
cd MyIndicator

3. Cipta penyelesaian .NET baharu dalam direktori yang baru dicipta.

dotnet new sln

4. Cipta projek perpustakaan kelas .NET.

dotnet new classlib --name MyIndicator

Projek ini akan dicipta dalam direktori MyIndicator.

5. Tambah projek ke penyelesaian anda.

dotnet sln add .\MyIndicator\MyIndicator.csproj

6. Pasang pakej NuGet cTrader.Automate.

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

7. Tambah kelas indikator. Untuk berbuat demikian, namakan semula fail Class1.cs kepada MyIndicator.cs dan buka ia, kemudian gantikan kandungannya dengan kod pemegang tempat berikut. Edit kod dalam 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. Bina projek.

dotnet build --configuration Release

Anda juga boleh membina projek anda dengan kod sumber.

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

Anda boleh menukar konfigurasi pembinaan kepada Debug jika anda ingin nyahpepijat indikator anda.

Selepas pembinaan berjaya, anda akan mempunyai fail .algo indikator dalam folder bin projeknya dan juga dalam folder Documents\cAlgo\Sources\Indicators\ jika anda menggunakan Windows.

Cipta cBot

Mencipta cBot adalah serupa dengan mencipta indikator kecuali anda perlu menggunakan kelas Robot dan bukannya kelas Indicator dan direktori Documents\cAlgo\Sources\Robots\ dan bukannya Documents\cAlgo\Sources\Indicators\.

Anda boleh menggunakan kod sampel di bawah untuk kelas cBot anda:

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

IDE .NET lain

Jika anda memilih, anda boleh menggunakan IDE lain untuk bekerja dengan cBot, plugin dan indikator. Ikuti langkah-langkah ini untuk mencipta sambungan cTrader yang sah:

1. Cipta projek perpustakaan kelas .NET.
2. Pasang pakej NuGet cTrader.Automate.
3. Cipta fail kelas yang mengandungi kod sumber cBot/indikator anda. Indikator mewarisi daripada kelas Indicator manakala cBot mesti mewarisi daripada kelas Robot.
4. Bina sambungan anda. Untuk maklumat lanjut tentang penyusunan/pembinaan, semak bahagian berkaitan dalam dokumentasi ini.