Megosztás a következőn keresztül:


Szimbólumok közzététele az Azure Pipelines használatával

Azure DevOps Services | Azure DevOps Server 2022 – Azure DevOps Server 2019

Az Azure Pipelines használatával a szimbólumokat közzéteheti az Azure Artifacts szimbólumkiszolgálón az Index-források használatával, és közzéteheti a szimbólumokat . A hibakeresővel a megfelelő szimbólumfájlokat csatlakoztathatja és automatikusan lekérheti anélkül, hogy ismerné a termékneveket, a buildszámokat vagy a csomagneveket. Az Azure Pipelines használatával a szimbólumokat fájlmegosztásokban és hordozható PDF-fájlokban is közzéteheti.

Szimbólumok közzététele az Azure Artifacts szimbólumkiszolgálón

  1. Jelentkezzen be az Azure DevOps-szervezetbe, és lépjen a projekthez.

  2. Válassza a Folyamatok lehetőséget, válassza ki a folyamatot, majd válassza a Szerkesztés lehetőséget a folyamat módosításához.

  3. A folyamatdefinícióban válassza ki + az új feladat hozzáadását.

  4. Keresse meg az indexforrásokat, és tegye közzé a szimbólumokat . Válassza a Hozzáadás lehetőséget a folyamathoz való hozzáadásához.

  5. Töltse ki a szükséges mezőket az alábbiak szerint:

    • Feladat verziója: 2.\*.

    • Megjelenítendő név: feladatmegjelenítés neve.

    • A szimbólumok mappa elérési útja: a szimbólumfájlokat tartalmazó mappa elérési útja.

    • Keresési minta: a .pdb fájlok megkeresésére használt minta a Path to symbols mappában kijelölt mappában. Az egymappás helyettesítő karakterek (*) és a rekurzív helyettesítő karakterek (**) egyaránt támogatottak. Példa: *\bin**.pdb: minden .pdb fájlt keres az összes bin nevű alkönyvtárban.

    • Indexforrások: azt jelzi, hogy a forráskiszolgáló adatait be kell-e szúrni a PDB-fájlokba.

    • Szimbólumok közzététele: azt jelzi, hogy közzé kívánja-e tenni a szimbólumfájlokat.

      • Szimbólumkiszolgáló típusa: válassza a szimbólumkiszolgálót ebben a szervezetben/gyűjteményben (az Azure Artifacts szükséges) a szimbólumok Azure Artifacts szimbólumkiszolgálón való közzétételéhez.
    • Részletes naplózás: további információk belefoglalása a naplókba.

Képernyőkép az indexforrások konfigurálásáról és a szimbólumok közzétételéről, hogy szimbólumokat tegyenek közzé az Azure Artifacts szimbólumkiszolgálón.

Szimbólumok közzététele fájlmegosztásban

Az Azure Artifacts szimbólumkiszolgálón kívül a szimbólumokat egy fájlmegosztásban is közzéteheti az Indexforrások és a Szimbólumok közzététele feladattal.

  1. Jelentkezzen be az Azure DevOps-szervezetbe, és lépjen a projekthez.

  2. Válassza a Folyamatok lehetőséget, válassza ki a folyamatot, majd válassza a Szerkesztés lehetőséget a folyamat módosításához.

  3. A folyamatdefinícióban válassza ki + az új feladat hozzáadását.

  4. Keresse meg az indexforrásokat, és tegye közzé a szimbólumokat . Válassza a Hozzáadás lehetőséget a folyamathoz való hozzáadásához.

  5. Töltse ki a szükséges mezőket az alábbiak szerint:

    • Feladat verziója: 2.\*.

    • Megjelenítendő név: feladatmegjelenítés neve.

    • A szimbólumok mappa elérési útja: a szimbólumfájlokat tartalmazó mappa elérési útja.

    • Keresési minta: a .pdb fájlok megkeresésére használt minta a Path to symbols mappában kijelölt mappában.

    • Indexforrások: azt jelzi, hogy a forráskiszolgáló adatait be kell-e szúrni a PDB-fájlokba.

    • Szimbólumok közzététele: azt jelzi, hogy közzé kívánja-e tenni a szimbólumfájlokat.

      • Szimbólumkiszolgáló típusa: Válassza a Fájlmegosztás lehetőséget a szimbólumok fájlmegosztásban való közzétételéhez.
      • Szimbólumok közzétételének elérési útja: a szimbólumokat tartalmazó fájlmegosztás.
    • Részletes naplózás: ellenőrizze, hogy további információkat szeretne-e szerepeltetni a naplókban.

    Képernyőkép az indexforrások konfigurálásáról és a szimbólumok közzétételéről a szimbólumok fájlmegosztásban való közzétételéhez.

Hordozható PDF-ek közzététele az Azure Artifacts szimbólumkiszolgálón

A hordozható PDF-fájlok olyan szimbólumfájlok, amelyek minden platformon létrehozhatók és használhatók, ellentétben a hagyományos PDF-ekkel, amelyeket csak Windows rendszeren használnak. Hordozható PDF-fájlok esetén a build végzi az indexelést, de a szimbólumok közzétételéhez továbbra is az Indexforrások és a Szimbólumok közzététele feladatot kell használnia.

