개발 이야기2026년 11월 2일

Microsoft Store 가독 등록일지

가독(GaDoc)은 회사 친구 준경이랑 만들고 있는 협업 툴이다. (어쩌다 만들게 됐는지는 가독 개발기에 적어 뒀다.) 데스크톱 앱은 Electron으로 만들었다. 맥 버전은 Apple 개발자 인증서로 서명하고 공증까지 받아 배포하고 있는데, 홈페이지에서 내려받는 윈도우 설치 파일은 아직 서명하지 않았다.

홈페이지에서 exe를 받아 실행하면 "Windows의 PC 보호"라는 파란 창이 뜬다. "추가 정보"를 눌러야 겨우 "실행" 버튼이 나온다. 서명한 파일도 게시자의 평판에 따라 경고가 뜰 수는 있지만, 처음 설치하는 사람 입장에서는 이유가 뭐든 '이거 깔아도 되나...?' 싶은 화면이다.

그래서 가독 윈도우 앱을 Microsoft Store에 올려 보기로 했다. 처음에는 계정을 만들고 직접 제출했다. 나중에는 채팅에 @일렉트론이라고 입력하면 버전 올리기부터 Store 제출까지 이어지도록 자동화했다.


인증서를 살까, Store에 올릴까

처음 설치하는 사람이 이 경고 때문에 망설이지 않게 하려고 두 가지를 비교했다.

하나는 코드 서명 인증서를 사서 exe에 서명하는 거다. 1년에 수십만 원이 들고, 서명을 해도 평판이 쌓일 때까지는 경고가 뜨기도 한다. 업데이트는 지금처럼 앱이 알아서 한다.

다른 하나는 Microsoft Store에 MSIX로 올리는 거다. 인증을 통과한 패키지는 Microsoft가 서명해서 배포해 주고, 업데이트도 Store가 맡는다. Store로 배포하는 이 패키지에는 우리가 별도로 인증서를 살 필요가 없다.

개인 개발자 등록비도 없어져서 Store로 가 보기로 했다. 예전 안내에는 개인 19달러, 회사 99달러가 나왔는데, 현재 Microsoft 안내를 다시 보니 새 등록 절차에서는 개인과 회사 계정 모두 등록비가 없다. 계정 유형은 비용보다 앱을 개인으로 낼 건지, 사업체로 낼 건지에 맞춰 고르는 게 먼저다. (이 부분은 2026년 11월 3일 기준으로 다시 확인했다.)


계정 만들기부터 막혔다

storedeveloper.microsoft.com에서 가입하려는데 Microsoft 계정 확인 코드부터 안 왔다. 휴대폰 번호로 가입하면 문자가 와야 하는데 감감무소식... 이유는 정확히 모르겠지만 휴대폰 번호 대신 Gmail로 계정을 만드니까 메일로 코드가 바로 왔다.

그다음 계정 유형을 고르는데 여기서 한 번 고민했다.

  • 개인 계정은 개인 Microsoft 계정을 쓰고 신분증으로 본인 확인을 한다.
  • 회사 계정은 사업체 정보를 확인하는 절차가 따로 있다.
  • 개인 계정을 회사 계정으로 바로 바꾸는 건 지원하지 않는다. 회사 계정이 필요해지면 새로 만들어야 하니, 이미 낸 앱의 이전 절차도 미리 확인해야 한다.

나는 개인 계정으로 가입했다. Store에 보이는 게시자 이름은 Colding으로 정했다. GitHub 조직(GaDoc-by-Colding)이랑 저작권 표기가 이미 Colding이라 맞춰 두는 게 자연스럽고, 나중에 다른 앱을 내도 같은 게시자로 묶인다.

계정이 만들어지면 앱 이름부터 예약한다. '앱 및 게임 → 새 제품 → MSIX 앱'에서 "GaDoc"을 잡았다. (예약하고 3개월 안에 제출 안 하면 풀린다.) 예약하면 패키지에 넣어야 하는 값 세 개를 준다.

  • Package/Identity/Name: Colding.GaDoc
  • Package/Identity/Publisher: CN=899C6EC3-... (Partner Center가 정해 주는 게시자 ID)
  • PublisherDisplayName: Colding

