주의 (Caution)

많은/모든 업데이트 채널에서 출시된 최근 몇 번의 Windows 업데이트가(7월부터 시작된 문제) 많은 사용자들의 WSA 설치를 깨뜨리고 있는 것으로 보입니다!

또는

팁 (Tip)

GApps 문제 : LSPosed/MagiskOnWSALocal#595****폴더 문제 : WSA 폴더의 긴 폴더 이름(MagiskOnWSALocal 스크립트에 의해 자동 생성됨)은 WSA가 시작되지 않는 원인이 될 수 있습니다. WSA를 압축 해제한 후 설치하기 전에 폴더 이름을WSA로 변경하세요.#154설치된 Magisk 모듈이 설치 및 이후 재부팅 후 사라짐 (WSA v2307):**

| WSA 버전: | ||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| v2210.40000.7.0 | ✅ | ✅ | ||||||||||||||||||
| ... |v2308.40000.2.0 |
문서 및 빌드 스크립트(MagiskOnWSALocal)를 조정할 시간을 확보하기 위해 업데이트를 건너뛰었습니다. 불편을 드려 죄송합니다. 이후 업데이트는 정상적으로 재개될 것입니다. |
|||||||||||||||||||
| v2308.40000.3.0 | ✅ | ✅ | ||||||||||||||||||
| v2309.40000.2.0 | ✅ | ✅ | ||||||||||||||||||
v2309.40000.4.0 to 2310.40000.1.0 and 2311.40000.3.0 |
"GitHub 리포지토리를 시작한 이후로 사용해 온 저의 Linux 서버에서 GitHub Actions로 전환할 시간을 확보하기 위해 업데이트를 건너뛰었습니다. 이번이 아마도 마지막 중단이 될 것이니 안심하십시오. 다시 한번 사과드리며, 이 리포지토리를 사용해 주셔서 감사합니다." MustardChef |
|||||||||||||||||||
| v2310.40000.2.0 | ✅ | ✅ | ||||||||||||||||||
| v2311.40000.4.0 | ✅ | ✅ | ||||||||||||||||||
| ... |
| 지표 키 (Indicator Keys) | |||
|---|---|---|
| ✅ | 안정적 (Stable) | 모든 것이 의도한 대로 작동합니다. 빌드가 안정적이지 않다고 생각되면 GitHub Issue를 열거나 저희 Discord에 문제를 보고해 주세요 |
|
| 불안정 (Unstable) | 알려진 버그나 문제로 인해 경험이 매끄럽지 않을 수 있습니다 | 자세한 정보는 이모지를 클릭하세요 |
|
| ⛔ | 작동 안 함 (Not Working) | 빌드가 작동하지 않습니다. 다운로드하지 마세요! | 자세한 정보는 이모지를 클릭하세요 |
| ➖ | 아직 정보 없음 (No Information Yet) | 상태를 확인하기 위한 정보가 충분하지 않습니다.

Discord에 참여하여 빌드가 작동하는지 여부를 확인해 주세요. |

운영 체제 (Operating System)	다운로드 페이지 (Download Page)

