← 블로그로
Ai약 11 분 읽기

APK를 더블클릭하면 Windows 앱이 된다 — ApkStart는 Android 앱을 하나의 창으로 다룬다

게시일 2026년 11월 21일
APK를 더블클릭하면 Windows 앱이 된다 — ApkStart는 Android 앱을 하나의 창으로 다룬다

Android-on-Windows 해법은 대개 런처를 열고, 앱을 클릭하고, 자기가 에뮬레이터 안에 있다는 사실을 받아들이라고 요구한다. RoutineMiku의 ApkStart는 2026년 10월 29일 등장한 뒤 8,815개의 star를 모았는데, 다른 쪽에 걸었다. 에뮬레이터가 인터페이스가 되어서는 안 된다는 쪽이다.

파일 탐색기에서 .apk를 더블클릭한다. 패키지를 파싱하고, 설치하고, 아이콘을 뽑아내고, 바탕 화면에 바로가기를 놓는다. 그다음부터는 다른 프로그램과 똑같이 그 아이콘을 더블클릭하면 된다. 창이 열리면 제목 표시줄에는 앱 자신의 아이콘이, 작업 표시줄에는 앱 자신의 이름이 뜬다.

창 뒤에서 돌아가는 건 여전히 Android 에뮬레이터다. 요점은 그것이 더 이상 보이지 않는다는 것이다.

실제로 설치되는 것

배포 형태는 네 가지이고, 각각 존재 이유가 다르다.

패키지크기언제 합리적인가
Microsoft Store .msix런타임 포함업데이트를 Store에 맡기고 싶을 때
전체 포터블 zip약 830 MB, 압축 해제 후 약 1.3 GB설치 없이, 첫 실행 때 내려받지도 않게
설치 프로그램 .exe약 1.3 GB바탕 화면과 시작 메뉴 바로가기, 제거 항목
경량 포터블 zip96 MiB, 압축 해제 후 약 227 MB일단 써 보고, 실행할 때 런타임을 가져오기

셸 자체에는 서드파티 의존성이 하나도 없다. ZIP, PNG, ICO, 그리고 Android의 바이너리 XML 포맷까지 전부 직접 작성한 코드로 파싱한다. 경량 포터블 빌드가 UI와 설치 프로그램을 안고도 96 MiB에 들어가는 이유다. Android 런타임은 필요할 때 가져오고, 유휴 상태가 되면 회수하며, 이미 기기에 있으면 그대로 재사용한다.

마지막 항목은 잠깐 짚고 갈 만하다. 이미 API 34 Android 에뮬레이터를 돌리고 있다면, ApkStart는 같은 시스템 이미지를 하나 더 깔지 않고 거기에 붙을 수 있다. 추가 디스크 비용은 0이 된다.

화면 방향 문제를 설치 시점에 해결한다

이 프로젝트가 겉보기보다 재미있는 이유를 설명해 주는 대목이다.

Android 에뮬레이터에는 hw.lcd.width와 hw.lcd.height로 정해지는 물리 패널 방향이 있다. 패널은 가로인데 앱이 세로를 선언하면, Android는 앱에게 가운데 레터박스 띠를 주고 양옆을 검은 바로 채운다. 창 크기를 바꿔도 소용없다. wm size도 소용없다. 레터박스 스타일을 건드려도 소용없다. 작성자는 그 전부를 시도했고 src/core/apk.js에 메모를 남겼다.

그래서 ApkStart는 설치할 때 AndroidManifest.xml을 오프라인으로 읽고, 런처 액티비티들의 무게를 재서 이 앱이 본래 세로인지 가로인지 판정한다. sensor나 fullSensor만 선언한 앱은 첫 실행 때 한 번 물어본다. 답은 apps.json에 기록되고, 런타임은 거기에 맞는 패널로 시작한다. 숏드라마 앱이면 720×1280 세로, 리더라면 1280×720 가로다.

