Microsoft MVP성태의 닷넷 이야기
글쓴 사람
정성태 (techsharer at outlook.com)
홈페이지
첨부 파일
 
(연관된 글이 3개 있습니다.)
(시리즈 글이 4개 있습니다.)
.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

개발 환경 구성: 717. Visual Studio - C# 프로젝트에서 레지스트리에 등록하지 않은 COM 개체 참조 및 사용 방법
; https://www.sysnet.pe.kr/2/0/13693




Reg-free COM 개체 사용을 위한 manifest 파일 생성 도구 - COMRegFreeManifest

COM 객체를 regsvr32.exe로 등록하지 않아도, manifest 파일을 통해 직접 생성해 사용할 수 있다고 설명했었습니다.

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

일례로 다음의 글들이 모두 그런 식으로,

C# - VLC(ActiveX) 컨트롤을 레지스트리 등록없이 사용하는 방법
; https://www.sysnet.pe.kr/2/0/1640

eBEST XingAPI의 C# 래퍼 버전 - XingAPINet Nuget 패키지
; https://www.sysnet.pe.kr/2/0/12134

C# - 키움 Open API+ 사용 시 Registry 등록 없이 KHOpenAPI.ocx 사용하는 방법
; https://www.sysnet.pe.kr/2/0/12129

COM 객체를 등록하지 않고 같은 폴더에 있는 dll로부터 로드하고 있습니다. 그런데... 가끔 해보는 거지만 그때마다 manifest 파일을 일일이 만들려니 꽤나... ^^; 귀찮습니다. 그래서 어차피, tlbimp.exe가 생성한 COM Interop DLL만 있으면 나머지는 Reflection으로 COM 객체의 정보를 열람할 수 있기 때문에 manifest 만드는 것을 자동화했습니다.

다음 코드는 간략하게 만들어 본 것이고,

using Microsoft.Win32;
using System;
using System.Collections.Generic;
using System.Diagnostics;
using System.IO;
using System.Linq;
using System.Reflection;
using System.Runtime.InteropServices;
using System.Text;

namespace COMRegFreeManifest
{
    class Program
    {
        static void Main(string[] args)
        {
            if (args.Length < 1)
            {
                Console.WriteLine("COMRegFreeManifest.exe [com_dll_path]");
                return;
            }

            string path = args[0];

            string currentPath = Environment.CurrentDirectory;
            string dllManifestPath = Path.Combine(currentPath, Path.GetFileName(path));
            string exeManifestPath = Path.Combine(currentPath, "Sample.exe");

            string impLibPath = Path.Combine(Path.GetTempPath(), "test.dll");

            try
            {
                if (RunTlbImp(path, impLibPath) == false)
                {
                    Console.WriteLine("TLBIMP not work");
                    return;
                }

                byte[] buf = File.ReadAllBytes(impLibPath);
                Assembly asm = Assembly.ReflectionOnlyLoad(buf);

                ExportDllManifest(asm, impLibPath, dllManifestPath);
                ExportExeManifest(asm, impLibPath, dllManifestPath, exeManifestPath);
            }
            finally
            {
                if (File.Exists(impLibPath) == true)
                {
                    File.Delete(impLibPath);
                }
            }
        }
        private static void ExportExeManifest(Assembly asm, string impLibPath, string dllManifestPath, string exeManifestPath)
        {
            string manifestTemplate = @"<?xml version=""1.0"" encoding=""utf-8""?>
<asmv1:assembly manifestVersion=""1.0"" xmlns=""urn:schemas-microsoft-com:asm.v1"" xmlns:asmv1=""urn:schemas-microsoft-com:asm.v1"" xmlns:asmv2=""urn:schemas-microsoft-com:asm.v2"" xmlns:xsi=""http://www.w3.org/2001/XMLSchema-instance"">
  <assemblyIdentity version=""1.0.0.0"" name=""MyApplication.app""/>

  <trustInfo xmlns=""urn:schemas-microsoft-com:asm.v2"">
    <security>
      <requestedPrivileges xmlns=""urn:schemas-microsoft-com:asm.v3"">
        <requestedExecutionLevel level=""asInvoker"" uiAccess=""false"" />
      </requestedPrivileges>
    </security>
  </trustInfo>
  
  <compatibility xmlns=""urn:schemas-microsoft-com:compatibility.v1"">
    <application>
    </application>
  </compatibility>
  
  <dependency>
    <dependentAssembly asmv2:dependencyType=""install"" asmv2:codebase=""{0}.manifest"">
      <assemblyIdentity name=""{0}"" version=""{1}"" type=""win32"" />
    </dependentAssembly>
  </dependency>

</asmv1:assembly>
";


            string dllName = Path.GetFileName(dllManifestPath);
            string version = asm.GetName().Version.ToString();

            string manifestText = string.Format(manifestTemplate, dllName, version);
            File.WriteAllText(exeManifestPath + ".manifest", manifestText);
        }

