1.3 C# un .NET sagatavošana

Stundas uzdevums: Pārbaudīt .NET SDK, izveidot C# skriptu un iziet pilnu rediģēšanas, kompilācijas un palaišanas ciklu.

SR 2.4.12. Programmēšanas vide SR 2.4.2. Argumentēti izvēlas rīkus SR 2.3.2. Datorikas virzieni un profesijas SR 2.4.8. Koda dokumentēšana un noformēšana SR 2.4.9. Versiju pārvaldība SR 2.4.11. Standartizētas bibliotēkas un API

80 min plāns: Ievads (~10 min) · .NET pārbaude (~20 min) · pirmais Build (~25 min) · redaktors un kļūdu meklēšana (~20 min) · saglabāšana (~5 min).

Pirms sāc: atver savu 1.2 Pong projektu ar Main, abām raketēm un Ball. Šodien pārbaudīsi darba vidi ar mazu BuildCheck skriptu, lai kustības programmēšanā vēlāk netraucētu instalācijas kļūdas.

Darba ritms: pēc katra uzdevuma saglabā un pārbaudi rezultātu. Kad projektam pievienots C# skripts, pirms palaišanas nospied Build. Kļūdu gadījumā sāc ar pirmo sarkano kļūdu, nevis nākamo uzdevumu.

Teorija: redaktors, SDK un kompilācija

Godot .NET atver C# projektu, bet koda kompilācijai nepieciešams atsevišķs .NET SDK. Tikai .NET Runtime nav pietiekams. dotnet --list-sdks parāda uzstādītos SDK; dotnet build kompilē projektu mapē ar .csproj.

Godot izveido C# projekta failus, kad pievieno pirmo C# skriptu. Build pogas neesamība vēl tukšā projektā pati par sevi nav kļūda. Pārbaude ir skripta izveide → veiksmīgs Build → izdruka spēles palaišanas laikā. Skati Godot C# vides norādes.

1. uzdevums -

Pārbaudi .NET SDK un redaktora versiju

Godot izvēlnē Help → About pārbaudi, ka lieto .NET variantu. Parastā Godot versijā Attach Script valodu sarakstā C# nebūs.
Atver VS Code termināli un izpildi dotnet --list-sdks un dotnet --version. Sarakstam jābūt netukšam. Pieraksti Godot un SDK versiju README.md.
Ja SDK nav, instalē to no oficiālās .NET lejupielādes. Kursa piemērā izmantots .NET 8 SDK; citas Godot versijas gadījumā ievēro tās SDK prasības. Atver Godot un termināli no jauna.
VS Code atver visu Pong projekta mapi. Pagaidām neizpildi dotnet build, ja .csproj vēl nav — to izveidos nākamais uzdevums.

Gatavs, kad: terminālis atrod SDK un Pong ir atvērts Godot .NET redaktorā.

2. uzdevums -

Izveido un palaid BuildCheck.cs

Main.tscn saknei pievieno Node bērnu ar nosaukumu BuildCheck. Atlasot šo mezglu, izvēlies Attach Script, valodu C# un ceļu res://Scripts/BuildCheck.cs.
Aizstāj skripta saturu ar pilno failu zemāk. BuildCheck.cs satur public partial class BuildCheck : Node; klases un faila nosaukumi sakrīt.
Saglabā skriptu un scēnu. Nospied Build; ja pakotnes jālejupielādē pirmo reizi, sagaidi procesa beigas. Turpini tikai tad, kad nav kompilācijas kļūdu.
Palaid F5 un atver Output. Jāparādās C# build darbojas.. Apturi spēli; projekta mapē atrodi Pong.csproj un Godot ģenerēto risinājuma failu, ja tas ir izveidots.
VS Code terminālī no Pong mapes izpildi dotnet build. Tas pats kods jāspēj kompilēt arī no termināļa.

1.3 BuildCheck.cs — pilns fails salīdzināšanai

Lejupielādēt BuildCheck.cs. Aizstāj tikai atbilstošā faila saturu; neveido otru tāda paša nosaukuma klasi.

using Godot;

public partial class BuildCheck : Node
{
    public override void _Ready()
    {
        GD.Print("C# build darbojas.");
    }
}

Gatavs, kad: abi kompilācijas veidi izdodas, un F5 laikā redzama tieši šī skripta izdruka.

3. uzdevums -

Pieslēdz koda redaktoru un atrodi vienu kļūdu

Godot Editor → Editor Settings → Dotnet → Editor kā External Editor izvēlies Visual Studio Code. VS Code uzstādi Microsoft C# paplašinājumu. Veicot dubultklikšķi uz BuildCheck.cs, jāsākas rediģēšanai.
Nomaini izdrukas tekstu, saglabā, Build un F5. Salīdzini jauno izdruku ar iepriekšējo. Saglabāts fails un veiksmīgi pārkompilēts kods ir divi atsevišķi soļi.
Uz laiku izdzēs semikolu pēc GD.Print un nospied Build. Nokopē pirmās kļūdas tekstu ar failu un rindas numuru. Atjauno semikolu, tad atkārto Build un F5.
Pārskati Source Control: saglabā .cs, .csproj, risinājuma failu (.sln vai .slnx, ja tāds ģenerēts), .tscn un skriptu .uid failus, ja tie izveidoti. .godot, bin un obj paliek ignorēti. Veic Commit un Push.

Gatavs, kad: proti rediģēt, kompilēt, nolasīt kļūdu un atgriezt projektu strādājošā stāvoklī.

Papildu uzdevums — izveido savu BUILD.md atgādni

Pieraksti Godot un SDK versiju, projekta atvēršanas ceļu, Build/F5 darbības, komandas un atrastās kļūdas risinājumu. Palūdz klasesbiedram pēc pieraksta atrast, kur jālabo skripts.

Ko sagatavo

Stundas mērķis: vide ir pārbaudīta ar īstu C# kompilāciju un izpildi.

GitHub krātuvē jābūt:

Scripts/BuildCheck.cs, atjaunināts Main.tscn un C# projekta faili.
README.md: abu rīku versijas, pirmās kļūdas teksts un labojums; Output izdrukas pierādījums.

Saglabā projekta iestatījumus, izveidotās scēnas un resursus; no 1.3 stundas arī C# skriptus un projekta failus (.csproj u.c.). .gitignore ieraksti .godot/, bin/ un obj/ katru savā rindā.

Kā iesniedz: veic commit un push. Skolotāja norādītajā vietā iesniedz GitHub krātuves saiti; README.md un pārbaudes pierādījumiem jābūt krātuvē.

Ja kaut kas nestrādā

Pazīme	Ko pārbaudīt
C# nav valodu sarakstā	Atver projektu Godot .NET variantā.
dotnet nav atrasts vai SDK saraksts tukšs	Uzstādi SDK, ne tikai Runtime; atver termināli un Godot no jauna.
MSB1003: nav projekta	Termināļa darba mapei jāsatur Pong.csproj. Vispirms izveido C# skriptu Godot.
NETSDK1045 vai trūkst atbilstoša SDK	Salīdzini .csproj TargetFramework ar uzstādītajiem SDK un Godot versijas prasībām; neizmaini versijas uz nejaušām vērtībām.
Build izdodas, bet izdrukas nav	Pārbaudi skripta piesaisti BuildCheck mezglam Main scēnā un palaid F5, nevis atsevišķu Paddle scēnu.