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

Visual Studio 2019 - This extension uses deprecated APIs and is at risk of not functioning in a future VS update.

블로그를 위해 정의해 둔 비주얼 스튜디오 확장 도구가,

Visual Studio 확장(VSIX)을 이용해 사용자 매크로를 추가하는 방법
; https://www.sysnet.pe.kr/2/0/11186

2019 Preview 버전에 설치하니 다음과 같은 경고가 뜹니다.

This extension uses deprecated APIs and is at risk of not functioning in a future VS update.

문제는, "deprecated" 되었다는 API가 어떤 것인지 알려주지 않는다는 점입니다. ^^; 그래서 비교를 위해 새롭게 Visual Studio 2019에서 "Custom Command" 확장을 생성했더니, 결정적인 차이점으로 Package 객체가 AsyncPackage로 바뀌어 전체적인 동작이 비동기로 변경된 것입니다.

그래서 제 코드도 AsyncPackage를 사용하도록 변경했고 이후 설치를 하니 "deprecaged" 경고가 없어졌습니다.




아울러 AsyncPackage 적용을 위해 몇 가지 부가 작업이 함께 따르게 됩니다. 우선, csproj의 패키지 참조가 다음과 같이 바뀌고,

<ItemGroup>
	<PackageReference Include="Microsoft.VisualStudio.SDK" Version="15.9.3" ExcludeAssets="runtime" />
	<PackageReference Include="Microsoft.VSSDK.BuildTools" Version="16.0.298" />
</ItemGroup>

ProvideAutoLoad를 사용한 경우 PackageAutoLoadFlags도 함께 적용해야 합니다.

[ProvideAutoLoad(UIContextGuids80.EmptySolution, PackageAutoLoadFlags.BackgroundLoad)]

마지막으로 기존에 작성되었던 동기 호출 방식의 코드를 모두 비동기로 만들어야 하는데 이때 Visual Studio DOM을 호출하는 코드는 동기식으로 작성해야 하므로 다음과 같이 SwitchToMainThreadAsync 호출을 사전에 꼭 호출하는 코드를 넣어야 합니다.

private async Task DoSomeActionAsync(DTE2 dte, AsyncPackage package)
{
    await ThreadHelper.JoinableTaskFactory.SwitchToMainThreadAsync(package.DisposalToken);

    dte.ActiveDocument.Save(""); // Visual Studio UI Thread에서 이 코드가 실행되어야 하므로.

	...[생략]...
}

이 정도의 변경을 거치고 나면 2019 Preview 버전에서도 잘 동작하게 됩니다.




참고로, AsyncPackage로 변경했는데 Visual Studio에서 로딩 시 다음과 같은 오류가 발생할 수 있습니다.

The 'MacroCommandPackage' package did not load correctly.

The problem may have been caused by a configuration change or by the installation of another extension. You can get more information by examining the file '%USERPROFILE%\AppData\Roaming\Microsoft\VisualStudio\16.0_d362fc82\ActivityLog.xml'.

Restarting Visual Studio could help resolve this issue.

로딩 시 실행되는 코드 중에 ThreadHelper.JoinableTaskFactory.SwitchToMainThreadAsync 코드를 적절한 위치에 넣어주지 않은 경우 예외가 발생한 문제였습니다. 코드를 꼼꼼히 확인해 주셔야 합니다. ^^




본문과는 상관없지만, 제가 가지고 있는 또 다른 VSIX 패키지를 마이그레이션 중에 "Microsoft.VisualStudio.TextTemplating.VSHost.11.0.dll"이 없어서 빌드를 못하는 문제가 있었습니다. 관련 버전을 담은 Visual Studio SDK를 삭제했던 것 같은데요. 검색해 보면, Visual Studio 2015 설치 파일에서 구할 수 있다고 하며 다음과 같이 명령행에서 실행하면 된다는 글이 있습니다.

vs_enterprise.exe /s /installSelectableItems VS_SDK_GROUPV1  

음... 그런데 실제로 해보니 ^^; Visual Studio 2015를 설치만 하고 SDK는 설치하지 않았습니다. 그래서 다시 vs_enterprise.exe를 실행해 "Visual Studio Extensibility Tools Update 3" 항목을 직접 선택하여 설치할 수 있었습니다.




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



donaricano-btn



[최초 등록일: ]
[최종 수정일: 2/20/2019 ]

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

비밀번호

댓글 쓴 사람
 



