네이티브 이미지 생성기(Ngen.exe)

네이티브 이미지 생성기(Ngen.exe)는 관리되는 응용 프로그램의 성능을 향상시키는 도구입니다. Ngen.exe는 컴파일된 프로세서별 기계어 코드가 포함된 파일인 네이티브 이미지를 만들어서 로컬 컴퓨터의 네이티브 이미지 캐시에 설치합니다. 런타임은 JIT(Just-In-Time) 컴파일러를 사용하지 않고 캐시의 네이티브 이미지를 사용하여 원본 어셈블리를 컴파일할 수 있습니다.

.NET Framework 버전 2.0에서는 Ngen.exe가 크게 변경되었습니다.

  • 어셈블리를 설치하면 종속성도 함께 설치되어 Ngen.exe의 구문이 간단해집니다.

  • 이제 응용 프로그램 도메인 간에 네이티브 이미지를 공유할 수 있습니다.

  • 새로운 동작인 update는 무효화된 이미지를 다시 만듭니다.

  • 이미지를 생성하고 설치할 컴퓨터에서 유휴 시간에 서비스 실행 동작을 지연시킬 수 있습니다.

  • 이미지를 무효화시키는 몇 가지 원인이 제거되었습니다.

Ngen.exe 및 네이티브 이미지 서비스 사용 방법에 대한 자세한 내용은 네이티브 이미지 서비스를 참조하십시오.

참고

.NET Framework 버전 1.0 및 1.1의 Ngen.exe 구문은 네이티브 이미지 생성기(Ngen.exe) 레거시 구문에 있습니다.

ngen <action> [options]
ngen /? | /help

작업

다음 표에서는 각 동작의 구문을 보여 줍니다. actionArguments의 각 부분에 대한 설명은 인수, 시나리오 및 구성 표를 참조하십시오. Options 표에서는 options 및 도움말 스위치를 설명합니다.

작업 설명

install [assemblyName | assemblyPath] [scenarios] [config] [/queue[:{1|2|3}]]

어셈블리 및 해당 종속성에 대한 네이티브 이미지를 생성하고 그러한 이미지를 네이티브 이미지 캐시에 설치합니다.

/queue를 지정하면 네이티브 이미지 서비스에 대한 동작이 큐에 대기합니다. 기본 우선 순위는 3입니다.

uninstall [assemblyName | assemblyPath | *] [scenarios] [config]

네이티브 이미지 캐시에서 어셈블리에 대한 네이티브 이미지와 그 종속성을 삭제합니다.

하나의 이미지와 그 종속성을 제거하려면 해당 이미지를 설치할 때 사용한 것과 동일한 명령줄 인수를 사용합니다.

update [/queue]

무효화된 네이티브 이미지를 업데이트합니다.

/queue를 지정하면 네이티브 이미지 서비스에 대한 업데이트가 큐에 대기합니다. 업데이트는 항상 우선 순위 3에서 예약되므로 컴퓨터가 유휴 상태일 때 실행됩니다.

display [assemblyName | assemblyPath]

어셈블리에 대한 네이티브 이미지와 그 종속성의 상태를 표시합니다.

인수를 지정하지 않은 경우 네이티브 이미지 캐시에 있는 모든 것이 표시됩니다.

executeQueuedItems [1|2|3]

큐에 대기한 컴파일 작업을 실행합니다.

우선 순위를 지정하면 우선 순위가 크거나 같은 컴파일 작업이 실행됩니다. 우선 순위를 지정하지 않으면 큐에 대기한 컴파일 작업이 모두 실행됩니다.

queue {pause | continue | status}

네이티브 이미지 서비스를 일시 중지하거나 일시 중지된 서비스를 계속 수행할 수 있도록 하거나 서비스 상태를 쿼리합니다.

인수

인수 설명

assemblyName

어셈블리의 이름입니다. myAssembly와 같은 부분 어셈블리 이름이나 myAssembly, Version=2.0.0.0, Culture=neutral, PublicKeyToken=0038abc9deabfle5와 같은 전체 표시 이름을 지정할 수 있습니다.

