커스텀 네이티브 컨테이너 구현
Implement custom native containers.
읽는 시간 2분최근 업데이트: 한 달 전
커스텀 네이티브 컨테이너를 구현하려면 속성을 사용하여 유형을 주석으로 작성해야 합니다. 또한 네이티브 컨테이너가 안전 시스템과 어떻게 통합되는지 이해해야 합니다.
NativeContainer두 가지 주요 요소를 구현해야 합니다.
- 사용 추적: Unity가 인스턴스를 사용하는 예약된 잡을 추적하여 두 개의 잡이 동시에 동일한 네이티브 컨테이너에 쓰는 것과 같은 충돌 가능성을 감지하고 방지할 수 있도록 합니다.
NativeContainer - 누수 추적: 가 제대로 제거되지 않은 경우 감지합니다. 이 경우 메모리 누수가 발생하여 프로그램의 남은 전체 수명 동안
NativeContainer에 할당된 메모리를 사용할 수 없게 됩니다.NativeContainer
사용 추적 구현
코드에서 사용 트래킹에 액세스하려면 클래스를 사용하십시오. 은 안전 시스템이 특정 네이티브 컨테이너에 대해 저장하는 중앙 정보에 대한 레퍼런스를 보유하며, 의 메서드가 안전 시스템과 상호 작용하는 주요 방법입니다. 따라서 모든 인스턴스에는 라는 필드가 포함되어야 합니다.
AtomicSafetyHandleAtomicSafetyHandleNativeContainerNativeContainerm_SafetyAtomicSafetyHandle각 에는 현재 컨텍스트에서 네이티브 컨테이너에서 수행할 수 있는 작업 유형을 나타내는 일련의 플래그가 저장됩니다. 잡에 인스턴스가 포함된 경우 잡 시스템은 의 플래그를 자동으로 설정하여 해당 잡에서 네이티브 컨테이너를 사용할 수 있는 방법을 반영합니다.
AtomicSafetyHandleNativeContainerAtomicSafetyHandle잡이 인스턴스에서 읽으려고 할 때 읽기 전에 잡 시스템이 메서드를 호출하여 잡에 네이티브 컨테이너에 대한 읽기 액세스 권한이 있는지 확인합니다. 마찬가지로 잡이 네이티브 컨테이너에 쓰기를 시도할 때 쓰기 전에 잡 시스템이 를 호출하여 잡에 네이티브 컨테이너에 쓰기 액세스 권한이 있는지 확인합니다. 동일한 인스턴스에 할당된 두 개의 잡에는 해당 네이티브 컨테이너에 대해 별도의 오브젝트가 있으므로 둘 다 동일한 중앙 정보 집합을 참조하지만 각 잡이 네이티브 컨테이너에 대해 어떤 읽기 및 쓰기 액세스 권한을 갖는지 나타내는 별도의 플래그를 각각 포함할 수 있습니다.
NativeContainerCheckReadAndThrowCheckWriteAndThrowNativeContainerAtomicSafetyHandle누수 추적 구현
Unity의 네이티브 코드는 주로 누수 추적을 구현합니다. 메서드를 사용하여 데이터를 저장하는 데 필요한 메모리를 할당한 후 를 사용하여 이를 폐기합니다.
UnsafeUtility.MallocTrackedNativeContainerUnsafeUtility.FreeTracked이전 버전의 Unity에서는 클래스가 누수 추적을 제공합니다. Unity는 가비지 컬렉터가 오브젝트를 수집할 때 메모리 누수를 보고합니다. 을 생성하려면 동시에 을 초기화하는 메서드를 사용하십시오. 이 메서드를 사용하면 을 초기화할 필요가 없습니다. 가 폐기되면 메서드는 단일 호출로 과 을 모두 폐기합니다.
DisposeSentinelDisposeSentinelDisposeSentinelAtomicSafetyHandleCreateAtomicSafetyHandleNativeContainerDisposeDisposeSentinelAtomicSafetyHandle누출된 가 생성된 위치를 식별하려면 메모리가 원래 할당된 위치의 스택 추적을 캡처할 수 있습니다. 이렇게 하려면 프로퍼티를 사용하십시오. 에디터에서 이 프로퍼티에 액세스할 수도 있습니다. 이렇게 하려면 Preferences > Jobs > Leak Detection Level로 이동하여 필요한 누수 감지 수준을 선택합니다.
NativeContainerNativeLeakDetection.Mode중첩된 네이티브 컨테이너
안전 시스템은 잡에서 중첩된 네이티브 컨테이너를 지원하지 않는데, 이는 잡 시스템이 더 큰 인스턴스 내부의 각 개별 에 대해 을 올바르게 설정할 수 없기 때문입니다.
NativeContainerNativeContainerAtomicSafetyHandle중첩된 네이티브 컨테이너를 사용하는 잡을 예약하지 않으려면 다른 인스턴스를 포함할 때 를 중첩된 것으로 플래그를 지정하는 를 사용하십시오.
NativeContainerNativeContainerSetNestedContainer안전 ID 및 오류 메시지
안전 시스템은 코드가 안전 제약을 준수하지 않는 경우 오류 메시지를 표시합니다. 오류 메시지를 더 명확하게 만들기 위해 안전 시스템에 오브젝트의 이름을 등록할 수 있습니다.
NativeContainer이름을 등록하려면 를 사용하여 에 전달할 수 있는 안전 ID를 반환합니다. 안전 ID를 생성한 후에는 모든 인스턴스에 재사용할 수 있으므로 일반적인 패턴은 컨테이너 클래스의 정적 멤버에 저장하는 것입니다.
NewStaticSafetyIdSetStaticSafetyIdNativeContainer또한 로 특정 안전 제약 위반에 대한 오류 메시지를 오버라이드할 수도 있습니다.
SetCustomErrorMessage