A .NET Fordító Platformja SDK

A fordítók az alkalmazáskód részletes modelljét készítik el, mivel ellenőrzik a kód szintaxisát és szemantikáját. Ezzel a modellel készítik el a végrehajtható kimenetet a forráskódból. A .NET Fordítóplatform SDK hozzáférést biztosít ehhez a modellhez. Egyre inkább az integrált fejlesztési környezet (IDE) olyan funkcióira támaszkodunk, mint az IntelliSense, az újrabontás, az intelligens átnevezés, a "Minden hivatkozás keresése" és a "Ugrás a definícióra" a hatékonyság növelése érdekében. A kódelemzési eszközökre támaszkodunk a kódminőség javítása érdekében, valamint a kódgenerátorokra, hogy segítsük az alkalmazásépítést. Ahogy ezek az eszközök intelligensebbek lesznek, egyre több olyan modellhez kell hozzáférniük, amelyet csak a fordítók hoznak létre az alkalmazáskód feldolgozása során. Ez a Roslyn API-k alapvető küldetése: az átlátszatlan dobozok megnyitása, és lehetővé tétele az eszközök és a végfelhasználók számára, hogy részesülhessenek a fordítók kóddal kapcsolatos információ-kincseiben. Ahelyett, hogy csak a forráskódot átalakító és az objektumkódot előállító fordítók lennének, a Roslynen keresztül a fordítók platformmá válnak: API-kat kínálnak, amelyeket kóddal kapcsolatos feladatokhoz használhat az eszközeiben és alkalmazásaiban.

A .NET Fordítóplatform SDK-fogalmai

A .NET Fordítóplatform SDK jelentősen csökkenti a kódközpontú eszközök és alkalmazások létrehozásának akadályát. Számos lehetőséget teremt az innovációra olyan területeken, mint a metaprogramozás, a kódgenerálás és az átalakítás, a C# és a Visual Basic nyelvek interaktív használata, valamint a C# és a Visual Basic beágyazása tartományspecifikus nyelvekbe.

A .NET Fordítóplatform SDK lehetővé teszi olyan elemzők és kódjavítások készítését, amelyek megkeresik és kijavítják a kódolási hibákat. Az elemzők megértik a szintaxist (a kód szerkezetét) és a szemantikát a javítandó eljárások észleléséhez. A kódjavítások egy vagy több javasolt javítást biztosítanak az elemzők vagy fordítódiagnosztikák által talált kódolási hibák kezeléséhez. Az elemzők és a kapcsolódó kódjavítások általában egyetlen projektbe vannak csomagolva.

Az elemzők és a kódjavítások statikus elemzést használnak a kód megértéséhez. Nem futtatják a kódot, és nem biztosítanak más tesztelési előnyöket. Rámutathatnak azonban az olyan eljárásokra, amelyek gyakran hibákhoz, elérhetetlen kódhoz vagy szabványos irányelvsértésekhez vezetnek.

Az elemzők és a kódjavítások mellett a .NET Fordítóplatform SDK is lehetővé teszi a kód újrabontását. Emellett egyetlen API-készletet is biztosít, amelyek lehetővé teszik egy C# vagy Visual Basic kódbázis vizsgálatát és megértését. Mivel ezt az egyetlen kódbázist használhatja, könnyebben írhat elemzőket és kódjavításokat a .NET Fordítóplatform SDK által biztosított szintaktikai és szemantikai elemzési API-k használatával. A fordító által végzett elemzés replikálásának nagy feladatától megszabadulva koncentrálhat a projekt vagy tár gyakori kódolási hibáinak megkeresésére és kijavítására.

Kisebb előnye, hogy az elemzők és a kódjavítások kisebbek, és sokkal kevesebb memóriát használnak a Visual Studióban való betöltésekor, mint ha saját kódbázist írna a projekt kódjának megértéséhez. A fordító és a Visual Studio által használt osztályokkal saját statikus elemzési eszközöket hozhat létre. Ez azt jelenti, hogy csapata anélkül használhat elemzőket és kódjavításokat, hogy az az IDE teljesítményére gyakorolt észrevehető hatással lenne.

Az elemzők írásának és a kódjavításoknak három fő forgatókönyve van:

Csapatkódolási szabványok kényszerítése
Útmutatás a kódtárcsomagokkal kapcsolatban
Általános útmutatás megadása

Csapatkódolási szabványok kényszerítése

Sok csapat olyan kódolási szabványokkal rendelkezik, amelyeket kódkonfigurálással kényszerítenek ki más csapattagokkal. Az elemzők és a kódjavítások sokkal hatékonyabbá tehetik ezt a folyamatot. A kódértékelések akkor fordulnak elő, ha egy fejlesztő megosztja a munkáját a csapat más tagjaival. A fejlesztő minden szükséges időt fektetett be egy új funkció befejezéséhez, mielőtt megjegyzéseket kap. Heteket is igénybe vehet, amíg a fejlesztő megerősíti a csapat gyakorlatának nem megfelelő szokásokat.

