참조
앱 선언 반영 문제 해결
앱 선언 반영 문제 해결
앱 선언 반영 문제 해결
메뉴·리소스·설정이 나타나지 않을 때
- 앱 Manifest의 contribution 위치와 PHP namespace가 실제 클래스에 맞는지 확인합니다.
- 클래스가 필요한 공개 SDK 인터페이스를 구현했는지 확인합니다. 선언 메서드에서는 데이터 조회나 쓰기를 하지 않습니다.
- 앱 폴더에서
nexia check를 실행해 로컬 소스를 확인합니다. - 프로젝트의
nexia dev가 실행 중인지 확인하고, 소스 변경 후 샌드박스 준비 완료를 기다립니다. 로컬 검증 성공만으로 Catalog 반영이 보장되지는 않습니다. - 새 권한을 추가했다면 워크스페이스의 설정 → 자격 증명 및 접근에서 부여합니다.
- 화면 컴포넌트 등록, 경로, 선언의 lifecycle과 실행 환경의 기능 지원 여부를 확인합니다.
준비 실패 시 오류를 해결한 뒤 다시 실행합니다. 운영자 검토가 필요하면 프로젝트·앱·실행 요청 식별자와 비밀값을 제외한 오류를 지원 담당자에게 전달하세요.
선언 구조 · 앱 테스트 · 앱 실행 단계
누락된 결과별 확인
| 누락된 결과 | 확인할 항목 |
|---|---|
| 앱 화면 | 프런트엔드 진입점, 등록, 런타임 준비 |
| 리소스 또는 메뉴 | Manifest 선언, 승인된 카탈로그, 테스트 권한 |
| 설정 | 설정 선언과 선택한 앱 또는 테넌트 범위 |
원인을 수정한 뒤 준비 완료를 기다리고 대상 사용자로 같은 화면을 다시 여세요. 계속 실패하면 지원 요청에 사용할 작업 식별자와 비밀 값을 제거한 오류를 보관합니다.
CLI 명령과 옵션은 공개 CLI 문서에서도 확인할 수 있습니다.