Version: 2023.1
언어: 한국어
iOS 관련 최적화
빌드한 iOS 플레이어 크기 최적화

빌트인 프로파일러로 성능 측정

참고: 내부 프로파일러는 지원이 중단되어 향후 Unity 버전에서 제거될 예정입니다. 대신 프로파일러 창(메뉴: Window > Analysis > Profiler)을 사용하십시오.

Unity에는 iOS 및 Android용 빌트인 프로파일러가 들어 있습니다. 30프레임마다 빌트인 프로파일러가 기기에서 실행되는 앱에서 콘솔 메시지를 발송합니다. 이 메시지는 앱의 동작 방식에 대한 인사이트를 제공합니다. 특히 앱이 CPU 또는 GPU 바운드인지 판단할 때 큰 도움이 됩니다. 앱이 CPU 바운드이면 스크립트 코드 또는 가비지 컬렉션이 병목 현상을 유발하는지도 확인할 수 있습니다. 이 페이지에는 빌트인 프로파일러의 설정 방법이 나와 있습니다.

다음은 빌트인 프로파일러에서 출력되는 정보의 예제입니다.

iPhone Unity internal profiler stats
frametime>     min: 32.5   max: 34.1   avg: 33.3
cpu-player>    min:  2.2   max:  4.4   avg:  3.7
batches>       min:   3    max:   3    avg:   3
draw calls>    min:   3    max:   3    avg:   3
tris>          min:  1704  max:  1704  avg:  1704
verts>         min:  5088  max:  5088  avg:  5088
dynamic batching> batched draw calls:   0 batches:   0 tris:     0 verts:     0
static batching>  batched draw calls:   0 batches:   0 tris:     0 verts:     0
player-detail> physx:  0.0 animation:  0.0 culling  0.0 skinning:  0.0 batching:  0.0 render:  0.0 fixed-update-count: 0 .. 0
scripting-scripts>  update:  0.0   fixedUpdate:  0.0 coroutines:  0.0 
scripting-memory>   information not available on non-development player configuration

모든 시간은 프레임당 밀리초 단위로 측정됩니다. 최근 30프레임에 걸친 최소, 최대, 평균 시간을 볼 수 있습니다.

일반 CPU 활동

프로퍼티 기능
cpu-player 앱이 Unity 엔진 안에서 코드를 실행하고 CPU에서 스크립트를 실행하는 데 소비하는 시간을 표시합니다.
cpu-ogles-drv (Android 전용) CPU에서 OpenGL ES 드라이버 코드를 실행하는 데 소요되는 시간을 표시합니다. 이 드라이버는 드로우 콜 수, 내부 렌더링 상태 변경 수, 렌더링 파이프라인 설정 및 처리된 버텍스 수를 비롯한 여러 요인의 영향을 받을 수 있습니다.
cpu-present (Android 전용) OpenGL ES의 presentRenderbuffer 커맨드를 실행하는 데 소요된 시간입니다.
frametime 앱 프레임의 전체 시간을 나타냅니다. iOS 하드웨어는 새로고침 속도가 항상 60Hz로 고정되므로, 이 프로퍼티는 항상 16.7ms(1,000ms/60Hz = 16.7ms)의 배수인 시간을 반환합니다.

렌더링 통계

프로퍼티 기능
tris # 렌더링하기 위해 전송된 총 삼각형 수입니다.
verts # 렌더링하기 위해 전송된 총 버텍스 수입니다. 앱이 정적 지오메트리만 사용하는 경우 숫자를 10,000 이하로 유지해야 합니다. 앱이 스키닝된 지오메트리 인스턴스를 많이 사용하는 경우 훨씬 더 낮은 값을 사용해야 합니다.
dynamic/static batching 엔진에 의해 자동으로 배칭되는 드로우 콜, 삼각형, 버텍스의 수입니다. 이 수를 드로우 콜 및 삼각형 합계와 비교하면 씬이 배칭에 얼마나 잘 준비되어 있는지 대강 알 수 있습니다. 배칭을 개선하려면 오브젝트 간에 최대한 많은 머티리얼을 공유해야 합니다.

상세 Unity 플레이어 통계

