mas - GitLite

KO | EN

gitlite — search

#javascript #typescript #android #rust #linux #docker #macos #nodejs #awesome #kubernetes #pytorch #openai #mcp #ios

mas

(★ 12,311)

:package: Mac App Store 커맨드라인 인터페이스

파일 탐색기

최종 버전 다운로드 (.zip)

- - 01-bug-report.yaml
  - 02-feature-request.yaml
- - build-test.yaml
  - codeql.yaml
  - release-published.yaml
  - scorecard.yaml
  - tag-pushed.yaml
- CODEOWNERS
- dependabot.yaml
- release.yaml
- - mas.bash
  - mas.fish
- - MASBuildToolPlugin.swift
- _setup_script
- bootstrap
- build
- clean
- format
- generate_manual
- generate_token
- lint
- mas
- package
- prebuild
- release_cancel
- release_start
- setup_libexec
- setup_workflow_repo
- test
- update_dependencies
- update_headers
- version
- - PrivateFrameworks.c
- - MASTests.swift
- .swiftlint.yml
.editorconfig
.geminiignore
.gitattributes
.gitignore
.markdownlint-cli2.yaml
.periphery.yaml
.swift-version
.swiftformat
.swiftlint.yml
.xcode-version
.yamllint.yaml
AGENTS.md
Brewfile
CODE_OF_CONDUCT.md
CONTRIBUTING.md
LICENSE
mas.png
Package.resolved
Package.swift
README.md
SECURITY.md

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

