Forrás- és konfigurációs fájlok

1Egy konzolos projekt anatómiája

Így néz ki egy frissen létrehozott, egyszer már lefordított konzolos projekt:

Mastermind/                        ← a projekt mappája
├─ Program.cs                      ← FORRÁSKÓD — ezt írod te
├─ Mastermind.csproj               ← PROJEKTFÁJL — beállítások a fordítónak
├─ bin/                            ← KÉSZ PROGRAM — a fordítás végterméke
│  └─ Debug/
│     └─ net10.0/
│        ├─ Mastermind.exe         ← ezt indítod el
│        ├─ Mastermind.dll         ← ebben van az IL-kódod (A3!)
│        └─ …
└─ obj/                            ← MŰHELY — a fordító ideiglenes fájljai
   └─ …

Négyféle szereplő, négyféle szabály:

2A forrásfájlok: *.cs

A .cs kiterjesztésű fájlokban van a C#-kód. Egy projektben bármennyi forrásfájl lehet — a fordító a projektmappa összes .cs fájlját lefordítja, külön felsorolás nélkül. Ahogy nő a program, úgy bontjuk majd több fájlra (a Konzol segédosztályunk is saját fájlt kap).

Két sor, amivel sok fájl elején találkozol majd:

using System.Text;        // névtér „importálása” — kész osztályok elérése

namespace Mastermind;     // a saját kódod névtere

• A névtér (namespace) az osztályok „vezetékneve”: a Console teljes nevén System.Console. A using sorral megspórolod, hogy mindig ki kelljen írni a System. előtagot.
• Az újabb .NET-projektekben az alap névterek (köztük a System) automatikusan importálódnak — ezért tudunk Console.WriteLine-t írni using nélkül is. Ezt a .csproj egyik kulcsa kapcsolja be (mindjárt látni fogod).

3A projektfájl: *.csproj

A .csproj a projekt személyi igazolványa: XML-formátumú beállításfájl, amely megmondja a fordítónak, mit és hogyan fordítson. Egy friss konzolos projekté így néz ki:

<Project Sdk="Microsoft.NET.Sdk">

  <PropertyGroup>
    <OutputType>Exe</OutputType>
    <TargetFramework>net10.0</TargetFramework>
    <ImplicitUsings>enable</ImplicitUsings>
    <Nullable>enable</Nullable>
  </PropertyGroup>

</Project>

Mit jelentenek ezek a kulcsok?

4bin és obj — a végtermék és a műhely

• obj/ — a műhely. Ide dolgozik a fordító menet közben: ideiglenes, félkész fájlok, gyorsítótár. Ettől gyorsabb az újrafordítás: csak az fordul újra, ami változott.
• bin/ — a végtermék. Ide kerül a kész, futtatható program és minden, ami a futásához kell. A bin\Debug\net10.0\ útvonal elárulja: Debug = fejlesztői változat, net10.0 = a cél-keretrendszer.

A Debug mellett létezik Release mód is: optimalizált, gyorsabb, hibakereső-információk nélküli változat — ezt adnád ki a felhasználóknak. A kettő között a Visual Studio eszköztárán egy legördülővel váltasz.

5SDK és runtime — fejlesztéshez több kell, mint futtatáshoz

Az A3-ból tudjuk: a C#-program futásához kell a .NET runtime (CLR + BCL). Fejlesztéshez viszont több kell — az SDK (Software Development Kit):

• A te gépeden: SDK kell (a Visual Studio telepíti — A5 fejezet).
• A felhasználó gépén: elég a runtime — vagy még az sem, ha „önálló” programot adsz neki (lásd a 7. pontot).

A parancssorból bármikor megnézheted, mi van a gépen:

dotnet --list-sdks       ← telepített SDK-k
dotnet --list-runtimes   ← telepített runtime-ok

6A solution: *.sln

A Visual Studio nem projekteket, hanem solutiont (megoldást) nyit meg: ez egy gyűjtő, amelyben egy vagy több projekt él. Nálunk eleinte minden solutionben egyetlen projekt lesz — de a II. félévben jól jön majd: a kalandjáték logikája és a konzolos felülete külön projekt lehet ugyanabban a solutionben, és az L blokkban csak egy harmadik (WPF-es) projektet teszünk melléjük.

Kalandjatek.sln                 ← a solution (gyűjtő)
├─ Kalandjatek.Logika/          ← Library projekt (a játék szíve)
├─ Kalandjatek.Konzol/          ← Exe projekt (konzolos felület)
└─ Kalandjatek.Wpf/             ← WinExe projekt (év végén)

7Publish — így adod oda a programod másnak

A bin\Debug mappa nem arra való, hogy továbbadd. A kiadásra a publish (közzététel) szolgál, két üzemmódban:

Önálló, egyetlen fájlba csomagolt program parancssorból:

dotnet publish -c Release -r win-x64 --self-contained -p:PublishSingleFile=true

Ugyanez a Visual Studióban: jobb kattintás a projekten → Publish. A Mastermind projektnél (G blokk) élesben is kipróbáljuk.

8Gyakorlat — projekt a parancssorból

1. Nyiss parancssort: Win + R → cmd → Enter.
2. Ellenőrizd az SDK-t: dotnet --list-sdks — látnod kell egy 10.x sort.
3. Hozz létre projektet és lépj be a mappájába:

cd %USERPROFILE%\Desktop
dotnet new console -o ElsoProba
cd ElsoProba

4. Nézd meg, mi készült: dir — ott a Program.cs és az ElsoProba.csproj. Nyisd meg Jegyzettömbben mindkettőt: notepad Program.cs, notepad ElsoProba.csproj.
5. Fordítsd és futtasd: dotnet run — a képernyőn megjelenik: Hello, World!
6. Nézd meg újra a mappát: dir — megjelent a bin és az obj! Keresd meg a bin\Debug\net10.0\ElsoProba.exe fájlt, és indítsd el dupla kattintással is.

9Feladatok

10Önellenőrző kvíz

11Fogalomtár

12Összegzés