지원

Mac App Store 판은 macOS 샌드박스 안에서 동작합니다. 샌드박스 앱은 사용자가 직접 고른 폴더만 읽을 수 있는데, Xcode 가 프로비저닝 프로파일을 두는 폴더는 앱 바깥에 있어서 한 번 허용해 주어야 합니다.

프로파일 탭의 폴더 버튼을 누르면 그 폴더가 열린 상태로 열기 패널이 뜹니다. 아무것도 바꾸지 말고 「허용」만 누르면 됩니다. 한 번 허용하면 앱을 다시 열어도 기억합니다 (macOS 의 보안 스코프 북마크 방식).

읽는 폴더:

• ~/Library/Developer/Xcode/UserData/Provisioning Profiles — Xcode 16 이상
• ~/Library/MobileDevice/Provisioning Profiles — 그 이전 Xcode

Finder 에서 ~/Library 는 기본으로 숨겨져 있습니다. 열기 패널에서 ⌘⇧G 를 누르고 위 경로를 붙여 넣으면 바로 갈 수 있습니다. 허용하지 않아도 .mobileprovision 파일을 창에 끌어다 놓거나 「파일에서 추가…」로 열어 볼 수는 있습니다.

• 산출물 검사: .ipa (iOS 탭), .apk · .aab (Android 탭)
• OTA 배포: .ipa (iOS), .apk (Android). AAB 는 기기에 바로 설치할 수 없어 받지 않습니다.
• 프로파일: .mobileprovision
• API 키: App Store Connect 에서 내려받은 .p8

파일은 끌어다 놓거나 「파일 선택…」(⌘O)으로 엽니다.

Mac App Store 앱은 샌드박스가 필수이고, 샌드박스 안에서는 xcodebuild · gradle 같은 외부 프로그램을 실행할 수 없습니다. 그래서 이 판은 빌드 대신 검사 · 프로파일 · OTA 세 가지에 집중합니다. 산출물 검사도 외부 도구에 기대지 않고 앱 안의 파서가 IPA · APK · AAB 를 직접 읽습니다.

1. App Store Connect › 사용자 및 액세스 › 통합 › App Store Connect API 로 갑니다.
2. 팀 키(Team key)를 만듭니다. 프로파일과 기기를 조회 · 생성하려면 보통 Admin 역할이 필요합니다.
3. Issuer ID, Key ID, 내려받은 .p8 파일을 앱의 「프로파일 다운로드」 › 「API 키」에 등록합니다. AuthKey_XXXXXXXX.p8 파일을 고르면 Key ID 는 자동으로 채워집니다.

.p8 파일은 Apple 에서 한 번만 내려받을 수 있으니 안전한 곳에 보관하세요. Apple ID 나 2단계 인증은 쓰지 않습니다.

.p8 파일은 고른 자리에 그대로 있고, 앱은 그 파일의 위치(보안 스코프 북마크)만 기억합니다. Apple 에 보내는 요청 토큰은 Mac 에서 서명하며, 키 자체는 Apple 의 App Store Connect API(api.appstoreconnect.apple.com) 말고는 어디로도 가지 않습니다. 앱에서 키를 삭제해도 .p8 파일은 지우지 않습니다.

만료까지 30일 이내면 「곧 만료」로 분류하고 남은 날짜를 D-N(주황) 배지로 보여 줍니다. 이미 지난 것은 「만료」(빨강)입니다. 「신규」는 최근에 만든 프로파일, 「중복」은 같은 팀 · 같은 앱 ID · 같은 종류의 프로파일이 2개 이상일 때입니다.

키체인에 있는 코드 서명 인증서 목록은 샌드박스 안에서 읽을 수 없어, Mac App Store 판에서는 이 카드가 비어 있습니다. 대신 프로파일 안에 담긴 인증서는 상세 화면과 비교 화면에서 그대로 볼 수 있습니다 (SHA-1 · SHA-256 복사 가능).

Apple 개발자 계정은 멤버십 1년마다 기기 종류(iPhone · iPad · Mac …)별로 100대까지 등록할 수 있습니다. 비활성으로 바꾼 기기도 멤버십을 갱신하기 전까지는 자리를 차지합니다. 앱의 「기기」 탭 위쪽에 종류별 사용량(예: iPhone 3 / 100)이 보입니다.

아니요. 파일은 읽기만 합니다. 원본을 고치지 않고, 옆에 결과 파일을 쓰지 않으며, 어떤 서버에도 보내지 않습니다. 검사 결과는 앱 창에만 보입니다.