2019-02-25 09시01분
정성태

1  2  3  4  5  [6]  7  8  9  10  11  12  13  14  15  ...
NoWriterDateCnt.TitleFile(s)
12564정성태3/16/2021217VS.NET IDE: 160. 새 프로젝트 창에 C++/CLI 프로젝트 템플릿이 없는 경우
12563정성태3/16/2021234개발 환경 구성: 551. C# - JIRA REST API 사용 정리 (3) jira-oauth-cli 도구를 이용한 키 관리
12562정성태3/15/2021376개발 환경 구성: 550. C# - JIRA REST API 사용 정리 (2) JIRA OAuth 토큰으로 API 사용하는 방법파일 다운로드1
12561정성태3/12/2021285VS.NET IDE: 159. Visual Studio에서 개행(\n, \r) 등의 제어 문자를 치환하는 방법 - 정규 표현식 사용
12560정성태3/11/2021351개발 환경 구성: 549. ssh-keygen으로 생성한 개인키/공개키 파일을 각각 PKCS8/PEM 형식으로 변환하는 방법
12559정성태3/11/2021266.NET Framework: 1028. 닷넷 5 환경의 Web API에 OpenAPI 적용을 위한 NSwag 또는 Swashbuckle 패키지 사용파일 다운로드1
12558정성태3/10/2021461Windows: 192. Power Automate Desktop (Preview) 소개 - Bitvise SSH Client 제어 [1]
12557정성태3/10/2021163Windows: 191. 탐색기의 보안 탭에 있는 "Object name" 경로에 LEFT-TO-RIGHT EMBEDDING 제어 문자가 포함되는 문제
12556정성태3/9/2021173오류 유형: 703. PowerShell ISE의 Debug / Toggle Breakpoint 메뉴가 비활성 상태인 경우
12555정성태3/8/2021309Windows: 190. C# - 레지스트리에 등록된 DigitalProductId로부터 라이선스 키(Product Key)를 알아내는 방법파일 다운로드2
12554정성태3/8/2021394.NET Framework: 1027. 닷넷 응용 프로그램을 위한 PDB 옵션 - full, pdbonly, portable, embedded
12553정성태3/5/2021395개발 환경 구성: 548. 기존 .NET Framework 프로젝트를 .NET Core 용으로 변환해 주는 upgrade-assistant, try-convert 도구 소개
12552정성태3/5/2021260개발 환경 구성: 547. github workflow/actions에서 Visual Studio Marketplace 패키지 등록하는 방법
12551정성태3/5/2021266오류 유형: 702. 비주얼 스튜디오 - The 'CascadePackage' package did not load correctly. (2)
12550정성태3/5/2021250오류 유형: 701. Live Share 1.0.3713.0 버전을 1.0.3884.0으로 업데이트 이후 ContactServiceModelPackage 오류 발생하는 문제
12549정성태3/4/2021271오류 유형: 700. VsixPublisher를 이용한 등록 시 다양한 오류 유형 해결책
12548정성태3/4/2021297개발 환경 구성: 546. github workflow/actions에서 nuget 패키지 등록하는 방법
12547정성태3/3/2021386오류 유형: 699. 비주얼 스튜디오 - The 'CascadePackage' package did not load correctly.
12546정성태3/3/2021340개발 환경 구성: 545. github workflow/actions에서 빌드시 snk 파일 다루는 방법 - Encrypted secrets
12545정성태3/2/2021896.NET Framework: 1026. 닷넷 5에 추가된 POH (Pinned Object Heap) [7]
12544정성태2/26/2021560.NET Framework: 1025. C# - Control의 Invalidate, Update, Refresh 차이점 [2]
12543정성태2/26/2021516VS.NET IDE: 158. C# - 디자인 타임(design-time)과 런타임(runtime)의 코드 실행 구분
12542정성태2/20/2021543개발 환경 구성: 544. github repo의 Release 활성화 및 Actions를 이용한 자동화 방법
12541정성태2/18/2021567개발 환경 구성: 543. 애저듣보잡 - Github Workflow/Actions 소개
12540정성태2/17/2021564.NET Framework: 1024. C# - Win32 API에 대한 P/Invoke를 대신하는 Microsoft.Windows.CsWin32 패키지
12539정성태2/16/2021616Windows: 189. WM_TIMER의 동작 방식 개요파일 다운로드1
1  2  3  4  5  [6]  7  8  9  10  11  12  13  14  15  ...