Skip to content
Blackbird API

Projekt beállítása és alkalmazások klónozása

Használja kedvenc IDE-jét egy .NET osztálykönyvtár létrehozásához a projekt indításához. Ezután telepítse az SDK-nkat a NuGet segítségével. Az SDK-nk linkjét itt találja, vagy keressen rá a ‘Blackbird’ kulcsszóra a NuGet csomagkezelőben. Ez az útmutató bemutatja a lépéseket a Visual Studio 2022 for Windows használatával. Alternatívaként létrehozhat Blackbird alkalmazást egy sablonból is.

Előfeltételek

  • Telepített Git a helyi gépen. Ehhez az oktatóanyaghoz feltételezzük, hogy alapvető ismeretekkel rendelkezik a Git használatáról (ha sablonból indul).
  • Telepítse a Visual Studio for Windows-t a .NET desktop development munkaterülettel. Letöltheti és telepítheti a 2022 Community kiadást ingyenesen, vagy használhatja a Professional vagy Enterprise kiadást. Alternatívaként használhat bármilyen más .NET IDE környezetet, mint például a Rider vagy a VS Code a szükséges bővítményekkel.
  • .NET 8 (vagy újabb) telepítve a gépére.

Nulláról kezdve

Projekt létrehozása

  1. A Visual Studio-ban válassza a Fájl > Új > Projekt menüpontot.
  2. Az Új projekt létrehozása ablakban írja be az Osztálykönyvtár kifejezést a keresőmezőbe, és válassza a C# lehetőséget a legördülő listákban. Az eredményül kapott projektsablonok listájából válassza az Osztálykönyvtár lehetőséget, majd kattintson a Tovább gombra.
  3. Az Új projekt konfigurálása ablakban frissítse a Projekt nevét és a Megoldás nevét, majd kattintson a Tovább gombra.
  4. Válassza a .NET 8.0 (vagy a legújabb verziót) a Keretrendszer számára a További információk ablakban, majd kattintson a Létrehozás gombra.

A Visual Studio létrehozza a projektet, amely megjelenik a Megoldáskezelőben.

SDK hozzáadása

A projekt formátumától függően a NuGet csomag telepítése a függőséget vagy a projektfájlban, vagy egy packages.config fájlban rögzíti. További információt a Csomag használati munkafolyamat részben találhat.

A Blackbird.Applications.Sdk.Common csomag telepítéséhez a NuGet Package Manager használatával a Visual Studio-ban kövesse az alábbi lépéseket:

  1. Válassza a Projekt > NuGet csomagok kezelése menüpontot.
  2. A NuGet Package Manager oldalon válassza a nuget.org lehetőséget a Csomagforrás számára.
  3. A Böngészés fülön keressen rá a Blackbird.Applications.Sdk.Common kifejezésre, válassza ki a Blackbird.Applications.Sdk.Common csomagot a listából, majd kattintson a Telepítés gombra.
  4. Amikor a rendszer kéri a telepítés megerősítését, kattintson az OK gombra.

nuget

Sablon alapján

Klónozza a sablon alkalmazás repozitóriumát a parancssorból a következő paranccsal:

Terminal window
git clone https://github.com/bb-io/TemplateApp.git

Nyissa meg a solution fájlt és fedezze fel a projektet

Klónozás meglévő alkalmazásból

Klónozza annak az alkalmazásnak a repozitóriumát, amelyet módosítani szeretne. A Blackbird összes repozitóriumát itt találja.

A módosítások telepítésekor egy egyéni alkalmazásban kell ezt megtennie. Kérjük, tekintse meg a telepítési útmutatót. Vegye figyelembe, hogy a metaadat struktúrában a Product és az AssemblyName változókat is módosítania kell. Lásd alább.

Metaadat struktúra

A Blackbird a .csproj fájlban meghatározott tulajdonságokat használja a metaadat mezők kitöltéséhez. A legtöbb egyéni alkalmazás esetében csak a Version és az AssemblyName releváns (a többi tulajdonság a felhasználói felületen van meghatározva). Egy meglévő alkalmazás újabb verziójának feltöltésekor győződjön meg arról, hogy a verziószám magasabb.

nuget