온디맨드 로딩으로 전환되는 Adobe Express 문서 아키텍처
어도비(Adobe)가 대형 프로젝트 환경과 저사양 기기 성능 최적화를 목적으로 Adobe Express에 온디맨드 페이지 로딩 방식인 '대규모 문서 지원(Large Document Support)'을 도입한다고 발표했습니다. 기존에는 문서 내 모든 페이지의 도형, 텍스트, 이미지 노드가 브라우저 메모리에 상시 로드되어 페이지 수가 늘어날수록 시스템 리소스 점유율이 급증하는 구조적 한계가 있었습니다.
새로운 메모리 모델에서는 현재 사용자가 작업 중이거나 API를 통해 명시적으로 진입한 활성(Active) 페이지만 세부 시각 노드가 메모리에 유지됩니다. 반면 비활성(Inactive) 상태의 페이지는 아트보드와 내부 시각 노드가 메모리에서 즉시 해제되며, 고유 식별자(id), 이름(name), 너비와 높이 등 메타데이터만 상시 조회 가능한 상태로 남게 됩니다.
애드온 개발 패턴의 변화와 필수 마이그레이션 요건
이번 아키텍처 변경에 따라 마켓플레이스 애드온의 코드 작성 패턴도 직접적인 영향을 받게 됩니다. 현재 활성화된 단일 페이지만 동기적으로 수정하는 단순한 애드온은 별도 수정 없이 동작하지만, 문서 전역을 순회하거나 백그라운드 페이지의 노드를 직접 조작하던 애드온은 수정이 불가피합니다.
특히 비동기 네트워크 통신이나 연산 대기 중에 특정 페이지 노드의 참조를 유지해야 할 경우 keepContentActiveDuringAsync() 패턴을 적용해야 합니다. 다중 페이지를 연속해서 탐색하며 콘텐츠를 읽거나 편집해야 하는 작업에는 새롭게 제공되는 visitPages() 메서드를 단계적으로 사용해야만 런타임 오류를 방지할 수 있습니다.
점검 도구 활용법과 검증 과정의 기술적 한계
어도비는 개발자의 마이그레이션 부담을 줄이기 위해 별도의 번들링 없이 소스 코드 디렉터리를 스캔할 수 있는 LLM 기반 'Large Document Support Checker Skill'을 배포했습니다. 이 도구는 비권장 API 호출과 안전하지 않은 노드 참조 패턴을 탐지할 수 있어 Git 프리커밋(pre-commit) 훅이나 CI 파이프라인에 통합해 1차 검증 장치로 활용하기에 유용합니다.
그러나 공식 문서에서도 명시하듯, 이 도구는 정적 휴리스틱과 언어 모델 추론에 기반하므로 오탐(false positive)이나 미탐(false negative)이 발생할 수 있다는 기술적 한계를 안고 있습니다. 따라서 도구의 통과 여부만 신뢰하기보다는, 비동기 지연 상황에서 페이지 전환이 일어나는 복잡한 사용자 시나리오를 가정한 실환경 단위 테스트와 단계별 런타임 검증을 병행하는 전략이 필수적입니다.
배포 타임라인 및 엔터프라이즈 환경에서의 실무 영향
어도비의 발표 일정에 따르면 2026년 7월 최초 안내 이후 9월 세부 지침이 갱신되었으며, 대규모 문서 지원은 수개월에 걸쳐 단계적(phased rollout)으로 적용되고 있습니다. 기존 마켓플레이스 생태계의 급격한 중단을 막기 위해 최대 6개월간의 마이그레이션 유예 기간이 부여됩니다.
유예 기간 이후에는 새로운 규칙이 강제 적용(enforcement)될 예정입니다. 다만 강제 적용의 구체적인 마감일자나 마켓플레이스 노출 제한 방식 등 세부 정책은 단계별 롤아웃 진행 상황에 따라 추후 공지될 예정이므로, 운영팀 차원에서 지속적인 공지 모니터링이 요구됩니다.
상태 분리 중심의 애드온 재설계 전략
이번 개편은 단순한 API 변경을 넘어, 문서 내 시각 노드를 '영속적인 객체'가 아닌 '필요에 따라 생성·소멸되는 휘발성 리소스'로 바라보도록 설계 패러다임의 전환을 요구합니다. 개발팀은 이제 문서 내 노드 인스턴스 자체를 전역 상태로 유지하던 구조를 폐기하고, 경량 메타데이터와 고유 식별자(id)만을 애플리케이션 상태로 관리하도록 리팩터링해야 합니다.
궁극적으로 온디맨드 로딩 방식은 다량의 슬라이드나 대형 카탈로그를 제작하는 기업 고객 환경에서 브라우저 탭 다운 현상을 크게 줄이고 전반적인 실행 반응성을 확보하는 효과를 낳을 것입니다. 장기적인 확장성과 안정적인 마켓플레이스 유지를 목표로 하는 개발팀이라면, 강제 적용 시점까지 작업을 미루지 말고 조기에 비동기 수명주기 격리 패턴을 정립하는 것이 바람직합니다.
출처
Adobe Developers Blog의 원출처와 본문에 표시한 참고자료를 바탕으로 한국어로 재구성했습니다. ‘ARCH.B 분석’은 자료를 읽고 덧붙인 편집 해석입니다.
Is Your Adobe Express Add-on Ready for Large Document Support? (새 창)