[![current version](https://img.shields.io/github/v/release/mas-cli/mas.svg?style=for-the-badge)](https://github.com/mas-cli/mas/releases/latest)
[![supported OS: macOS 13+](https://img.shields.io/badge/Supported\_OS-macOS\_13%2B-teal?style=for-the-badge)](https://raw.githubusercontent.com/mas-cli/mas/main/Package.swift)
[![license: MIT](https://img.shields.io/badge/license-MIT-750014.svg?style=for-the-badge)](https://raw.githubusercontent.com/mas-cli/mas/main/LICENSE)
[![language: Swift 6.3](https://img.shields.io/badge/language-Swift\_6.3-F05138.svg?style=for-the-badge)](https://www.swift.org)
[![build, test & lint status](https://img.shields.io/github/actions/workflow/status/mas-cli/mas/build-test.yaml?label=build,%20test%20%26%20lint&style=for-the-badge)](https://github.com/mas-cli/mas/actions/workflows/build-test.yaml)
[![dependencies status](https://img.shields.io/librariesio/github/mas-cli/mas?style=for-the-badge)](https://raw.githubusercontent.com/mas-cli/mas/main/Package.swift)

# ![mas](https://raw.githubusercontent.com/mas-cli/mas/main/mas.png)

mas는 스크립팅과 자동화를 위해 설계된 Mac App Store용 명령줄 인터페이스입니다.
## 설치

| 제공자 | 방법 | mas | macOS |
|:------------------------------------------------------------------------------|:-------------------------------|:--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|:------------------|
| [Homebrew](https://brew.sh) [Core](https://github.com/Homebrew/homebrew-core) | `brew install mas` | [![Homebrew Core](https://repology.org/badge/version-for-repo/homebrew/mas-mac-app-store.svg?header=)](https://formulae.brew.sh/formula/mas) | 14+ (권장) |
| [Homebrew](https://brew.sh) [Tap](https://github.com/mas-cli/homebrew-tap) | `brew install mas-cli/tap/mas` | [![Homebrew Tap](https://img.shields.io/badge/dynamic/json?url=https%3A%2F%2Fapi.github.com%2Frepos%2Fmas-cli%2Fhomebrew-tap%2Freleases%2Flatest&query=%24.name&label=&color=4c1)](https://github.com/mas-cli/homebrew-tap/releases/latest) | 13+ |
| [MacPorts](https://www.macports.org/install.php) | `sudo port install mas` | [![MacPorts](https://repology.org/badge/version-for-repo/macports/mas-mac-app-store.svg?header=)](https://ports.macports.org/port/mas/details/) | 13+ |
| [GitHub Releases](https://github.com/mas-cli/mas/releases) | 설치 프로그램 및 소스 아카이브 | 전체 | 릴리스에 따라 다름 |

## 명령어
상세한 문서는 `man mas` 및 `mas --help`를 통해 확인할 수 있습니다.

| 명령어 | 기능 | 참고 사항 | 별칭 |
|:------------------------------|:----------------------------------------------|:------------------------------------------------------------------------------------------------------------|:-----------|
| `search …` | App Store 앱 검색 | [json](#json-app-output) | |
| `lookup …` | App Store 앱 세부 정보 출력 | [json](#json-app-output) | `info` |
| `list […]` | 설치된 앱 출력 | [spotlight](#spotlight), [json](#json-app-output) | |
| `outdated […]` | 업데이트가 필요한 앱 출력 | [spotlight](#spotlight), [json](#json-app-output) | |
| `outdated --accurate […]` | 업데이트가 필요한 앱 출력 | [spotlight](#spotlight), [account](#app-store-apple-account-requirements), [json](#json-app-output) | |
| `get …` | [무료 앱 가져오기](#paid-apps), 모든 앱 설치 | [spotlight](#spotlight), [root](#root-privileges), [account](#app-store-apple-account-requirements-for-get) | `purchase` |
| `install …` | 가져오거나 구매한 앱 설치 | [spotlight](#spotlight), [root](#root-privileges), [account](#app-store-apple-account-requirements) | |
| `lucky …` | 일치하는 첫 번째 앱 설치 | [spotlight](#spotlight), [root](#root-privileges), [account](#app-store-apple-account-requirements) | |
| `update […]` | 구버전 앱 업데이트 | [spotlight](#spotlight), [root](#root-privileges), [account](#app-store-apple-account-requirements) | `upgrade` |
| `update --accurate […]` | 구버전 앱 업데이트 | [spotlight](#spotlight), [root](#root-privileges), [account](#app-store-apple-account-requirements) | `upgrade` |
| `uninstall (…\|--all)` | 앱 제거 | [spotlight](#spotlight), [root](#root-privileges) | |
| `signout` | App Store에서 로그아웃 | | |
| `open []` | App Store 앱 페이지 열기 | | |
| `home …` | 앱 웹페이지 열기 | | |
| `seller …` | 판매자 앱 웹페이지 열기 | | `vendor` |
| `reset` | App Store 프로세스 재설정 | | |
| `config` | 설정 출력 | [json](#json-config-output) | |
| `version` | 버전 출력 | | |

## 연동

| 도구 | 기능 |
|:-----------------------------------------------------------------|:----------------------------------------------------------------------------|
| [Homebrew Bundle](https://docs.brew.sh/Brew-Bundle-and-Brewfile) | 설치된 앱을 `Brewfile`에 포함; `Brewfile` 앱 가져오기, 설치 및 업데이트 |
| [Topgrade](https://github.com/topgrade-rs/topgrade) | 앱 업데이트 |

## 알려진 문제점

| 문제 | 해결책 |
|:-------------------------------------------------------------------------------|:----------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| 시스템 소프트웨어 관리 (macOS, Safari 등) | [`softwareupdate`](https://www.unix.com/man-page/osx/8/softwareupdate) 사용 |
| [일치하지 않는 앱 데이터](https://github.com/mas-cli/mas/issues/387) | 몇 시간에서며칠 기다리기 (App Store는 결과적 일관성을 사용합니다) |
| [유료 앱을 구매할 수 없음](https://github.com/mas-cli/mas/issues/558) | App Store에서 직접 유료 앱 구매; PR 제출 |
| [iOS 및 iPadOS 앱은 지원되지 않습니다](https://github.com/mas-cli/mas/issues/321) | PR 제출 |
| [응답 없음 (멈춤 현상)](https://github.com/mas-cli/mas/issues/1222) | [Spotlight에서 앱 색인화](#spotlight); 멈춤 현상이 지속되면 [버그 리포트 작성](https://github.com/mas-cli/mas/issues/new?template=01-bug-report.yaml) |
| 설치된 앱을 감지하지 못함 | [Spotlight에서 앱 색인화](#spotlight) |
| `This redownload is not available for this Apple Account…` 오류 | App Store에 올바른 Apple 계정으로 로그인하거나, 앱을 제거한 후 현재 Apple 계정으로 다시 받기 |
| 기타 버그 | [기존 버그 리포트 구독](https://github.com/mas-cli/mas/issues) 또는 [새 버그 리포트 작성](https://github.com/mas-cli/mas/issues/new?template=01-bug-report.yaml) |

## 개발

| 동작 | 명령어 |
|:------------------------------------------------------------------------|:-------------------------------|
| 빌드 | `Scripts/build` 또는 Xcode 26.4+ |
| zsh 래퍼 설정 | `Scripts/setup\_libexec` |
| zsh 래퍼 실행 | `Scripts/mas` |
| 테스트 ([Swift Testing](https://developer.apple.com/xcode/swift-testing)) | `Scripts/test` |

## 앱 ID (App IDs)
App Store 앱에는 각각 2개의 고유한 ID가 있습니다:
| 형식 | 포맷 | 예시 (Xcode 기준) |
|:----------|:--------|:--------------------|
| ADAM ID | 정수 (Integer) | 497799835 |
| Bundle ID | 문자열 (String) | com.apple.dt.Xcode |
mas 명령어는 두 가지 유형의 앱 ID를 모두 인자로 허용합니다.
기본적으로 숫자로만 이루어진 앱 ID는 ADAM ID로 간주되며, 그 외의 앱 ID는 bundle ID로 간주됩니다.
`--bundle`을 사용하면 숫자로만 이루어진 앱 ID도 bundle ID로 강제 간주할 수 있습니다.
ADAM ID는 다음 방법으로 찾을 수 있습니다:
- `mas search …`
- `mas list`
- App Store:
1. 앱의 App Store 페이지를 엽니다.
2. 페이지의 공유 시트(Share Sheet)를 엽니다.
3. `복사`를 선택합니다.
4. 복사한 텍스트의 URL에서 ADAM ID를 추출합니다. 예: `https://apps.apple.com/us/app/xcode/id497799835?mt=12`에서 `497799835` 추출.

## JSON 앱 출력 (JSON App Output)
`list`, `outdated`, `search`는 일반적으로 각 앱의 몇 가지 필드를 행 단위로 나누어 표 형식의 데이터를 출력합니다.
`lookup`은 일반적으로 앱마다 빈 줄을 두고 연속된 블록 형태로 각 필드를 키-값 쌍(key-value pair)으로 줄마다 출력합니다.
`--json`이 제공되면, 이 명령어들은 Apple이 해당 앱에 대해 제공하는 모든 필드를 포함하는 JSON 객체 스트림을 앱당 하나씩 출력합니다.
Apple이 제공하는 키 중 상당수는 이름이 좋지 않으므로, 알고리즘을 통해 더 나은 이름으로 매핑됩니다.
매핑된 키는 [정렬됩니다](
https://developer.apple.com/documentation/foundation/nsstring/compareoptions/numeric
).
각 키는 객체 내에서 고유해야 하며, 객체에 중복된 키가 있는 경우 입력에서의 상대적 순서가 출력에도 유지됩니다.
표 형식 출력의 경우, 객체에 중복된 키가 있으면 마지막 값이 사용됩니다.
Apple이 키의 이름을 변경하거나 추가하는 경우, 매핑이 업데이트될 때까지 차선책의 키가 출력될 수 있습니다.

## JSON 설정 출력 (JSON Config Output)
`config`는 일반적으로 설정을 키-값 쌍으로 줄마다 하나씩 출력합니다.
`--json`이 제공되면, `config`는 모든 설정을 단일 JSON 객체로 출력합니다.
키는 mas에 의해 정의되므로 고유성과 정확성이 보장됩니다.

## 스포트라이트 (Spotlight)
`list`, `outdated`, `get`, `install`, `lucky`, `update`, `uninstall`은 설치된 앱에 대한 데이터를 스포트라이트 메타데이터 서비스(MDS)에서 가져옵니다.
따라서 App Store 앱이 포함된 폴더에 대해 스포트라이트 색인화(indexing)가 활성화되어 있고 유효해야 합니다.
앱이 스포트라이트에 제대로 색인되었는지 확인하는 방법:
```console
## General format:
$ mdls -rn kMDItemAppStoreAdamID 
## Outputs the ADAM ID if the app is indexed.
## Outputs nothing if the app is not indexed.
## Example:
$ mdls -rn kMDItemAppStoreAdamID /Applications/Xcode.app
497799835
```
앱이 스포트라이트에 색인되어 있는 경우, ADAM ID를 통해 앱의 경로를 찾는 방법:
```shell
mdfind 'kMDItemAppStoreAdamID = '
```
일부 App Store 앱이 제대로 색인되지 않은 경우, 다음 명령어로 색인화합니다:

```shell
# 개별 앱 (누락된 앱을 알고 있는 경우). 예: Xcode의 경우:
mdimport /Applications/Xcode.app
# 모든 앱:
vol="$(/usr/libexec/PlistBuddy -c "Print :PreferredVolume:name" ~/Library/Preferences/com.apple.appstored.plist 2>/dev/null)"
mdimport /Applications ${vol:+"/Volumes/${vol}/Applications"}
# 모든 볼륨:
sudo mdutil -Eai on
```

## Root Privileges
`get`, `install`, `lucky`, `update` & `uninstall` 명령어는 루트 권한이 필요합니다.
루트 권한 없이 실행하면, mas는 필요에 따라 권한을 요청합니다.
mas는 기존의 유효한 sudo 자격 증명을 사용하며, 이것이 실패할 경우 macOS 사용자 암호를 입력받는 프롬프트로 대체합니다. 입력된 암호는 sudo 프로세스로 직접 전달되며, mas가 암호를 볼 수도 없고 저장하지도 않습니다.
mas에 의해 사용되거나 생성된 모든 sudo 자격 증명은 사용자가 설정한 sudo 타임아웃에 따라 mas가 종료된 후에도 유효한 상태로 유지됩니다.

## App Store Apple Account Requirements
`get`, `install`, `lucky`, `update` & `outdated --accurate` 명령어는 App Store에 로그인된 Apple Account가 필요합니다.

## App Store Apple Account Requirements for `get`
`get` 명령어는 App Store에 로그인된 Apple Account가 필요합니다.
Apple Account가 이미 App Store에 로그인되어 있는 경우에도, 시스템 보안 설정에 따라 다운로드하려는 각 앱마다 Apple Account 인증을 요구할 수 있습니다.
`System Settings` > `Touch ID & Password` > `Use Touch ID for purchases in iTunes Store, App Store and Apple Books` 설정이 다음과 같을 때:
- `Enabled`: 다운로드하는 각 앱마다 (Touch ID 또는 Apple Account 암호를 통해) 인증해야 합니다.
- `Disabled`: 만약 `System Settings` > `Apple Account` > `Media & Purchases` > `Free Downloads` 설정이 다음과 같다면:
- `Always Require`: 다운로드하는 각 앱마다 (Apple Account 암호를 통해) 인증해야 합니다.
- `Never Require`: 추가 인증 없이 앱이 다운로드됩니다.

\*\*참고:\*\* App Store 인증은 앱을 다운로드하기 위해 루트 권한을 부여하는 데 필요한 macOS 사용자 인증과는 별개입니다.

## Outdated-App Detection
`outdated` 및 `update` 명령어에서 앱의 구버전 여부는 다음 2가지 설정을 통해 구성할 수 있습니다:
- [Minimum macOS Check](#minimum-macos-check)
- [Accuracy](#accuracy)

### Concepts & Constraints
\*\*릴리스(Release)\*\*는 사용자에게 배포되는 앱의 빌드입니다.
\*\*버전(Version)\*\*은 동일한 앱의 다른 모든 릴리스와 비교하여 릴리스의 순서를 매기는 레이블입니다.
[iTunes Search API](https://performance-partners.apple.com/search-api)는 자신이 인식하는 최신 릴리스에 대한 앱 데이터만 보고하며, 결과적 일관성(Eventual consistency) 지연으로 인해 API가 App Store에서 사용 가능한 최신 릴리스를 인식하지 못할 수 있습니다.

### Minimum macOS Check
- `--check-min-os` (기본값): 구버전 앱 목록을 필터링하여 [iTunes Search API](https://performance-partners.apple.com/search-api)가 보고한 릴리스가 현재 사용 중인 macOS와 호환되는 앱만 포함합니다.
- `--no-check-min-os`: 구버전 앱을 필터링하지 않습니다. 이 설정은 여러 개의 최신 릴리스가 존재하고 일부는 현재 macOS와 호환되지만 가장 최신 버전은 호환되지 않을 때 유용합니다. 이 설정을 사용하면 최신 릴리스가 설치된 릴리스보다 최신이지만 현재 macOS와 호환되지 않는 앱은 다음과 같이 처리됩니다:
- `outdated`: 구버전으로 보고되어 위음성(False negative)을 방지하지만, 위양성(False positive)을 유발할 수 있습니다.
- `update`: 현재 macOS와 호환되는 가장 최신 릴리스(설치된 버전이거나 더 최신이지만 절대 최신은 아닐 수 있는 버전)를 설치할 수 있는 대화상자를 표시합니다.

### Accuracy
2가지 구버전 앱 감지 모드는 상호 배타적인 플래그를 통해 선택할 수 있습니다:

| 기능 | `--inaccurate` (기본값) | `--accurate` |
|:-----------------|:---------------------------------------------------------------------------------|:---------------------------------------------|
| \*\*메서드\*\* | [iTunes Search API](https://performance-partners.apple.com/search-api) 쿼리 | App Store 다운로드를 시작하여 메타데이터 읽기 |
| \*\*정확도\*\* | 잠재적 위양성 또는 위음성 발생 가능 | 위양성 또는 위음성 없음 |
| \*\*속도\*\* | 빠름 (앱당 약 7ms) | 느림 (앱당 약 175ms) |
| \*\*요구사항\*\* | [iTunes Search API](https://performance-partners.apple.com/search-api) | App Store에 로그인된 Apple Account |
| \*\*대화상자\*\* | `--no-check-min-os`를 사용할 때만 | 다양한 잠재적 대화상자 발생 가능 |
| \*\*멈춤 현상\*\* | 없음 | 100개 이상의 앱을 연속으로 빠르게 확인할 경우 발생 가능 |

#### `--inaccurate` (기본값)
inaccurate 모드는 다음 사항에 최적화되어 있습니다:
- 빠른 속도 유지
- 멈춤(hang) 현상 방지
- 대화상자 표시 방지 (`--no-check-min-os`가 제공되지 않은 경우)
- App Store에 Apple Account가 로그인되어 있지 않아도 모든 Apple Account가 소유한 구버전 앱을 보고 (단, 앱 업데이트는 App Store에 로그인된 Apple Account로만 가능)
설치된 앱의 버전을 [iTunes Search API](https://performance-partners.apple.com/search-api)가 보고하는 버전과 [Semantic Versions](https://semver.org) 기준으로 비교하며, 빌드 메타데이터를 통해 동점을 해결합니다.
이 모드는 잠재적인 오탐(false positive) 및 미탐(false negative)이 발생할 수 있습니다:
- \*\*버전 불일치:\*\* 일부 앱의 경우, iTunes Search API가 다른 모든 App Store 시스템 및 설치된 앱이 보고하는 동일 릴리스의 버전과 지속적으로 다른 버전을 보고하여 오탐 또는 미탐을 유발합니다.
- \*\*최종 일관성 지연(Eventual consistency delays):\*\* App Store와 iTunes Search API 간의 지연으로 인해 미탐이 발생할 수 있습니다.
#### `--accurate`
accurate 모드는 속도 저하, 잠재적인 멈춤 현상 및 대화상자 표시를 감수하면서 오탐과 미탐을 방지하도록 최적화되어 있습니다.
다운로드 메타데이터에서 올바른 최신 버전을 얻기 위해 App Store에서 설치된 앱의 최신 릴리스 다운로드를 시작합니다. 이후의 동작은 명령에 따라 다릅니다:
- `outdated`: 각 다운로드는 즉시 취소되며, 앱의 버전이 다운로드 메타데이터 버전과 다를 경우 구버전으로 보고됩니다.
- `update`: 설치된 버전이 다운로드 메타데이터 버전과 동일한 경우에만 다운로드가 취소됩니다. 그렇지 않으면 업데이트가 완료됩니다.
이 모드의 특징:
- `--no-check-min-os`가 제공되지 않은 경우에만 [iTunes Search API](https://performance-partners.apple.com/search-api)에 연결됩니다.
- App Store에 로그인된 Apple Account가 필요합니다.
- 다음과 같은 경우 대화상자가 열립니다:
- App Store에 Apple Account가 로그인되어 있지 않은 경우.
- 다른 Apple Account가 소유한 각 앱의 경우.
- App Store에서 더 이상 사용할 수 없는 각 앱의 경우.
- `--no-check-min-os`가 제공된 경우, iTunes Search API가 보고한 릴리스가 현재 macOS와 호환되지 않는 각 앱의 경우.
- 멈춤 현상 발생 가능: 수십 개의 앱에 대한 다운로드를 시작하는 것은 안전하지만, 수백 개의 앱에 대해서는 App Store가 응답을 멈추게 할 수 있습니다. 이는 Apple의 속도 제한(rate limiting) 때문일 가능성이 높으며, 정확한 임계값, 지속 시간 및 영향은 현재 알려져 있지 않습니다.
## 라이선스
[MIT license](LICENSE) 하에 라이선스가 부여됩니다.
원작자: Andrew Naylor
([GitHub의 @argon](https://github.com/argon) |
[X의 @argon](https://x.com/argon))