점선 밑줄이 있는 항목 이름(권한 · 기기 기능 · 매니페스트 설정 · 인증서 지문 · Entitlements 등)을 누르면 무엇인지 · 자세히 · 주의 설명이 팝오버로 나옵니다. 16 KB 카드는 제목 옆 ⓘ 를 누르세요.

Android 15 부터 16 KB 메모리 페이지를 쓰는 기기가 있고, Google Play 는 이를 지원하는 네이티브 라이브러리를 요구합니다. 앱은 64비트(arm64-v8a · x86_64) .so 파일의 ELF LOAD 정렬과, APK 안에 압축 없이 저장된 .so 의 16 KB 경계를 확인해 미지원 라이브러리를 목록으로 보여 줍니다.

순서대로 확인해 보세요.

• IPA · manifest.plist · install.html 이 모두 https 주소에 있어야 합니다. iOS 는 http 로 설치하지 않습니다.
• 설치 링크나 QR 은 기기의 Safari 에서 열어야 합니다. 메신저 미리보기나 다른 앱의 웹 화면에서는 시작되지 않을 수 있습니다.
• Ad Hoc: 기기의 UDID 가 프로파일에 등록되어 있어야 합니다. 없으면 프로파일에 기기를 넣고 다시 만든 IPA 가 필요합니다.
• Enterprise: 설치 후 설정 › 일반 › VPN 및 기기 관리에서 개발자 앱을 신뢰해야 열립니다.
• App Store 배포용 프로파일로 서명한 IPA 는 OTA 로 설치되지 않습니다. 앱이 파일을 고를 때 알려 줍니다.
• manifest 의 IPA 주소가 실제 파일 위치와 같은지, 파일 이름에 공백이나 특수 문자가 없는지 확인하세요.

「설치 파일 만들기」(⌘↩)를 누르면 저장할 폴더를 고르는 창이 뜹니다. 고른 폴더 안에 <이름>_OTA 폴더를 만들고, 그 안에 IPA(또는 APK) 복사본과 <이름>.manifest.plist · <이름>.install.html · <이름>.qr.png (Android 는 .install.html · .qr.png)를 함께 둡니다. 같은 이름이 있으면 덮어씁니다. 앱은 파일을 서버에 올리지 않으므로 IPA · APK 와 함께 직접 올려야 합니다.

APK · install.html · QR 을 같은 https 폴더에 올리고, 기기의 브라우저(Chrome)에서 설치 페이지를 엽니다. Play 스토어 밖에서 받은 앱이므로 기기에서 「출처를 알 수 없는 앱 설치」를 허용해야 합니다. 설치 페이지에는 SHA-256 이 적혀 있어 받은 파일이 맞는지 확인할 수 있습니다.

툴바의 지구본 메뉴에서 언어를 고르고 「지금 다시 시작」을 누르면 그 언어로 다시 열립니다. 언어는 앱을 다시 시작해야 적용되며, 하던 작업은 그대로 남습니다. 한국어 · English · 日本語 · 简体中文 · 繁體中文 · Español 을 지원합니다.

툴바에서 라이트 · 다크 · 시스템 테마를 고릅니다. 글자 크기는 보기 메뉴의 「텍스트 크게 ⌘+ · 작게 ⌘- · 기본 크기 ⌘0」 또는 설정(⌘,) › 화면에서 85 % ~ 150 % 사이로 바꿉니다.

macOS 15 Sequoia 이상. Apple Silicon 과 Intel Mac 모두 지원합니다. 프로파일 다운로드 · 생성 · 기기 등록에는 App Store Connect API 키가 필요하고, 그 밖의 기능은 인터넷 없이 동작합니다.

beakbigkb@gmail.com 으로 아래 내용을 함께 보내 주시면 빨리 살펴볼 수 있습니다.

• macOS 버전 (Apple 메뉴 › 이 Mac에 관하여)
• 앱 버전 (ShouArchive 메뉴 › ShouArchive 정보)
• 어떤 순서로 무엇을 했을 때 무슨 일이 생겼는지
• 가능하면 화면 캡처나 오류 문구

IPA · APK · 프로파일 파일은 보내지 않아도 됩니다. 꼭 필요하면 따로 요청드리며, 보내실 때는 키 파일(.p8)이나 민감한 정보가 들어 있지 않은지 확인해 주세요.