Ir al contenido

AL 개발 문제 해결

Business Central 환경에서 배포, 의존성 및 기호 다운로드 관련 일반적인 오류를 해결하는 가이드.

0조회

우리의 DevSecOps 운영에서 대부분의 차단은 코드의 논리적 오류보다는 환경 구성 오류, 버전 불일치, 또는 로컬 IDE(VS Code)와 클라우드 테넌트 간 네트워크 통신 문제에서 비롯됩니다.

이것은 개발 및 통합 단계에서 기록된 사고를 즉시 해결하기 위한 우리의 지식 기반입니다.

AL: Download Symbols 명령어를 실행(또는 F5로 빌드 시도)하면 출력(출력 -> AL) 터미널에 다음과 같은 대량 오류 블록이 반환됩니다:

[2026-03-24 10:15:23] Sending request to https://api.businesscentral.../v2.0/sandbox/dev/packages?publisher=Microsoft&appName=Application&versionText=27.4.45366
[2026-03-24 10:15:24] Error: Not Found
[2026-03-24 10:15:24] The request for path ... failed with code NotFound.
error AL1022: A package with publisher 'Microsoft', name 'Application', and a version compatible with '27.4.45366' could not be found.

이는 매니페스트의 버전 불일치로 인한 오류입니다. 비즈니스 센트럴은 매우 엄격한 (버전 민감성) 환경입니다. 오류는 로컬 app.json 파일이 서버에 코어 라이브러리를 27.4.45366 버전으로 요청하고 있는 것을 나타냅니다. 그러나 우리가 연결된 샌드박스(launch.json에 설정됨)는 더 낮은 버전(예: 25.0.0.0 버전)이 설치되어 있습니다. 서버가 요청한 버전을 보유하고 있지 않기 때문에 404 오류를 반환합니다.

  1. 서버 버전 식별: 실제 버전을 확인하려면 Business Central 웹사이트 -> 도움말 및 지원 -> 소개로 이동합니다.
  2. app.json 해제: 로컬 프로젝트에서 파일 app.json을 엽니다.
  3. 최소 요구 버전을 낮춥니다. "application" 및 "platform"을 우리가 알고 있는 안전하고 보편적인 버전(예: 25.0.0.0로 수정합니다).
  4. 실행 엔진 "runtime"을 호환 가능한 버전(예: 13.0 또는 16.0로 낮춥니다).
  5. 캐시 정리: 숨은 폴더 .alpackages의 콘텐츠를 물리적으로 삭제합니다.
  6. 재시도: AL: Download Symbols을 다시 실행합니다. 터미널은 All reference symbols have been downloaded을 표시해야 합니다.

심볼을 다운로드하거나 컴파일하려고 할 때, 시스템이 찾을 수 없는 특정 의존성을 나타냅니다. 예를 들어: A package with publisher 'Microsoft', name 'API Reports - Finance', could not be found.

VS Code는 AL: Go!를 통해 프로젝트를 초기화할 때, 종종 고유한 모듈(예: 고급 재무 모듈)의 의존성을 "dependencies"에 주입합니다. app.json에 해당 Microsoft 앱이 설치되어 있지 않으면 전체 패키징이 연쇄적으로 실패합니다.

프로젝트의 의존성을 정리해야 합니다.

  1. app.json를 엽니다.
  2. 배열 "dependencies": [ ... ]을 찾습니다.
  3. 일반적인 통합 또는 간단한 API를 개발하는 경우, API Reports - Finance와 같은 추가 의존성 블록을 완전히 제거하고 배열을 비워두거나([PC_BLOCK_1]), 자체 회사의 필수 의존성만 유지합니다.
  4. .alpackages의 캐시를 삭제하고 심볼을 다시 다운로드하세요.

사건 3: 폴더와 명명 규칙의 신화(CamelCase vs Snake_case)

Sección titulada «Incidente 3: Mito de las Carpetas y Nomenclatura (CamelCase vs Snake_case)»

팀의 질문: “내 하드디스크의 프로젝트 루트 폴더(예: Consulta_Datos_Comercial)가 camelSensitive/CamelCase로 작성되지 않았을 때 AL 컴파일러가 오류를 발생시키나요?”

명확한 답변은 아니오입니다. AL 컴파일러는 Windows 폴더의 물리적 이름에 대소문자 또는 형식에 대한 감도가 없습니다.

  1. SO 파일 시스템: Visual Studio Code와 Windows는 경로가 C:/Proyectos/Consulta_Datos인지 c:/proyectos/cOnSuLtAdAtOs인지에 대해 무관심합니다.
  2. 컴파일러 동작: 빌드 명령을 실행하면 엔진은 app.json 내에서 선언된 메타데이터(속성 "name" 및 "publisher")에 완전히 의존하여 콘텐츠를 패키지화합니다. 로컬 디렉토리의 이름은 클라우드 서버에 대해 무시되고 관련 없습니다.

명명법 권장사항: 우리는 Git 리포지토리에서 인간의 가독성과 시각적 정렬을 위해 디렉토리(Entradas_Salidas_AL)에 Snake_Case(언더스코어) 규약을 사용합니다. 컴파일러의 기술적 강제 사항 때문이 아닙니다.

  • ✓ 정리: app.json에서 구조적 변경을 수행할 때 .alpackages 폴더를 사전에 비우는 것.
  • ✓ 검증: 매니페스트에 선언된 의존성 세트와 클라우드에 설치된 확장 기능 간의 절대적 일관성.
  • ✓ 추적: 네트워크 오류의 정확한 진단을 위해 VS Code의 “AL Language” 채널 출력을 모니터링하는 것.