다음을 통해 공유


연습: Visual Studio 확장 게시

이 연습에서는 Visual Studio 확장을 Visual Studio Marketplace에 게시하는 방법을 보여 줍니다. Visual Studio Marketplace에 확장을 추가하면 개발자가 확장 및 업데이트를 사용하여 신규 및 업데이트된 확장을 찾아볼 수 있습니다.

필수 조건

이 연습을 수행하려면 Visual Studio SDK를 설치해야 합니다. 자세한 내용은 Visual Studio SDK 설치를 참조하세요.

Visual Studio 확장 만들기

이 문서에서는 기본 VSPackage 확장이 사용되지만 모든 종류의 확장에 유효합니다.

확장을 패키지합니다.

  1. 제품 이름, 작성자 및 버전에 대한 올바른 정보로 확장 .vsixmanifest를 업데이트합니다.

    update extension vsixmanifest

  2. 릴리스 모드에서 확장을 빌드합니다. 이제 확장이 \bin\Release 폴더에 VSIX로 패키지됩니다.

  3. VSIX를 두 번 클릭하여 설치를 확인할 수 있습니다.

확장 테스트

확장을 배포하기 전에 빌드 및 테스트하여 Visual Studio의 실험적 인스턴스에 올바르게 설치되었는지 확인합니다.

  1. Visual Studio에서 디버깅을 시작하여 Visual Studio의 실험적 인스턴스를 엽니다.

  2. 실험적 인스턴스에서 도구 메뉴로 이동하고 확장 및 업데이트를클릭합니다. TestPublish 확장이 가운데 창에 표시되고 사용하도록 설정됩니다.

  3. 도구 메뉴에서 테스트 명령이 표시되는지 확인합니다.