| Windows™ 11: 빌드 (Build) 22000.526 이상. | Windows™ 10: 22H2 10.0.19045.2311 이상. Windows™ 10: 20H1 10.0.19041.264 이상에서도 작동할 수 있습니다.11. 이러한 이전 버전의 Windows 10 빌드에서 WSA를 사용하려면 KB5014032를 설치한 다음 KB5022834를 설치해야 할 수도 있습니다. |
| |
| |
| CPU 아키텍처 (Architecture): x86_64 또는 arm64 |
| |
| PC는 Windows™ 11의 기본 요구 사항(예: Core i3 8세대, Ryzen 3000, Snapdragon 8c 이상)을 충족해야 합니다 | 해당 사항 없음 (N/A). 이는 다소 복불복일 수 있으나, 프로세서가 Windows 11 요구 사항의 지원 CPU 목록에 포함되어 있는 것을 강력히 권장합니다 |
| |
| 호환 가능한 모든 Intel, AMD 또는 Nvidia GPU. GPU 성능은 Windows Subsystem For Android™와의 호환성에 따라 달라질 수 있습니다. ## Intel HD Graphics 530 및 이전 세대 iGPU를 사용하는 경우 WSA가 시작되지 않거나 그래픽 글리치 (Graphical Glitches)가 발생할 수 있습니다. 이는 알려진 문제이지만, 불행히도 현재 제가 알고 있는 해결 방법은 없습니다. 또한, 이러한 GPU는 너무 오래되어 Windows 11 요구 사항을 충족하지 않으므로 공식적으로 지원되지 않습니다. 이 가이드를 따라 보유 중인 다른 iGPU/dGPU/eGPU 또는 Microsoft Basic Renderer로 전환하십시오. ## Nvidia GPU는 문제를 일으키는 것으로 알려져 있습니다. Nvidia GPU를 사용할 때 Windows Subsystem For Android™가 시작되지 않거나 그래픽 글리치가 발생하는 경우, 이 가이드를 따라 보유 중인 다른 iGPU/dGPU/eGPU 또는 Microsoft Basic Renderer로 전환하십시오. |
| |
| 솔리드 스테이트 드라이브 (SSD) (권장) 또는 하드 디스크 드라이브 (HDD) (권장하지 않음) |
| |
| 최소 저장 공간 요구 사항: 시스템 드라이브 (C:)에 최소 10GB 이상의 여유 공간이 있어야 합니다 |
| |
| NTFS 전용: Windows Subsystem For Android™는 exFAT 파티션이 아닌 NTFS 파티션에만 설치할 수 있습니다 |
| |
| 가상 머신 플랫폼 (Virtual Machine Platform) 활성화됨 | |
| Windows 하이퍼바이저 플랫폼 (Windows Hypervisor Platform) 활성화됨 | |
이러한 선택적 설정은 가상화(Virtualization)를 위한 것이며 WSA를 실행하는 데 필요한 구성 요소를 제공합니다.

키보드에서 Windows Key + R을 누르고 상자에 "OptionalFeatures.exe"를 입력한 뒤, Enter를 누르고 위의 기능들을 선택한 다음 적용(Apply)을 눌러 이러한 설정들을 활성화할 수 있습니다. |
||
| 컴퓨터는 가상화(Virtualization)를 지원해야 하며, BIOS/UEFI 및 선택적 기능(Optional Features)에서 활성화되어 있어야 합니다. |

중요

Google Apps (GApps)가 포함된 빌드에는 Magisk가 기본적으로 포함되어 있습니다:

• Windows 11 x64

• Windows 10 x64

(Magisk가 기본적으로 포함되는 것을 원하지 않는 경우) (릴리스에는 Magisk 빌드가 포함되지 않습니다)

• Windows 11 x64
• Windows 10 x64

팁

"Microsoft는 Windows Subsystem for Android™️ (WSA)에 대한 지원을 종료합니다. 그 결과, Windows의 Amazon Appstore와 WSA에 의존하는 모든 애플리케이션 및 게임은 2025년 3월 5일부터 더 이상 지원되지 않습니다."

WSABuilds는 WSA 버전 ≥ 2311.40000.5.0에 대해 LTS (Long Term Support) 단계에 진입했으며, Magisk 버전, KernelSU 버전 및 GApps 버전은 새로운 릴리스를 통해 최신 상태로 유지될 것입니다.

이 리포지토리(Repo)는 아카이브되지 않을 것이며, 이 리포지토리에서 WSA Builds를 설치하는 모든 사용자에게 지원이 계속 제공될 것입니다. 이 리포지토리를 사용해 주시고 제 작업을 지원해 주신 모든 분께 감사드리며, 이 커뮤니티에 기여할 수 있어 즐거웠습니다.

WSA 및 WSABuilds의 향후 변경 사항을 통지받으려면 이 리포지토리의 업데이트를 반드시 계속 확인하시기 바랍니다.

2025년 6월 2일 월요일

현재 이용 가능 (Downloads의 Stable release 버튼을 통해)

2025년 6월 2일 월요일

현재 이용 가능 (Downloads의 Pre-release 버튼을 통해)