Az elemzők futnak, miközben a fejlesztő kódot ír. A fejlesztő azonnali visszajelzést kap, amely arra ösztönzi, hogy azonnal kövesse az útmutatást. A fejlesztő szokásokat épít ki a megfelelő kód írására, amint elkezdik a prototípus-készítést. Ha a funkció készen áll az emberek számára a felülvizsgálatra, az összes szabványos útmutatót érvényesítették.

A Teams olyan elemzőket és kódjavításokat hozhat létre, amelyek a csapat kódolási gyakorlatát sértő leggyakoribb eljárásokat keresik. Ezek minden fejlesztő gépére telepíthetők a szabványok érvényre juttatásához.

Jótanács

Mielőtt saját elemzőt készít, tekintse meg a beépítetteket. További információ: Kódstílusú szabályok.

Útmutatás a könyvtár csomagokkal kapcsolatban

A NuGetben számos kódtár érhető el .NET-fejlesztők számára. Ezek némelyike a Microsofttól, néhány külső cégtől, más közösségi tagoktól és önkéntesektől származik. Ezek a kódtárak nagyobb bevezetést és magasabb szintű felülvizsgálatot kapnak, ha a fejlesztők sikeresek lehetnek ezekkel a kódtárakkal.

A dokumentáció mellett olyan elemzőket és kódjavításokat is biztosíthat, amelyek megtalálják és kijavítják a tár gyakori helytelen használatát. Ezek az azonnali javítások segítenek a fejlesztőknek a gyorsabb sikerben.

Az elemzőket és a kódjavításokat a NuGet könyvtárával csomagolhatja. Ebben a forgatókönyvben minden fejlesztő, aki telepíti a NuGet-csomagot, az elemzőcsomagot is telepíti. A kódtárat használó fejlesztők azonnal útmutatást kapnak a csapattól a hibákra és a javasolt javításokra vonatkozó azonnali visszajelzés formájában.

Általános útmutatás megadása

A .NET fejlesztői közösség a tapasztalatok alapján olyan mintákat talált, amelyek jól működnek, és a legjobban elkerülendő mintákat. Több közösségtag is létrehozott elemzőket, amelyek betartatják az ajánlott mintákat. Ahogy többet megtudunk, mindig van hely az új ötleteknek.

Ezek az elemzők feltölthetők a Visual Studio Piactérre , és a Fejlesztők a Visual Studio használatával tölthetik le őket. A nyelvre és a platformra újonnan érkezők gyorsan elsajátíthatják az elfogadott eljárásokat, és a .NET-folyamatuk korábbi szakaszában hatékonyan dolgozhatnak. Mivel ezek egyre szélesebb körben elterjedtek, a közösség elfogadja ezeket a gyakorlatokat.

Forrásgenerátorok

A forrásgenerátorok célja, hogy lehetővé tegyék a fordítási idő metaprogramozását, vagyis a fordításkor létrehozható és a fordításhoz hozzáadott kódot. A forrásgenerátorok a futtatás előtt elolvashatják a fordítás tartalmát, valamint hozzáférhetnek a további fájlokhoz. Ez a képesség lehetővé teszi számukra a felhasználói C#-kód és a generátorspecifikus fájlok betekintő használatát. Megtudhatja, hogyan hozhat létre növekményes forrásgenerátorokat a forrásgenerátor szakácskönyvével.

Következő lépések

A .NET Fordítóplatform SDK tartalmazza a kódgenerálás, -elemzés és újrabontás legújabb nyelvi objektummodelljeit. Ez a szakasz a .NET Fordítóplatform SDK koncepcionális áttekintését tartalmazza. További részletek a rövid útmutatók, minták és oktatóanyagok szakaszában találhatók.

A .NET Fordítóplatform SDK-ban az alábbi öt témakörből tudhat meg többet a fogalmakról:

Első lépésként telepítenie kell a .NET Fordítóplatform SDK-t:

Telepítési utasítások – Visual Studio Installer

A .NET Fordítóplatform SDK-t kétféleképpen keresheti meg a Visual Studio Installerben:

Telepítés a Visual Studio Installer – Munkaterhelések nézet használatával

A .NET Fordítóplatform SDK nincs automatikusan kiválasztva a Visual Studio bővítményfejlesztési számítási feladatainak részeként. Választható összetevőként kell kiválasztania.

Visual Studio Installer futtatása
Válassza a Módosítás lehetőséget
Ellenőrizze a Visual Studio bővítményfejlesztési számítási feladatát.
Nyissa meg a Visual Studio bővítményfejlesztési csomópontot az összefoglaló fán.
Jelölje be a .NET Fordítóplatform SDK jelölőnégyzetét. Az opcionális összetevők alatt fogja utoljára megtalálni.

Szükség esetén azt is szeretné, hogy a DGML-szerkesztő diagramokat jelenítsen meg a vizualizációban:

Nyissa meg az Egyes összetevők csomópontot az összefoglaló fán.
A DGML-szerkesztő jelölőnégyzetének bejelölése

Telepítés a Visual Studio Installer – Egyéni összetevők lap használatával

Visual Studio Installer futtatása
Válassza a Módosítás lehetőséget
Az Egyes összetevők lap kiválasztása
Jelölje be a .NET Fordítóplatform SDK jelölőnégyzetét. A fordítók, a buildelési eszközök és a futtatókörnyezetek szakasz tetején találja meg.