Notitie
Voor toegang tot deze pagina is autorisatie vereist. U kunt proberen u aan te melden of de directory te wijzigen.
Voor toegang tot deze pagina is autorisatie vereist. U kunt proberen de mappen te wijzigen.
Azure DevOps Services | Azure DevOps Server 2022 - Azure DevOps Server 2019
Zodra u uw extensie hebt ontwikkeld, kunt u deze inpakken en publiceren naar Visual Studio Marketplace. Marketplace is een globale opslagplaats voor privé- en openbare extensies, integraties en andere aanbiedingen van Microsoft.
Notitie
Zie de extensiemanifestverwijzing voor informatie over de detectie-eigenschappen die beschikbaar zijn in het manifestbestand van uw extensie waarmee gebruikers uw extensie kunnen detecteren en leren.
Vereisten
Aan de volgende lijst met vereisten moet worden voldaan voordat u naar Marketplace publiceert.
Categorie | Vereisten |
---|---|
Verpakkingshulpmiddel | Installeer het hulpprogramma voor extensieverpakkingen (TFX). Uitvoeren npm install -g tfx-cli vanaf een opdrachtprompt. |
Afbeeldingsmachtigingen | Zorg ervoor dat u over de juiste machtigingen beschikt voor het gebruik van afbeeldingen, zoals pictogrammen, logo's, schermopnamen, enzovoort. |
Overzicht van Marketplace | Voeg een grondig overview.md bestand toe om uw vermelding in Marketplace te beschrijven. |
Extensiepictogram | Neem een pictogram op voor uw extensie die uw integratie, bedrijf of organisatie vertegenwoordigt, ten minste 128x128 pixels groot (PNG of JPEG). |
Microsoft-productnamen | Gebruik volledige namen voor Microsoft-producten (bijvoorbeeld Azure DevOps in plaats van AzDO of andere afkortingen). |
Merknamen | Gebruik geen merknamen in de naam van uw extensie. |
Een uitgever maken
Elke extensie of integratie, inclusief die van Microsoft, moet een uitgever hebben. Iedereen kan een uitgever maken en er extensies onder publiceren. U kunt ook uitgeverstoegang delen met andere gebruikers, zoals uw ontwikkelteam.
Meld u aan bij de Visual Studio Marketplace-publicatieportal.
Als u geen deel uitmaakt van een bestaande uitgever, selecteert u + Een uitgever maken.
Voer een naam in voor de uitgever; het id-veld wordt automatisch ingevuld op basis van uw invoer.Notitie
- Zorg ervoor dat de naam van de uitgever binnen 16 tekens valt bij multibyte-tekens.
- Sla de uitgevers-id op. U hebt deze nodig in het manifestbestand van uw extensie.
Als u niet wordt gevraagd om een uitgever te maken, schuift u naar Extensies publiceren onder Gerelateerde sites.
- Stel een unieke uitgevers-id in, zoals
mycompany-myteam
. Gebruik deze waarde voor hetpublisher
kenmerk in uw manifest. - Stel een weergavenaam in, zoals
My Team
.
Controleer de Marketplace-uitgeversovereenkomst en selecteer Maken.
Nadat u de uitgever hebt gemaakt, kunt u items beheren, hoewel er geen items worden weergegeven totdat u publiceert.
Uw extensie verpakken
Als u uw extensie wilt uploaden, verpakt u deze als een VSIX 2.0-compatibel VSIX-bestand. Microsoft biedt een platformoverschrijdende opdrachtregelinterface (CLI) voor het verpakken en publiceren van uw extensie.
Open het manifestbestand van de extensie (
vss-extension.json
) en stel de waarde van hetpublisher
veld in op de id van uw uitgever. Voorbeeld:{ ... "id": "my-first-extension", "publisher": "AnnetteNielsen", ... }
Voer vanaf een opdrachtprompt de pakketopdracht van het TFX-hulpprogramma uit vanuit de extensiemap.
npx tfx-cli extension create
Er wordt een bericht weergegeven waarin wordt aangegeven dat uw extensie is verpakt:
=== Completed operation: create extension === - VSIX: C:\my-first-extension\AnnetteNielsen.my-first-extension-1.0.0.vsix - Extension ID: my-first-extension - Extension Version: 1.0.0 - Publisher: AnnetteNielsen
Notitie
Verhoog de versie van uw extensie of integratie in het manifest met elke update.
Gebruik de --rev-version
opdrachtregeloptie. Met deze schakelaar wordt de patch-versie van uw extensie verhoogd en de nieuwe versie wordt opgeslagen in uw manifest.
Grootte van pakket controleren
Controleer de grootte van de vsix nadat deze is ingepakt. Als deze groter is dan 50 MB, moet u deze optimaliseren. Zie de volgende overwegingen om dit te doen:
- Ontdubbel veelvoorkomende afhankelijkheden door ze eenmaal in het extensiepakket te vermelden.
- Haal afhankelijkheden tijdens runtime of tijdens de installatietijd op in plaats van ze op te slaan in het pakket. Overweeg het gebruik van de installatiebibliotheek voor hulpprogramma's om tijdens runtime hulpprogrammaafhankelijkheden op te halen. Deze aanpak plaatst het hulpprogramma in de cache per versie voor privéagenten, waardoor downloads voor elke build worden voorkomen. De installatiebibliotheek van het hulpprogramma werkt niet in niet-verbonden scenario's (geen internet), die moeten worden vermeld in de taakbeschrijving of documentatie.
- Gebruik WebPack om afhankelijkheden in taken te schudden.
Uw extensie publiceren
Zodra uw extensie is verpakt, kunt u deze uploaden naar Marketplace onder een uitgever. De publisher
id die is opgegeven in het manifestbestand van uw extensie moet overeenkomen met de id van de uitgever waaronder de extensie wordt geüpload.
Selecteer in de beheerportal uw uitgever in de vervolgkeuzelijst boven aan de pagina.
Selecteer De nieuwe extensie>Azure DevOps.
Sleep uw bestand hierheen of selecteer het om uw VSIX-bestand te vinden, dat u in de vorige verpakkingsstap hebt gemaakt, en klik vervolgens op Uploaden.
Na snelle validatie wordt uw extensie weergegeven in de lijst met gepubliceerde extensies. Maak u geen zorgen, de extensie is alleen zichtbaar voor u.
Op dit moment is uw extensie niet zichtbaar voor accounts. Als u het zichtbaar wilt maken voor anderen, moet u de extensie delen.
Notitie
Microsoft voert een virusscan uit op elk nieuw en bijgewerkt extensiepakket dat is gepubliceerd. Totdat de scan is voltooid, publiceren we de extensie niet in Marketplace voor openbaar gebruik. Op deze manier vermijden we ook ongepaste of aanstootgevende inhoud op de Marketplace-pagina's.
Uw extensie delen
Deel uw extensie met een organisatie voordat u deze kunt installeren in Azure DevOps. Als u een extensie wilt delen, voert u de volgende taken uit:
Selecteer uw extensie in de lijst van de marketplace-beheerportal, klik met de rechtermuisknop en kies Delen/Afschermen of Publiceren/Intrekken, afhankelijk van de extensie.
Selecteer Organisatie en voer de naam van uw organisatie in. Selecteer Enter.
Sluit het paneel.
Uw extensie kan nu in deze organisatie worden geïnstalleerd.
Uw extensie installeren
Voer de volgende stappen uit om uw gedeelde extensie te installeren.
Selecteer uw extensie in Marketplace om de overzichtspagina te openen.
Notitie
Omdat uw extensie privé is, kunnen alleen u en leden van de organisatie waarmee het is gedeeld deze pagina zien.
Selecteer Gratis downloaden om het installatieproces te starten. Selecteer de organisatie waarmee u de extensie hebt gedeeld in de vervolgkeuzelijst.
Selecteer Installeren.
Gefeliciteerd U hebt uw extensie geïnstalleerd in een organisatie en u kunt deze proberen.
Probeer uw extensie
Selecteer Doorgaan naar organisatie aan het einde van de installatiewizard om naar de startpagina van de organisatie te gaan waarop de extensie is geïnstalleerd .
https://dev.azure.com/{organization}
Vernieuw de browser.
Open Organisatie-instellingen en selecteer Vervolgens Extensies.
U ziet nu de nieuwe extensie op het tabblad Geïnstalleerd .
Fouten opsporen in uw extensie
Als u fouten wilt opsporen in de extensie met Visual Studio of Browser Developer Tools, wijzigt u het manifest door de baseUri
eigenschap toe te voegen. Deze actie versnelt de ontwikkeling zonder dat u de extensie telkens opnieuw hoeft te implementeren wanneer u de broncode wijzigt.
{
...
"baseUri": "https://localhost:44300",
...
}
Wanneer u het manifest wijzigt, wordt de extensie vanuit uw lokale webserverexemplaar geladen. Bijvoorbeeld IISExpress in Visual Studio. Nadat u het manifest hebt gewijzigd, implementeert en installeert u deze extensie voor foutopsporing slechts één keer.
Notitie
Voer uw lokale webserver uit in de SSL-modus omdat Azure DevOps vereist dat de webpagina wordt geleverd vanuit een beveiligde bron. Anders krijgt u een foutmelding in de browserconsole tijdens het laden van de extensie-IFRAME.
Uw extensie bijwerken
Ga als volgt te werk om een extensie bij te werken die u al hebt gepubliceerd:
Aanbeveling
Werk uw extensie bij in plaats van deze te verwijderen en opnieuw te uploaden. We raden u aan om twee extensies te onderhouden: publisher.extension
openbaar in marketplace voor klanten en publisher.extension-dev
privé, alleen gedeeld met uw organisatie voor ontwikkeling en testen.
U hebt geen twee kopieën van uw broncode nodig. U hoeft alleen afzonderlijke manifestbestanden voor elke extensie te onderhouden. Geef bij het verpakken het juiste manifestbestand op voor het hulpprogramma tfx-cli. Zie TFX-extensieopdrachten voor meer informatie.
- Selecteer uw extensie in de lijst met weergegeven items.
- Klik met de rechtermuisknop en selecteer Update voor de ontwikkelingsversie, zoals
publisher.extension-dev
. - Valideer uw extensie.
- Pas dezelfde updates toe op de productieversie, zoals
publisher.extension
. - Blader naar het VSIX-bestand voor uw extensie en upload het.
Azure DevOps installeert automatisch de bijgewerkte versie voor alle accounts die al de extensie hebben. Nieuwe installaties ontvangen ook de nieuwste versie.
Uw extensie openbaar maken
Houd deze privé terwijl u uw extensie of integratie voor marketplace ontwikkelt. Hierdoor wordt de zichtbaarheid van de extensie beperkt tot specifieke accounts waarmee u de extensie hebt gedeeld.
Als u uw extensie openbaar beschikbaar wilt maken, stelt u de openbare vlagtrue
in op uw manifest.
Kwalificaties
Als u een openbare vermelding op Marketplace wilt hebben, moet uw integratie of extensie voldoen aan de volgende kwalificaties:
- Werkt met of breidt Azure DevOps uit.
- U, of uw bedrijf, bezit, ontwikkelt en heeft een licentie om de integratie of extensie te distribueren en te adverteren.
- De extensie of integratie wordt actief onderhouden.
Microsoft kan ook een demo aanvragen en de inhoud bekijken die is gepland voor uw Marketplace-vermelding.
Topuitgever
Het Top Publisher-programma is alleen beschikbaar voor uitgevers met Azure DevOps-extensies of -integraties. Dit is niet van toepassing op Uitgevers van Visual Studio IDE- en Visual Studio Code-extensies.
Het Top Publisher-programma herkent uitgevers met toewijding aan hun klanten en de Marketplace via voorbeeldbeleid, kwaliteit, betrouwbaarheid en ondersteuning. Zodra u topuitgever bent geworden, worden in al uw openbare aanbiedingen de badge Top Publisher weergegeven.
Belangrijkste vereisten voor Publisher
Het Top Publisher-programma in Marketplace is ontworpen om u te helpen azure DevOps-extensies en -integraties met vertrouwen te evalueren of te verkrijgen. De badge Top Publisher impliceert dat de uitgever zich verplicht stelt aan hun klanten en de Marketplace via voorbeeldbeleid, kwaliteit, betrouwbaarheid en ondersteuning. Dit is bedoeld voor uitgevers met een of meer globale Azure DevOps-extensies of -integraties en is niet van toepassing op Uitgevers van Visual Studio IDE- en Visual Studio Code-extensies.
Marketplace wijst de badge toe aan een uitgever nadat de uitgever zorgvuldig is beoordeeld op de volgende parameters:
- Privacybeleid
- Licentiebeleid
- Ondersteuningsbeleid
- Documentatie
- Q & A-reactiesnelheid
- Beoordelingen en recensies voor hun aanbiedingen
- Aantal actieve acceptatie en installaties voor hun diensten
- Beheer van ten minste één openbare extensie voor Azure DevOps
- Openbare uitbreiding met meer dan 5.000 installaties en een actief aantal installaties dat groter is dan 1000
U kunt tijdige ondersteuning en een goede algehele ervaring verwachten wanneer u een extensie krijgt van een Top Publisher. Bekijk de aanbiedingen van de topuitgevers.
Zie het uitbreidingsmanifest voor meer informatie over het toevoegen van beleidsregels aan uw aanbieding.
Werk uw uitgeversprofiel bij.
Via het uitgeversprofiel kunt u al uw aanbiedingen op één plek presenteren, samen met belangrijke informatie over uitgevers. Voer de volgende stappen uit om de informatie op te geven die in het profiel wordt weergegeven:
een. Meld u aan bij https://marketplace.visualstudio.com/manage/publishers het account waarmee u uw aanbiedingen publiceert en beheert in Visual Studio Marketplace.
b. Selecteer de uitgever en voltooi de sectie Over u op het tabblad Details .
c. Sla uw wijzigingen op en selecteer Profiel weergeven om te zien hoe het voor consumenten wordt weergegeven. U kunt deze profielpagina gebruiken om uw aanbiedingen te evangeliseren.
Notitie
Dit programma certificeert de uitgever, niet de software of beveiliging van hun extensies en integraties. We raden u aan de veiligheidsinformatie te herzien bij het evalueren van aanbiedingen van een uitgeverij. Als u een extensie van een topuitgever hebt en niet tevreden bent met uw ervaring, kunt u eerst contact opnemen met de uitgever.
Aanmelden als een topuitgever
- Meld u aan bij Marketplace-beheerportal met het account waarmee u uw productaanbod publiceert en beheert in Marketplace.
- Selecteer de uitgever en ga naar het tabblad Top Publisher. Er moeten een of meerdere globale Azure DevOps (Server/Service) extensies of integraties aanwezig zijn om het tabblad weer te geven.
- Als u voldoet aan de eerder vermelde vereisten en de eigenaar van de uitgever bent, kunt u het programma aanvragen. Na de toepassing wordt een e-mailbericht naar het Marketplace-team verzonden om uw aanvraag te beoordelen. Ze reageren binnen 10 werkdagen met de volgende stappen, het verduidelijken van vragen of de toekenning van de badge.
Het team beschouwt waarschijnlijk andere parameters, zoals actieve interesse in uw aanbiedingen, het aantal installaties en gebruikers die aan de slag gaan, en beoordelingen en recensies voor uw aanbiedingen voordat de badge wordt verleend. Microsoft behoudt zich het recht voor de badge Top Publisher op elk gewenst moment te verlenen, af te wijzen of in te trekken.
Zodra een uitgever een Top Publisher is, moeten alle toekomstige updates en aanbiedingen voldoen aan de eerder vermelde vereisten.
Reageren op marketplace-extensiebeoordelingen
U kunt reageren op beoordelingen die klanten achterlaten voor uw extensies in de Visual Studio Marketplace. Zoek en selecteer Beantwoorden naast een beoordeling als u een van de volgende machtigingen hebt: eigenaar, maker of inzender.
U kunt slechts één antwoord achterlaten. Vermijd het gebruik van beoordelingen als ondersteuningsforum. Als u meer informatie nodig hebt, geeft u een ondersteuningsalias op waarmee de revisor contact kan opnemen. Vervolgens kunt u hun problemen extern oplossen en uw antwoord bijwerken met een oplossing.
Richtlijnen voor reacties van uitgevers
Zorg ervoor dat Visual Studio Marketplace een open, uitnodigende, respectvolle en nuttige plek is voor klanten om extensies te vinden, te proberen, te installeren en te controleren. Communicatie speelt een belangrijke rol bij het houden van een gezonde community. Hier zijn richtlijnen voor uitgevers die reageren op klantbeoordelingen om te helpen deze omgeving te creëren. Denk diep na over de interacties van uw klanten en denk na over de geest van de klantervaring die de Marketplace probeert te maken.
- Reserveer reviews voor klantopmerkingen. Gebruik Beantwoorden alleen om te reageren op een beoordeling.
- Respecteer alle klantadviezen. Behandelt opmerkingen als feedback zonder debat, kritiek of argument.
- Zorg ervoor dat uw antwoorden waarde toevoegen en relevant zijn voor de opmerkingen van uw klanten.
- Richt u op het nauwkeurig aanpakken van vragen of problemen. Als u meer informatie nodig hebt, vraagt u de klant om contact met u op te vragen via e-mail in plaats van in reviews te bespreken. Wanneer u het probleem oplost, werkt u uw antwoord bij met de oplossing. U kunt uw antwoord bewerken, zoals klanten kunnen hun beoordelingen bewerken.
- Markeer eventuele ongepaste beoordelingen, zoals spam, beledigende of aanstootgevende inhoud, voor onze beoordeling.
Aanvraag om een beoordeling te annuleren
Als uitgever kunt u een beoordeling ongeldig maken als het gemelde probleem wordt veroorzaakt door de Marketplace of het onderliggende platform. Als het probleem geldig is, kunnen Marketplace-beheerders de classificatie niet meer beoordelen. U kunt in beroep gaan vanuit de sectie Beoordelingen en Recensies op uw extensiehubpagina.
Publicatie van een extensie ongedaan maken
U kunt de publicatie van gratis extensies ongedaan maken als u ze niet meer wilt aanbieden in Marketplace.
Overweeg om uw extensie uit Marketplace te verwijderen in de volgende scenario's:
- U hebt een nieuwe extensie ontwikkeld en wilt de huidige extensie niet meer aanbieden.
- Uw extensie heeft een probleem en u wilt deze verwijderen uit Marketplace totdat u het probleem hebt opgelost.
- U hebt per ongeluk uw extensie gepubliceerd als openbaar.
Aan bepaalde criteria moet worden voldaan om een extensie niet te publiceren of te verwijderen:
Actie | Vereisten |
---|---|
Publicatie ongedaan maken | Alleen gratis extensies kunnen niet worden gepubliceerd. |
Verwijderen | Uw extensie moet nul (0) installaties hebben om te kunnen worden verwijderd. |
Belangrijk
Als u uw uitbreiding moet verwijderen vanwege juridische of beveiligingsproblemen, neemt u contact op met de klantondersteuning in de ontwikkelaarscommunity. We controleren de aanvraag en verwijderen de extensie handmatig.
Selecteer de extensie op uw uitgeverspagina en kies Publicatie ongedaan maken in het menu.
Uw extensie wordt onmiddellijk niet gepubliceerd vanuit Marketplace en nieuwe gebruikers kunnen deze niet installeren. Waarderingen en beoordelingen voor uw extensie blijven intact.
Als u uw extensie opnieuw wilt aanbieden in de Marketplace, selecteert u Publiceren in het menu.
Als uw extensie nul installaties heeft, kunt u ervoor kiezen om deze volledig uit Marketplace te verwijderen. Selecteer verwijderen in het menu. U kunt deze actie niet ongedaan maken.
Hub voor extensierapportage
Zodra uw extensie beschikbaar is in Visual Studio Marketplace, kunt u de functie Rapporten gebruiken. Met deze functie kunt u bijhouden en analyseren hoe de extensie presteert en de vereiste acties uitvoert. Als u naar de extensiehub wilt gaan, bladert u naar de uitgeverspagina en selecteert u de extensie of selecteert u de koppeling Rapporten op de pagina met extensiedetails.
Verwerving
U kunt overnamegerelateerde gegevens weergeven op dit tabblad voor de geselecteerde periode.
- Geaggregeerde verwerving in de geselecteerde periode voor totale overname
- Geaggregeerde overname gesplitst door extensie downloadt de met Azure DevOps verbonden installatie voor een gratis extensie
- Geaggregeerde overname gesplitst door proefversies van azure DevOps connected buy voor betaalde uitbreiding
- Dagelijkse trend van weergaven van extensiepagina's met acquisitie voor Azure DevOps en verbonden server
- Conversiepercentage van paginaweergaven naar acquisitie
Voor betaalde extensies zijn alle transactionele gegevens voor aankopen en proefversies beschikbaar met datum, organisatienaam, einddatum van proefabonnement en hoeveelheid. U kunt de actie Contact gebruiken om met uw gebruikers te communiceren. Zie de sectie Contactpersonen verderop in dit artikel voor meer informatie.
Deïnstalleren
U kunt de volgende statistieken bekijken:
- Hoeveel organisaties uw extensie hebben verwijderd
- Dagelijkse trend van verwijdering van extensies
- Gedetailleerde feedback gedeeld tijdens verwijderingen
- Belangrijkste redenen voor verwijderen
U kunt zoeken naar tekst en datums om meer inzichten te verkrijgen en te analyseren op basis van de gedetailleerde feedback.
Voor betaalde extensies kunt u de actie Contact gebruiken om met uw gebruikers te communiceren. Contactsectie verderop in dit artikel voor meer details.
Beoordelingen en recensie
Op dit tabblad vindt u de volgende informatie:
- Gemiddelde waardering voor de geselecteerde periode versus algehele waardering
- Gemiddelde beoordeling per aantal revisoren
- Dagelijkse trend van gemiddelde waardering
De sectie Details bevat alle beoordelingen en uw antwoorden in de transactionele weergave.
U kunt een beoordeling beantwoorden of een eerder antwoord bewerken en de betrokkenheid met uw extensiegebruikers beter beheren. U kunt ook een classificatie ongeldig maken als het gemelde probleem wordt veroorzaakt door de Marketplace of het onderliggende platform. Als het probleem geldig is, wordt de beoordeling ongeldig.
Betrokkenheid beheren
Het Q & A-tabblad biedt een momentopname van alle vragen van uw extensiegebruikers, met niet-reagerende query's bovenaan. U kunt eerdere antwoorden beantwoorden of bewerken om de betrokkenheid met uw extensiegebruikers beter te beheren.
Exporteren naar Excel
Alle gegevenselementen die beschikbaar zijn op de rapportpagina, kunnen ook worden gedownload in XLS-indeling om uw eigen aangepaste rapporten te maken.
Contactpersoon
Voor betaalde extensies kunt u de actie Contact gebruiken om met uw gebruikers te communiceren. Deze functie is alleen beschikbaar voor uitgevers met inzender+ toegang voor de extensie.
Marketplace brokers de eerste communicatie met de gebruiker omdat ons privacybeleid het direct delen van e-mailadressen van klanten niet toestaat. Alleen gebruikers die zich hebben aangemeld voor communicatie, ontvangen de e-mail. De laatste contactdatum voor een organisatie wordt bijgewerkt nadat een communicatie is verzonden.
Belangrijk
Volg de richtlijnen voor transactionele en promotiecommunicatie. Uitgevers hebben vastgesteld dat ze promotiecommunicatie of spamberichten verzenden, worden toegevoegd aan een blokkeringslijst en hebben geen toegang meer tot de functie Contact voor al hun extensies.
Transactionele communicatie: e-mailberichten die essentiële informatie overbrengen die nodig is voor het voortgezet gebruik van de extensie of service, zoals:
- Kritieke beveiligingswaarschuwingen
- Transactiebevestigingen
- Kennisgevingen over productherroepen
- Specifieke feedbackaanvragen
- Kennisgevingen over stopzetting van de service
Promotionele e-mailberichten: e-mails die worden gebruikt om uw extensie, product, service, website of gebeurtenis op de markt te plaatsen, zoals:
- Uitnodigingen voor gebeurtenissen of webcasts
- Informatie over nieuwe marketing- of partnerprogramma's
- Aanbiedingen voor het verkrijgen van inhoud met toegevoegde waarde
- Nieuwsbrieven met promotie-inhoud
Zie de Marketplace Publisher-overeenkomst voor meer informatie.
Terminologie | Beschrijving |
---|---|
Paginaweergaven | Totaal aantal detailpaginaweergaven van extensies. Herhaalde weergaven worden geteld. |
Azure DevOps Services-installaties | Het totale aantal organisaties waarin de extensie is geïnstalleerd. Herhaalde installaties op dezelfde organisatie worden geteld. |
Azure DevOps Server-installaties | Het totale aantal verzamelingen waarin de extensie is geïnstalleerd. Herhaalde installaties op dezelfde verzameling worden geteld. Gegevens van een niet-verbonden server zijn niet beschikbaar. |