안녕하세요, 앱인토스 팀입니다.
SDK 3.x 마이그레이션 시 브라우저 localStorage를 사용하고 있는 서비스에 영향을 줄 수 있는 변경 사항이 있어 안내드립니다.
SDK 3.x에서는 서비스 구조 변경에 따라 서빙되는 Origin이 변경되었습니다.
SDK에서 제공하는 Storage를 사용하고 있는 경우에는 별도 영향이 없습니다. 다만, SDK에서 제공하는 Storage가 아닌 브라우저의 localStorage를 직접 사용해 데이터를 저장한 경우, Origin 변경에 따라 SDK 3.x 환경에서는 기존 데이터에 접근할 수 없습니다.
브라우저 localStorage는 Origin을 기준으로 데이터가 분리되기 때문에, SDK 3.x로 마이그레이션한 이후에는 기존 Origin에 저장된 데이터가 자동으로 이전되지 않습니다.
기존 SDK 2.x 환경에서 브라우저 localStorage를 직접 사용해 온 서비스의 원활한 전환을 위해, 기존 데이터를 SDK 3.x에서도 이어서 활용할 수 있는 마이그레이션 지원 방안을 검토하고 있습니다.
따라서 브라우저 localStorage를 직접 사용하고 있으며 기존 데이터 유지가 필요한 경우에 한해, 관련 지원이 제공되기 전까지 SDK 3.x로의 마이그레이션을 잠시 보류해 주시길 권장드립니다.
SDK에서 제공하는 Storage를 사용하고 있거나 기존 localStorage 데이터 유지가 필요하지 않은 경우에는 이번 변경의 영향을 받지 않으며, SDK 3.x로 마이그레이션하셔도 됩니다.
또한 localStorage는 영구적인 데이터 보관을 보장하는 저장소가 아니므로, 서비스에서 유지가 필요한 데이터는 가급적 @apps-in-toss/web-framework 에서 제공하는 Storage API를 사용해 관리하는 것을 권장드립니다.
특히 사용자의 기기 변경 이후에도 유지되어야 하는 데이터의 경우 클라이언트 저장소에 의존하기보다는, 별도의 서버 통신을 통해 데이터를 저장하고 불러올 수 있는 구조로 구현하는 것을 권장드립니다.
구체적인 마이그레이션 지원 방법과 일정은 확정되는 대로 다시 안내드리겠습니다.
감사합니다.