이호원 airtaxi

Windows를 좋아해서 C#과 .NET을 시작했고,
지금은 WinUI와 Uno Platform으로 Windows 앱을 만듭니다.

이 발표에서 다루는 내용

오늘의 순서

AT Installer 개발 과정

2023년 12월부터 2026년 10월까지, 커밋 198개

자체 인스톨러는 모든 것을 직접 관리해야 했습니다

이 발표에서 말하는 샌드박스는 파일과 레지스트리 가상화입니다

앱의 권한을 제한하는 AppContainer 격리와는 다릅니다. 그래도 설치와 제거를 관리하는 데는 가상화만으로 충분합니다.

자체 인스톨러에서 InstalledFiles로 직접 추적하던 일을 이제 운영체제가 처리합니다.

앱 설치 관리자와 PowerShell 모두 같은 이유로 실패합니다

앱 설치 관리자에서 더블클릭, 설치 버튼 비활성화

Add-AppxPackage .\DemoApp.msix

설치하려면 사용자가 이 단계를 직접 거쳐야 합니다

공인 인증서를 사면 되지 않을까요?

기본 NSIS 인스톨러로 설치한 뒤 제거해 보겠습니다

실행앱을 실행하면 WebView2 데이터 폴더가 생깁니다

제거 후앱 폴더는 사라졌지만 데이터 폴더는 남았습니다

같은 앱을 MSIX로 패키징하고 Installer-arm64.exe로 설치합니다

1. 설치 화면

이름, 게시자, 아이콘은 패키지 매니페스트에서 읽어 옵니다. 인증서 등록, 개발자 모드 설정, PowerShell 실행은 사용자가 할 필요가 없습니다.

2. UAC 승인 후 설치 진행

3. 설치 완료, 몇 초 뒤 자동 종료

설치된 앱은 시작 메뉴에 등록되고, 데이터는 패키지 전용 위치에 저장됩니다

시작 메뉴일반 앱처럼 검색되고 실행됩니다

한 번 실행하고 닫은 뒤원래 경로에는 폴더가 생기지 않았습니다

앱은 %LOCALAPPDATA%\com.demo.tauridemo에 쓰지만, 실제 파일은 Packages\TauriDemo_…\LocalCache\Local 아래에 저장됩니다.

앱을 제거하면 데이터도 함께 삭제됩니다

제거시작 메뉴에서 바로 제거

제거 후패키지 폴더가 삭제되었습니다

NSIS와 달리 남은 데이터 폴더가 없습니다

NSIS와 MSIX의 제거 결과 비교

두 경우 모두 앱 코드는 같습니다. MSIX로 설치하면 운영체제가 쓰기 경로를 패키지 전용 위치로 리디렉션합니다.

더블클릭부터 설치 완료까지

설치 화면의 앱 이름, 아이콘, 버전은 패키지 안의 매니페스트에서 읽어 옵니다.

EXE 인스톨러는 SFX 모듈, 설정, 압축 파일을 이어 붙여 만듭니다

rem SFX 모듈 + 실행 설정 + 압축 파일 = 단일 EXE
copy /b 7zS.sfx + config_x64.txt + Archive.7z Installer-x64.exe

;!@Install@!UTF-8!
RunProgram="Installer.exe Package.msixbundle"
;!@InstallEnd@!

// SFX가 작업 디렉터리를 바꾸므로 절대 경로로 고정
var packageFilePath = Path.GetFullPath(args[1]);

설치기는 패키지 확장자에 따라 처리 흐름을 나눕니다

var isSilent = args.Contains("/silent", StringComparer.OrdinalIgnoreCase);
var shouldAutoInstall = args.Contains("/install", StringComparer.OrdinalIgnoreCase);

// Dispatch to the appropriate window based on package file extension
var extension = Path.GetExtension(packageFilePath).ToLowerInvariant();
if (extension == ".msix" || extension == ".msixbundle")
    _window = new MsixInstallerWindow(packageFilePath, isSilent, shouldAutoInstall);
else _window = new InstallerWindow(packageFilePath, isSilent, shouldAutoInstall);

1단계: 관리자 권한으로 자신을 다시 실행합니다

public static bool IsRunningAsAdministrator()
{
    using var identity = WindowsIdentity.GetCurrent();
    return new WindowsPrincipal(identity).IsInRole(WindowsBuiltInRole.Administrator);
}