Ngen.exe 명령줄 당 어셈블리를 하나만 지정할 수 있습니다.

assemblyPath

어셈블리의 명시적 경로입니다. 전체 또는 상대 경로를 지정할 수 있습니다.

경로 없이 파일 이름을 지정하는 경우 어셈블리가 현재 디렉터리에 있어야 합니다.

Ngen.exe 명령줄 당 어셈블리를 하나만 지정할 수 있습니다.

시나리오

시나리오 설명

/Debug

디버거에서 사용할 수 있는 네이티브 이미지를 생성합니다.

/Profile

프로파일러에서 사용할 수 있는 네이티브 이미지를 생성합니다.

/NoDependencies

지정한 시나리오 옵션에 필요한 최소 네이티브 이미지 수를 생성합니다.

구성

구성 설명

/ExeConfig: exePath

지정한 실행 어셈블리의 구성을 사용합니다.

Ngen.exe는 종속성에 바인딩할 때 로더와 같은 결정을 해야 합니다. 공유 구성 요소가 런타임 시 로드되면 응용 프로그램의 구성 파일은 Load 메서드를 사용하여 공유 구성 요소에 대해 로드된 종속성을 결정합니다(예: 로드된 종속성 버전). /ExeConfig 스위치는 런타임 시 종속성을 로드하는 Ngen.exe 지침을 제공합니다.

/AppBase: directoryPath

종속성을 찾을 때 지정된 디렉터리를 응용 프로그램 기본 디렉터리로 사용합니다.

옵션

옵션 설명

/nologo

Microsoft 시작 배너를 표시하지 않습니다.

/silent

성공 메시지를 표시하지 않습니다.

/verbose

디버깅에 대한 자세한 내용을 표시합니다.

참고

운영 체제 제한으로 인해 이 옵션은 Windows 98 및 Windows Millennium Edition에 대한 추가 정보를 표시하지 않습니다.

/help, /?

현재 릴리스의 명령 구문 및 옵션을 표시합니다.

설명

Ngen.exe를 실행하려면 관리자 권한이 있어야 합니다.

Ngen.exe는 지정된 어셈블리 및 해당하는 모든 종속성에 대한 네이티브 이미지를 생성합니다. 어셈블리 매니페스트의 참조로 종속성을 확인할 수 있습니다. 종속성을 별도로 설치해야 하는 경우는 응용 프로그램에서 System.Reflection.Assembly.Load 메서드를 호출하는 것과 같은 방법으로 리플렉션을 사용하여 종속성을 로드하는 경우밖에 없습니다.

Note중요

네이티브 이미지에 System.Reflection.Assembly.LoadFrom 메서드를 사용하지 마십시오. 이 메서드로 로드된 이미지는 실행 컨텍스트의 다른 어셈블리에서 사용할 수 없습니다.

Ngen.exe에서는 종속성 개수가 유지됩니다. 예를 들어, 네이티브 이미지 캐시에 MyAssembly.exeYourAssembly.exe가 모두 설치되어 있고 이 두 가지 모두에 OurDependency.dll에 대한 참조가 있는 경우, MyAssembly.exe를 제거해도 OurDependency.dll은 제거되지 않고 YourAssembly.exe도 제거할 때만 제거됩니다.

전역 어셈블리 캐시에 어셈블리에 대한 네이티브 이미지를 생성 중인 경우 해당 표시 이름을 지정합니다. System.Reflection.Assembly.FullName을 참조하십시오.

Ngen.exe에서 생성되는 네이티브 이미지는 응용 프로그램 도메인 간에 공유할 수 있습니다. 즉, 응용 프로그램 도메인 간에 어셈블리를 공유해야 하는 응용 프로그램 시나리오에서는 Ngen.exe를 사용할 수 있습니다. 도메인 중립성을 지정하려면

같은 어셈블리를 여러 응용 프로그램 도메인으로 로드할 때 항상 도메인 중립 코드를 사용합니다. 네이티브 이미지가 공유 도메인으로 로드된 후 비공유 응용 프로그램 도메인으로 로드되면 사용할 수 없습니다.

