Microsoft MVP성태의 닷넷 이야기
.NET Framework: 127. ClickOnce로 ActiveX를 같이 배포하는 방법 [링크 복사], [링크+제목 복사]
조회: 29252
글쓴 사람
정성태 (techsharer at outlook.com)
홈페이지
첨부 파일
(연관된 글이 3개 있습니다.)
(시리즈 글이 3개 있습니다.)
.NET Framework: 127. ClickOnce로 ActiveX를 같이 배포하는 방법
; https://www.sysnet.pe.kr/2/0/692

개발 환경 구성: 133. Registry 등록 과정 없이 COM 개체 사용 - 두 번째 이야기
; https://www.sysnet.pe.kr/2/0/1167

개발 환경 구성: 469. Reg-free COM 개체 사용을 위한 manifest 파일 생성 도구 - COMRegFreeManifest
; https://www.sysnet.pe.kr/2/0/12160





ClickOnce로 ActiveX를 같이 배포하는 방법


이에 대한 주제를 파악하고 나면, 사실 제목이 잘못되었다는 것을 알게 됩니다. 즉, 이 문제는 ClickOnce로 국한되는 것이 아니고, 단지 COM 개체를 레지스트리에 등록하지 않고 사용하는 방법을 설명하는 것이기 때문인데요.

이미 지난 글에서 이에 대한 소개를 잠시 해드렸지요.

Registry 등록 없이 COM 개체 사용 
; https://www.sysnet.pe.kr/2/1/262

ClickOnce에서의 ActiveX 배포도 위의 글에서 설명한 C# 응용 프로그램 범주를 벗어나지 않습니다. 그래도 따라하기 쉽도록... 정리를 한번 해볼까요? ^^




1. WPF 응용 프로그램과 ATL 응용 프로그램을 생성.

테스트를 위해 2개의 프로젝트를 생성합니다. ATL 프로젝트에는 [그림 1]에서 보는 것처럼 "SimpleObject" COM 개체를 추가하고 예를 들기 위한 메서드 하나를 추가합니다.

[그림 1: WPF프로젝트 / ATL프로젝트]
howtodeploy_clickonce_with_com_1.png

=== SimpleObject.cpp ===

STDMETHODIMP CSimpleObject::DoMethod(void)
{
	return S_OK;
}

2. 등록 코드 삭제 / 등록 옵션 해제

UAC 때문에 빌드하면 오류나는 문제도 있고, 어차피 등록이 필요없기 때문에 아예 오류가 발생하지 않도록 등록 코드를 주석 처리하거나, 프로젝트 설정에서 등록 옵션을 해제합니다.

[그림 2: 등록 옵션 제거]
howtodeploy_clickonce_with_com_2.png

3. COM 개체를 위한 manifest 생성

C/C++에서는 해당 COM 개체를 사용하려면 #import 구문을 이용하여 직접 COM 개체의 경로를 지정해서 스마트 포인터로 COM 개체를 사용하는 것이 가능합니다. 반면, C#에서 해당 COM 개체를 사용하려면 어떻게 참조해야 할까요? COM 개체가 등록되지 않았기 때문에 "참조 추가" 대화상자의 "COM" 탭은 무용지물이지요. 대신에 COM 개체에 대한 manifest 파일을 참조하는 것으로 해결할 수 있습니다.

"Registration-Free Activation of COM Components: A Walkthrough"에서 설명하는 것처럼 manifest 파일을 아래와 같이 구성해 주면 됩니다.

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<assembly xmlns="urn:schemas-microsoft-com:asm.v1" manifestVersion="1.0">

  <assemblyIdentity version="1.0.0.1" processorArchitecture="x86" 
     name="AtlTest.dll" type="win32">
  </assemblyIdentity>
  
  <file name="AtlTest.dll">
    <comClass clsid="{1DC804F4-7587-45F2-92C8-7470FE6C091B}" threadingModel="Apartment">
    </comClass>
    <typelib tlbid="{6ECA849F-8500-4539-9287-CFB9D07208A2}" version="1.0" 
             helpdir="AtlTest 1.0 Type Library">
    </typelib>
  </file>
  <comInterfaceExternalProxyStub name="ISimpleObject" 
                                 iid="{9E4A5819-446D-4CEE-ADBB-8D1CE6F1B43A}" 
                                 proxyStubClsid32="{00020424-0000-0000-C000-000000000046}" 
                                 baseInterface="{00000000-0000-0000-C000-000000000046}" 
                                 tlbid="{6ECA849F-8500-4539-9287-CFB9D07208A2}">
  </comInterfaceExternalProxyStub>
</assembly>

위의 manifest 파일에서 사용되는 각각의 값은 .idl 파일과 .rc 파일에서 구할 수 있습니다.