public static void RelaunchElevatedPreservingArguments()
{
    var arguments = string.Join(' ', Environment.GetCommandLineArgs().Skip(1)
        .Select(arg => arg.Contains(' ') ? $"\"{arg}\"" : arg));
    if (!arguments.Contains("/install", StringComparison.Ordinal)) arguments += " /install";

    try { Process.Start(new ProcessStartInfo { FileName = Environment.ProcessPath, Arguments = arguments,
                                           Verb = "runas", UseShellExecute = true }); }
    catch { }
    Environment.Exit(0);
}

/install 인자가 있으면 다시 실행된 설치기가 사용자 입력 없이 설치를 진행합니다.

2단계: 패키지 서명에서 인증서를 꺼내 신뢰 저장소에 등록합니다

#pragma warning disable SYSLIB0057
var signerCertificate = new X509Certificate2(X509Certificate.CreateFromSignedFile(packageFilePath));
#pragma warning restore SYSLIB0057

using var store = new X509Store(StoreName.Root, StoreLocation.LocalMachine);
store.Open(OpenFlags.ReadWrite);
var existing = store.Certificates.Find(X509FindType.FindByThumbprint, signerCertificate.Thumbprint, false);
if (existing.Count == 0) store.Add(signerCertificate);

3단계: 개발자 모드를 켜고, 설치가 끝나면 원래 값으로 되돌립니다

int? originalDeveloperModeState = null;
try
{
    originalDeveloperModeState = DeveloperModeHelper.BackupDeveloperModeState();
    bool developerModeEnabled = DeveloperModeHelper.TryEnableDeveloperMode();
    // 버전 비교, 배포 ...
}
finally
{
    if (originalDeveloperModeState.HasValue)
        DeveloperModeHelper.TryRestoreDeveloperModeState(originalDeveloperModeState.Value);
}

4단계: 이미 설치된 버전과 비교합니다

var packageManager = new PackageManager();
foreach (var package in packageManager.FindPackagesForUser(string.Empty))
{
    if (package.Id.Name != metadata.Name) continue;
    // package.Id.Version을 System.Version으로 바꿔 패키지 버전과 비교
}

5단계: AddPackageAsync로 패키지를 배포합니다

public static async Task<MsixDeploymentResult> AddPackageAsync(string packageFilePath, IProgress<DeploymentProgress> progress)
{
    var packageManager = new PackageManager();
    var packageUri = new Uri(packageFilePath);
    var deploymentOperation = packageManager.AddPackageAsync(packageUri, null, DeploymentOptions.ForceApplicationShutdown);

    try { await deploymentOperation.AsTask(progress); }
    catch (Exception exception)
    {
        return new MsixDeploymentResult { IsSuccessful = false, ErrorText = exception.Message, ... };
    }

    // 완료 상태와 오류 코드를 MsixDeploymentResult로 정리해 반환
}

콘솔 앱이나 WPF 앱에서도 PackageManager를 호출할 수 있습니다

<TargetFramework>net10.0-windows10.0.26100.0</TargetFramework>

silent 모드에서는 설치 결과를 종료 코드로 반환합니다

RunProgram="Installer.exe Package.msix /silent"

MSIX 인스톨러 생성기의 두 가지 사용 방법

MSIX 패키징 1단계: 인증서 생성

게시자이름만 입력하면 CN=이름 형식으로 변환

유효 기간기본 1825일(5년)

비밀번호비워 두면 기본값 password

재사용하는 이유같은 인증서로 계속 서명해야 사용자가 버전마다 새 인증서를 신뢰하지 않아도 됩니다

2단계: 매니페스트 작성

표시 이름, 설명시작 메뉴와 설정 앱에 보이는 정보

실행 파일 이름폴더마다 이 파일을 찾아 아키텍처를 감지합니다

로고선택 사항, 설치 화면과 시작 메뉴 아이콘

.aticmsixconfig버전과 인증서를 뺀 정보만 담아 릴리스마다 재사용합니다

3단계: 버전과 빌드 출력을 지정해 패키징

매니페스트2단계에서 저장한 파일을 불러옵니다

인증서1단계의 PFX, 비우면 이번만 쓸 임시 인증서

버전실행 파일의 파일 버전으로 자동으로 채웁니다

출력 폴더아키텍처별 빌드 폴더를 추가하면 하나면 .msix, 여럿이면 .msixbundle

EXE 패키징 탭은 MSIX의 패키지 정보를 읽어 표시합니다

패키지 정보이름, 표시 이름, 버전, 게시자를 매니페스트에서 읽습니다

아키텍처번들에 든 아키텍처만 고를 수 있습니다. 이 번들에는 x86이 없습니다

생성하나를 고르면 EXE, 둘 이상이면 아키텍처별 EXE를 담은 ZIP

