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.
Feljegyzés
A kiadási folyamatok nem támogatják az indexforrásokat és a szimbólumok közzétételét.
Szimbólumok közzététele az Azure Artifacts szimbólumkiszolgálón
Jelentkezzen be az Azure DevOps-szervezetbe, és lépjen a projekthez.
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.
A folyamatdefinícióban válassza ki
+az új feladat hozzáadását.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.
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.
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.
Jelentkezzen be az Azure DevOps-szervezetbe, és lépjen a projekthez.
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.
A folyamatdefinícióban válassza ki
+az új feladat hozzáadását.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.
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.
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.
Forráshivatkozás használata .NET-projektekben
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.GitHubcsomaghivatkozá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.Gitcsomaghivatkozá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.Gitcsomaghivatkozá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.
Jelentkezzen be az Azure DevOps-szervezetbe, és lépjen a projekthez.
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.
A folyamatdefinícióban válassza ki
+az új feladat hozzáadását.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.
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.
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:
A Visual Studióban válassza az Eszközök , majd a Beállítások lehetőséget.
Válassza a Szimbólumok lehetőséget a Hibakeresés menüben.
Válassza ki a
+jelet egy új szimbólumkiszolgáló helyének hozzáadásához.
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.
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.
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.