이 값이 MSIX 안의 매니페스트랑 하나라도 다르면 패키지를 올릴 때 바로 걸린다.


맥에서 윈도우 패키지 만들기

가독 데스크톱 빌드는 맥미니 한 대에서 돈다. 윈도우용 exe(NSIS)를 만들 때 나오는 win-unpacked 폴더(실제 앱 파일)를 그대로 MSIX로 다시 싸는 방식으로 갔다. 도구는 Microsoft가 공개한 msix-packaging의 makemsix를 맥(arm64)에서 직접 빌드해서 썼다. (맥에서 윈도우 패키지를 만들고 있는 게 좀 웃기긴 하다.)

Store 버전에서 꼭 바꿔야 하는 게 하나 있었다. 앱 안의 자동 업데이트를 끄는 것. Store로 설치한 앱은 Store가 업데이트를 맡는다. 앱이 혼자 새 exe를 받아서 깔려고 하면 두 업데이트 경로가 겹친다. 가독은 Electron의 process.windowsStore로 Store 설치본을 구분해서 앱 자체 업데이트를 건너뛴다.

  • Store에서 받은 MSIX: Microsoft가 인증 후 서명하고, 업데이트도 Store가 맡는다.
  • 홈페이지에서 받은 exe: 아직 서명이 없고, 업데이트는 앱이 직접 확인한다.

Store에 올려도 홈페이지의 exe가 바뀌는 건 아니어서, 다운로드 경로별로 확인해야 했다.

그렇게 만든 첫 Store 제출본(1.1.5)을 지금 다시 풀어 보면 이렇게 생겼다.

Identity는 아까 예약할 때 받은 값 그대로고, 버전은 1.1.5.0처럼 네 자리다. Store 패키지 버전은 네 자리를 쓰고 마지막 자리는 0으로 둔다.

눈여겨볼 건 runFullTrust다. 일반 UWP 앱이랑 달리 Electron 앱은 보통 Win32 프로그램처럼 돌아야 해서, 제한된 권한(restricted capability)인 runFullTrust가 필요하다. 이건 제출할 때 왜 필요한지 따로 적어 내야 한다.


Partner Center에서 첫 제출하기

Partner Center에서 처음 제출할 때 채운 것들이다.

  • 패키지: GaDoc-1.1.5-x64.msix (155.5MiB). 올리자마자 Store가 패키지를 검사하는데, 경고는 예상한 runFullTrust 하나뿐이었다.
  • 가격: 무료. 웹이 무료인데 데스크톱만 돈을 받을 이유는 없으니까. 유료 판매는 지급·세금 정보와 결제 방식을 따로 확인해야 한다. 참고로 Microsoft 결제 시스템을 쓰는 일반 앱은 수수료가 15%지만, 자체 결제 등 다른 선택지도 있다.
  • 배포 지역: 전 세계. Partner Center 기준 240개 마켓이다.
  • 분류: 생산성
  • 연령 등급: IARC 설문을 하면 등급이 나온다. 가독은 사용자끼리 대화하는 앱이라 12+가 나왔다. (차단·신고·관리 기능이 있다고 답했다.)
  • 스토어 목록: 한국어 설명, 기능 5개, 스크린샷 4장, 개인정보처리방침 주소
  • runFullTrust 사유: 이 권한이 왜 필요한지 영어로 적어 냈다.

그리고 '인증을 위해 제출'. Partner Center 안내로는 보통 몇 시간, 길면 영업일 기준 3일이다. 첫 제출이라 그런지 10월 30일에 내고 다음 날 아침 8시에 공개됐다. 하루 가까이 걸린 셈이다.


Store 제출도 자동화하기

가독은 데스크톱을 꽤 자주 낸다. 근데 Store 버전을 따로 손으로 올려야 하면, 홈페이지 exe는 최신인데 Store에는 예전 버전이 남기 쉽다. (나라면 100% 까먹는다.)