참고

도메인 중립 코드는 특히 정적 멤버에 액세스할 때 언로드할 수 없으며 성능이 저하될 수 있습니다.

다른 시나리오에 대한 이미지 생성

어셈블리의 네이티브 이미지를 생성하고 나면 런타임은 해당 어셈블리를 실행할 때마다 자동으로 이 네이티브 이미지를 찾아서 사용합니다. 사용 시나리오에 따라 여러 이미지를 생성할 수 있습니다.

예를 들어, 디버깅 또는 프로파일링 시나리오에서 어셈블리를 실행하는 경우 런타임은**/Debug** 및 /Profile 옵션을 사용하여 생성한 네이티브 이미지를 찾습니다. 일치하는 네이티브 이미지를 찾을 수 없는 경우 런타임은 표준 JIT 컴파일로 되돌립니다. 네이티브 이미지를 디버깅하는 유일한 방법은 /Debug 옵션으로 네이티브 이미지를 만드는 것입니다.

uninstall 동작은 시나리오도 인식하므로 시나리오를 모두 제거하거나 선택한 시나리오만 제거할 수 있습니다.

네이티브 이미지 사용 시기 결정

네이티브 이미지는 향상된 메모리 사용과 시작 시간의 단축으로 성능을 향상시킬 수 있습니다.

참고

네이티브 이미지의 성능은 코드 및 데이터 액세스 패턴, 모듈 경계에서의 호출 수, 다른 응용 프로그램에서 이미 로드한 종속성 수와 같이 분석을 어렵게 하는 여러 가지 요소에 따라 다릅니다. 네이티브 이미지가 응용 프로그램에 이점을 제공하는지 여부를 확인하는 유일한 방법은 키 배포 시나리오에서 성능을 측정하는 것입니다.

향상된 메모리 사용

네이티브 이미지는 코드가 프로세스 간에 공유되는 경우 메모리 사용을 향상시킬 수 있습니다. 네이티브 이미지는 Windows PE 파일이므로 .dll 파일의 단일 복사본은 여러 프로세스에서 공유할 수 있지만 JIT 컴파일러가 생성한 네이티브 이미지는 개인 메모리에 저장되며 공유할 수 없습니다.

터미널 서비스에서 실행된 응용 프로그램은 공유 코드 페이지를 활용할 수도 있습니다.

또한 JIT 컴파일러를 로드하지 않으면 각 응용 프로그램 인스턴스의 고정 메모리 양을 저장합니다.

빠른 응용 프로그램 시작

Ngen.exe로 어셈블리를 미리 컴파일하면 일부 응용 프로그램의 시작 시간을 줄일 수 있습니다. 일반적으로 응용 프로그램을 처음 시작한 후에 공유 구성 요소가 다음 응용 프로그램을 위해 이미 로드되므로 응용 프로그램이 구성 요소 어셈블리를 공유할 때 이러한 이점을 활용할 수 있습니다. 응용 프로그램의 모든 어셈블리를 하드 디스크에서 로드해야 하는 콜드 시작은 하드 디스크 액세스 시간이 우선하므로 네이티브 이미지에서 만큼의 이점은 없습니다.

하드 바인딩은 주 응용 프로그램 어셈블리에 하드 바인딩된 모든 이미지를 동시에 로드해야 하므로 시작 시간에 영향을 줄 수 있습니다.

참고

강력한 이름의 구성 요소를 공유한 경우 그러한 구성 요소를 전역 어셈블리 캐시에 지정합니다. 로더는 전역 어셈블리 캐시에 없는 강력한 이름의 어셈블리에서 추가 유효성 검사를 수행하여 시작 시간에 네이티브 이미지를 사용하여 얻은 향상된 기능을 효율적으로 제거합니다.

어셈블리 기준 주소의 중요성

네이티브 이미지는 Windows PE 파일이므로 다른 실행 파일과 마찬가지로 기준 재지정 문제의 영향을 받습니다. 재배치를 위한 성능 비용은 하드 바인딩이 사용된 경우 훨씬 더 많이 듭니다.

