---

한눈에 보기

Universal Build Script는 현재 디렉터리가 단일 프로젝트인지 모노레포 루트인지 판단한 뒤, 감지된 프로젝트를 알맞은 빌드 어댑터로 연결합니다.

./build.sh

인자 없이 실행하면 다음 안전한 기본값을 사용합니다.

항목	기본 동작
실행 방식	비대화형
앱 버전	변경하지 않음
단일 프로젝트	현재 프로젝트만 빌드
모노레포 루트	하위 프로젝트를 찾아 경로순으로 모두 빌드
Flutter 출력	auto: macOS는 AAB+IPA, 그 외는 AAB
Flutter 캐시	flutter clean을 생략하고 기존 캐시 유지
Tauri 패키징	서명 설정 완전: .pkg, 불완전: .app
여러 프로젝트 중 하나 실패	나머지를 계속 실행하고 마지막에 집계
UBS 업데이트	빌드와 분리. update 명령에서만 실행

사용자 진입점은 루트의 ./build.sh입니다. scripts/ 아래 파일은 내부 어댑터이므로 직접 실행할 필요가 없습니다.

빠른 시작

설치

빌드하려는 단일 프로젝트 루트 또는 모노레포 루트에서 실행합니다.

curl -fsSL https://raw.githubusercontent.com/kimdzhekhon/Universal-Build-Script/main/install.sh | bash

설치 프로그램은 모노레포에서도 사용할 수 있도록 모든 어댑터를 함께 설치합니다. 기존 UBS 파일은 기본적으로 보존됩니다. 기존 파일까지 갱신하려면 다음처럼 실행합니다.

curl -fsSL https://raw.githubusercontent.com/kimdzhekhon/Universal-Build-Script/main/install.sh \
  | UBS_FORCE=true bash

실행

./build.sh

실제 빌드 전에 감지 결과만 확인하고 싶다면:

./build.sh detect
./build.sh audit
./build.sh --dry-run

버전과 Flutter 플랫폼을 메뉴에서 직접 선택하려면:

./build.sh --interactive

AI와 MCP 연동

이 저장소에는 AI가 빌드 절차를 일관되게 수행하도록 skills/universal-build 스킬이 포함되어 있습니다. Codex 같은 스킬 호환 에이전트에 이 폴더를 설치하거나 SKILL.md를 에이전트 지침으로 제공하면 detect --json → audit --json → plan --json → 실제 build 순서로 작업합니다.

예시 프롬프트:

$universal-build 이 워크스페이스를 감지하고 최적화 감사를 한 다음,
Flutter AAB와 Web을 버전 변경 없이 빌드해줘.

스킬은 자체 빌드 로직을 복제하지 않고 저장소의 ./build.sh를 호출합니다. 따라서 사람, CI, AI가 동일한 감지 규칙과 어댑터를 사용합니다.

기계 판독용 명령

./build.sh detect --json /workspace
./build.sh audit --json /workspace
./build.sh plan --json /workspace

감지는 { "type", "path" } 객체 배열을, 감사는 { "type", "path", "category", "check", "status", "detail" } 객체 배열을 출력합니다. 계획은 실행될 { "type", "path", "adapter", "options" } 객체 배열을 반환합니다. 세 명령 모두 읽기 전용이며 JSON은 stdout, 오류는 stderr로 분리됩니다.

MCP로 감쌀 때

현재 저장소는 MCP 서버 자체를 포함하지 않습니다. 대신 임의 셸 실행기를 노출하지 않고 아래 네 도구만 허용하는 얇은 래퍼를 권장합니다.

MCP 도구 예시	내부 명령	성격
detect_projects(root)	./build.sh detect --json ROOT	읽기 전용
audit_build(root)	./build.sh audit --json ROOT	읽기 전용 정적 분석
plan_build(root, options)	./build.sh plan --json ... ROOT	읽기 전용 구조화 계획
run_build(root, options)	./build.sh ... ROOT	파일·버전·산출물을 변경할 수 있음