방향이 어긋난 경우 비용을 치르는 건 첫 실행뿐이다. 런타임 재시작으로 약 40초, 제목 표시줄에 안내가 뜬다. 그 뒤로는 같은 방향의 앱이 즉시 열리고, 제목 표시줄의 회전 버튼이 앱별로 선택을 기억한다.

190 dpi가 제품 결정인 이유

그 묘기의 나머지 절반은 밀도다.

폭 720 패널을 190 dpi로 돌리면 논리 폭이 606 dp가 된다. Android의 태블릿 분기점은 600 dp다. 이걸 넘으면 2단 태블릿 레이아웃을 넣은 앱이 실제로 그 레이아웃을 그린다. 갈라진 설정 창, 2열 에피소드 그리드까지. 기본 에뮬레이터 이미지는 320 dpi라서 360 dp가 나오고, 이건 폰 레이아웃이다.

그 숫자 하나가 "작은 창에 들어앉은 Android 앱"과 "주어진 창을 제대로 쓰는 Android 앱"을 가른다. "태블릿 레이아웃" 스위치로 노출되어 있고 기본값은 켜짐이다. 모니터에서 만화를 읽거나 드라마를 보고 싶어 하는 사람만 내릴 수 있는 종류의 결정이다.

줄이 그어진 나무판 한가운데 직사각형 창이 뚫려 있고, 그 구멍 뒤에 폰 크기의 액자가 놓여 있다.

창 처리도 같은 결이다. 앱은 창 모드로 돈다. 헤드리스 Android에는 VSYNC가 없고, 헤드리스 앱은 살아 있어도 아무것도 렌더링하지 않기 때문이다. ApkStart는 그 창을 넘겨받아 제목을 바꾸고, 진짜 아이콘으로 갈아 끼우고, 폰 비율에 맞춰 크기를 잡고, 가운데로 옮긴다. 전체 화면은 늘리지 않고 높이만 채운다. 창 모드는 끌 수 있고 크기도 조절되며, 크기를 앱별로 기억한다.

가상 어댑터 없는 네트워킹

QEMU 안의 Android는 보통 호스트에 가상 네트워크 인터페이스가 생긴다는 뜻이다. ApkStart는 대신 QEMU의 사용자 모드 NAT를 통과시켜서, 트래픽이 호스트의 물리 어댑터로 나간다. 네트워크 연결에는 아무것도 나타나지 않는다. 드라이버도, 브리지도, 두 번째 IP도 없다.

그냥 앱 하나 돌리고 싶은 사람을 위한 도구에게 이 정도가 네트워킹의 적정량이다. 보이지 않는 정도.

공유 폴더도 같은 논리다. %USERPROFILE%\ApkStartShared가 /sdcard/ApkStartShared에 매핑되고 양방향으로 동기화된다. 앱이 저장한 파일이 내보내기 절차 없이 탐색기에 나타난다.

내려받기 전에 재는 업데이터

업데이트 경로는 이 프로젝트가 취미를 벗어나 작은 인프라 조각이 되기 시작하는 지점이다.

GitHub를 가리켜 놓고 기도하는 대신, 클라이언트는 GitHub와 Gitee 양쪽에 최신 버전을 물어 더 높은 쪽을 택한다. 한쪽이 막혀도 업데이트가 멈추지 않는다. 그다음 후보 목록을 만든다. 직접 소스, 같은 자산의 다른 호스트판, 미러 프리픽스. 후보마다 256 KB를 내려받고 첫 바이트가 도착한 뒤부터 처리량을 잰다. 핸드셰이크를 포함해 재면 지연이 크고 대역폭이 높은 미러가 느린 것으로 잘못 매겨지기 때문이다. 가장 빠른 후보가 다운로드를 맡고, 청크 분할과 병렬 처리, 자동 페일오버가 붙는다.

경량 포터블 패키지는 7-Zip deflate 최고 설정으로 압축해 95.0 MB에 맞췄다. Gitee의 첨부 용량 상한이 100 MB이기 때문이다. 그 제약이 오히려 더 나은 패키지를 만들었다.