네이티브 이미지에 대한 기준 주소를 설정하려면 컴파일러의 해당 옵션을 사용하여 어셈블리에 대한 기준 주소를 설정합니다. Ngen.exe는 네이티브 이미지에 이러한 기준 주소를 사용합니다.

참고

네이티브 이미지는 이미지를 만든 관리되는 어셈블리보다 큽니다. 이러한 크기를 허용할 수 있게 기준 주소를 계산해야 합니다.

dumpbin.exe와 같은 도구를 사용하여 네이티브 이미지의 기본 기준 주소를 볼 수 있습니다.

사용 고려 사항 요약

다음과 같은 일반적인 고려 사항 및 응용 프로그램 고려 사항은 응용 프로그램에 대한 네이티브 이미지 평가를 수행할지 여부를 결정하는 데 도움이 됩니다.

  • 네이티브 이미지를 로드할 때는 JIT 컴파일 및 형식 안전 확인과 같은 여러 가지 시작 동작이 필요하지 않으므로 MSIL보다 로드 속도가 빠릅니다.

  • JIT 컴파일러가 필요 없기 때문에 네이티브 이미지에 필요한 초기 작업 집합의 크기가 작습니다.

  • 네이티브 이미지를 사용하면 프로세스 간에 코드를 공유할 수 있습니다.

  • 네이티브 이미지에는 MSIL 어셈블리보다 하드 디스크 공간이 더 많이 필요하며 생성 시간이 오래 걸릴 수 있습니다.

  • 네이티브 이미지를 유지 관리해야 합니다.

    • 원본 어셈블리나 해당 종속성 중 하나가 서비스되는 경우 이미지를 다시 생성해야 합니다.

    • 한 어셈블리를 여러 응용 프로그램이나 여러 가지 시나리오에서 사용하려면 네이티브 이미지가 여러 개 필요할 수 있습니다. 예를 들어, 두 응용 프로그램에 구성 정보가 있으면 동일한 종속 어셈블리에 대해 여러 가지 바인딩 결정이 내려질 수 있습니다.

    • 네이티브 이미지는 관리자가 생성해야 합니다. 즉, Administrators 그룹의 Windows 계정을 사용하여 생성해야 합니다.

네이티브 이미지가 성능 이점을 제공하는지 여부를 결정할 때는 이러한 일반적인 고려 사항 외에 응용 프로그램의 특성을 고려해야 합니다.

  • 응용 프로그램이 여러 공유 구성 요소를 사용하는 환경에서 실행되면 네이티브 이미지를 사용하여 여러 프로세스에서 구성 요소를 공유할 수 있습니다.

  • 응용 프로그램이 여러 응용 프로그램 도메인을 사용하는 경우 네이티브 이미지를 사용하여 도메인 간에 코드 페이지를 공유할 수 있습니다.

    참고

    .NET Framework 버전 1.0 및 1.1에서는 응용 프로그램 도메인 간에 네이티브 이미지를 공유할 수 없습니다. 버전 2.0에서는 그렇지 않습니다.

  • 응용 프로그램이 터미널 서버에서 실행되면 네이티브 이미지를 사용하여 코드 페이지를 공유할 수 있습니다.

  • 일반적으로 규모가 큰 응용 프로그램은 네이티브 이미지로 컴파일하는 것이 좋습니다. 일반적으로 규모가 작은 응용 프로그램에는 유용하지 않습니다.

  • 장기 실행 응용 프로그램의 경우 런타임 JIT 컴파일이 네이티브 이미지보다 성능이 약간 더 좋습니다. 하드 바인딩을 사용하면 이러한 성능 차이를 어느 정도 줄일 수 있습니다.

하드 바인딩

하드 바인딩은 처리량을 늘리고 네이티브 이미지의 작업 집합 크기를 줄입니다. 하드 바인딩을 사용하지 않으면 어셈블리에 하드 바인딩된 이미지를 어셈블리가 로드될 때 모두 로드해야 합니다. 이렇게 하면 규모가 큰 응용 프로그램을 시작하는 데 시간이 오래 걸릴 수 있습니다.

