Microsoft MVP성태의 닷넷 이야기
글쓴 사람
정성태 (techsharer at outlook.com)
홈페이지
첨부 파일
 

VsixPublisher를 이용한 등록 시 다양한 오류 유형 해결책

"VsixPublisher Github Action" 도움말에서 "publishManifest.json" 파일 예제를 보면,

{
    "$schema": "http://json.schemastore.org/vsix-publish",
    "categories": [
        "coding",
        "scaffolding"
    ],
    "identity": {
        "internalName": "mappinggenerator"
    },
    "overview": "overview.md",
    "priceCategory": "free",
    "publisher": "54748ff9-45fc-43c2-8ec5-cf7912bc3b84",
    "private": false,
    "qna": true,
    "repo": "https://github.com/cezarypiatek/MappingGenerator"
}

publisher의 값이 GUID로 나오는데요, 왜 이런 예제를 구성했는지 잘 이해가 안 됩니다. 사실 marketplace.visualstudio.com 웹 사이트의 vsix 등록 페이지를 이용해 수작업으로 등록하는 경우에도 publisher에 대한 GUID 값은 존재하지 않습니다. 대신 source.extension.vsixmanifest에 보면 "Product ID"가 존재하는데 나중에 vsix를 등록할 때 이것은 "VSIX ID"로 참조가 됩니다.

혹시나 해서 publisher의 값을 그 "VSIX ID"로 설정한 경우 다음과 같은 식의 오류가 발생하게 됩니다.

Run cezarypiatek/VsixPublisherAction@0.2
C:\ProgramData\Chocolatey\bin\vswhere.exe -products * -requires Microsoft.Component.MSBuild -property installationPath -latest
C:\Program Files (x86)\Microsoft Visual Studio\2019\Enterprise
"C:\Program Files (x86)\Microsoft Visual Studio\2019\Enterprise\VSSDK\VisualStudioIntegration\Tools\Bin\VsixPublisher.exe" publish -personalAccessToken *** -payload ./XmlCodeGenerator/bin/Release/XmlCodeGenerator.vsix -publishManifest ./XmlCodeGenerator/publishManifest.json
VSSDK: error VsixPub0029 : An error occurred while communicating with the marketplace: The requested publisher doesn't exist.
Error: The process 'C:\Program Files (x86)\Microsoft Visual Studio\2019\Enterprise\VSSDK\VisualStudioIntegration\Tools\Bin\VsixPublisher.exe' failed with exit code 29

VsixPublisher가 원하는 publisher 값을 찾는 방법은 다음의 사이트에 방문해,

Manage Publishers & Extensions
; https://marketplace.visualstudio.com/manage/

보이는 다음의 텍스트로 알 수 있습니다.

vsgallery_pub_id_1.png

SeongTae Jeong (SeongTaeJeong)

저기서, "SeongTae Jeong"은 display name이고, 괄호 안에 있는 "SeongTaeJeong"이 publisher입니다. 만약 이걸 혼동해서 공백 문자가 포함된 "SeongTae Jeong"을 publisher로 넣고 VsixPublisher를 실행하면 이런 오류가 발생하게 됩니다.

Run cezarypiatek/VsixPublisherAction@0.2
C:\ProgramData\Chocolatey\bin\vswhere.exe -products * -requires Microsoft.Component.MSBuild -property installationPath -latest
C:\Program Files (x86)\Microsoft Visual Studio\2019\Enterprise
"C:\Program Files (x86)\Microsoft Visual Studio\2019\Enterprise\VSSDK\VisualStudioIntegration\Tools\Bin\VsixPublisher.exe" publish -personalAccessToken *** -payload ./XmlCodeGenerator/bin/Release/XmlCodeGenerator.vsix -publishManifest ./XmlCodeGenerator/publishManifest.json
VSSDK: error VsixPub0029 : An error occurred while communicating with the marketplace: The publisher name 'SeongTae Jeong' is invalid. Publisher names may only contain 'A' through 'Z', 'a' through 'z', '0' through '9' and '-'. The publisher name must start with an alphabetic or numeric character.
Error: The process 'C:\Program Files (x86)\Microsoft Visual Studio\2019\Enterprise\VSSDK\VisualStudioIntegration\Tools\Bin\VsixPublisher.exe' failed with exit code 29

만약 publisher를 등록한 적이 없다면 위의 화면에서 좌측에 있는 "+ Create publisher" 링크를 통해 새롭게 추가할 수 있습니다. 관련해서는 다음의 자료를 참고하시고.

Package, publish, unpublish, and install extensions - Create a publisher
; https://docs.microsoft.com/en-us/azure/devops/extend/publish/overview?view=azure-devops#create-a-publisher




publishManifest.json 파일에, 좀 더 많은 정보를 넣고 싶어 다음과 같은 식으로 "identity"에 vsixmanifest 패키지 파일에 이미 반영된 정보를 추가로 넣는 경우,

