콘텐츠로 이동

Apple

아카이브, 설치 가능 파일 또는 빌드된 앱을 대상으로 tuist inspect bundle를 실행하여 Apple 번들을 분석하세요:

bash
tuist inspect bundle App.ipa
bash
tuist inspect bundle App.xcarchive
bash
tuist inspect bundle App.app
bash
tuist inspect bundle App --platforms ios --configuration Debug

macOS에서 경로 대신 앱 이름을 전달하면 Tuist는 Xcode의 빌드 산출물에서 빌드된 .app를 해결합니다(--derived-data-path가 설정된 경우 이를 반영함). 이는 tuist share와 동일한 방식입니다.

이 명령어는 번들을 Tuist에 업로드하고 콘텐츠 스캔 및 모듈 세부 정보를 포함한 상세 개요 링크를 반환합니다:

분석된 번들

App Store Connect와 비교하기#

Tuist는 제공된 번들을 그대로 측정하며 앱 슬라이싱을 적용하지 않습니다. 보고되는 크기는 기기별 변형이 아닌 **유니버설**(슬라이싱되지 않은) 변형에 해당합니다. 이는 App Store Connect의 앱 파일 크기 보고서에서 "Universal"로 표시된 행과 일치합니다.

수치는 Universal 행과 유사한 범위이지만 정확히 동일하지는 않습니다:

  • 설치 크기는 Universal 설치 크기와 비슷합니다. App Store Connect는 파일 시스템 블록 할당 및 Apple 자체 추정치 등 원시 파일 크기 측정으로는 포착되지 않는 온디바이스 오버헤드를 포함하므로 약간 더 높은 값을 보고합니다.
  • 다운로드 크기는 Universal 다운로드 크기보다 작습니다. Apple은 업로드 후 앱 바이너리를 암호화하며, 암호화된 데이터는 압축 효율이 낮기 때문에 App Store의 압축 다운로드 크기가 Tuist가 측정한 .ipa 아카이브보다 커집니다. 이는 업로드 후 Apple 측에서 발생하므로 Tuist의 수치에는 반영되지 않습니다.

App Store Connect의 기기별 행은 앱 슬라이싱이 특정 기기에 필요 없는 CPU 아키텍처와 에셋 변형을 제거하므로 더 작습니다. Tuist는 현재 기기별(슬라이싱된) 크기를 보고하지 않습니다.

태그#

번들 업로드 시 태그를 추가하여 빌드 변형, 환경 또는 릴리스 채널을 구분하세요. 번들 태그는 빌드 인사이트 태그와 동일한 규칙을 따릅니다:

bash
tuist inspect bundle App.ipa --tags paid production

CI에서는 TUIST_BUNDLE_TAGS을 사용하여 쉼표로 구분된 태그를 설정할 수도 있습니다:

bash
TUIST_BUNDLE_TAGS="paid,production" tuist inspect bundle App.ipa

명시적인 --tags은 환경 변수의 태그를 대체합니다. 태그에는 문자, 숫자, 하이픈 및 밑줄을 사용할 수 있으며, 번들당 최대 10개, 태그당 최대 50자까지 허용됩니다. 동일한 옵션은 Android 번들에도 적용됩니다. --json는 로컬에서만 작동하며 태그나 번들을 업로드하지 않습니다.

태그는 번들 이름 옆과 번들 세부 정보에 표시됩니다. 대시보드의 태그 필터를 사용하여 태그를 입력하면 번들 목록에서 포함하거나 제외할 수 있습니다. 필터 연산자 레이블이 포함 및 미포함이라도 매칭은 정확하고 대소문자를 구분합니다. 즉, paid는 paid-extra와 일치하지 않습니다. CLI에서 필터링하려면:

bash
tuist bundle list --tags paid production

CLI, API(?tags=paid,production), 그리고 MCP list_bundles 도구(tags: ["paid", "production"])는 지정된 모든 태그를 포함하는 번들을 반환합니다. API 업로드는 bundle.custom_metadata.tags를 허용하며, 목록 및 상세 응답은 custom_metadata.tags를 반환합니다. 태그가 없는 기존 번들은 이전과 동일하게 사용 가능합니다. 태그는 번들 목록을 필터링하지만, 크기 차트나 자동 비교 및 임계값 기준선에는 영향을 주지 않습니다.

기존 클라이언트는 태그 없이 번들을 계속 업로드하고 읽을 수 있습니다. 업데이트된 클라이언트는 custom_metadata를 생략하는 이전 서버의 응답도 읽을 수 있습니다. 태그 저장 및 필터링에는 번들 태그를 지원하는 서버 버전이 필요합니다. 이전 서버는 업로드 메타데이터를 무시하고 태그 필터를 거부합니다. 업데이트된 클라이언트는 태그가 제공되지 않을 때 업로드 메타데이터와 태그 쿼리 매개변수를 모두 생략합니다.

번들 크기 이해하기#

분석된 각 번들에 대해 Tuist는 두 가지 값을 보고합니다:

  • 설치 크기: 기기에 설치된 후 앱이 차지하는 공간입니다.
  • 다운로드 크기: 사용자가 다운로드하는 압축된 크기입니다. Apple 번들의 경우 .ipa(아카이브 크기)에만 보고되며, .xcarchive 또는 .app 입력의 경우에는 사용할 수 없습니다.