하드 바인딩은 응용 프로그램의 성능이 중요한 모든 시나리오에 있어서 로드된 종속성에 적합합니다. 네이티브 이미지 사용 시와 마찬가지로 하드 바인딩이 응용 프로그램의 성능을 향상시키는지 여부를 확인하는 유일한 방법은 성능을 신중하게 측정하는 것입니다.

DependencyAttributeDefaultDependencyAttribute 특성을 사용하여 Ngen.exe에 하드 바인딩 힌트를 제공할 수 있습니다.

참고

이러한 특성은 명령이 아니라 Ngen.exe에 대한 힌트입니다. 이러한 특성을 사용한다고 해서 하드 바인딩이 보장되는 것은 아닙니다. 이러한 특성의 의미는 다음 릴리스에서 변경될 수 있습니다.

종속성에 대한 바인딩 힌트 지정

DependencyAttribute를 어셈블리에 적용하여 지정한 종속성이 로드될 가능성을 나타냅니다. System.Runtime.CompilerServices.LoadHint.Always는 하드 바인딩이 적합함을, Default는 종속성에 대한 기본값을 사용해야 함을, Sometimes는 하드 바인딩이 적합하지 않음을 나타냅니다.

아래 코드에서는 두 개의 종속성이 있는 어셈블리에 대한 특성을 보여 줍니다. 첫 번째 종속성(Assembly1)은 하드 바인딩에 적합한 후보이며 두 번째 종속성(Assembly2)은 적합하지 않은 후보입니다.

Imports System.Runtime.CompilerServices
<Assembly:DependencyAttribute("Assembly1", LoadHint.Always)>
<Assembly:DependencyAttribute("Assembly2", LoadHint.Sometimes)>
using System.Runtime.CompilerServices;
[assembly:DependencyAttribute("Assembly1", LoadHint.Always)]
[assembly:DependencyAttribute("Assembly2", LoadHint.Sometimes)]
using namespace System::Runtime::CompilerServices;
[assembly:DependencyAttribute("Assembly1", LoadHint.Always)];
[assembly:DependencyAttribute("Assembly2", LoadHint.Sometimes)];

어셈블리 이름에는 파일 이름 확장명이 없습니다. 표시 이름을 사용할 수 있습니다.

어셈블리에 대한 기본 바인딩 힌트 지정

기본 바인딩 힌트는 어셈블리에 대한 종속성이 있는 응용 프로그램이 즉시 자주 사용하는 어셈블리에만 필요합니다. 하드 바인딩을 사용하도록 지정할 이러한 어셈블리에 DefaultDependencyAttribute를 사용하여 System.Runtime.CompilerServices.LoadHint.Always를 적용합니다.

참고

System.Runtime.CompilerServices.LoadHint.Always 이외의 값이 있는 특성을 적용하면 특성을 전혀 적용하지 않았을 때와 효과가 동일하므로 이 범주에 속하지 않는 .dll 어셈블리에 DefaultDependencyAttribute를 적용할 이유는 없습니다.

Microsoft는 DefaultDependencyAttribute를 사용하여 하드 바인딩이 mscorlib.dll과 같은 .NET Framework의 소수 어셈블리에 대한 기본값이 되도록 지정합니다.

문제 해결

네이티브 이미지를 응용 프로그램이 현재 사용 중인지 확인하려면 어셈블리 바인딩 로그 뷰어(Fuslogvw.exe)를 사용합니다. 바인딩 로그 뷰어 창의 로그 범주 상자에서 네이티브 이미지를 선택합니다. Fuslogvw.exe는 네이티브 이미지를 거부하는 이유에 대한 정보를 제공합니다.

JitCompilationStart MDA(관리 디버깅 도우미)를 사용하여 JIT 컴파일러가 함수 컴파일을 시작하는 시기를 결정할 수 있습니다.

처리 지연