2024년 12월 9일 월요일

현재 이용 가능 (Downloads의 Stable release 버튼을 통해)

2024년 12월 9일 월요일

현재 이용 가능 (Downloads의 Pre-release 버튼을 통해)

2024년 12월 5일 목요일

현재 이용 가능 (Downloads의 Stable release 버튼을 통해)

2024년 12월 5일 목요일

현재 이용 가능 (Downloads의 Pre-release 버튼을 통해)

2024년 7월 15일 월요일

현재 이용 가능 (Downloads의 Pre-release 버튼을 통해)

2024년 6월 3일 월요일

현재 이용 가능 (Downloads의 Pre-release 버튼을 통해)

2024년 5월 3일 금요일

현재 이용 가능 (Downloads의 Pre-release 버튼을 통해)

2024년 4월 3일 수요일

현재 이용 가능 (Downloads의 Pre-release 버튼을 통해)

[!NOTE]

공식 Windows Subsystem For Android™가 설치되어 있는 경우, MagiskOnWSA를 사용하려면 이를 완전히 삭제해야 합니다.

[!IMPORTANT]

이전 설치 버전(공식 버전 또는 MagiskOnWSA)의 데이터를 보존하고자 하는 경우, 삭제하기 전에 다음 위치에 있는 Userdata.vhdx를 백업하고 설치 후에 이를 복구할 수 있습니다.

%LOCALAPPDATA%\Packages\MicrosoftCorporationII.WindowsSubsystemForAndroid_8wekyb3d8bbwe\LocalCache\userdata.vhdx

이 프로세스에 대한 가이드는 이 README의 아래쪽에 위치해 있습니다.

• Releases 페이지로 이동합니다.
• 최신 릴리스(latest release)에서 Assets 섹션으로 이동하여 원하는 버전의 Windows Subsystem For Android™를 다운로드합니다 (

cd "{X:\path\to\your\extracted\folder}"

아래 명령어를 입력하고 엔터를 누르세요

PowerShell.exe -ExecutionPolicy Bypass -File .\Install.ps1

스크립트가 실행되며 Windows Subsystem For Android™가 설치됩니다

이 우회 방법(workaround)이 작동하지 않는다면, 귀하의 PC는 WSA를 지원하지 않는 것입니다

설치 프로세스가 완료되면 Windows Subsystem For Android™가 실행됩니다 (만약 처음 설치하는 경우, 진단 정보 제공에 동의를 구하는 창이 대신 나타납니다. 때때로 동일한 창이 두 개 나타날 수 있으나, 이는 정상이며 두 창 모두에서 OK를 클릭해도 아무런 문제가 발생하지 않습니다)

PowerShell 창을 클릭한 다음 키보드의 아무 키나 누르면 PowerShell 창이 닫혀야 합니다

파일 탐색기를 닫으세요

즐겁게 사용하세요

---

• Windows Subsystem For Android™ 설치 폴더를 삭제할 수 없습니다.
  Add-AppxPackage -Register .\AppxManifest.xml 명령어가 수행하는 역할은 기존의 일부 언팩된 파일(unpackaged files)들과 함께 appx 패키지를 등록하는 것이므로, Windows Subsystem For Android™를 계속 사용하려는 동안에는 해당 파일들을 유지해야 합니다. 자세한 내용은 https://learn.microsoft.com/en-us/powershell/module/appx/add-appxpackage?view=windowsserver2022-ps 를 확인하세요. - Windows Subsystem For Android™를 실행하기 전에 Windows Subsystem For Android™ appx 패키지를 등록해야 합니다.
  WSABuilds 및 MagiskOnWSALocal 사용자의 경우, 압축을 해제한 디렉토리에서
  Run.bat
  를 실행해야 합니다. 만약 스크립트가 실패한다면, 진단을 위해 다음 단계들을 수행할 수 있습니다 (관리자 권한 필요):

• PowerShell 창을 열고 작업 디렉토리를 Windows Subsystem For Android™ 디렉토리로 변경합니다.

PowerShell에서 아래 명령어를 실행합니다. 이 명령은 실패하면서 ActivityID를 출력해야 하며, 이는 다음 단계에 필요한 UUID입니다.

Add-AppxPackage -ForceApplicationShutdown -ForceUpdateFromAnyVersion -Register .\AppxManifest.xml

PowerShell에서 아래 명령어를 실행합니다. 이 명령은 실패한 작업의 로그를 출력해야 합니다.

Get-AppPackageLog -ActivityID <uuid>

로그를 확인하여 실패 원인을 파악하고 수정하세요.

[!IMPORTANT] 설정에서 WSA가 꺼져 있는지, 그리고 WSA-System-Control, WSA-Sideloader, WSAPacman 등의 도구가 실행 중이지 않은지 반드시 확인하세요.

업데이트하려는 최신 빌드 (latest build)를 다운로드하세요.

Windows Subsystem For Android가 실행 중이지 않은지 확인하세요 (WSA 설정에서 "Turn off"를 클릭하고 로딩 아이콘이 사라질 때까지 기다리세요).

7-Zip, WinRAR 또는 원하는 다른 도구를 사용하여 .7z 압축 파일을 여세요.

.7z 압축 파일 내의 하위 폴더를 여세요.

예시:

• WSA_2xxx.xxxxx.xx.x_xx

또는

• WSA_2xxx.xxxxx.xx.x_xx_Release-Nightly-with-magisk-xxxxxxx-MindTheGapps-xx.x-RemovedAmazon)