{
    "$schema": "http://json.schemastore.org/vsix-publish",
    "categories": [
        "coding"
    ],
    "identity": {
        "internalName": "XmlCodeGenerator",
        "displayName": "XmlCodeGenerator",
        "description": "Auto-generates source code with XML + XSLT",
        "tags": [ "Code Generator" ],
        "vsixId": "b9a2f630-ec32-49a5-96a9-612bcb1d25e4"
    },
    "overview": "overview.md",
    "priceCategory": "free",
    "publisher": "SeongTae Jeong",
    "private": false,
    "qna": true,
    "repo": "https://github.com/stjeong/XmlCodeGenerator"
}

이런 오류가 발생합니다.

Run cezarypiatek/VsixPublisherAction@0.2
C:\ProgramData\Chocolatey\bin\vswhere.exe -products * -requires Microsoft.Component.MSBuild -property installationPath -latest
C:\Program Files (x86)\Microsoft Visual Studio\2019\Enterprise
"C:\Program Files (x86)\Microsoft Visual Studio\2019\Enterprise\VSSDK\VisualStudioIntegration\Tools\Bin\VsixPublisher.exe" publish -personalAccessToken *** -payload ./XmlCodeGenerator/bin/Release/XmlCodeGenerator.vsix -publishManifest ./XmlCodeGenerator/publishManifest.json
VSSDK: error VsixPub0017 : The publish manifest from 'D:\a\XmlCodeGenerator\XmlCodeGenerator\./XmlCodeGenerator/bin/Release/XmlCodeGenerator.vsix' cannot contain any identity information other than "InternalName" because the payload is a 'vsix' file.
Error: The process 'C:\Program Files (x86)\Microsoft Visual Studio\2019\Enterprise\VSSDK\VisualStudioIntegration\Tools\Bin\VsixPublisher.exe' failed with exit code 17

identity 정보에 internalName만 허용된다는 것은 다음의 문서에도 잘 설명하고 있는데,

publishManifest file
; https://docs.microsoft.com/en-us/visualstudio/extensibility/walkthrough-publishing-a-visual-studio-extension-via-command-line?view=vs-2019#publishmanifest-file

따라서 이외의 정보는 모두 삭제하시면 됩니다.

"identity": {
    "internalName": "XmlCodeGenerator",
},




다음과 같은 오류가 발생한다면?

Run cezarypiatek/VsixPublisherAction@0.2
C:\ProgramData\Chocolatey\bin\vswhere.exe -products * -requires Microsoft.Component.MSBuild -property installationPath -latest
C:\Program Files (x86)\Microsoft Visual Studio\2019\Enterprise
"C:\Program Files (x86)\Microsoft Visual Studio\2019\Enterprise\VSSDK\VisualStudioIntegration\Tools\Bin\VsixPublisher.exe" publish -personalAccessToken *** -payload ./XmlCodeGenerator/bin/Release/XmlCodeGenerator.vsix -publishManifest ./XmlCodeGenerator/publishManifest.json
VSSDK: error VsixPub0029 : An error occurred while communicating with the marketplace: VSIXValidatorWarning08 - (XmlCodeGenerator) An open ended version range was detected in an InstallationTarget element in the .vsixmanifest file. 

해당 확장의 프로젝트에 포함된 vsixmanifest 파일의 "Install Targets" 값으로 다음과 같이 끝 버전을 지정하지 않은 상태일 것입니다.

vsixmanifest_install_targets_1.png

Microsoft.VisualStudio.Pro  [11.0,]

따라서 이 값에 끝 버전을 지정하면 됩니다.

Microsoft.VisualStudio.Pro  [11.0, 17.0)




분명히 marketplace.visualstudio.com에 대한 PAT(Personal Access Tokens)를 입력했는데도 불구하고 다음과 같이 not authorized가 발생한다면?

Run cezarypiatek/VsixPublisherAction@0.2
C:\ProgramData\Chocolatey\bin\vswhere.exe -products * -requires Microsoft.Component.MSBuild -property installationPath -latest
C:\Program Files (x86)\Microsoft Visual Studio\2019\Enterprise
"C:\Program Files (x86)\Microsoft Visual Studio\2019\Enterprise\VSSDK\VisualStudioIntegration\Tools\Bin\VsixPublisher.exe" publish -personalAccessToken *** -payload ./XmlCodeGenerator/bin/Release/XmlCodeGenerator.vsix -publishManifest ./XmlCodeGenerator/publishManifest.json
VSSDK: error VsixPub0031 : An error occurred while attempting to authenticate: VS30063: You are not authorized to access https://marketplace.visualstudio.com.
Error: The process 'C:\Program Files (x86)\Microsoft Visual Studio\2019\Enterprise\VSSDK\VisualStudioIntegration\Tools\Bin\VsixPublisher.exe' failed with exit code 31

Personal Access Tokens를 생성할 때 자세히 보면 "Organization"이 잘못 지정된 경우일 수 있습니다. 예를 들어 저같은 경우에는 다음과 같이 2개의 Marketplace (Manage) 권한을 갖는 토큰을 생성했는데,

