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 | Azure DevOps Server 2022 | Azure DevOps Server 2020

Az Azure Pipelines segítségével a szimbólumokat közzéteheti az Azure Artifacts szimbólumkiszolgálón a indexforrások és a szimbólumok feladat használatával. 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.

Megjegyzés

A kiadási folyamatok nem támogatják az indexforrások és szimbólumok közzététele feladatot.

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 Folyamatoklehetőséget, jelölje 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 a + új feladat hozzáadásához.

  4. Keresse meg a indexforrásokat, és tegye közzé a szimbólumokat a feladat végrehajtásához. Válassza a elemet, és adja hozzá a-et a munkafolyamatá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.

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

    • Keresési minta: a .pdb fájlok megkeresésére használt minta az általad kijelölt mappában a Szimbólumok elérési útja. Az egymappás helyettesítő karakterek (*) és a rekurzív helyettesítő karakterek (**) egyaránt támogatottak. Példa: *\bin**.pdb: az összes .pdb fájlt megkeresi az binnevű 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 (Azure Artifacts szükséges), hogy közzétegye a szimbólumokat az Azure Artifacts szimbólumkiszolgálón.

    • Részletes naplózás: több információt tartalmazzon a naplókban.

Képernyőkép arról, hogyan konfigurálhatja az indexforrásokat, és hogyan tehet közzé szimbólumokat 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 fájlmegosztásokban is közzéteheti az Indexforrások és szimbólumok közzététele feladattal.

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

  2. Válassza Folyamatoklehetőséget, jelölje 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 a + új feladat hozzáadásához.

  4. Keresse meg a indexforrásokat, és tegye közzé a szimbólumokat a feladat végrehajtásához. Válassza a elemet, és adja hozzá a-et a munkafolyamatá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.

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

    • Keresési minta: a .pdb fájlok megkeresésére használt minta az általad kijelölt mappában a Szimbólumok elérési útja.

    • 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 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őrizd, hogy további információkat szeretnél-e felvenni 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 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 a Indexforrásokat é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. A dotnet/sourcelink GitHub-adattárban megismerheti 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 Forráshivatkozáshasználunk, le kell tiltanunk az indexelési a közzétételi feladatban.

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

  2. Válassza Folyamatoklehetőséget, jelölje 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 a + új feladat hozzáadásához.

  4. Keresse meg a indexforrásokat, és tegye közzé a szimbólumokat a feladat végrehajtásához. Válassza a elemet, és adja hozzá a-et a munkafolyamatához.

  5. Töltse ki a szükséges mezőket, és válassza Szimbólumkiszolgáló lehetőséget a szimbólumkiszolgáló típusának. Az indexelés letiltásához törölje a indexforrások 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

A 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 adatmegőrzési szabályzatok alkalmazásával vagy a futtatás manuális törlésével érhető el.

A Visual Studio telepítése

Megjegyzé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 Eszközök, majd Beállításoklehetőséget.

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

  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 elkészült, válassza a Csatlakozás lehetőséget.

  5. Ugyanabból a hibakeresési szakaszból válassza Általános lehetőséget. Görgessen le, és ellenőrizze A forráshivatkozás támogatásának engedélyezése a hordozható PDB fájlok támogatásának biztosításához.

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

Megjegyzés

A Forráskiszolgáló támogatásának engedélyezése beállítás bejelölése lehetővé teszi, hogy a Forráskiszolgálót használja olyan helyzetekben, amikor a forráskód nem érhető el helyileg, vagy 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.

Gyakori kérdések

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.

  • Last updated on