이 하위 폴더 안에 있는 모든 파일을 선택하여, Windows Subsystem For Android 파일이 있는 현재 폴더(WSA를 압축 해제하고 설치했던 폴더)에 압축을 푸세요.

폴더를 교체하겠느냐는 메시지가 뜨면 "모든 현재 항목에 대해 이 작업 수행"을 선택하고 "예"를 클릭하세요.

파일을 교체하겠느냐는 메시지가 뜨면 "대상 위치의 파일 덮어쓰기"를 클릭하세요.

Run.bat 파일을 실행하세요.

Windows Subsystem For Android 설정 앱을 실행하고 사이드바를 사용하여 About 탭으로 이동하세요.

WSA 버전이 최신 버전 또는 업데이트하려는 버전 번호와 일치하는지 확인하세요.

어려움이 있다면 Discord에 참여하세요

[!NOTE]

데이터를 보존하고 싶다면 %LOCALAPPDATA%\Packages\MicrosoftCorporationII.WindowsSubsystemForAndroid_8wekyb3d8bbwe\LocalCache\userdata.vhdx 파일을 백업해 두세요. 삭제 후, VHDX 파일을 다시 %LOCALAPPDATA%\Package\MicrosoftCorporationII.WindowsSubsystemForAndroid_8wekyb3d8bbwe\LocalCache 폴더로 복사하세요. 더 포괄적이고 자세한 가이드는 이 README markdown의 Backup and Restore 섹션을 참조하세요.

1.) Windows Subsystem For Android™가 실행 중이지 않은지 확인하세요.

2.) Windows 기본 검색 또는 '프로그램 추가/제거'를 통해 Windows Subsystem For Android™ Settings를 검색하고 제거(uninstall)를 누르세요.

3.) WSA를 설치하기 위해 압축을 해제하고 Run.bat를 실행했던 WSA 폴더(MagiskOnWSA 폴더)를 삭제하세요.

4.) %LOCALAPPDATA%/Packages/ 경로로 이동하여

MicrosoftCorporationII.WindowsSubsystemForAndroid_8wekyb3d8bbwe 폴더가

여전히 존재하는지 확인하세요.

• 폴더가 여전히 존재하는 경우:
  삭제하세요 - 만약 파일을 삭제할 수 없다는 오류가 발생하면, WSA가 꺼져 있는지 확인하세요.

• 폴더가 존재하지 않는 경우:
  이 단계를 건너뛰세요

• 폴더가 여전히 존재하는 경우:

1.) Windows 기본 검색 또는 '프로그램 추가/제거'를 사용하여 Windows Subsystem For Android™ Settings를 검색하고 제거(uninstall)를 누르세요.