Visual Studio Marketplace에 확장 게시

  1. 확장의 릴리스 버전이 빌드되었고 최신 상태인지 확인합니다.

  2. 웹 브라우저에서 Visual Studio Marketplace로 이동합니다.

  3. 오른쪽 위에서 로그인을 클릭합니다.

  4. Microsoft 계정을 사용하여 로그인합니다. Microsoft 계정이 없으면 지금 만들 수 있습니다.

  5. 확장 게시를 클릭합니다. 이 옵션을 선택하면 모든 확장에 대한 관리 페이지로 이동합니다. 게시자 계정이 없으면, 이 때 계정을 만들라는 메시지가 표시됩니다.

    Upload to Marketplace

  6. 확장을 업로드하는 데 사용하려는 게시자를 선택합니다. 왼쪽에 나열된 게시자 이름을 클릭하여 게시자를 변경할 수 있습니다. 새 확장을 클릭하고 Visual Studio를 선택합니다.

  7. 1: 확장 업로드에서 VSIX 파일을 Visual Studio Marketplace에 직접 업로드하거나 자체 웹 사이트 링크만 추가하도록 선택할 수 있습니다. 이 예제에서는 TestPublish.vsix 확장이 업로드됩니다. 확장을 끌어 놓거나 클릭 링크를 사용하여 파일을 찾아봅니다. 프로젝트의 \bin\Release 폴더에서 확장을 찾습니다. 계속을 클릭합니다.

  8. 2: 확장 세부 정보 제공에서 일부 필드는 해당 확장의 source.extension.vsixmanifest 파일에서 자동으로 채워진 상태입니다. 아래에서 각 항목에 대한 세부 정보를 찾습니다.

    • 내부 이름은 확장의 세부 정보 페이지 URL에 사용됩니다. 예를 들어 "myname"이라는 게시자 이름으로 확장을 게시하고 내부 이름을 "my extension"으로 지정하면 확장 세부 정보 페이지에 대해 결과 URL이 "marketplace.visualstudio.com/items?itemName=myname.myextension"으로 생성됩니다.

    • 확장의 표시 이름. 이 이름은 source.extension.vsixmanifest 파일에서 자동으로 채워집니다.

    • 업로드하려는 확장의 버전 번호. 이 버전은 source.extension.vsixmanifest 파일에서 자동으로 채워집니다.

    • VSIX ID는 Visual Studio에서 확장에 사용되는 고유 식별자입니다. 확장을 자동으로 업데이트하려면 이 식별자가 필요합니다. 이 식별자는 source.extension.vsixmanifest 파일에서 자동으로 채워집니다.

    • 확장에 사용되는 로고. 이 로고는 source.extension.vsixmanifest 파일(제공된 경우)에서 자동으로 채워집니다.

    • 확장이 수행하는 작업에 대한 간단한 설명. 이 설명은 source.extension.vsixmanifest 파일에서 자동으로 채워집니다.

    • 개요는 확장이 수행하는 작업에 대한 자세한 정보 및 스크린샷을 포함하기에 적합한 장소입니다.

    • 지원되는 Visual Studio 버전을 사용하면 확장이 작동할 Visual Studio 버전을 선택할 수 있습니다. 확장이 해당 버전에만 설치됩니다.

    • 지원되는 Visual Studio 에디션을 사용하면 확장이 작동할 Visual Studio 에디션을 선택할 수 있습니다. 확장이 해당 에디션에만 설치됩니다.

    • 유형. 확장의 가장 일반적인 형식은 도구입니다.

    • 범주. 확장에 가장 적합한 범주를 3개까지 선택합니다.

    • 태그는 사용자가 확장을 찾을 수 있도록 도와 주는 키워드입니다. 태그는 Visual Studio Marketplace에서 해당 확장의 검색 관련성을 높이는 데 도움이 될 수 있습니다.

    • 가격 책정 범주는 확장 비용입니다.

    • 원본 코드 리포지토리를 사용하면 원본 코드 링크를 커뮤니티에 공유할 수 있습니다.

    • 확장에 대한 QA 허용&을 사용하면 확장 항목 페이지에 사용자가 질문을 남길 수 있습니다.

  9. 저장 & 업로드를 클릭합니다. 이 옵션을 선택하면 게시자 관리 페이지로 돌아갑니다. 확장이 아직 게시되지 않았습니다.

  10. 확장을 게시하려면 확장을 마우스 오른쪽 단추로 클릭하고 공개를 선택합니다. Visual Studio Marketplace에서 확장이 어떻게 표시되는지 확인하려면 확장 보기를 선택합니다. 취득 번호를 보려면 보고서를 클릭합니다. 확장을 변경하려면 편집을 클릭합니다.

    Extension Entry Menu

  11. 공개를 클릭하면 이제 확장이 공개됩니다. Visual Studio Marketplace에서 확장을 검색합니다.

Visual Studio Marketplace에서 게시된 확장 업데이트