가독에는 원래 채팅에 @일렉트론이라고 치면 맥미니가 데스크톱 앱을 빌드해서 게시해 주는 봇이 있다. 여기에 버전 올리기랑 Store 제출을 붙였다.

버전은 알아서 올린다

예전에는 @일렉트론을 치기 전에 누군가 package.json 버전을 손으로 올려야 했다. 깜빡하면 "이미 게시된 버전"이라고 거절당하고 다시 해야 했다. 그래서 이렇게 바꿨다.

  • main에 적힌 버전이 아직 게시 안 된 버전이면 그대로 쓴다.
  • 이미 게시된 버전이면 다음 패치 버전으로 올린다(1.1.8 → 1.1.9).
    • 모노레포의 모든 package.json 버전을 한꺼번에 맞추고,
    • 직전 버전 이후의 데스크톱 관련 커밋 제목으로 릴리스 노트(docs/releases/vX.Y.Z.md)를 만들어서,
    • dev에 커밋하고 main은 빨리 감기로만 올린다(둘 다 [skip ci]).
    • main과 dev 내용이 다르면(아직 반영 안 된 작업이 있으면) 사람 확인 없이 섞지 않고 멈춘다.

게시가 끝나면 Store에도 낸다

게시까지 끝나면 같은 윈도우 앱으로 MSIX를 하나 더 만들고, makemsix unpack으로 패키지 이름·게시자·버전·아키텍처가 맞는지 확인한 다음, Microsoft Store Submission API로 제출한다. Partner Center 화면에서 하던 걸 API로 그대로 하는 거다.

  1. 아직 공개 안 된 대기 제출이 있으면 지운다. 단, 인증이 진행 중인 제출은 건드리지 않는다. 같은 버전이면 건너뛰고, 다른 버전이면 새로 내지 않고 실패로 알린다.
  2. 지금 공개된 제출을 복제해서 새 제출을 만든다. (가격·배포 지역·스토어 목록은 그대로 따라온다.)
  3. 예전 패키지는 '지움' 표시를 하고 새 MSIX를 넣는다.
  4. 한국어 릴리스 노트만 이번 버전 내용으로 바꾼다. 커밋 접두어와 PR 번호는 떼고 1,500자에 맞춘다.
  5. MSIX를 ZIP에 담아 16MiB 블록으로 나눠 올린다.
  6. 새 제출을 commit한다.

Store 버전은 앞에서 말한 대로 네 자리라서, 앱 버전에 .0만 붙인다.

JavaScript

Store 제출이 실패하더라도 이미 끝난 게시는 되돌리지 않기로 했다. 홈페이지 다운로드, GitHub 릴리스, 앱 자동 업데이트는 그대로 두고, 완료 알림 끝에 Store 결과만 ⚠️ 한 줄로 붙인다. 잘 내면 "Microsoft Store 제출함 — Store 인증 대기", 실패하면 "Microsoft Store 제출 실패(이유) — 웹·GitHub·자동 업데이트 게시는 완료됨". Store 인증은 몇 시간에서 며칠이 걸리는데, 그걸 기다리느라 다른 배포까지 묶어 둘 이유는 없으니까. (인증 키 같은 비밀값은 본인만 읽을 수 있는 파일에서만 읽고, 로그나 채팅에는 절대 안 싣는다.)

실제로 돌면 채팅에는 이렇게 남는다.

위 실행에서는 @일렉트론을 친 뒤 버전을 1.1.9로 올리고, 맥 빌드·서명·공증, 윈도우 설치 파일 생성, 검증과 게시까지 14분 40초가 걸렸다. 마지막 줄 "Microsoft Store 제출함"이 이번에 붙인 부분이다.

1.1.9는 이렇게 @일렉트론이 Store에 자동으로 냈다. 위 화면을 확인했을 때는 세 번째 제출인 1.1.10(1.1.10.0)이 공개돼 있었다.

이 글을 쓰다가 한 번 더 돌렸다

