개요

Newtonsoft.Json은 .NET 생태계에서 가장 널리 쓰이는 JSON 처리 라이브러리로, 빠른 성능과 풍부한 기능을 제공한다.

Unity에는 기본 JSON 직렬화 도구인 JsonUtillity가 있지만, 딕셔너리나 다형성 등 지원하지 않는 기능에 제한이 많다.

예를 들어, JsonUtilityVector3 같은 일부 Unity 타입을 처리하지만 배열 루트는 직접 지원하지 않고, Dictionary는 아예 처리하지 못한다.

Newtonsoft.Json은 모든 공개 속성과 다양한 컬렉션, 사용자 지정 타입, 복잡한 객체 구조도 직렬화/역직렬화할 수 있어 유용하다.

다만 Unity의 JsonUtility가 단순 직렬화에서는 더 빠를 수 있지만, 기능 면에서 풍부함이 Newtonsoft.Json의 장점이다.

Newtonsoft.Json를 잘 사용하기 위해서, 설치부터 사용 방법, 활용까지 한 번 정리해본다.

Newtonsoft.Json 라이브러리

1. 설치 방법(Unity)

  1. Unity 에디터에서 Package Manager 클릭
  2. ‘+’ 클릭 후 Add package by name 선택
  3. com.unity.nuget.newtonsoft-json 입력 후 Add

2. 기본 사용법

Newtonsoft.Json은 직렬화/역질렬화를 위한 도구이고, 이를 위한 기능은 JsonConvert 클래스를 통해 수행된다.

직렬화는 SerializeObject, 역직렬화는 DeserializeObject를 사용한다.