Skip to content

Commit 146fe47

Browse files
authored
Merge pull request #7619 from MicrosoftDocs/main637794219500178845
For protected CLA branch, push strategy should use PR and merge to target branch method to work around git push error
2 parents 650903f + 5da1f7d commit 146fe47

6 files changed

+100
-105
lines changed

docs/extensibility/walkthrough-publishing-a-visual-studio-extension-via-command-line.md

Lines changed: 9 additions & 35 deletions
Original file line numberDiff line numberDiff line change
@@ -19,7 +19,7 @@ ms.workload:
1919

2020
This walkthrough shows you how to publish a Visual Studio extension to the Visual Studio Marketplace using the command line. When you add your extension to the Marketplace, developers can use the [**Extensions and Updates**](../ide/finding-and-using-visual-studio-extensions.md) dialog to browse there for new and updated extensions.
2121

22-
VsixPublisher.exe is the command line tool for publishing Visual Studio extensions to the Marketplace. It can be accessed from ${VSInstallDir}\VSSDK\VisualStudioIntegration\Tools\Bin\VsixPublisher.exe. Commands available on this tool are: **publish**, **createPublisher**, **deletePublisher**, **deleteExtension**, **login**, **logout**.
22+
VsixPublisher.exe is the command line tool for publishing Visual Studio extensions to the Marketplace. It can be accessed from ${VSInstallDir}\VSSDK\VisualStudioIntegration\Tools\Bin\VsixPublisher.exe. Commands available on this tool are: **publish**, **deletePublisher**, **deleteExtension**, **login**, **logout**.
2323

2424
## Commands
2525

@@ -38,22 +38,6 @@ Publishes an extension to the Marketplace. The extension can be a vsix, an exe/m
3838
VsixPublisher.exe publish -payload "{path to vsix}" -publishManifest "{path to vs-publish.json}" -ignoreWarnings "VSIXValidatorWarning01,VSIXValidatorWarning02"
3939
```
4040

41-
### createPublisher
42-
43-
Creates a publisher on the Marketplace. Also logs the publisher into the machine for future actions (for example, deleting/publishing an extension).
44-
45-
|Command Options |Description |
46-
|---------|---------|
47-
|displayName (required) | Display name of the publisher. |
48-
|publisherName (required) | The name of the publisher (for example, the identifier). |
49-
|personalAccessToken (required) | Personal Access Token that is used to authenticate the publisher. |
50-
|shortDescription | A short description of the publisher (not a file). |
51-
|longDescription | A long description of the publisher (not a file). |
52-
53-
```
54-
VsixPublisher.exe createPublisher -publisherName "{Publisher Name}" -displayName "{Publisher Display Name}" -personalAccessToken "{Personal Access Token}"
55-
```
56-
5741
### deletePublisher
5842

5943
Deletes a publisher on the Marketplace.
@@ -108,6 +92,10 @@ Logs a publisher out of the machine.
10892
VsixPublisher.exe logout -publisherName "{Publisher Name}"
10993
```
11094

95+
### createPublisher
96+
> [!Caution]
97+
> This command is no longer available. You can create a new publisher by navigating to [Visual Studio Marketplace](https://marketplace.visualstudio.com/manage/publishers).
98+
11199
## publishManifest file
112100

113101
A publishManifest file is used by the **publish** command. It represents all the metadata about the extension that the Marketplace needs to know. If the extension being uploaded is from a VSIX extension, the "identity" property must only have the "internalName" set. This is because the rest of the "identity" properties can be generated from the vsixmanifest file. If the extension is a msi/exe or a link extension, the user must provide the required fields in the "identity" property. The rest of the manifest contains information specific to the Marketplace (for example, categories, whether Q&A is enabled, etc.).
@@ -227,33 +215,19 @@ In this case, we will use a default VSPackage extension, but the same steps are
227215

228216
3. Open command line and navigate to ${VSInstallDir}\VSSDK\VisualStudioIntegration\Tools\Bin\ directory.
229217

230-
4. To create a new publisher, use the following command:
231-
232-
```
233-
VsixPublisher.exe createPublisher -publisherName "TestVSIXPublisher" -displayName "Test VSIX Publisher" -personalAccessToken "{Personal Access Token that is used to authenticate the publisher. If not provided, the pat is acquired from the logged-in users.}"
234-
```
235-
236-
5. On successful creation of publisher, you will see the following command line message:
237-
238-
```
239-
Added 'Test VSIX Publisher' as a publisher on the Marketplace.
240-
```
241-
242-
6. You can verify the new publisher you created by navigating to [Visual Studio Marketplace](https://marketplace.visualstudio.com/manage/publishers)
243-
244-
7. To publish a new extension, use the following command:
218+
4. To publish a new extension, use the following command:
245219

246220
```
247-
VsixPublisher.exe publish -payload "{Path to vsix file}" -publishManifest "{path to publishManifest file}"
221+
VsixPublisher.exe publish -payload "{Path to vsix file}" -publishManifest "{path to publishManifest file}" -personalAccessToken "{Personal Access Token that is used to authenticate the publisher. If not provided, the pat is acquired from the logged-in users.}"
248222
```
249223

250-
8. On successful creation of publisher, you will see the following command line message:
224+
5. On successful publishing of extension, you will see the following command line message:
251225

252226
```
253227
Uploaded 'MyVsixExtension' to the Marketplace.
254228
```
255229

256-
9. You can verify the new extension you published by navigating to [Visual Studio Marketplace](https://marketplace.visualstudio.com/)
230+
6. You can verify the new extension you published by navigating to [Visual Studio Marketplace](https://marketplace.visualstudio.com/)
257231

258232
### Install the extension from the Visual Studio Marketplace
259233

0 commit comments

Comments
 (0)