시작하기 전에 확장에 대한 새 릴리스 버전이 빌드되었고 최신 상태인지 확인합니다.

  1. 웹 브라우저에서 Visual Studio Marketplace로 이동합니다.

  2. 오른쪽 위 모서리에서 로그인을 클릭한 다음, Microsoft 계정으로 로그인합니다.

    Screenshot that shows selecting an uploaded extension file in File Explorer.

  3. 확장 게시를 클릭한 다음, 업데이트된 확장을 업로드하는 데 사용할 게시자를 선택합니다.

    Screenshot of Visual Studio Marketplace with the Publish extensions link highlighted.

  4. 업데이트하려는 확장 옆에서 세 개의 가로 점을 마우스를 가리킨 다음, 편집을 선택합니다.

    Screenshot that shows choosing an extension to edit.

  5. 1: 확장 업로드에서 게시된 확장을 편집하기 위해 VSIX 파일 이름 다음의 연필 아이콘을 클릭합니다.

    Screenshot that shows clicking the pencil icon to edit your extension.

  6. 업데이트된 확장 VSIX 파일로 이동합니다. 파일을 클릭한 다음, 열기를 클릭합니다.

    업데이트된 확장이 업로드됩니다.

    Screenshot of an Uploading file notification after uploading an edited extension.

  7. 2: 확장 세부 정보 제공에서 일부 세부 정보는 확장 업데이트에 대해 읽기 전용이거나 확장의 source.extension.vsixmanifest 파일에서 자동으로 채워집니다. 확장 세부 정보에 대한 자세한 내용은 다음과 같습니다.

    • 내부 이름*은 확장의 세부 정보 페이지 URL에 사용됩니다. 예를 들어 "myname"이라는 게시자 이름으로 확장을 게시하고 내부 이름을 "my extension"으로 지정하면 확장 세부 정보 페이지에 대해 결과 URL이 "marketplace.visualstudio.com/items?itemName=myname.myextension"으로 생성됩니다.

    • 확장의 표시 이름*. 이 이름은 source.extension.vsixmanifest 파일에서 자동으로 채워집니다.

    • 업로드하려는 확장의 버전* 번호. 이 버전은 source.extension.vsixmanifest 파일에서 자동으로 채워집니다.

    • VSIX ID*는 Visual Studio에서 확장에 사용되는 고유 식별자입니다. 확장을 자동으로 업데이트하려면 이 식별자가 필요합니다. 이 식별자는 source.extension.vsixmanifest 파일에서 자동으로 채워집니다.

    • 확장에 사용되는 로고*. 이 로고는 source.extension.vsixmanifest 파일(제공된 경우)에서 자동으로 채워집니다.

    • 확장이 수행하는 작업에 대한 간단한 설명*. 이 설명은 source.extension.vsixmanifest 파일에서 자동으로 채워집니다.

    • 개요는 확장이 수행하는 작업에 대한 자세한 정보 및 스크린샷을 포함하기에 적합한 장소입니다.

    • 지원되는 Visual Studio 버전*을 사용하면 확장이 작동할 Visual Studio 버전을 선택할 수 있습니다. 확장이 해당 버전에만 설치됩니다.

    • 지원되는 Visual Studio 에디션*을 사용하면 확장이 작동할 Visual Studio 에디션을 선택할 수 있습니다. 확장은 해당 에디션에만 설치됩니다.

    • 유형. 확장의 가장 일반적인 형식은 도구입니다.

    • 범주. 확장에 가장 적합한 범주를 3개까지 선택합니다.

    • 태그는 사용자가 확장을 찾을 수 있도록 도와 주는 키워드입니다. 태그는 Visual Studio Marketplace에서 해당 확장의 검색 관련성을 높이는 데 도움이 될 수 있습니다.

    • 가격 책정 범주는 확장 비용입니다.

    • 원본 코드 리포지토리를 사용하면 원본 코드 링크를 커뮤니티에 공유할 수 있습니다.

    • 확장에 대한 QA 허용&을 사용하면 확장 항목 페이지에 사용자가 질문을 남길 수 있습니다.

      * 확장 업데이트의 경우 이 세부 정보를 변경할 수 없습니다.

  8. 저장 & 업로드를 클릭합니다. 이 옵션을 선택하면 게시자 관리 페이지로 돌아갑니다. 확장이 아직 게시되지 않았습니다.

  9. 확장을 게시하려면 확장을 마우스 오른쪽 단추로 클릭하고 공개를 선택합니다. Visual Studio Marketplace에서 확장이 어떻게 표시되는지 확인하려면 확장 보기를 선택합니다. 취득 번호를 보려면 보고서를 클릭합니다. 확장을 변경하려면 편집을 클릭합니다.

게시자 계정 관리를 위해 사용자 추가