import "oaidl.idl";
import "ocidl.idl";

[
	object,
	uuid(9E4A5819-446D-4CEE-ADBB-8D1CE6F1B43A),
	dual,
	nonextensible,
	helpstring("ISimpleObject Interface"),
	pointer_default(unique)
]
interface ISimpleObject : IDispatch{
	[id(1), helpstring("method DoMethod")] HRESULT DoMethod(void);
};
[
	uuid(6ECA849F-8500-4539-9287-CFB9D07208A2),
	version(1.0),
	helpstring("AtlTest 1.0 Type Library")
]
library AtlTestLib
{
	importlib("stdole2.tlb");
	[
		uuid(1DC804F4-7587-45F2-92C8-7470FE6C091B),
		helpstring("SimpleObject Class")
	]
	coclass SimpleObject
	{
		[default] interface ISimpleObject;
	};
};

[그림 3: assemblyIdentity[@version]으로 사용될 버전]
howtodeploy_clickonce_with_com_3.png

4. WPF 프로젝트에서 manifest 참조 추가


자, 이제 [그림 4]에서 보는 것처럼 "참조 추가"대화상자에서 직접 "AtlTest.dll.manifest" 파일을 지정해서 COM 개체를 참조합니다.

[그림 4: Manifest 파일 참조]
howtodeploy_clickonce_with_com_4.png

정상적으로 참조가 된 경우, [그림 5]에서 보는 것처럼 "References" 노드에 "AtlTest.dll.manifest"가 추가된 것을 볼 수 있습니다.

[그림 5: Manifest 파일 참조된 상태]
howtodeploy_clickonce_with_com_5.png

5. WPF 프로젝트에서 COM 개체 사용 코드 추가

manifest 참조와 함께 Visual Studio는 인텔리센스까지 제공해 주기 때문에 아래와 같이 쉽게 코딩할 수 있습니다.

public partial class Window1 : Window
{
... [중간 생략] ...
    private void Window_Loaded(object sender, RoutedEventArgs e)
    {
        AtlTestLib.SimpleObjectClass soc = new AtlTestLib.SimpleObjectClass();
        soc.DoMethod();
    }
}

이렇게 해서 최종 빌드하고 나면, WPF 빌드 출력 결과물은 [그림 6]과 같이 됩니다.

[그림 6: WPF 응용 프로그램 빌드 후 결과물]
howtodeploy_clickonce_with_com_6.png

WpfApplication1.exe.manifest가 눈에 띄죠. 그런데, 아쉬운 것은 "WpfApplication1.vshost.exe.manifest" 파일이 없다는 점입니다. 이것이 뭘 의미하냐면? 이 상태에서 "WpfApplication1.exe"를 실행시키면 오류가 발생하지 않지만, Visual Studio에서 "F5" 디버깅을 하는 경우에는 오류가 발생한다는 문제가 있습니다. (아마도 이것은 Visual Studio에서 Hosting Process(vshost.exe)의 manifest에 대한 관리적인 측면에 오작동이 있는 것 같은데,... VS2010에서는 개선이 되길 바랍니다.)

그래서, "F5 디버깅"을 하기 위해서는 아래의 2가지 방법 중 하나를 선택해야 합니다.

  • 프로젝트 설정에서 "Enable the Visual Studio hosting process" 옵션을 해제한다.
  • 개발자 PC에서는 아예 COM 개체를 등록해 둔다.

뭐... 어쩔 수가 없겠지요.
이렇게 해서 ClickOnce로 배포하고 실행해 보면 정상적으로 COM 개체의 메서드가 실행되는 것을 확인할 수 있습니다. 참고로, 아래는 ClickOnce로 배포된 경우의 클라이언트 측 폴더 내용입니다.

[그림 7: ClickOnce로 배포된 폴더의 내용]
howtodeploy_clickonce_with_com_7.png

보시는 것처럼 정상적으로 AtlTest.dll 파일이 내려가 있습니다.

첨부된 파일은 이러한 과정이 적용된 WPF와 ATL프로젝트를 담고 있는 솔루션입니다.




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

[연관 글]






[최초 등록일: ]
[최종 수정일: 12/1/2023]

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

비밀번호

댓글 작성자
 



2009-04-21 05시49분
Deployment in Visual Studio
- Deploying COM Components with ClickOnce
; https://learn.microsoft.com/en-us/previous-versions/visualstudio/visual-studio-2015/deployment/deploying-com-components-with-clickonce