MCP 구현에서는 허용된 workspace root, 옵션 enum, timeout, stdout/stderr, 종료 코드를 검증해야 합니다. run_build는 명시적인 사용자 의도가 있을 때만 호출하고, 셸 문자열·서명 비밀·배포 명령을 자유 형식 인자로 받지 않는 구성이 안전합니다.

실행 흐름

flowchart TD
    A["사람·AI·CI가 ./build.sh 실행"] --> B["프로젝트 감지"]
    B --> C["최적화·난독화 설정 감사 가능"]
    C --> D{"dry-run 또는 실제 build"}
    D -->|"dry-run"| E["실행 계획만 출력"]
    D -->|"build"| F{"단일 프로젝트인가?"}
    F -->|"예"| G{"어댑터 선택"}
    F -->|"아니오"| H["하위 프로젝트 재귀 탐색"]
    H --> I["중복·생성 폴더 제거 후 경로순 실행"]
    I --> G
    G -->|"Tauri"| J["macOS .app 또는 서명된 .pkg"]
    G -->|"Flutter"| K["AAB / APK / IPA / Web"]
    G -->|"Android·Kotlin·KMP"| L["Gradle task 실행"]
    G -->|"React·Next·Node"| M["패키지 매니저 + build script"]
    J --> N["성공·실패와 산출물 출력"]
    K --> N
    L --> N
    M --> N

지원 범위

감지 순서는 Tauri → Flutter → Gradle → Node입니다. 상위 생태계를 먼저 확인해 Tauri가 React로, Flutter가 Android 프로젝트로 중복 감지되는 것을 방지합니다.

타입	감지 기준	기본 빌드	주요 산출물
Tauri 2	src-tauri/tauri.conf.json	패키지 매니저의 tauri build	.app, 조건 충족 시 .pkg
Flutter	Flutter SDK가 선언된 pubspec.yaml	flutter build appbundle/ipa (auto)	AAB, APK, IPA, Web, 디버그 심볼
Android	Gradle의 com.android.application/library	앱: bundleRelease, 그 외: build	Gradle 프로젝트 설정에 따름
Kotlin Multiplatform	Kotlin Multiplatform Gradle 플러그인	build	타깃별 Gradle 산출물
Kotlin/JVM	Kotlin Gradle 플러그인	build	JAR 등 프로젝트 설정에 따름
일반 Gradle	Gradle 프로젝트 파일	build	프로젝트 설정에 따름
Next.js	package.json의 next + scripts.build	<pm> run build	일반적으로 .next/
React	package.json의 react + scripts.build	<pm> run build	Vite 등 도구 설정에 따름
일반 Node	package.json의 scripts.build	<pm> run build	build script 설정에 따름

중복 감지 방지

• Tauri 루트에 있는 React/Vite 프런트엔드는 별도 React 프로젝트로 등록하지 않습니다.
• Flutter 내부 android/, ios/, macos/, linux/, windows/, web/은 별도 프로젝트로 등록하지 않습니다.
• 모노레포의 형제 디렉터리에 있는 앱들은 각각 독립 프로젝트로 감지합니다.
• .git, node_modules, build, dist, target, .gradle, .dart_tool, .next는 재귀 탐색에서 제외합니다.
• package.json에 build script가 없는 Node 패키지는 빌드 대상에서 제외합니다.

명령과 옵션

자주 쓰는 명령

# 단일 앱 또는 모노레포 전체 자동 빌드
./build.sh

# 감지 목록만 출력
./build.sh detect

# AI/CI용 JSON 감지와 최적화·난독화 감사
./build.sh detect --json
./build.sh audit --json
./build.sh plan --json

# 실제 실행 없이 계획 확인
./build.sh --dry-run

# 특정 프로젝트만 빌드
./build.sh build --project apps/mobile