규모가 큰 응용 프로그램의 네이티브 이미지를 생성하는 데 시간이 많이 걸릴 수 있습니다. 마찬가지로 공유 구성 요소를 변경하거나 컴파일러 설정을 변경하려면 업데이트할 네이티브 이미지가 여러 개 필요합니다. installupdate 동작에는 네이티브 이미지 서비스가 지연된 실행에 대한 작업을 큐에 대기시키는 /queue가 있습니다. 또한 Ngen.exe에는 서비스를 일부 제어하는 queueexecuteQueuedItems 동작이 있습니다. 자세한 내용은 네이티브 이미지 서비스를 참조하십시오.

네이티브 이미지 및 JIT 컴파일

Ngen.exe는 어셈블리에서 생성할 수 없는 메서드를 발견하면 네이티브 이미지에서 이를 제외합니다. 런타임에서 이 어셈블리를 실행할 때 네이티브 이미지에 포함되지 않은 메서드에 대한 JIT 컴파일로 되돌아갑니다.

또한 어셈블리가 업그레이드되지 않았거나 이미지가 어떤 이유로 무효화된 경우 네이티브 이미지가 사용되지 않습니다.

잘못된 이미지

Ngen.exe를 사용하여 어셈블리의 네이티브 이미지를 만드는 경우 출력은 사용자가 지정한 명령줄 옵션 및 컴퓨터의 특정 설정에 따라 달라지는데 다음 설정이 포함됩니다.

  • .NET Framework 버전

  • Windows 9x 제품군에서 Windows NT 제품군으로 변경되는 경우 운영 체제의 버전

  • 어셈블리의 정확한 ID(다시 컴파일하면 ID가 변경됨)

  • 어셈블리에서 참조하는 모든 어셈블리의 정확한 ID(다시 컴파일하면 ID가 변경됨)

  • 보안 요소

Ngen.exe는 네이티브 이미지를 생성할 때 이 정보를 기록합니다. 어셈블리를 실행하는 경우 런타임은 컴퓨터의 현재 환경과 일치하는 옵션 및 설정을 사용하여 생성된 네이티브 이미지를 찾고 일치하는 네이티브 이미지를 찾지 못하는 경우 어셈블리의 JIT 컴파일로 되돌립니다. 다음과 같이 컴퓨터 설정과 환경을 변경하면 네이티브 이미지를 사용할 수 없게 됩니다.

  • .NET Framework 버전

    .NET Framework에 업데이트를 적용하면 Ngen.exe를 사용하여 만든 네이티브 이미지를 모두 사용할 수 없게 됩니다. 따라서 .NET Framework의 모든 업데이트는 Ngen Update 명령을 실행하여 네이티브 이미지가 모두 다시 생성되도록 합니다. .NET Framework는 설치한 .NET Framework 라이브러리에 대한 새로운 네이티브 이미지를 자동으로 만듭니다.

  • Windows 9x 제품군에서 Windows NT 제품군으로 변경되는 경우 운영 체제의 버전

    예를 들어, 컴퓨터에서 실행되는 운영 체제 버전이 Windows 98에서 Windows XP로 변경되면 네이티브 이미지 캐시에 저장되어 있는 모든 네이티브 이미지를 사용할 수 없게 됩니다. 그러나 운영 체제가 Windows 2000에서 Windows XP로 변경되면 이미지가 무효화되지 않습니다.

  • 어셈블리의 정확한 ID

    어셈블리를 다시 컴파일하면 어셈블리의 해당하는 네이티브 이미지를 사용할 수 없게 됩니다.

  • 어셈블리에서 참조하는 모든 어셈블리의 정확한 ID

    관리되는 어셈블리를 업데이트하면 해당 어셈블리에 직접 또는 간접적으로 종속된 네이티브 이미지가 모두 사용할 수 없게 되므로 다시 생성해야 합니다. 여기에는 일반 참조와 하드 바인딩된 종속성이 모두 포함됩니다. 소프트웨어 업데이트가 적용될 때마다 설치 프로그램에서 Ngen Update 명령을 실행하여 종속된 네이티브 이미지가 모두 다시 생성되도록 해야 합니다.

  • 보안 요소

    어셈블리에 이전에 부여되었던 사용 권한을 제한하도록 컴퓨터 보안 정책을 변경하면 해당 어셈블리에 대해 이전에 컴파일한 네이티브 이미지를 사용하지 못할 수 있습니다.

    공용 언어 런타임이 코드 액세스 보안을 관리하는 방법과 권한 사용 방법에 대한 자세한 내용은 코드 액세스 보안을 참조하십시오.