글을 정리하던 11월 2일 오후 2시 57분에 @일렉트론을 한 번 더 쳤다. 1.1.10이 이미 게시돼 있으니 봇이 알아서 다음 버전 v1.1.11로 올려 dev·main에 반영하고(main 1de849c) 빌드를 시작했다.

실행기 로그에서 Store 쪽만 떼어 보면 이렇다.

  • 오후 3:08:07: 공개된 1.1.10 제출을 복제해 새 제출을 만들었다. (Store용 MSIX 155.7MiB, 앱 파일 88개)
  • 오후 3:08:48: 패키지를 블록 10개로 나눠 올리고 바로 제출(commit)했다.
  • 오후 3:11:52: 약 3분 동안 상태를 조회했지만 아직 CommitStarted였다. 실행기는 대기를 마치고, Store 처리 중이라는 결과와 함께 완료 알림을 남겼다.

빌드부터 Store 제출까지 14분 2초가 걸렸다. 인증은 몇 시간에서 며칠이 걸릴 수 있어서 실행기는 거기까지 기다리지 않는다. 채팅 한 줄로 홈페이지, GitHub, 앱 자동 업데이트 게시와 Store 제출까지 이어지지만, 제출됐다는 말이 Store에 공개됐다는 뜻은 아니다.

당시 Partner Center를 열어 보니 네 번째 제출이 "Update in certification"으로 들어가 있었다. 제출과 사전 처리는 끝났고 인증을 기다리는 상태. 그동안 Store에는 세 번째 제출인 1.1.10이 그대로 걸려 있었다.

11월 3일에 다시 확인해 보니 1.1.11(1.1.11.0, x64)은 인증을 마치고 Store에 공개됐다. 위 캡처는 전날 인증을 기다리던 순간이다. 제출 완료 알림을 보고 끝이라고 생각하면 안 되는 이유를 이번에 제대로 봤다.

이렇게 인증 중일 때 누가 또 @일렉트론을 쳐도, 실행기는 인증 중인 제출을 지우지 않는다. Store 제출만 건너뛰거나 실패로 알리고, 웹·GitHub·자동 업데이트 게시는 그대로 끝낸다.


11월 초에 남아 있던 것

홈페이지의 exe는 여전히 서명이 없다. Microsoft의 서명은 Store로 받는 MSIX에 붙는다. 홈페이지의 exe에는 별도로 서명해야 한다. 홈페이지에서 exe를 받으면 그 파란 창이 그대로 뜰 수 있다. 다운로드 페이지에도 Store 링크를 붙여서 윈도우 사용자를 먼저 안내하려고 한다.

그리고 Store 인증 결과는 아직 사람이 확인한다. 제출까지는 자동인데, 몇 시간 뒤 통과했는지는 Partner Center를 열어 봐야 안다. 이것도 채팅으로 알려 주게 만들 생각이다.


등록을 마치고

처음에는 윈도우 설치할 때 뜨는 파란 창이 신경 쓰여서 시작했다. 그런데 Store에 한 번 올리고 나니, 새 버전을 낼 때마다 Partner Center에 들어갈 자신이 없었다. 그래서 결국 @일렉트론 뒤에 제출까지 붙였다. (한 번 귀찮으면 계속 귀찮을 게 뻔해서...)

지금은 버전을 손으로 올리는 걸 깜빡해도 봇이 다음 버전으로 맞춰 준다. 인증 결과를 나중에 따로 확인해야 하는 일은 남았지만, 적어도 홈페이지 버전만 올리고 Store를 잊어버릴 일은 줄었다.

윈도우 쓰시는 분들은 Microsoft Store의 GaDoc에서 설치할 수 있다. 🙇🏻‍♂️

가독 이야기

  • 가독 개발기: 노션 좀 쓰게 해 달라고 했다가 협업 툴을 만들어 버린 이야기
  • 가독 MongoDB 운영기: standalone 때문에 배포가 막혀서 MongoDB를 직접 띄우고 죽여 본 이야기

참고