        private static void ExportDllManifest(Assembly asm, string impLibPath, string dllManifestPath)
        {
            string txt = GetManifestContents(asm, dllManifestPath);
            File.WriteAllText(dllManifestPath + ".manifest", txt);
        }

        static string GetManifestContents(Assembly asm, string dllManifestPath)
        { 
            string manifestTemplate = @"<?xml version=""1.0"" encoding=""UTF-8"" standalone=""yes""?>
<assembly xmlns=""urn:schemas-microsoft-com:asm.v1"" manifestVersion=""1.0"">

  <assemblyIdentity version=""{0}"" name=""{1}"" type=""win32"">
  </assemblyIdentity>
  
  <file name=""{1}"">
    <comClass clsid=""{2}"" threadingModel=""Apartment"" tlbid=""{3}"" />
    <typelib tlbid=""{3}"" version=""{4}"" helpdir="""" resourceid=""0"" />
  </file>

  {5}
</assembly>
";
            string interfaceTemplate = @"
  <comInterfaceExternalProxyStub name=""{0}"" 
                                 iid=""{1}"" 
                                 proxyStubClsid32=""{{00020424-0000-0000-C000-000000000046}}"" 
                                 baseInterface=""{2}"" 
                                 tlbid=""{3}"">
  </comInterfaceExternalProxyStub>
";

            string version = asm.GetName().Version.ToString();
            string dllName = Path.GetFileName(dllManifestPath);
            string clsid = $"{{{GetClsid(asm)}}}";
            string tlbid = $"{{{GetAssemblyAttr(asm, typeof(GuidAttribute))}}}";
            string tlbVersion = GetTypeLibVersion(asm);

            StringBuilder sb = new StringBuilder();

            foreach (Type type in asm.GetTypes())
            {
                if (type.IsInterface == false || HasCoClassAttribute(type))
                {
                    continue;
                }

                string interfaceName = type.Name;
                string interfaceIid = $"{{{GetGuid(type)}}}";
                string baseInterfaceIid = GetBaseInterfaceIID(type);

                string interfaceText = string.Format(interfaceTemplate, interfaceName, interfaceIid, baseInterfaceIid, tlbid);
                sb.AppendLine(interfaceText);
            }

            string manifestText = string.Format(manifestTemplate, version, dllName, clsid, tlbid, tlbVersion, sb.ToString());

            return manifestText;
        }

        private static string GetBaseInterfaceIID(Type type)
        {
            foreach (CustomAttributeData attr in type.GetCustomAttributesData())
            {
                if (attr.Constructor.DeclaringType == typeof(TypeLibTypeAttribute))
                {
                    TypeLibTypeFlags flags = (TypeLibTypeFlags)attr.ConstructorArguments[0].Value;
                    if (flags.HasFlag(TypeLibTypeFlags.FDual))
                    {
                        return "{00020400-0000-0000-C000-000000000046}";
                    }
                    else
                    { 
                        return "{00000000-0000-0000-C000-000000000046}";
                    }
                }
            }
            return "";
        }

        private static string GetTypeLibVersion(Assembly asm)
        {
            foreach (CustomAttributeData attr in asm.GetCustomAttributesData())
            {
                if (attr.Constructor.DeclaringType == typeof(TypeLibVersionAttribute))
                {
                    return $"{attr.ConstructorArguments[0].Value}.{attr.ConstructorArguments[1].Value}";
                }
            }

            return "";
        }

        private static bool HasCoClassAttribute(Type type)
        {
            foreach (CustomAttributeData attr in type.GetCustomAttributesData())
            {
                if (attr.Constructor.DeclaringType == typeof(CoClassAttribute))
                {
                    return true;
                }
            }

            return false;
        }

        private static string GetClsid(Assembly asm)
        {
            foreach (Type type in asm.GetTypes())
            {
                foreach (CustomAttributeData attr in type.GetCustomAttributesData())
                {
                    if (attr.Constructor.DeclaringType == typeof(CoClassAttribute))
                    {
                        return GetGuid(attr.ConstructorArguments[0].Value as Type);
                    }
                }
            }

            return "";
        }

        private static string GetGuid(Type type)
        {
            foreach (CustomAttributeData attr in type.GetCustomAttributesData())
            {
                if (attr.Constructor.DeclaringType == typeof(GuidAttribute))
                {
                    return attr.ConstructorArguments[0].Value as string;
                }
            }

            return "";
        }

        private static string GetAssemblyAttr(Assembly asm, Type targetType)
        {
            foreach (CustomAttributeData attr in asm.GetCustomAttributesData())
            {
                if (attr.Constructor.DeclaringType == targetType)
                {
                    return attr.ConstructorArguments[0].Value as string;
                }
            }

            return "";
        }

        private static bool RunTlbImp(string path, string impLibPath)
        {
            ProcessStartInfo psi = new ProcessStartInfo();
            psi.FileName = GetTlbImpPath("tlbimp.exe");
            psi.Arguments = $"\"{path}\" /out:\"{impLibPath}\"";
            psi.CreateNoWindow = true;
            psi.UseShellExecute = false;

            Process newProc = Process.Start(psi);
            newProc.WaitForExit();

            return File.Exists(impLibPath);
        }

        private static string GetTlbImpPath(string toolName)
        {
            using (RegistryKey regKey = Registry.LocalMachine.OpenSubKey(@"SOFTWARE\WOW6432Node\Microsoft\Microsoft SDKs\NETFXSDK", false))
            {
                // How do I force RunOnce commands to run in a specific order?
                // ; https://devblogs.microsoft.com/oldnewthing/20250515-00/?p=111181
                foreach (string version in regKey.GetSubKeyNames())
                {
                    using (RegistryKey versionKey = regKey.OpenSubKey(version, false))
                    {
                        foreach (string tool in versionKey.GetSubKeyNames())
                        {
                            using (RegistryKey toolKey = versionKey.OpenSubKey(tool))
                            {
                                string path = toolKey.GetValue("InstallationFolder") as string;

                                string tlbimpPath = Path.Combine(path, toolName);
                                if (File.Exists(tlbimpPath) == true)
                                {
                                    return tlbimpPath;
                                }
                            }
                        }
                    }
                }
            }

            return null;
        }
    }
}

실행은 단순하게, COM DLL 파일을 전달하면 됩니다.

c:\temp> COMRegFreeManifest.exe c:\test\my_atl.dll

그럼 my_atl.dll.manifest와 Sample.exe.manifest 파일이 각각 다음과 같은 식으로 생성됩니다.


[my_atl.dll.manifest]

(2024-07-21 업데이트) 참고로, DLL에 대한 manifest는 TLB 파일이 있는 경우 Windows SDK에 포함된 공식 도구인 mt.exe에 의해 생성하는 것도 가능합니다. 예를 들어, 이번 예제의 경우 다음과 같은 식으로 실행할 수 있습니다.

// 현재 디렉터리에 tlb 파일이 있어야 하지만, DLL 파일은 없어도 됨. (DLL 파일 이름을 주는 것은 manifest 내에 필요한 문자열이기 때문임)
c:\temp> mt -tlb:my_atl.tlb -dll:my_atl.dll -out:test.manifset

<?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.0" name="my_atl.dll" type="win32">
    </assemblyIdentity>

    <file name="my_atl.dll">
        <comClass clsid="{2F71B57A-B6DF-4733-A29A-6ECA13FAE34F}" threadingModel="Apartment" tlbid="{0B2AAC68-8E4B-4BAA-85D7-4DF62A224D9F}" />
        <typelib tlbid="{0B2AAC68-8E4B-4BAA-85D7-4DF62A224D9F}" version="1.0" helpdir="" resourceid="0" />
    </file>


    <comInterfaceExternalProxyStub name="IATLSimpleObject"
                                   iid="{CB82A462-8F49-4434-987B-CB8FBC8A9115}"
                                   proxyStubClsid32="{00020424-0000-0000-C000-000000000046}"
                                   baseInterface="{00020400-0000-0000-C000-000000000046}"
                                   tlbid="{0B2AAC68-8E4B-4BAA-85D7-4DF62A224D9F}">
    </comInterfaceExternalProxyStub>


</assembly>


[Sample.exe.manifest]

<?xml version="1.0" encoding="utf-8"?>
<asmv1:assembly manifestVersion="1.0" xmlns="urn:schemas-microsoft-com:asm.v1" xmlns:asmv1="urn:schemas-microsoft-com:asm.v1" xmlns:asmv2="urn:schemas-microsoft-com:asm.v2" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
    <assemblyIdentity version="1.0.0.0" name="MyApplication.app"/>

    <trustInfo xmlns="urn:schemas-microsoft-com:asm.v2">
        <security>
            <requestedPrivileges xmlns="urn:schemas-microsoft-com:asm.v3">
                <requestedExecutionLevel level="asInvoker" uiAccess="false" />
            </requestedPrivileges>
        </security>
    </trustInfo>

    <compatibility xmlns="urn:schemas-microsoft-com:compatibility.v1">
        <application>
        </application>
    </compatibility>

    <dependency>
        <dependentAssembly asmv2:dependencyType="install" asmv2:codebase="my_atl.dll.manifest">
            <assemblyIdentity name="my_atl.dll" version="1.0.0.0" type="win32" />
        </dependentAssembly>
    </dependency>

</asmv1:assembly>

오~~~ 제법 폼 나는군요. ^^ 이제 my_atl.dll.manifest 파일은 EXE 프로젝트에 포함해 "Copy to Output Directory" 옵션을 "Copy if newer"로 설정하고 Sample.exe.manifest 파일은 EXE 프로젝트 속성 창의 "Application" 범주의 "Resources" 영역에 "Manifest:" 콤보 박스에 등록해 주시면 됩니다.

(전체 프로젝트는 github에 올렸습니다. - https://github.com/stjeong/DotNetSamples/tree/master/WinConsole/COMRegFreeManifest)




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

[연관 글]






[최초 등록일: ]
[최종 수정일: 5/16/2025]

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

비밀번호

댓글 작성자
 




... 91  92  93  94  95  96  97  98  99  100  101  102  [103]  104  105  ...
NoWriterDateCnt.TitleFile(s)
11394정성태12/8/201719412개발 환경 구성: 342. 비주얼 스튜디오에서 실행하던 ASP.NET Core (.NET Framework) 응용 프로그램을 명령행에서 실행하는 방법
11393정성태12/7/201724573Windows: 145. 윈도우 10 빌드 17046부터 WSL에서 백그라운드 작업 지원 [5]
11392정성태12/7/201719054개발 환경 구성: 341. openSUSE에 닷넷 코어 설치
11391정성태12/7/201722102개발 환경 구성: 340. WSL을 이용해 윈도우 PC 1대에서 openSUSE 응용 프로그램을 Visual Studio로 개발하는 방법 [1]
11390정성태12/7/201731020개발 환경 구성: 339. WSL을 이용해 윈도우 PC 1대에서 Linux 응용 프로그램을 Visual Studio로 개발하는 방법 [6]
11389정성태12/7/201719680오류 유형: 440. .NET Core 오류 - 0x80131620 Unable to load DLL 'libuv'
11388정성태12/6/201723499개발 환경 구성: 338. WSL 또는 Ubuntu에 닷넷 코어 설치 [3]
11387정성태12/6/201723410오류 유형: 439. 이벤트 로그 - Data Sharing Service 서비스의 %%3239247874 오류 메시지
11386정성태12/5/201719431오류 유형: 438. Hyper-V - '...' failed to add device 'Virtual CD/DVD Disk'
11385정성태12/5/201732573VC++: 121. DXGI를 이용한 윈도우 화면 캡처 소스 코드(Visual C++) [16]파일 다운로드1
11384정성태12/5/201722046오류 유형: 437. Visual C++ - Cannot open include file: 'SDKDDKVer.h'
11383정성태12/4/201724662디버깅 기술: 110. 비동기 코드 실행 중 예외로 인한 ASP.NET 프로세스 비정상 종료 현상 [1]
11382정성태12/4/201723561오류 유형: 436. System.Data.SqlClient.SqlException (0x80131904): Connection Timeout Expired 예외 발생 시 "[Pre-Login] initialization=48; handshake=1944;" 값의 의미
11381정성태11/30/201720191.NET Framework: 702. 한글이 포함된 바이트 배열을 나눈 경우 한글이 깨지지 않도록 다시 조합하는 방법(두 번째 이야기)파일 다운로드1
11380정성태11/30/201720195디버깅 기술: 109. windbg - (x64에서의 인자 값 추적을 이용한) Thread.Abort 시 대상이 되는 스레드를 식별하는 방법
11379정성태11/30/201719947오류 유형: 435. System.Web.HttpException - Session state has created a session id, but cannot save it because the response was already flushed by the application.
11378정성태11/29/201721843.NET Framework: 701. 한글이 포함된 바이트 배열을 나눈 경우 한글이 깨지지 않도록 다시 조합하는 방법 [1]파일 다운로드1
11377정성태11/29/201721423.NET Framework: 700. CommonOpenFileDialog 사용 시 사용자가 선택한 파일 목록을 구하는 방법 [3]파일 다운로드1
11376정성태11/28/201726112VS.NET IDE: 123. Visual Studio 편집기의 \r\n (crlf) 개행을 \n으로 폴더 단위로 설정하는 방법
11375정성태11/28/201719882오류 유형: 434. Visual Studio로 ASP.NET 디버깅 중 System.Web.HttpException - Could not load type 오류
11374정성태11/27/201725862사물인터넷: 14. 라즈베리 파이 - (윈도우의 NT 서비스처럼) 부팅 시 시작하는 프로그램 설정 [1]
11373정성태11/27/201724868오류 유형: 433. Raspberry Pi/Windows 다중 플랫폼 지원 컴파일 관련 오류 기록
11372정성태11/25/201727407사물인터넷: 13. 윈도우즈 사용자를 위한 라즈베리 파이 제로 W 모델을 설정하는 방법 [4]
11371정성태11/25/201721221오류 유형: 432. Hyper-V 가상 스위치 생성 시 Failed to connect Ethernet switch port 0x80070002 오류 발생
11370정성태11/25/201721424오류 유형: 431. Hyper-V의 Virtual Switch 생성 시 "External network" 목록에 특정 네트워크 어댑터 항목이 없는 경우
11369정성태11/25/201723172사물인터넷: 12. Raspberry Pi Zero(OTG)를 다른 컴퓨터에 연결해 가상 키보드 및 마우스로 쓰는 방법 (절대 좌표, 상대 좌표, 휠) [1]
... 91  92  93  94  95  96  97  98  99  100  101  102  [103]  104  105  ...