빌드 프로필
SDK는 각 작업 메뉴별로 다른 빌드 설정(프로필)을 자동 적용해요.
이를 통해 개발, 테스트, 배포 각 단계에 최적화된 빌드를 생성할 수 있어요.
작업 메뉴
| 메뉴 | 용도 |
|---|---|
AIT > Dev Server > Start Server | 로컬 개발 서버를 실행해요 |
AIT > Production Server > Start Server | 프로덕션 설정으로 로컬 서버를 실행해요 (샌드박스 앱 연동 가능) |
AIT > Build & Package | 배포용 패키지를 생성해요 |
AIT > Publish | Apps in Toss에 배포해요 |
프로필 매트릭스
각 프로필의 기본 설정이에요:
| 작업 | Mock 브릿지 | 디버그 콘솔 | Development Build | WebGL 압축 | Stripping Level | LZ4 압축 | 디버그 심볼 |
|---|---|---|---|---|---|---|---|
| Dev Server | 활성화 | 활성화 | 활성화 | Disabled | Minimal | 활성화 | Embedded |
| Production Server | 비활성화 | 비활성화 | 비활성화 | 자동 (Brotli) | 자동 (High) | 활성화 | External |
| Build & Package | 비활성화 | 비활성화 | 비활성화 | 자동 (Brotli) | 자동 (High) | 활성화 | External |
| Publish | 비활성화 | 비활성화 | 비활성화 | 자동 (Brotli) | 자동 (High) | 활성화 | External |
각 설정의 의미
Mock 브릿지
네이티브 API가 없는 환경(로컬 브라우저)에서 SDK API를 테스트할 수 있도록 하는 시뮬레이션 레이어예요.
| 값 | 설명 |
|---|---|
| 활성화 | 로컬 브라우저에서 테스트할 수 있어요 (Mock 데이터 반환) |
| 비활성화 | 실제 Apps in Toss 앱 환경에서만 동작해요 |
Development Build
Unity의 Development Build 옵션을 활성화해요.
| 값 | 설명 |
|---|---|
| 활성화 | 빌드 속도가 향상되고, 디버깅이 편리해요 (Profiler 연결 가능) |
| 비활성화 | 최적화된 릴리즈 빌드예요 |
디버그 심볼
디버그 심볼(소스맵) 포함 방식을 결정해요.
| 값 | 설명 |
|---|---|
| Embedded | 빌드 파일에 심볼이 포함돼요 (파일 크기 증가, 디버깅 용이) |
| External | 별도 파일로 분리돼요 (파일 크기 감소, 배포에 적합) |
디버그 콘솔
화면에 디버그 콘솔 UI를 표시해요.
| 값 | 설명 |
|---|---|
| 활성화 | 좌측 하단에 디버그 버튼이 표시돼요 (메트릭, 로그 확인 가능) |
| 비활성화 | 디버그 UI가 숨겨져요 |
WebGL 압축
최종 빌드 결과물의 압축 포맷을 결정해요.
| 값 | 설명 |
|---|---|
| 자동 | Brotli를 사용해요 (기본값) |
| Disabled | 압축 없음 (빌드 속도 우선) |
| Gzip | Gzip 압축 |
| Brotli | Brotli 압축 (최고 압축률) |
TIP
Dev Server는 빌드 속도를 위해 Disabled, 나머지 프로필은 자동(Brotli)이 기본값이에요.
Stripping Level
사용하지 않는 코드를 제거해서 빌드 크기를 줄이는 수준을 결정해요.
| 값 | 설명 |
|---|---|
| 자동 | High를 사용해요 (기본값) |
| Disabled | 코드 제거 없음 |
| Minimal | 최소한의 코드만 제거 |
| Low | 낮은 수준의 코드 제거 |
| Medium | 중간 수준의 코드 제거 |
| High | 적극적으로 코드 제거 (최소 빌드 크기) |
LZ4 압축
Unity 빌드 프로세스에서 LZ4 압축을 사용해서 빌드 속도를 향상시켜요.
모든 프로필에서 기본적으로 활성화되어 있어요.
프로필 커스터마이징
각 프로필의 설정을 개별적으로 변경할 수 있어요.
설정 방법
AIT > Configuration메뉴를 열어요.- "빌드 프로필" 섹션을 확장해요.
- 원하는 프로필(Dev Server, Production Server 등)을 펼쳐요.
- 각 옵션의 체크박스를 변경해요.
- 변경 사항은 자동 저장돼요.
설정 저장 위치
프로필 설정은 Assets/AppsInToss/Editor/AITConfig.asset에 저장돼요.
환경 변수 오버라이드
CI/CD 환경이나 자동화 스크립트에서 환경 변수를 통해 빌드 프로필 설정을 오버라이드할 수 있어요.
지원 환경 변수
| 환경 변수 | 설명 | 값 |
|---|---|---|
AIT_DEBUG_CONSOLE | 디버그 콘솔 활성화 | true / false |
AIT_COMPRESSION_FORMAT | 압축 포맷 오버라이드 | -1 (자동) / 0 (Disabled) / 1 (Gzip) / 2 (Brotli) |
사용 예시
Unity Editor를 커맨드라인으로 실행할 때 환경 변수를 설정할 수 있어요:
bash
AIT_DEBUG_CONSOLE=true /Applications/Unity/Hub/Editor/2022.3.62f1/Unity.app/Contents/MacOS/Unity \
-quit -batchmode -projectPath ./MyProject빌드 로그
빌드 시작 시 적용된 프로필이 Unity Console에 출력돼요:
[AIT] ========================================
[AIT] 빌드 프로필: Dev Server
[AIT] ========================================
[AIT] Mock 브릿지: 활성화
[AIT] 디버그 콘솔: 활성화
[AIT] Development Build: 활성화
[AIT] LZ4 압축: 활성화
[AIT] 압축 포맷: Disabled
[AIT] Stripping Level: Minimal
[AIT] 디버그 심볼: Embedded
[AIT] ========================================이 로그를 통해 현재 빌드에 어떤 설정이 적용되었는지 확인할 수 있어요.