위의 토픽에서도 자세히 다루고 있군요. ^^
kevin25
2009-06-20 12시24분
vshost.exe에 대한 manifest 지원이 안 되는 문제로 인해 "Enable the Visual Studio hosting process" 옵션을 해제하는 것은 Connect에 피드백을 올렸는데... 의외로 마이크로소프트에 이에 대한 문제를 보고 받은 적이 없나 봅니다. ^^;

Using registration-free COM components in vshost.exe is not possible
; (broken) http://connect.microsoft.com/VisualStudio/feedback/ViewFeedback.aspx?FeedbackID=467551

어쨌든... 수정이 되면 좋겠군요. ^^
kevin25

1  2  3  4  5  6  [7]  8  9  10  11  12  13  14  15  ...
NoWriterDateCnt.TitleFile(s)
13454정성태11/23/20232731닷넷: 2167. C# - Qdrant Vector DB를 이용한 Embedding 벡터 값 보관/조회 (Azure OpenAI) [1]파일 다운로드1
13453정성태11/23/20232240오류 유형: 879. docker desktop 설치 시 "Invalid JSON string. (Exception from HRESULT: 0x83750007)"
13452정성태11/22/20232324닷넷: 2166. C# - Azure OpenAI API를 이용해 사용자가 제공하는 정보를 대상으로 검색하는 방법파일 다운로드1
13451정성태11/21/20232464닷넷: 2165. C# - Azure OpenAI API를 이용해 ChatGPT처럼 동작하는 콘솔 응용 프로그램 제작파일 다운로드1
13450정성태11/21/20232278닷넷: 2164. C# - Octokit을 이용한 GitHub Issue 검색파일 다운로드1
13449정성태11/21/20232385개발 환경 구성: 688. Azure OpenAI 서비스 신청 방법
13448정성태11/20/20232638닷넷: 2163. .NET 8 - Dynamic PGO를 결합한 성능 향상파일 다운로드1
13447정성태11/16/20232507닷넷: 2162. ASP.NET Core 웹 사이트의 SSL 설정을 코드로 하는 방법
13446정성태11/16/20232435닷넷: 2161. .NET Conf 2023 - Day 1 Blazor 개요 정리
13445정성태11/15/20232750Linux: 62. 리눅스/WSL에서 CA 인증서를 저장하는 방법
13444정성태11/15/20232483닷넷: 2160. C# 12 - Experimental 특성 지원
13443정성태11/14/20232561개발 환경 구성: 687. OpenSSL로 생성한 사용자 인증서를 ASP.NET Core 웹 사이트에 적용하는 방법
13442정성태11/13/20232387개발 환경 구성: 686. 비주얼 스튜디오로 실행한 ASP.NET Core 사이트를 WSL 2 인스턴스에서 https로 접속하는 방법
13441정성태11/12/20232713닷넷: 2159. C# - ASP.NET Core 프로젝트에서 서버 Socket을 직접 생성하는 방법파일 다운로드1
13440정성태11/11/20232406Windows: 253. 소켓 Listen 시 방화벽의 Public/Private 제어 기능이 비활성화된 경우
13439정성태11/10/20232885닷넷: 2158. C# - 소켓 포트를 미리 시스템에 등록/예약해 사용하는 방법(Port Exclusion Ranges)파일 다운로드1
13438정성태11/9/20232491닷넷: 2157. C# - WinRT 기능을 이용해 윈도우에서 실행 중인 Media App 제어
13437정성태11/8/20232679닷넷: 2156. .NET 7 이상의 콘솔 프로그램을 (dockerfile 없이) 로컬 docker에 배포하는 방법
13436정성태11/7/20232937닷넷: 2155. C# - .NET 8 런타임부터 (Reflection 없이) 특성을 이용해 public이 아닌 멤버 호출 가능
13435정성태11/6/20232864닷넷: 2154. C# - 네이티브 자원을 포함한 관리 개체(예: 스레드)의 GC 정리
13434정성태11/1/20232652스크립트: 62. 파이썬 - class의 정적 함수를 동적으로 교체
13433정성태11/1/20232368스크립트: 61. 파이썬 - 함수 오버로딩 미지원
13432정성태10/31/20232427오류 유형: 878. 탐색기의 WSL 디렉터리 접근 시 "Attempt to access invalid address." 오류 발생
13431정성태10/31/20232745스크립트: 60. 파이썬 - 비동기 FastAPI 앱을 gunicorn으로 호스팅
13430정성태10/30/20232642닷넷: 2153. C# - 사용자가 빌드한 ICU dll 파일을 사용하는 방법
13429정성태10/27/20232923닷넷: 2152. Win32 Interop - C/C++ DLL로부터 이중 포인터 버퍼를 C#으로 받는 예제파일 다운로드1
1  2  3  4  5  6  [7]  8  9  10  11  12  13  14  15  ...