# 특정 타입만 빌드
./build.sh build --all --type flutter
./build.sh build --all --type react

# 실패 즉시 전체 실행 중단
./build.sh --fail-fast

# UBS 전체 런타임 업데이트 확인·미리 보기·적용
./build.sh update --check
./build.sh update --dry-run
./build.sh update

공통 옵션

옵션	설명
detect [경로]	지정 경로 아래의 프로젝트 목록 출력
audit [경로]	최적화·난독화 관련 설정을 정적으로 감사
plan [경로]	어댑터와 적용 옵션을 실행 없이 계획
update --check	원격 manifest와 로컬 버전·해시 비교
update --dry-run	교체될 관리 파일만 출력
update	검증 다운로드, 백업, 원자적 교체 수행
--json	detect/audit/plan 결과를 JSON 배열로 출력
--dry-run	어댑터를 실행하지 않고 빌드 계획만 출력
--interactive	Flutter/Tauri 버전과 Flutter 플랫폼 선택 메뉴 사용
--non-interactive	안전한 기본값으로 무인 실행. 현재 기본값
--project <경로>	지정한 프로젝트 하나만 감지하고 빌드
--all	지정 루트 아래 감지된 프로젝트 전체 빌드
--type <타입>	전체 빌드에서 정확히 일치하는 타입만 선택
--version-bump <정책>	none, build, patch, minor, major
--flutter-platform <값>	auto, all, ios, android
--flutter-outputs <목록>	auto 또는 appbundle,apk,ipa,web의 쉼표 목록
--clean	Flutter 빌드 전에 flutter clean 실행
--skip-clean	Flutter 빌드 캐시 유지. 현재 기본값
--fail-fast	첫 실패에서 전체 빌드 중단

build 버전 정책은 Flutter의 build number 전용입니다. Tauri가 포함된 모노레포 전체에 --version-bump build를 적용하면 Tauri 어댑터는 지원하지 않는 정책으로 실패합니다.

종료 코드와 실패 처리

종료 코드	의미
0	선택된 모든 프로젝트 성공
1	감지 실패, 빌드 실패 또는 선택 대상 없음
2	잘못된 옵션이나 지원하지 않는 값

--fail-fast가 없으면 프로젝트 하나가 실패해도 다음 프로젝트를 계속 빌드합니다. 마지막 결과에서 전체·성공·실패 개수를 확인할 수 있습니다.

Flutter와 Tauri의 버전을 올린 뒤 빌드가 실패하거나 취소되면 원래 버전으로 자동 복원합니다. 성공한 경우에만 새 버전을 유지합니다.

빌드 스크립트 업데이트

기본 빌드는 네트워크에서 UBS 코드를 가져오지 않습니다. 업데이트 여부 확인과 적용은 빌드에서 분리된 명령으로 실행합니다.

# 버전과 관리 파일 무결성만 비교
./build.sh update --check

# 변경될 파일 확인. 다운로드·백업·교체 없음
./build.sh update --dry-run

# 전체 관리 번들 업데이트
./build.sh update

실제 업데이트는 다음 순서로 진행됩니다.

HTTPS manifest 다운로드
  → 허용된 16개 경로·중복·누락 검사
  → 로컬 SHA-256 비교
  → 변경 파일 전체를 임시 폴더에 다운로드
  → SHA-256 전부 검증
  → .ubs/backups/<timestamp>/ 백업
  → 파일별 임시 파일 + rename 교체
  → 실패 시 이미 교체한 파일 복원

업데이트 대상은 build.sh, 설치기, 어댑터, 감지·감사·업데이트 모듈, 버전 파일과 universal-build AI 스킬입니다. 프로젝트 소스, README, .env*, Apple 서명 파일, ios/ExportOptions.plist는 덮어쓰지 않습니다.

처음 설치된 구버전에 update 명령이 없다면 설치기를 한 번 갱신해야 합니다.