A Source Link olyan eszközök készlete, amelyek lehetővé teszik a fejlesztők számára a forráskód hibakeresését a .NET-szerelvényekről a forráskódra való leképezéssel. Tekintse meg a dotnet/sourcelink GitHub-adattárat, és ismerje meg a különböző csomagokat.

  • A GitHubon üzemeltetett projektek esetében adja hozzá a Microsoft.SourceLink.GitHub csomaghivatkozást a projektfájlhoz.

    <ItemGroup>
      <PackageReference Include="Microsoft.SourceLink.GitHub" Version="1.1.1" PrivateAssets="All"/>
    </ItemGroup>
    
  • Az Azure Reposban (korábbi Visual Studio Team Services) üzemeltetett projektek esetében adja hozzá a Microsoft.SourceLink.AzureRepos.Git csomaghivatkozást a projektfájlhoz.

    <ItemGroup>
      <PackageReference Include="Microsoft.SourceLink.AzureRepos.Git" Version="1.1.1" PrivateAssets="All"/>
    </ItemGroup>
    
  • Az Azure DevOps Serveren (korábbi Team Foundation Server) üzemeltetett projektek esetében adja hozzá a Microsoft.SourceLink.AzureDevOpsServer.Git csomaghivatkozást a projektfájlhoz.

    <ItemGroup>
      <PackageReference Include="Microsoft.SourceLink.AzureDevOpsServer.Git" Version="1.1.1" PrivateAssets="All"/>
    </ItemGroup>
    

A közzétételi feladat beállítása

Az Indexforrások > Szimbólumok közzététele feladat a forráskód indexelésére és a szimbólumok Azure Artifacts-szimbólumok kiszolgálói és fájlmegosztásokban való közzétételére szolgál. Mivel a Forráshivatkozást használjuk, le kell tiltanunk az indexelést a közzétételi feladatban.

  1. Jelentkezzen be az Azure DevOps-szervezetbe, és lépjen a projekthez.

  2. Válassza a Folyamatok lehetőséget, válassza ki a folyamatot, majd válassza a Szerkesztés lehetőséget a folyamat módosításához.

  3. A folyamatdefinícióban válassza ki + az új feladat hozzáadását.

  4. Keresse meg az indexforrásokat, és tegye közzé a szimbólumokat . Válassza a Hozzáadás lehetőséget a folyamathoz való hozzáadásához.

  5. Töltse ki a szükséges mezőket, és válassza a Szimbólumkiszolgáló lehetőséget a szimbólumkiszolgáló típusához. Az indexelés letiltásához törölje az Indexforrások jelölőnégyzet jelölését.

    Képernyőkép arról, hogyan konfigurálhatja a közzétételi feladatot hordozható PDF-fájlok Azure Artifacts-szimbólumkiszolgálón való közzétételére.

Fontos

Az Indexforrások > Szimbólumok közzététele feladaton keresztül közzétett szimbólumok törléséhez először törölnie kell a szimbólumokat létrehozó buildet. Ez megőrzési szabályzatok használatával vagy a futtatás manuális törlésével valósítható meg.

A Visual Studio telepítése

Feljegyzés

A Visual Studio for Mac nem támogatja a szimbólumkiszolgálók használatával végzett hibakeresést.

Mielőtt elkezdené használni szimbólumainkat az Azure Artifacts szimbólumkiszolgálóról, győződjön meg arról, hogy a Visual Studio megfelelően van beállítva:

  1. A Visual Studióban válassza az Eszközök , majd a Beállítások lehetőséget.

  2. Válassza a Szimbólumok lehetőséget a Hibakeresés menüben.

  3. Válassza ki a + jelet egy új szimbólumkiszolgáló helyének hozzáadásához.

    Képernyőkép egy új szimbólumkiszolgáló helyének hozzáadásáról.

  4. Megjelenik egy új párbeszédpanel, válassza ki a fiókját a legördülő menüből, majd válassza ki azt a szervezetet, amelyhez csatlakozni szeretne. Ha végzett, válassza Csatlakozás.

  5. Válassza az Általános lehetőséget ugyanabból a hibakeresési szakaszból. Görgessen le, és jelölje be a Forráshivatkozás engedélyezése támogatást a hordozható PDF-fájlok támogatásának engedélyezéséhez.

    Képernyőkép arról, hogyan engedélyezheti a forráshivatkozások támogatását a Visual Studióban.

Feljegyzés

A forráskiszolgáló támogatásának engedélyezése beállítás ellenőrzése lehetővé teszi a forráskiszolgáló használatát olyan esetekben, amikor a forráskód nem érhető el helyileg, vagy ha a szimbólumfájl nem egyezik a forráskóddal. Ha engedélyezni szeretné a külső forráskód hibakeresését, törölje a jelölést a Csak saját kód engedélyezése jelölőnégyzetből.

GYIK

K: Mennyi ideig őrzik meg a szimbólumokat?

Válasz: A szimbólumfájlok megőrzési ideje megegyezik az azt létrehozó buildel. Ha manuálisan vagy adatmegőrzési házirendek használatával töröl egy buildet, a build által létrehozott szimbólumok is törlődnek.

K: Használhatok forrásindexelést egy .NET Core-szerelvényből létrehozott hordozható PDB-n?

Válasz: Ez jelenleg nem lehetséges. A forrásindexelés jelenleg nem támogatott a hordozható PDF-fájlok esetében. Az ajánlott módszer az, hogy a buildet az indexeléshez konfigurálja.