예제

다음 명령은 현재 디렉터리에 있는 ClientApp.exe에 대한 네이티브 이미지를 생성하고 그 이미지를 네이티브 이미지 캐시에 저장합니다. 어셈블리에 대해 구성 파일이 존재하는 경우 Ngen.exe는 해당 파일을 사용합니다. 또한 ClientApp.exe에서 참조하는 모든 DLL에 대한 네이티브 이미지가 생성됩니다.

ngen install ClientApp.exe

Ngen.exe로 설치된 이미지를 루트라고도 합니다. 루트는 응용 프로그램 또는 공유 구성 요소일 수 있습니다.

다음 명령은 지정된 경로를 사용하여 MyAssembly.exe의 네이티브 이미지를 생성합니다.

ngen install c:\myfiles\MyAssembly.exe

어셈블리 및 해당 종속성을 찾을 때 Ngen.exe는 공용 언어 런타임에서 사용한 검색 논리를 사용합니다. 기본적으로 ClientApp.exe가 포함된 디렉터리는 응용 프로그램 기본 디렉터리로 사용되며 모든 어셈블리 검색은 이 디렉터리에서 시작됩니다. /AppBase 옵션을 사용하여 이 동작을 재지정할 수도 있습니다.

참고

이것은 응용 프로그램 기준이 현재 디렉터리로 설정된 .NET Framework 버전 1.0 및 1.1의 Ngen.exe 동작이 바뀐 것입니다.

예를 들어, 어셈블리에서 System.Reflection.Assembly.Load 메서드를 사용하여 .dll 파일을 로드하면 종속성이 참조 없이 어셈블리에 포함될 수 있습니다. /ExeConfig 옵션을 사용하는 경우 응용 프로그램 어셈블리에 대한 구성 정보를 사용하여 그러한 .dll 파일의 네이티브 이미지를 만들 수 있습니다. 다음 명령은 MyApp.exe에서 구성 정보를 사용하여 MyLib.dll,의 네이티브 이미지를 생성합니다.

ngen install c:\myfiles\MyLib.dll /ExeConfig:c:\myapps\MyApp.exe

이런 식으로 설치한 어셈블리는 응용 프로그램을 제거해도 제거되지 않습니다.

종속성을 제거하려면 해당 어셈블리를 설치할 때 사용한 것과 동일한 명령줄 옵션을 사용합니다. 다음 명령은 이전 예제에서 MyLib.dll을 제거합니다.

ngen uninstall c:\myfiles\MyLib.dll /ExeConfig:c:\myapps\MyApp.exe

전역 어셈블리 캐시에 어셈블리에 대한 네이티브 이미지를 만들려면 어셈블리의 표시 이름을 사용합니다. 예를 들어, 다음과 같습니다.

ngen install "ClientApp, Version=1.0.0.0, Culture=neutral, 
  PublicKeyToken=3c7ba247adcd2081, processorArchitecture=MSIL"

NGen.exe는 설치하는 각 시나리오마다 별도의 이미지 집합을 생성합니다. 예를 들어, 다음 명령은 일반적인 작업을 위한 네이티브 이미지의 전체 집합, 디버깅을 위한 또다른 전체 집합 및 프로파일링을 위한 집합을 설치합니다.

ngen install MyApp.exe
ngen install MyApp.exe /debug
ngen install MyApp.exe /profile

네이티브 이미지 캐시 표시

네이티브 이미지가 캐시에 설치되면 Ngen.exe를 사용하여 해당 이미지를 표시할 수 있습니다. 다음 명령은 네이티브 이미지 캐시의 네이티브 이미지를 모두 표시합니다.