크기는 바이트 단위로 저장되며 십진법 규약을 사용하여 표시됩니다. 여기서 1MB는 1,000,000바이트이고 1GB는 1,000,000,000바이트입니다. 이는 Apple이 스토리지 및 앱 크기를 보고할 때 사용하는 것과 동일한 규약입니다(Apple 기기에서 스토리지 용량을 측정하는 방법 참조). 설치 크기 733,446,863바이트는 733.4MB로 표시됩니다.

지속적 통합#

시간 경과에 따른 번들 크기를 추적하려면 CI에서 번들을 분석하세요. 먼저 CI가 인증되었는지 확인하세요.

Tuist는 번들을 보고할 프로젝트를 알아야 합니다. 아직 프로젝트를 연결하지 않았다면 tuist init을 실행하거나 핸들을 직접 선언하세요:

swift
let tuist = Tuist(fullHandle: "my-account/my-project")
toml
project = "my-account/my-project"

Gradle 프로젝트와 같이 Swift 매니페스트가 없는 프로젝트에는 tuist.toml를 사용하세요. 두 파일이 모두 존재하는 경우 Tuist.swift가 우선합니다.

GitHub Actions 워크플로우 예시:

yaml
name: Build
jobs:
build:
steps:
- # Build your app
- name: Analyze bundle
run: tuist inspect bundle App.ipa
env:
TUIST_TOKEN: ${{ secrets.TUIST_TOKEN }}
yaml
name: Build
jobs:
build:
steps:
- # Build your app
- name: Analyze bundle
# .aab is recommended over .apk for more accurate size analysis
run: tuist inspect bundle App.aab
env:
TUIST_TOKEN: ${{ secrets.TUIST_TOKEN }}

설정 완료 후 시간이 지남에 따라 번들 크기가 어떻게 변화하는지 확인할 수 있습니다:

번들 크기 그래프

풀/머지 요청 댓글#

Git 포지 통합 필요

자동 풀/머지 요청 댓글을 받으려면 Tuist 프로젝트를 Git 포지와 통합하세요.

Tuist 프로젝트가 GitHub와 같은 Git 플랫폼과 연결되면, tuist inspect bundle을 실행할 때마다 Tuist가 풀/머지 요청에 직접 댓글을 게시합니다:

검사된 번들이 포함된 GitHub 앱 댓글

크기 임계값#

Git 포지 통합 필요

크기 임계값을 사용하려면 Tuist GitHub App을 프로젝트에 연결하세요. 프로젝트의 통합 페이지에서 이 작업을 수행할 수 있습니다.

크기 임계값을 사용하면 번들 크기가 기준 브랜치와 비교하여 구성된 백분율 또는 절대 크기를 초과할 때 풀 요청을 차단할 수 있습니다. 임계값을 위반하면 Tuist는 PR 커밋에 GitHub Check Run을 생성하여 크기 증가가 해결될 때까지 머지를 차단합니다:

번들 크기 임계값 초과를 보여주는 PR 상태 확인

체크 런은 기준 크기, 현재 크기 및 구성된 단위에서의 변경 사항을 보여줍니다. 증가가 의도된 것이라면 GitHub UI에서 수락 버튼을 클릭하여 직접 수락할 수 있습니다:

임계값 위반을 보여주는 GitHub 체크 런

구성#

임계값을 구성하려면 프로젝트의 설정 > 번들 탭으로 이동하세요:

번들 크기 임계값 설정

설치 크기 또는 다운로드 크기를 선택한 다음 임계값 유형을 선택하세요:

  • 백분율(%): 기준 크기에 상대적인 성장을 제한합니다. 0.47와 같은 소수점 백분율이 지원됩니다. 기존 백분율 임계값은 구성된 값과 동작을 유지합니다.
  • 절대 크기(MB): 기준 크기와 무관하게 고정된 양만큼 성장을 제한합니다. 최대 1.5MB의 성장을 허용하려면 1.5를 입력하세요. MB는 십진 단위를 사용합니다: 1MB = 1,000,000바이트. 값은 양의 정수 바이트로 해석되어야 합니다.

절대 번들 크기 성장 임계값 구성

두 유형 모두 구성된 기준 브랜치의 최신 번들과 비교하며, 이름이 같고 번들 유형(예: .app 또는 .ipa)이 동일하며 최소한 하나의 플랫폼이 공통되어야 합니다. 따라서 시뮬레이터 .app는 시뮬레이터 .app 업로드와만 비교됩니다. 선택 사항인 번들 이름은 규칙을 해당 번들로 제한합니다. 성장이 한도를 초과할 때만 검사가 실패하며, 성장이 동일하거나 크기가 변하지 않거나 감소하는 경우는 통과합니다. 일치하는 기준이나 선택한 지표에 대한 기록된 크기가 없으면 규칙은 건너뜁니다. 절대 한도의 경우 크기가 0인 기준이 지원되지만, 백분율 성장은 정의되지 않으므로 백분율 한도는 이를 계속 건너뜁니다.

수락 가능한 사용자 제한#

기본적으로 리포지토리에 쓰기 권한이 있는 모든 사용자는 크기 증가를 수락할 수 있습니다. GitHub가 버튼을 표시하는 대상이기 때문입니다. 범위를 좁히려면 설정 > 번들 아래에서 수락 가능한 사용자를 설정하세요:

  • 모든 사용자: 기본값입니다. 리포지토리에 쓰기 권한이 있는 모든 사용자입니다.
  • 선택한 GitHub 사용자: 추가한 GitHub 사용자 이름만 해당됩니다.

목록에 없는 사용자는 설명과 함께 검사를 실패 상태로 남기며, 버튼은 사용할 수 있는 사용자를 위해 유지됩니다.