player-detail 섹션에서 엔진 내부 동작에 대한 상세 내역을 확인할 수 있습니다.

프로퍼티 기능
physx 물리 연산에 소요된 시간입니다.
animation 뼈대 애니메이션에 소요된 시간입니다.
culling 카메라 절두체 밖에 있는 오브젝트를 컬링하는 데 소요된 시간입니다.
skinning 스킨드 메시에 애니메이션을 적용하는 데 소요된 시간입니다.
batching 지오메트리 배칭에 소요된 시간입니다. 동적 지오메트리 배칭에는 정적 지오메트리 배칭보다 훨씬 더 많은 리소스가 사용됩니다.
render 가시적인 오브젝트를 렌더링하는 데 소요된 시간입니다.
fixed-update-count 프레임 중에 실행된 최소 및 최대 FixedUpdate 수입니다. FixedUpdate가 너무 많으면 성능이 크게 저하됩니다.

상세 스크립트 통계

scripting-scripts 섹션에서는 Mono 런타임에서 코드를 실행하는 데 소요된 시간에 대한 상세 내역을 확인할 수 있습니다.

프로퍼티 기능
update 스크립트의 모든 Update() 메서드를 실행하는 데 소요된 전체 시간입니다.
fixedUpdate 스크립트의 모든 FixedUpdate() 메서드를 실행하는 데 소요된 전체 시간입니다.
coroutines 스크립트 코루틴 안에서 소비한 시간입니다.

스크립트의 메모리 할당에 관한 상세 통계

scripting-memory 섹션에서는 Mono 가비지 컬렉터가 메모리를 관리하는 방법에 대한 정보를 확인할 수 있습니다.

프로퍼티: 기능:
allocated heap 할당할 수 있는 총 메모리 양입니다. 힙에 특정 할당을 위한 메모리가 부족하면 가비지 컬렉션이 실행됩니다. 그래도 충분한 메모리를 확보하지 못하면 할당된 힙의 크기가 커집니다.
used heap allocated heap 에서 오브젝트가 현재 사용 중인 비율입니다. 이 수는 다음 가비지 컬렉션까지 새 클래스 인스턴스(구조체 아님)를 만들 때마다 커집니다.
max number of collections 지난 30 프레임 동안의 가비지 컬렉션 패스 횟수입니다.
collection total duration 지난 30프레임 동안 발생한 모든 가비지 컬렉션 패스의 총 시간(밀리초 단위)입니다.

설정

iOS에서는 내부 프로파일러가 기본적으로 비활성화되어 있습니다. 활성화하려면 Unity에서 생성된 Xcode 프로젝트를 열어 InternalProfiler.h 파일을 선택하고 다음 줄을

# define ENABLE_INTERNAL_PROFILER 0

다음과 같이 변경합니다.

# define ENABLE_INTERNAL_PROFILER 1

또는 iOS 플레이어 설정(메뉴: Edit > Project Settings > Player Settings에서 iOS 선택)에 액세스할 수도 있습니다. Debugging and crash reporting 섹션에서 Enable Internal Profiler (지원 중단 예정)를 활성화하십시오. 앱을 빌드할 때 Build Settings 에서 Development Build 가 활성화되어 있어야 합니다.

출력 콘솔(GDB)을 표시하려면 Xcode의 메인 메뉴에서 View > Debug Area > Activate Console 을 선택한 후 프로젝트를 실행하십시오. 그러면 Unity는 30프레임마다 콘솔 창에 통계를 출력합니다.

Android에서 내부 프로파일러를 활성화하려면 Android 플레이어 설정(메뉴: Edit > Project Settings > Player Settings에서 Android 선택)에 액세스해야 합니다. Optimization 섹션에서 Enable Internal Profiler (지원 중단 예정) 설정을 활성화하십시오. 앱을 빌드할 때 Build Settings 에서 Development Build 가 활성화되어 있어야 합니다. 그러면 기기에서 앱이 실행될 때 로그캣에 통계가 표시됩니다. 로그캣을 보려면 adb 또는 Android Debug Bridge를 설치한 후 adb logcat 셸 커맨드를 실행하십시오.

iOS 관련 최적화
빌드한 iOS 플레이어 크기 최적화