ngen display

display 작업은 먼저 루트 어셈블리를 모두 나열한 다음 모든 네이티브 이미지 목록을 나열합니다.

어셈블리의 단순한 이름을 사용하여 해당 어셈블리에 대한 정보만 표시합니다. 다음 명령은 부분 이름 MyAssembly에 일치하는 네이티브 이미지 캐시의 모든 네이티브 이미지, 해당 종속성, MyAssembly에서 종속성을 갖는 모든 루트를 표시합니다.

ngen display MyAssembly

공유 구성 요소 어셈블리에 의존하는 루트를 알고 있는 것이 공유 구성 요소가 업그레이된 후 update 작업의 영향을 측정하는 데 유용합니다.

어셈블리의 파일 확장명을 지정하는 경우 어셈블리가 포함된 디렉터리에서 경로를 지정하거나 Ngen.exe를 실행해야 합니다.

ngen display c:\myApps\MyAssembly.exe

다음 명령은 네이티브 이미지 캐시에서 이름이 MyAssembly이고 버전이 1.0.0.0인 모든 네이티브 이미지를 표시합니다.

ngen display "myAssembly, version=1.0.0.0"

이미지 업데이트

이미지는 일반적으로 공유 구성 요소가 업그레이드된 후에 업데이트됩니다. 변경되었거나 종속성이 변경된 네이티브 이미지를 모두 업데이트하려면 인수 없이 update 작업을 사용합니다.

ngen update

모든 이미지를 업데이트하려면 시간이 많이 걸릴 수 있습니다. /queue 옵션을 사용하여 네이티브 이미지 서비스에서 실행할 업데이트를 큐에 대기시킬 수 있습니다. /queue 옵션 및 설치 우선 순위에 대한 자세한 내용은 네이티브 이미지 서비스를 참조하십시오.

ngen update /queue

이미지 제거

Ngen.exe가 종속성 목록을 유지 관리하므로 공유 구성 요소는 공유 구성 요소에 의존하는 모든 어셈블리가 제거된 경우에만 제거됩니다. 또한 공유 구성 요소는 루트로 설치된 경우 제거되지 않습니다.

다음 명령은 루트 ClientApp.exe에 대한 시나리오를 모두 제거합니다.

ngen uninstall ClientApp

uninstall 동작은 특정 시나리오를 제거할 때 사용할 수 있습니다. 다음 명령은 ClientApp.exe에 대한 모든 디버그 시나리오를 제거합니다.

ngen uninstall ClientApp /debug

참고

/debug 시나리오를 제거해도 /profile/debug가 모두 포함된 시나리오는 제거되지 않습니다.

다음 명령은 ClientApp.exe의 특정 버전에 대한 시나리오를 모두 제거합니다.

ngen uninstall "ClientApp, Version=1.0.0.0"

다음 명령은 "ClientApp, Version=1.0.0.0, Culture=neutral, PublicKeyToken=3c7ba247adcd2081, processorArchitecture=MSIL"에 대한 모든 시나리오 또는 해당 어셈블리에 대한 디버그 시나리오만 제거합니다.

ngen uninstall "ClientApp, Version=1.0.0.0, Culture=neutral, 
  PublicKeyToken=3c7ba247adcd2081, processorArchitecture=MSIL"
ngen uninstall "ClientApp, Version=1.0.0.0, Culture=neutral, 
  PublicKeyToken=3c7ba247adcd2081, processorArchitecture=MSIL" /debug

install 동작과 마찬가지로 확장명을 제공하려면 어셈블리가 포함된 디렉터리에서 Ngen.exe를 실행하거나 전체 경로를 지정해야 합니다.

네이티브 이미지 서비스에 대한 예제를 보려면 네이티브 이미지 서비스를 참조하십시오.

참고 항목

참조

.NET Framework 도구
SDK 명령 프롬프트

개념

네이티브 이미지 서비스
MSIL을 네이티브 코드로 컴파일
런타임에서 어셈블리를 찾는 방법