본문으로 건너뛰기

Core

앱 복구와 호환성 검사

0.8.51

차단된 개발 환경을 확인하고 제출 테스트를 검증하며 앱 버전과 플랫폼 빌드를 구분합니다.

차단된 개발 환경 복구

개발 콘솔에서 차단된 작업별 복구 명령과 검사 상태를 확인할 수 있습니다. 기존 데이터를 보존하고 빈 환경으로 교체할 때의 영향도 안내합니다.

대응하는 CLI에서 nexia recover <operation-id>를 실행하면 읽기 전용 검사를 요청하고, 실행이 차단된 이유와 다음 행동을 확인할 수 있습니다. 안전성이 확인된 경우에만 재시도할 수 있으며 앱 코드를 자동으로 다시 실행하지 않습니다. 앱 게시 심사는 별도입니다.

결과를 확인할 수 없으면 --preserve-and-replace --confirm-preserve를 명시적으로 선택해 개인 샌드박스의 모든 앱을 중지하고, 기존 데이터를 보존한 채 빈 새 환경을 만들 수 있습니다. --export-data <새파일.jsonl.gz>로 기존 프로젝트 권한을 확인받아 보존된 앱의 스키마 설명·데이터·소스를 내려받습니다. 기존 파일은 덮어쓰지 않습니다. 대응하는 Core를 먼저 배포한 뒤 CLI를 갱신하세요.

프런트엔드 호환성과 제출 테스트

  • 제출 심사에는 PHP와 프런트엔드 테스트 통과가 필요합니다. 프런트엔드는 제출한 소스의 Vitest 테스트를 실행하며, 테스트 누락·건너뛴 항목·실패가 있으면 승인을 차단합니다. 앱 개발 의존성에 Vitest를 포함하고 의존성 잠금 파일을 커밋하세요.
  • React SDK 0.8.9로 만든 프런트엔드 빌드는 선언한 SDK 호환 범위와 필요한 공용 기능을 기록할 수 있습니다. 호환되는 플랫폼 변경에는 기존 앱 버전을 유지할 수 있습니다. 지원하지 않거나 확인되지 않은 요구사항은 기존 앱을 서비스하면서 새 전환을 차단합니다. 이미 게시된 산출물의 기록은 보존하며, 호스트 변경 전에는 별도로 검증한 호환성 근거가 필요합니다.

제출 결과 안내

같은 태그를 다시 제출하면 Console에서 기존 제출임을 안내하고 API 접수 응답에 submission_reused를 추가합니다. 대응하는 CLI는 검사 결과·진행률과 상태별 다음 행동을 표시합니다. 명시적인 중복 안내를 사용하려면 Core를 먼저 배포한 뒤 CLI를 배포하세요. 제출 버전의 불변성과 승인·게시·배포의 구분은 유지됩니다.

앱 버전과 플랫폼 재빌드

  • 호환되는 플랫폼 재빌드는 제출된 앱 버전과 승인된 소스 리비전을 유지하고, 별도 빌드 번호로 구분합니다. 재빌드된 산출물은 다시 심사받아야 하며, 이전 승인이 다른 이미지의 승인으로 이어지지 않습니다.
  • 앱 소스나 동작이 바뀌면 새 앱 버전이 필요합니다. 후보 버전을 심사하고 준비하는 동안 기존 앱은 호환되는 런타임을 유지할 수 있습니다.
  • 서비스 중 스키마를 확장하려면 현재 설치된 정확한 앱 이미지에 대한 검증, 초기화 내용과 기존 데이터의 보존, 트랜잭션으로 처리되는 추가형 스키마 변경이 필요합니다. 지원하지 않거나 검증되지 않은 변경은 차단하며, 이전 심사 기록만으로 호환성을 인정하지 않습니다.

사용 방법