Microsoft MVP성태의 닷넷 이야기
.NET Framework: 127. ClickOnce로 ActiveX를 같이 배포하는 방법 [링크 복사], [링크+제목 복사]
조회: 29197
글쓴 사람
정성태 (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)
13400정성태8/10/20233376오류 유형: 874. 파이썬 - pymssql을 윈도우 환경에서 설치 불가
13399정성태8/9/20233393닷넷: 2135. C# - 지역 변수로 이해하는 메서드 매개변수의 값/참조 전달
13398정성태8/3/20234164스크립트: 55. 파이썬 - pyodbc를 이용한 SQL Server 연결 사용법
13397정성태7/23/20233685닷넷: 2134. C# - 문자열 연결 시 string.Create를 이용한 GC 할당 최소화
13396정성태7/22/20233377스크립트: 54. 파이썬 pystack 소개 - 메모리 덤프로부터 콜 스택 열거
13395정성태7/20/20233332개발 환경 구성: 685. 로컬에서 개발 중인 ASP.NET Core/5+ 웹 사이트에 대해 localhost 이외의 호스트 이름으로 접근하는 방법
13394정성태7/16/20233283오류 유형: 873. Oracle.ManagedDataAccess.Client - 쿼리 수행 시 System.InvalidOperationException
13393정성태7/16/20233437닷넷: 2133. C# - Oracle 데이터베이스의 Sleep 쿼리 실행하는 방법
13392정성태7/16/20233315오류 유형: 872. Oracle - ORA-01031: insufficient privileges
13391정성태7/14/20233380닷넷: 2132. C# - sealed 클래스의 메서드를 callback 호출했을 때 인라인 처리가 될까요?
13390정성태7/12/20233368스크립트: 53. 파이썬 - localhost 호출 시의 hang 현상
13389정성태7/5/20233400개발 환경 구성: 684. IIS Express로 호스팅하는 웹을 WSL 환경에서 접근하는 방법
13388정성태7/3/20233532오류 유형: 871. 윈도우 탐색기에서 열리지 않는 zip 파일 - The Compressed (zipped) Folder '[...].zip' is invalid. [1]파일 다운로드1
13387정성태6/28/20233545오류 유형: 870. _mysql - Commands out of sync; you can't run this command now
13386정성태6/27/20233616Linux: 61. docker - 원격 제어를 위한 TCP 바인딩 추가
13385정성태6/27/20233829Linux: 60. Linux - 외부에서의 접속을 허용하기 위한 TCP 포트 여는 방법
13384정성태6/26/20233577.NET Framework: 2131. C# - Source Generator로 해결하는 enum 박싱 문제파일 다운로드1
13383정성태6/26/20233321개발 환경 구성: 683. GPU 런타임을 사용하는 Colab 노트북 설정
13382정성태6/25/20233366.NET Framework: 2130. C# - Win32 API를 이용한 윈도우 계정 정보 (예: 마지막 로그온 시간)파일 다운로드1
13381정성태6/25/20233751오류 유형: 869. Fatal Python error: init_fs_encoding: failed to get the Python codec of the filesystem encoding
13380정성태6/24/20233199스크립트: 52. 파이썬 3.x에서의 동적 함수 추가
13379정성태6/23/20233213스크립트: 51. 파이썬 2.x에서의 동적 함수 추가
13378정성태6/22/20233122오류 유형: 868. docker - build 시 "CANCELED ..." 뜨는 문제
13377정성태6/22/20236906오류 유형: 867. 파이썬 mysqlclient 2.2.x 설치 시 "Specify MYSQLCLIENT_CFLAGS and MYSQLCLIENT_LDFLAGS env vars manually" 오류
13376정성태6/21/20233294.NET Framework: 2129. C# - Polly를 이용한 클라이언트 측의 요청 재시도파일 다운로드1
13375정성태6/20/20232989스크립트: 50. Transformers (신경망 언어모델 라이브러리) 강좌 - 2장 코드 실행 결과
1  2  3  4  5  6  7  8  [9]  10  11  12  13  14  15  ...