curl -fsSL https://raw.githubusercontent.com/kimdzhekhon/Universal-Build-Script/main/install.sh \
  | UBS_FORCE=true bash

백업은 자동 삭제하지 않습니다. .ubs/를 프로젝트 .gitignore에 추가하고, 업데이트가 정상 확인된 후 .ubs/backups/를 저장소 정책에 맞게 정리하십시오.

관리 파일을 개발·배포할 때는 VERSION을 올리고 아래 명령으로 manifest를 다시 생성해야 합니다. CI가 manifest와 실제 파일 해시의 차이를 차단합니다.

scripts/generate-update-manifest.sh > scripts/update-manifest.txt

Flutter 빌드

요구 사항

• Flutter SDK와 flutter 명령
• Android 빌드: Android SDK 및 서명 설정
• iOS 빌드: macOS, Xcode, Apple 서명 설정
• iOS 내보내기: ios/ExportOptions.plist

기본 동작

버전 정책 적용
  → 선택적으로 flutter clean
  → flutter pub get
  → Android AAB 및/또는 iOS IPA 릴리스 빌드
  → 결과 경로와 소요 시간 출력

• 기본 버전 정책은 none입니다.
• 기본 플랫폼 auto는 macOS에서 Android+iOS, 그 외 운영체제에서 Android를 선택합니다.
• --flutter-outputs를 지정하면 플랫폼 자동 선택을 덮어쓰며 원하는 결과를 조합할 수 있습니다.
• .env.prod가 있으면 우선 사용하고, 없으면 .env를 사용합니다.
• 두 파일이 모두 없으면 dart-define 없이 빌드합니다.
• AAB·APK·IPA에는 --obfuscate와 --split-debug-info를 적용합니다.
• 모든 출력에 release 빌드와 icon tree shaking을 적용하며, APK는 --split-per-abi로 분리합니다.
• Flutter Web은 release 최적화 대상이지만 Flutter 네이티브의 --obfuscate 대상은 아닙니다.

# Play Store AAB + 웹 배포물
./build.sh --flutter-outputs appbundle,web

# ABI별 APK만
./build.sh --flutter-outputs apk

# 네 가지 출력 모두. IPA는 macOS/Xcode/Apple 설정 필요
./build.sh --flutter-outputs appbundle,apk,ipa,web

결과물

