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프로젝트]
=== SimpleObject.cpp ===
STDMETHODIMP CSimpleObject::DoMethod(void)
{
return S_OK;
}
2. 등록 코드 삭제 / 등록 옵션 해제
UAC 때문에 빌드하면 오류나는 문제도 있고, 어차피 등록이 필요없기 때문에 아예 오류가 발생하지 않도록 등록 코드를 주석 처리하거나, 프로젝트 설정에서 등록 옵션을 해제합니다.
[그림 2: 등록 옵션 제거]
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]으로 사용될 버전]
4. WPF 프로젝트에서 manifest 참조 추가
자, 이제 [그림 4]에서 보는 것처럼 "참조 추가"대화상자에서 직접 "AtlTest.dll.manifest" 파일을 지정해서 COM 개체를 참조합니다.
[그림 4: Manifest 파일 참조]
정상적으로 참조가 된 경우, [그림 5]에서 보는 것처럼 "References" 노드에 "AtlTest.dll.manifest"가 추가된 것을 볼 수 있습니다.
[그림 5: Manifest 파일 참조된 상태]
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 응용 프로그램 빌드 후 결과물]
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로 배포된 폴더의 내용]
보시는 것처럼 정상적으로 AtlTest.dll 파일이 내려가 있습니다.
첨부된 파일은 이러한 과정이 적용된 WPF와 ATL프로젝트를 담고 있는 솔루션입니다.
[이 토픽에 대해서 여러분들과 의견을 공유하고 싶습니다. 틀리거나 미흡한 부분 또는 의문 사항이 있으시면 언제든 댓글 남겨주십시오.]