Microsoft MVP성태의 닷넷 이야기
.NET Framework: 127. ClickOnce로 ActiveX를 같이 배포하는 방법 [링크 복사], [링크+제목 복사]
조회: 20740
글쓴 사람
정성태 (techsharer at outlook.com)
홈페이지
첨부 파일

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프로젝트를 담고 있는 솔루션입니다.




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

[연관 글]





[최초 등록일: ]
[최종 수정일: 11/10/2019 ]

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

비밀번호

댓글 쓴 사람
 



2009-04-21 05시49분
Deployment in Visual Studio
- Deploying COM Components with ClickOnce
; https://docs.microsoft.com/en-us/visualstudio/deployment/deploying-com-components-with-clickonce?view=vs-2015

위의 토픽에서도 자세히 다루고 있군요. ^^

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
; 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)
12438정성태12/2/202025오류 유형: 688. .Visual C++ - Error C2011 'sockaddr': 'struct' type redefinition
12437정성태12/1/202043VS.NET IDE: 155. pfx의 암호 키 파일을 Visual Studio 없이 등록하는 방법
12436정성태12/1/202016오류 유형: 687. .NET Core 2.2 빌드 - error MSB4018: The "RazorTagHelper" task failed unexpectedly.
12435정성태12/1/202052Windows: 181. 윈도우 환경에서 클라이언트 소켓의 최대 접속 수 (4) - ReuseUnicastPort를 이용한 포트 고갈 문제 해결파일 다운로드1
12434정성태12/2/202080Windows: 180. C# - dynamicport 값의 범위를 알아내는 방법
12433정성태12/1/202063Windows: 179. 윈도우 환경에서 클라이언트 소켓의 최대 접속 수 (3) - SO_PORT_SCALABILITY파일 다운로드1
12432정성태11/30/2020147Windows: 178. 윈도우 환경에서 클라이언트 소켓의 최대 접속 수 (2) - SO_REUSEADDR [1]파일 다운로드1
12431정성태11/27/202077.NET Framework: 976. UnmanagedCallersOnly + C# 9.0 함수 포인터 사용 시 x86 빌드에서 오동작하는 문제파일 다운로드1
12430정성태11/27/202028오류 유형: 686. Ubuntu - E: The repository 'cdrom://...' does not have a Release file.
12429정성태12/2/202068디버깅 기술: 175. windbg - 특정 Win32 API에서 BP가 안 걸리는 경우
12428정성태11/25/202044VS.NET IDE: 154. Visual Studio - .NET Core App 실행 시 dotnet.exe 실행 화면만 나오는 문제
12427정성태11/25/2020124.NET Framework: 975. .NET Core를 직접 호스팅해 (runtimeconfig.json 없이) EXE만 배포해 실행파일 다운로드1
12426정성태11/24/202038오류 유형: 685. WinDbg Preview - error InitTypeRead
12425정성태11/24/202029VC++: 141. Visual C++ - "Treat Warnings As Errors" 옵션이 꺼져 있는데도 일부 경고가 에러 처리되는 경우
12424정성태11/24/202070VC++: 140. C++의 연산자 동의어(operator synonyms), 대체 토큰
12423정성태11/22/2020118.NET Framework: 974. C# 9.0 - (16) 제약 조건이 없는 형식 매개변수 주석(Unconstrained type parameter annotations)파일 다운로드1
12422정성태11/21/202079.NET Framework: 973. .NET 5, .NET Framework에서만 허용하는 UnmanagedCallersOnly 사용예파일 다운로드1
12421정성태11/23/202082.NET Framework: 972. DNNE가 출력한 NE DLL을 직접 생성하는 방법파일 다운로드1
12420정성태11/19/202041오류 유형: 684. Visual C++ - MSIL .netmodule or module compiled with /GL found; restarting link with /LTCG; add /LTCG to the link command line to improve linker performance
12419정성태11/23/2020100VC++: 139. Visual C++ - .NET Core의 nethost.lib와 정적 링크파일 다운로드1
12418정성태11/19/202041오류 유형: 683. Visual C++ - error LNK2038: mismatch detected for 'RuntimeLibrary': value 'MT_StaticRelease' doesn't match value 'MDd_DynamicDebug'파일 다운로드1
12417정성태11/19/202042오류 유형: 682. Visual C++ - warning LNK4099: PDB '...pdb' was not found with '...lib(pch.obj)' or at '...pdb'; linking object as if no debug info
12416정성태11/19/202031오류 유형: 681. Visual C++ - error LNK2001: unresolved external symbol _CrtDbgReport
12415정성태11/19/202090.NET Framework: 971. UnmanagedCallersOnly 특성과 DNNE 사용파일 다운로드1
12414정성태11/20/2020128VC++: 138. x64 빌드에서 extern "C"가 아닌 경우 ___cdecl name mangling 적용 [4]파일 다운로드1
[1]  2  3  4  5  6  7  8  9  10  11  12  13  14  15  ...