대상	경로
Android AAB	build/app/outputs/bundle/release/app-release.aab
Android ABI별 APK	build/app/outputs/flutter-apk/
Android 디버그 심볼	build/app/outputs/symbols/
iOS IPA	build/ios/ipa/*.ipa
iOS 디버그 심볼	build/ios/outputs/symbols/
Flutter Web	build/web/

Tauri macOS 빌드

현재 Tauri 어댑터는 macOS 전용입니다. Windows/Linux에서 Tauri 프로젝트를 감지하면 지원 범위를 설명하고 실패합니다.

요구 사항

• Tauri 2 프로젝트와 src-tauri/tauri.conf.json
• Node.js와 프로젝트가 사용하는 패키지 매니저
• Rust/Tauri 빌드 환경
• .pkg 생성 시 Apple 인증서, provisioning profile, entitlements

패키지 모드

UBS_TAURI_PACKAGE_MODE로 결과물을 제어합니다.

값	동작
auto	기본값. 서명 설정이 완전하면 .pkg, 아니면 .app 생성
signed	.pkg 필수. 서명 설정이 하나라도 없으면 빌드 전에 실패
unsigned	Apple 서명 후처리를 건너뛰고 .app 생성

서명된 .pkg에 필요한 값:

TAURI_SIGN_IDENTITY="Apple Distribution: Your Name (TEAMID)"
TAURI_INSTALLER_IDENTITY="3rd Party Mac Developer Installer: Your Name (TEAMID)"
TAURI_PROVISION_PROFILE=signing/App.provisionprofile
TAURI_ENTITLEMENTS=signing/app.entitlements

경로 두 개는 생략할 수 있습니다. 생략하면 signing/*.provisionprofile, signing/*.entitlements의 첫 번째 파일을 사용합니다.

서명 직전에는 provisioning profile과 .app 번들의 quarantine/확장 속성을 xattr -cr로 제거해 App Store 검증 오류 가능성을 줄입니다.

패키지 매니저 선택

Tauri와 React/Node 어댑터는 같은 선택 규칙을 사용합니다.

1. package.json의 packageManager 필드
2. pnpm-lock.yaml
3. yarn.lock
4. bun.lock 또는 bun.lockb
5. 그 외에는 npm

선택된 명령이 설치되어 있지 않으면 명확한 오류를 출력하고 중단합니다. npm lock 파일이 있으면 npm ci, pnpm/bun lock 파일이 있으면 frozen 설치를 사용하며 Yarn Berry는 --immutable을 사용합니다.

결과물

모드	경로
.app	src-tauri/target/release/bundle/macos/<productName>.app
서명된 .pkg	signing/build/<productName>.pkg

서명된 .pkg는 Transporter를 통해 App Store Connect에 제출할 수 있습니다.

Android·Kotlin·Gradle 빌드

Gradle Wrapper가 실행 가능하면 ./gradlew를 사용하고, 없으면 시스템 gradle을 사용합니다.

감지 결과	기본 task
Android application	bundleRelease
Android library	build
Kotlin/JVM	build
Kotlin Multiplatform	build
일반 Gradle	build

product flavor, 커스텀 variant 또는 특정 모듈 task가 필요하면 직접 지정합니다.

UBS_GRADLE_TASK=:app:bundleProdRelease ./build.sh

React·Next·Node 빌드

감지된 패키지 매니저로 의존성을 설치한 다음 scripts.build를 실행합니다.

# 기본 build 대신 build:production 실행
UBS_NODE_BUILD_SCRIPT=build:production ./build.sh

# 이미 의존성이 준비된 CI 또는 로컬 환경
UBS_SKIP_INSTALL=true ./build.sh

산출물 위치는 Vite, Next.js, CRA 등 프로젝트의 build script 설정을 따릅니다.

환경변수

UBS 공통 설정

환경변수	기본값	설명
UBS_NON_INTERACTIVE	true	무인 실행 여부
UBS_VERSION_BUMP	none	버전 정책
UBS_FLUTTER_PLATFORM	auto	Flutter 대상 플랫폼
UBS_FLUTTER_OUTPUTS	auto	Flutter 산출물 쉼표 목록
UBS_SKIP_CLEAN	true	Flutter clean 생략
UBS_SKIP_INSTALL	false	Node 의존성 설치 생략
UBS_GRADLE_TASK	자동	Gradle task 강제 지정
UBS_NODE_BUILD_SCRIPT	build	Node build script 이름
UBS_TAURI_PACKAGE_MODE	auto	Tauri .app/.pkg 정책
UBS_NO_NOTIFY	false	macOS 알림과 결과 폴더 열기 생략
UBS_ALLOW_SELF_UPDATE	false	대화형 모드에서 Flutter/Tauri 어댑터 원격 업데이트 확인 허용
UBS_UPDATE_BASE_URL	공식 main raw URL	사설 mirror 또는 테스트용 업데이트 기준 URL
UBS_UPDATE_ALLOW_DOWNGRADE	false	더 낮은 SemVer 적용을 명시적으로 허용
UBS_FORCE	false	설치 프로그램에서 기존 UBS 파일 덮어쓰기

Tauri 전용 설정

.env.macos에서는 다음 키만 읽습니다.

• TAURI_SIGN_IDENTITY
• TAURI_INSTALLER_IDENTITY
• TAURI_PROVISION_PROFILE
• TAURI_ENTITLEMENTS
• TAURI_OBFUSCATE_JS

.env.macos는 source로 실행하지 않고 허용된 값을 문자열로 파싱합니다. 셸 표현식이나 명령 치환은 실행되지 않습니다.

환경변수와 보안

• Flutter의 dart-define 값은 컴파일된 앱에서 추출될 수 있습니다.
• React/Vite의 VITE_* 값은 프런트엔드 번들에 포함됩니다.
• Supabase anon key처럼 공개 사용을 전제로 한 값만 클라이언트 빌드에 넣고, 서버 비밀키·service-role key·개인 API key는 넣지 마십시오.
• .env, .env.prod, .env.macos, provisioning profile 및 entitlements는 저장소 정책에 맞게 보호하십시오.
• 중앙 update 명령을 권장합니다. 기존 UBS_ALLOW_SELF_UPDATE=true ./build.sh --interactive는 Flutter/Tauri 어댑터 하나만 교체하는 호환 경로입니다.
• manifest 해시는 손상·불완전 다운로드를 탐지하지만, manifest와 파일이 같은 GitHub 채널에서 제공되므로 독립적인 서명 검증은 아닙니다.
• 업데이트는 HTTPS만 허용하고 지정된 관리 경로 밖이나 심볼릭 링크 경로에는 쓰지 않습니다.
• curl | bash 설치는 원격 스크립트를 즉시 실행합니다. 민감한 환경에서는 install.sh를 먼저 내려받아 검토한 다음 실행하십시오.

최적화와 난독화 감사

./build.sh audit
./build.sh audit --json
./build.sh audit --json --type flutter /workspace

감사는 어댑터 정책과 프로젝트 설정 파일을 읽는 정적 점검입니다. 실제 산출물을 디컴파일하거나 성능 측정·서명 검증·재현 빌드하는 인증 절차가 아닙니다. 따라서 “release/minify 성공”을 “모든 코드가 난독화됨”으로 표현하지 않습니다.

상태	의미
enforced	UBS 어댑터가 해당 옵션을 항상 전달
configured	인식 가능한 프로젝트 설정을 발견
framework-default	알려진 production 프레임워크 기본 처리에 위임
compiled	네이티브 release 컴파일이며 난독화 보장은 아님
recommended	선택적 크기·하드닝 설정 검토 권장
optional-off	기능은 있으나 기본적으로 꺼짐
not-configured	기대 설정을 찾지 못함
not-supported	해당 출력에서 그 방식은 지원되지 않음
unknown / project-specific	정적 규칙만으로 판정하기 어려움

스택별 실제 보장 범위

스택·출력	최적화	난독화	별도 확인 사항
Flutter AAB/APK/IPA	release AOT, icon tree shaking	--obfuscate 강제	split-debug-info 심볼을 안전하게 보관
Flutter Web	release compiler, tree shaking	네이티브 Dart 난독화 옵션 미지원	minify 결과를 난독화로 간주하지 않음
Tauri Rust	Cargo release; LTO/strip 설정 감지	네이티브 컴파일 자체는 난독화 보장이 아님	Cargo.toml release profile과 바이너리 확인
Tauri frontend	Vite/Next/CRA production 처리 감지	TAURI_OBFUSCATE_JS=true일 때만 추가 처리	dist/ 전제, 런타임 회귀·크기 증가 테스트
Android	release의 R8/minify, resource shrink 설정 감지	R8 규칙이 연결된 경우에만 근거 표시	mapping 파일 보관, reflection/serialization 테스트
Kotlin/JVM/KMP/Gradle	프로젝트의 Gradle task에 위임	자동 보장하지 않음	타깃별 패키징·ProGuard/R8/plugin 확인
React/Next/Node	인식한 프레임워크 production build에 위임	별도 패키지·설정이 있을 때만 감지	SSR/server bundle과 source map 노출 점검

추가로 서명은 게시자 신원과 무결성을 위한 절차이며 최적화·난독화와 별개입니다. 높은 보증 수준이 필요하면 빌드 로그, 산출물 크기, source map·symbol·mapping 보관 여부, 실제 디컴파일 결과, 서명 검증을 생태계별 도구로 확인해야 합니다.

아키텍처

Universal-Build-Script/
├── VERSION                          # 전체 관리 번들 버전
├── .github/dependabot.yml            # 고정된 Actions 의존성 갱신
├── .github/workflows/validate.yml   # Bash·동작·AI 스킬 CI 검증
├── build.sh                         # 사용자 진입점·실행 집계
├── install.sh                       # 전체 런타임 설치
├── scripts/
│   ├── lib/
│   │   ├── detect.sh                # 프로젝트 감지·모노레포 탐색
│   │   ├── audit.sh                 # 최적화·난독화 설정 감사
│   │   ├── update.sh                # 검증·백업·롤백 업데이트
│   │   └── node-package-manager.sh  # npm/pnpm/yarn/bun 공통 처리
│   ├── generate-update-manifest.sh  # 관리 파일 SHA-256 manifest 생성
│   ├── update-manifest.txt          # 배포 버전·허용 파일 해시
│   ├── build-flutter.sh             # Flutter AAB/APK/IPA/Web
│   ├── build-tauri-macos.sh         # Tauri macOS app/pkg
│   ├── build-gradle.sh              # Android/Kotlin/Gradle
│   ├── build-node.sh                # React/Next/Node
│   ├── FLUTTER_VERSION
│   └── TAURI_VERSION
├── ios/ExportOptions.plist
├── skills/universal-build/          # AI용 안전 실행 스킬과 감사 기준
├── tests/test-detection.sh
├── .env.example
└── .env.macos.example

어댑터는 프로젝트 디렉터리를 현재 작업 디렉터리로 받아 실행됩니다. 새 생태계를 추가할 때는 감지 규칙과 어댑터 매핑을 확장하는 방식입니다.

테스트

bash tests/test-detection.sh

현재 테스트는 임시 모노레포를 만들고 다음을 검증합니다.

• Tauri+React를 Tauri 하나로 감지
• Flutter 내부 Android 중복 제거
• 독립 Android, Kotlin Multiplatform, React 감지
• 인자 없는 ./build.sh의 모노레포 자동 전환
• dry-run 프로젝트 수
• JSON 감지 결과와 감사 스키마
• JSON 계획의 어댑터·스택별 옵션
• 업데이트 check/dry-run/적용, 백업과 SHA-256 검증
• 악성 manifest 경로와 심볼릭 링크 차단
• Flutter/Tauri/Android/React 감사 상태 판정
• Android 기본 bundleRelease 선택
• npm lock 파일의 npm ci 선택
• Flutter 성공 시 버전 유지 및 실패 시 원상 복구
• Flutter AAB·ABI별 APK·Web 다중 출력 명령
• .env가 없는 Flutter 실행 경로
• .env.macos의 명령 치환이 실행되지 않음
• 서명 설정이 없는 Tauri의 .app 대체 경로
• Tauri signed 모드의 quarantine 속성 제거와 .pkg 생성

테스트는 실제 Flutter SDK, Gradle, npm, Apple 인증서를 사용하지 않고 모의 명령으로 실행됩니다. 실제 AAB·APK·IPA·Web·PKG 생성과 산출물 수준의 난독화 검증은 각 프로젝트 환경에서 별도로 확인해야 합니다.

문제 해결

프로젝트가 감지되지 않음

./build.sh detect

• Flutter는 pubspec.yaml에 Flutter SDK 선언이 있어야 합니다.
• Node는 package.json에 문자열 형태의 scripts.build가 있어야 합니다.
• 재귀 Gradle 탐색은 settings.gradle 또는 settings.gradle.kts를 프로젝트 루트 기준으로 사용합니다.

Flutter가 iOS까지 빌드해서 실패함

macOS의 auto 기본값은 Android+iOS입니다. Android만 필요하면:

./build.sh --flutter-platform android

필요한 산출물을 더 정확히 지정하려면 플랫폼 대신 출력 목록을 사용합니다.

./build.sh --flutter-outputs appbundle,apk

Android flavor task를 찾지 못함

UBS_GRADLE_TASK=:app:bundleProdRelease ./build.sh

Tauri에서 .pkg 대신 .app만 생성됨

서명 identity, provisioning profile, entitlements 중 하나 이상이 없습니다. 누락을 즉시 확인하려면:

UBS_TAURI_PACKAGE_MODE=signed ./build.sh

패키지 매니저를 찾지 못함

package.json의 packageManager 필드 또는 lock 파일이 선택한 npm/pnpm/yarn/bun 명령을 설치하십시오. packageManager 선언과 실제 lock 파일도 일치시키는 것이 좋습니다.

전체 빌드 중 한 프로젝트 실패

기본값은 나머지 프로젝트를 계속 실행합니다. 첫 실패에서 멈추려면:

./build.sh --fail-fast

알려진 제한 사항

• 프로젝트 간 dependsOn 관계를 계산하지 않으며 경로순으로 순차 실행합니다.
• 서로 독립적인 프로젝트의 병렬 실행은 아직 지원하지 않습니다.
• Tauri 어댑터는 현재 macOS 전용입니다.
• Xcode-only 네이티브 iOS 프로젝트는 감지하지 않습니다.
• Gradle product flavor와 커스텀 task는 자동 추론하지 않습니다.
• Kotlin Multiplatform의 플랫폼별 배포 task는 자동 선택하지 않고 기본 build만 실행합니다.
• Tauri JS 난독화는 프런트엔드 결과 폴더가 dist/라고 가정합니다.
• Tauri .app 경로는 기본 release bundle 구조를 전제로 합니다.
• 모노레포 설치 시 하위 앱별 .env, Apple 서명 파일과 플랫폼 설정은 자동 생성하지 않습니다.
• audit는 알려진 설정 패턴만 찾으며 커스텀 플러그인·간접 Gradle 설정·실제 바이너리 상태를 완전히 증명하지 않습니다.
• JSON은 현재 감지·감사·계획에 제공되며 실제 빌드 결과의 구조화된 artifact manifest는 아직 없습니다.
• 업데이트 manifest는 무결성 검사용이며 별도 서명·투명성 로그를 제공하지 않습니다.

Roadmap

• Flutter/Tauri 우선순위 감지와 내부 프로젝트 중복 제거
• 단일 프로젝트·모노레포 자동 전환
• Flutter AAB/APK/IPA/Web 선택 출력, 네이티브 난독화, 심볼 분리
• Tauri macOS .app 및 서명된 .pkg
• Android/Kotlin/Kotlin Multiplatform/일반 Gradle 어댑터
• React/Next/일반 Node 어댑터
• npm/pnpm/yarn/bun 자동 선택
• dry-run, 타입 필터, 지정 프로젝트, fail-fast
• 비대화형 기본 실행과 대화형 선택 모드
• 실패·취소 시 Flutter/Tauri 버전 복원
• Tauri .env.macos 안전 파싱
• AI 스킬과 MCP 래퍼용 JSON 감지·감사 계약
• AI/MCP용 읽기 전용 JSON 빌드 계획
• 스택별 최적화·난독화 정적 감사
• Bash 동작과 AI 스킬 메타데이터 GitHub Actions 검증
• 전체 관리 번들 check/dry-run/SHA-256/백업·롤백 업데이트
• 프로젝트 의존성 그래프와 위상 정렬
• 안전한 병렬 빌드
• Tauri Windows/Linux 어댑터
• Xcode-only iOS 네이티브 어댑터
• 구조화된 JSON 빌드 리포트와 CI artifact manifest
• 선택형 로컬 MCP 서버 패키지

라이선스

MIT License — Copyright © 2024-2026 kimdzhekhon

자세한 내용은 LICENSE를 확인하십시오.