Visual Studio Marketplace는 게시자 계정에 액세스하고 관리할 수 있는 추가 사용자 권한 부여를 지원합니다.

  1. 추가하려는 구성원에게 Marketplace의 계정에 로그인하고 사용자 ID를 가져오도록 요청합니다. 다음 이미지와 같이 전자 메일을 마우스로 가리키면 사용자 ID가 표시됩니다.

    Screenshot that shows the user ID next to a user's name and email address in Marketplace.

  2. 구성원은 클립보드로 복사 단추를 클릭하여 사용자 ID를 복사한 다음 사용자와 공유할 수 있습니다.

  3. 사용자를 추가하려는 게시자 계정으로 이동합니다.

  4. 멤버를 선택하고 추가를 클릭합니다.

    Add Additional User

  5. 그런 다음 추가하려는 사용자의 사용자 ID를 지정하고 역할 선택에서 적절한 수준의 액세스 권한을 부여할 수 있습니다. 다음 옵션 중에서 선택할 수 있습니다.

    • 작성자: 사용자가 확장을 게시할 수 있지만 다른 사용자가 게시한 확장을 보거나 관리할 수는 없습니다.

    • 읽기 권한자: 사용자가 확장을 볼 수 있지만 확장을 게시하거나 관리할 수 없습니다.

    • 기여자: 사용자가 확장을 게시하고 관리할 수 있지만 게시자 설정을 편집하거나 액세스를 관리할 수는 없습니다.

    • 소유자: 사용자가 확장을 게시하고 관리하고, 게시자 설정을 편집하고, 액세스를 관리할 수 있습니다.

게시자 계정에 사용자 추가 문제 해결

이메일 주소를 사용하여 게시자 프로필에 사용자를 추가하면 TF14045: The identity could not be found 오류가 표시될 수 있습니다.

이 오류를 방지하려면 이메일 주소 대신 사용자 ID를 사용하여 게시자 계정에 사용자를 추가합니다. 사용자 ID를 찾으려면 Visual Studio Marketplace에서 창 위에 있는 사용자 이름을 마우스로 가리킵니다. 복사 아이콘을 선택하여 사용자 ID를 복사합니다.

Screenshot that shows the user ID next to a user's name and email address in Marketplace.

그런 다음, 해당 사용자 ID를 사용하여 새 사용자를 추가할 수 있습니다.

Visual Studio Marketplace에서 확장 설치

확장이 게시되었으므로 이제 확장을 Visual Studio에 설치하고 테스트합니다.

  1. Visual Studio의 도구 메뉴에서 확장 및 업데이트를 클릭합니다.

  2. 온라인을 클릭한 다음, TestPublish를 검색합니다.

  3. 다운로드를 클릭합니다. 확장 설치가 예약됩니다.

  4. 설치를 완료하려면 Visual Studio의 모든 인스턴스를 닫습니다.

확장을 제거하려면

Visual Studio Marketplace 및 컴퓨터에서 확장을 제거할 수 있습니다.

Visual Studio Marketplace에서 확장을 제거/게시 취소하려면

  1. Visual Studio Marketplace로 이동합니다.

  2. 오른쪽 위 모서리에서 확장 게시를 클릭합니다. 게시하는 데 사용한 게시자(예: TestPublish)를 선택합니다. 확장 목록이 표시됩니다.

  3. 확장 메뉴 단추를 → 제거를 클릭합니다. 확장을 제거할지 확인하는 메시지가 표시됩니다.

Screenshot that shows Remove menu item.

실수로 게시되지 않도록 하려면 경고 대화 상자에서 확장 이름을 입력하여 제거 작업을 확인해야 합니다. 제거/게시 취소 작업은 되돌릴 수 없습니다.

Screenshot that shows warning.

컴퓨터에서 확장 제거하기

  1. Visual Studio의 도구 메뉴에서 확장 및 업데이트를 클릭합니다.

  2. TestPublish를 선택한 다음, 제거를 클릭합니다. 그런 다음, 확장 제거가 예약됩니다.

  3. 제거를 완료하려면 Visual Studio의 모든 인스턴스를 닫습니다.