본문으로 건너뛰기
참조

앱 선언 반영 문제 해결

앱 선언 반영 문제 해결

앱 선언 반영 문제 해결

메뉴·리소스·설정이 나타나지 않을 때

  1. 앱 Manifest의 contribution 위치와 PHP namespace가 실제 클래스에 맞는지 확인합니다.
  2. 클래스가 필요한 공개 SDK 인터페이스를 구현했는지 확인합니다. 선언 메서드에서는 데이터 조회나 쓰기를 하지 않습니다.
  3. 앱 폴더에서 nexia check를 실행해 로컬 소스를 확인합니다.
  4. 프로젝트의 nexia dev가 실행 중인지 확인하고, 소스 변경 후 샌드박스 준비 완료를 기다립니다. 로컬 검증 성공만으로 Catalog 반영이 보장되지는 않습니다.
  5. 새 권한을 추가했다면 워크스페이스의 설정 → 자격 증명 및 접근에서 부여합니다.
  6. 화면 컴포넌트 등록, 경로, 선언의 lifecycle과 실행 환경의 기능 지원 여부를 확인합니다.

준비 실패 시 오류를 해결한 뒤 다시 실행합니다. 운영자 검토가 필요하면 프로젝트·앱·실행 요청 식별자와 비밀값을 제외한 오류를 지원 담당자에게 전달하세요.

선언 구조 · 앱 테스트 · 앱 실행 단계

누락된 결과별 확인

누락된 결과확인할 항목
앱 화면프런트엔드 진입점, 등록, 런타임 준비
리소스 또는 메뉴Manifest 선언, 승인된 카탈로그, 테스트 권한
설정설정 선언과 선택한 앱 또는 테넌트 범위

원인을 수정한 뒤 준비 완료를 기다리고 대상 사용자로 같은 화면을 다시 여세요. 계속 실패하면 지원 요청에 사용할 작업 식별자와 비밀 값을 제거한 오류를 보관합니다.

CLI 명령과 옵션은 공개 CLI 문서에서도 확인할 수 있습니다.

원본 위치: docs/developers/content/ko/troubleshooting/contribution-discovery.md