vs_pat_token_3.png

상단의 항목은 "All accessible organization"으로 지정한 반면 하단은 다른 값을 갖고 있습니다. not authorized가 발생하지 않으려면 "All accessible organization" 값으로 지정해야 하는데 사실 기본적으로 New Token으로 제공하는 화면에서 기본 값이 "All accessible organization"으로 되어 있지 않아,

vs_pat_token_4.png

주의가 필요합니다.




[이 글에 대해서 여러분들과 의견을 공유하고 싶습니다. 틀리거나 미흡한 부분 또는 의문 사항이 있으시면 언제든 댓글 남겨주십시오.]

[연관 글]


donaricano-btn



[최초 등록일: ]
[최종 수정일: 6/18/2021

Creative Commons License
이 저작물은 크리에이티브 커먼즈 코리아 저작자표시-비영리-변경금지 2.0 대한민국 라이센스에 따라 이용하실 수 있습니다.
by SeongTae Jeong, mailto:techsharer at outlook.com

비밀번호

댓글 쓴 사람
 




[1]  2  3  4  5  6  7  8  9  10  11  12  13  14  15  ...
NoWriterDateCnt.TitleFile(s)
12733정성태7/23/202144.NET Framework: 1081. Self-Contained/SingleFile 유형의 .NET Core/5+ 실행 파일을 임베딩한다면?파일 다운로드2
12732정성태7/23/202116오류 유형: 742. SharePoint - The super user account utilized by the cache is not configured.
12731정성태7/23/202122개발 환경 구성: 584. Add Internal URLs 화면에서 "Save" 버튼이 비활성화 된 경우
12730정성태7/23/202116개발 환경 구성: 583. Visual Studio Code - Go 코드에서 입력을 받는 경우
12729정성태7/22/202145.NET Framework: 1080. xUnit 단위 테스트에 메서드/클래스 수준의 문맥 제공 - Fixture
12728정성태7/22/202143.NET Framework: 1079. MSTestv2 단위 테스트에 메서드/클래스/어셈블리 수준의 문맥 제공
12727정성태7/21/202166.NET Framework: 1078. C# 단위 테스트 - MSTestv2/NUnit의 Assert.Inconclusive 사용법(?)
12726정성태7/21/202172VS.NET IDE: 169. 비주얼 스튜디오 - 단위 테스트 선택 시 MSTestv2 외의 xUnit, NUnit 사용법
12725정성태7/21/202130오류 유형: 741. Failed to find the "go" binary in either GOROOT() or PATH
12724정성태7/21/202173개발 환경 구성: 582. 윈도우 환경에서 Visual Studio Code + Go (Zip) 개발 환경
12723정성태7/21/202125오류 유형: 740. SharePoint - Alternate access mappings have not been configured 경고
12722정성태7/20/202159오류 유형: 739. MSVCR110.dll이 없어 exe 실행이 안 되는 경우
12721정성태7/20/202132오류 유형: 738. The trust relationship between this workstation and the primary domain failed. - 세 번째 이야기
12720정성태7/19/202178Linux: 43. .NET Core/5+ 응용 프로그램의 Ubuntu (Debian) 패키지 준비
12719정성태7/19/202149오류 유형: 737. SharePoint 설치 시 "0x800710D8 The object identifier does not represent a valid object." 오류 발생
12718정성태7/19/202183개발 환경 구성: 581. Windows에서 WSL로 파일 복사 시 root 소유권으로 적용되는 문제파일 다운로드1
12717정성태7/18/202187Windows: 195. robocopy에서 파일의 ADS(Alternate Data Stream) 정보 복사를 제외하는 방법
12716정성태7/17/202183개발 환경 구성: 580. msbuild의 Exec Task에 robocopy를 사용하는 방법파일 다운로드1
12715정성태7/17/202177오류 유형: 736. Windows - MySQL zip 파일 버전의 "mysqld --skip-grant-tables" 실행 시 비정상 종료
12714정성태7/16/202156오류 유형: 735. VCRUNTIME140.dll, MSVCP140.dll, VCRUNTIME140.dll, VCRUNTIME140_1.dll이 없어 exe 실행이 안 되는 경우
12713정성태7/16/2021112.NET Framework: 1077. C# - 동기 방식이면서 비동기 규약을 따르게 만드는 Task.FromResult파일 다운로드1
12712정성태7/15/202180개발 환경 구성: 579. Azure - 리눅스 호스팅의 Site Extension 제작 방법
12711정성태7/15/202164개발 환경 구성: 578. Azure - Java Web App Service를 위한 Site Extension 제작 방법
12710정성태7/15/2021108개발 환경 구성: 577. MQTT - emqx.io 서비스 소개
12709정성태7/14/202150Linux: 42. 실행 중인 docker 컨테이너에 대한 구동 시점의 docker run 명령어를 확인하는 방법
[1]  2  3  4  5  6  7  8  9  10  11  12  13  14  15  ...