생성기 자체도 MSIX로 만들어 Microsoft Store에서 배포합니다

언어영어, 한국어, 일본어, 중국어 간체와 번체

테마시스템 기본, 밝게, 어둡게

업데이트Microsoft Store 업데이트를 주기적으로 확인하고 알림

받는 곳Microsoft Store에서 무료, 소스는 GitHub에 공개

실행 파일의 PE 헤더로 아키텍처를 판별합니다

stream.Seek(PeOffsetLocation, SeekOrigin.Begin);  // 0x3C
var peOffset = reader.ReadInt32();

stream.Seek(peOffset, SeekOrigin.Begin);
var peSignature = reader.ReadUInt32();
if (peSignature != PeSignature) return "Unknown";

var machine = reader.ReadUInt16();
return machine switch
{
    0x8664 => "x64",
    0x014C => "x86",
    0xAA64 => "ARM64",
    _ => "Unknown"
};

MSIX는 ZIP 형식이고, 번들 안에는 아키텍처별 MSIX가 들어 있습니다

App.msixbundle
├─ AppxMetadata/
│  └─ AppxBundleManifest.xml   이름, 게시자, 버전, 아키텍처 목록
├─ App_x64.msix
│  ├─ AppxManifest.xml         표시 이름, 게시자 표시 이름
│  └─ Assets/
│     └─ StoreLogo.scale-400.png 가장 큰 scale을 아이콘으로
├─ App_arm64.msix
└─ App_x86.msix

MSIX 패키징은 WinApp CLI로 처리합니다

winapp.exe pack x64 ARM64 --executable MyApp.exe --cert cert.pfx --cert-password "********"

MSIX를 아키텍처별 EXE로 조립합니다

빌드 출력에서 인스톨러를 만드는 명령

# 한 번만: 설치와 인증서 생성
dotnet tool install --global aticmsixgen
aticmsixgen cert generate --publisher "Demo" --output cert.pfx

# 릴리스마다
dotnet publish -c Release -r win-x64 -o out\x64
dotnet publish -c Release -r win-arm64 -o out\arm64
aticmsixgen msix-quick-pack --display-name "Demo App" --description "Demo" --executable "DemoApp.exe" `
    -f out\x64 -f out\arm64 --cert E:\Demo\cert.pfx --version 1.0.0.0 -o Demo.msixbundle
aticmsixgen exe-pack -i Demo.msixbundle -a arm64 -o Installer-arm64.exe

msix-quick-pack 실행 결과

• 두 폴더의 DemoApp.exe에서 ARM64와 x64를 자동으로 감지합니다.
• 아키텍처마다 매니페스트를 만들고 패키지를 하나씩 만듭니다.
• 두 패키지를 .msixbundle로 묶고 인증서로 서명합니다.
• 사용자가 지정한 것은 빌드 출력 폴더와 인증서 파일입니다.

exe-pack 실행 결과

GUI에서 공통 코드를 떼어 CLI와 나눠 씁니다

UI에 묶인 코드는 서비스에 남기고, 파일과 프로세스만 다루는 코드는 대상 프레임워크가 net10.0인 라이브러리로 옮겼습니다. 그래서 CLI가 Windows App SDK 없이 빌드됩니다.

NativeAOT로 가려면 리플렉션을 걷어내야 했습니다

.NET 10부터 NativeAOT 실행 파일을 dotnet tool로 배포할 수 있습니다

<PublishAot>true</PublishAot>
<RuntimeIdentifiers>win-x86;win-x64;win-arm64</RuntimeIdentifiers>
<ToolPackageRuntimeIdentifiers>$(RuntimeIdentifiers)</ToolPackageRuntimeIdentifiers>
<PackAsTool>true</PackAsTool>
<ToolCommandName>aticmsixgen</ToolCommandName>

dotnet tool install --global aticmsixgen

csproj 버전을 올려 push하면 NuGet에 자동으로 게시됩니다

runs-on: windows-latest
# ...
dotnet pack MsixInstallerComposerCommandLine.csproj -c Release -p:ContinuousIntegrationBuild=true
dotnet pack MsixInstallerComposerCommandLine.csproj -c Release -p:Platform=$platform   # x86, x64, ARM64

데모 2의 명령을 같은 워크플로에 넣으면 앱 릴리스마다 인스톨러가 함께 만들어집니다.

정리

소스 코드github.com/airtaxi/
AT-Installer

GUI 생성기Microsoft Store
MSIX 인스톨러 생성기

CLIdotnet tool install
-g aticmsixgen