교체는 별도 PowerShell 스크립트가 맡는다. 메인 프로세스가 끝나기를 기다렸다가 프로그램 디렉터리를 덮어쓰고 다시 실행한다. 앱 데이터와 런타임은 프로그램 디렉터리 밖에 있어서, 업데이트가 설치된 앱이나 스냅샷을 지우지 않는다.

이것이 아닌 것

README는 드물게 솔직하다. 초기 버전이고, 저녁과 주말에 만든 취미 프로젝트이고, 무료이고, 광고는 없고, "아직 쓰기 좋지는 않다". 이 말은 진지하게 받아들여야 한다.

에뮬레이터 래퍼이므로 에뮬레이션을 탐지하는 것은 여전히 탐지한다. 하드웨어 DRM이 붙은 앱, root와 에뮬레이터 검사가 있는 은행 앱, 안티치트가 달린 게임은 대상이 아니다. 부팅은 즉시가 아니다. 콜드 런타임 시작에 18초 생존 확인이 더해지므로 세션의 첫 실행은 느리고, 방향이 어긋나면 재시작이 한 번 더 얹힌다.

그 18초 생존 프로브 자체가 좋은 디테일이다. 앱이 실행 중 죽으면 ApkStart는 재시도하고, 필요하면 앱 데이터를 초기화하고, 앱이 요청한 런타임 권한을 부여해서 시스템 대화상자에서 멈춰 있지 않게 한다.

한번 볼 만한 이유

플랫폼 벤더가 신경 쓰지 않아서 끝내 쓰이지 않는 소프트웨어 범주가 있다. 실제로 쓰는 Android 앱 두세 개를, 실제로 작업하는 데스크톱에서, 런처를 끼우지 않고 돌리는 일이다.

ApkStart가 그것이다. 매니페스트 파싱, 밀도 상수 하나, NAT 결정 하나, 그리고 네트워크를 믿는 대신 재는 업데이터로 조립되어 있다. 새로운 아이디어는 하나도 없다. 조합이 에뮬레이터를 사라지게 만들고, 그게 제품의 전부다.

관련 글

서버 한 대, AI 스트리머 한 명: 야간 라이브를 돌리는 코드

open-yoki는 매일 밤 Binance Square에서 방송하는 AI 진행자의 프로덕션 코드로, 성격과 목소리, 돈에 닿는 기능은 걷어냈습니다. headless Chrome이 프레임을 그리고 ffmpeg이 RTMP를 밀며, Markdown 폴더가 그녀의 기분과 올릴 글을 정합니다.

Pinky는 agent에게 당신의 폰을 맡기고, 당신이 허용을 누를 때까지 전송 버튼을 붙잡고 있습니다

Pinky는 어떤 MCP agent든 실제 iPhone이나 Android 폰에 연결하고, 승인을 프롬프트가 아닌 자체 게이트웨이에서 강제합니다. 은행 앱은 보이지 않고 비밀번호 입력란은 손댈 수 없으며, Android 13에서는 agent가 숨겨진 두 번째 화면을 받습니다.

인터페이스의 AI 티를 잡아내고 9단계로 고치는 Claude skill

unslop은 Claude Code, Codex, Antigravity에서 도는 skill로, vibecoded 화면이 어디서 싸구려처럼 보이는지를 먼저 이름 붙여 줍니다. 제품에서 방향을 잡고 나면 디자이너가 redline review를 하듯 패스를 겹쳐 고칩니다. star는 19,413개이고, slop이 무엇인지에 대한 답도 분명합니다.

세계의 법을 git에 넣은 사람들, 이제 법조문도 blame할 수 있다

global-law는 각국 법령을 git 저장소로 보관하고, 커밋 하나가 특정 날짜에 시행된 법 하나에 대응한다. 조문에 log, blame, show, diff를 돌릴 수 있고, 어느 날 각국에서 시행 중이던 법을 확인하고, 코퍼스 전체를 MCP로 어시스턴트에 넘길 수 있다.