이 항목에서는 SharePoint 솔루션을 패키지하고 배포할 때 발생할 수 있는 다양한 문제에 대해 설명합니다.
향상된 디버깅 사용
Visual Studio, SharePoint 및 기타 계층을 진단하려면 EnableDiagnostics 레지스트리 키를 사용하여 스택 추적을 볼 수 있습니다. 자세한 내용은 SharePoint 솔루션 디버그를 참조하세요.
솔루션 패키지에 프로젝트 출력 추가
패키지 디자이너를 통해 패키지에 프로젝트 출력을 추가할 수 있습니다. 그러나 프로젝트 출력을 추가할 때 프로젝트의 플랫폼이 SharePoint 솔루션의 플랫폼과 일치하는지 확인합니다. SharePoint 서버에 배포하려는 어셈블리의 플랫폼 대상으로 Any CPU를 사용하는 것이 좋습니다. 자세한 내용은 컴파일 페이지, 프로젝트 디자이너(Visual Basic) 및 고급 컴파일러 설정 대화 상자(Visual Basic)를 참조하세요.
유효성 검사 경고 및 오류
Visual Studio의 SharePoint 개발 도구는 유효성 검사 단계를 수행하여 솔루션 패키지가 올바르게 구성되었는지 확인합니다. 기능 및 패키지에 대한 사용자 지정 유효성 검사 단계를 만들 수도 있습니다. 자세한 내용은 방법: SharePoint 솔루션에 대한 사용자 지정 기능 및 패키지 유효성 검사 규칙 만들기를 참조하세요.
배포 충돌 해결
SharePoint 솔루션을 배포할 때 서버의 항목이 솔루션 패키지의 항목과 동일한 이름, URL 또는 ID를 갖는 경우 충돌이 발생할 수 있습니다. 모듈, 웹 파트, 목록 인스턴스 및 콘텐츠 형식에 대한 충돌을 해결, 보고 또는 무시하도록 배포 충돌 해결 속성을 변경할 수 있습니다.
다음 표에서는 배포 충돌 해결 속성에 대한 설정을 보여 줍니다.
| 가치 | Description |
|---|---|
| 자동 | 충돌을 감지하고 충돌을 자동으로 해결합니다. |
| 프롬프트 | 충돌을 감지하고 충돌을 해결하기 전에 개발자에게 보고합니다. |
| None | 충돌을 감지하지 않습니다. |
F5 배포 간의 차이점
Visual Studio를 사용하여 테스트 및 디버깅을 위해 로컬 SharePoint 서버에 SharePoint 프로젝트를 배포하는 경우 Visual Studio에서 수행하는 몇 가지 추가 단계가 있습니다.
배포 단계 중에 IIS(인터넷 정보 서비스)를 다시 설정합니다.
워크플로를 자동으로 연결합니다.
패키지 디자이너의 계층 구조에 따라 기능 활성화 순서를 설정합니다.
사용자 지정 배포 단계를 추가하여 F5 동작을 추가로 변경할 수 있습니다. 자세한 내용은 연습: SharePoint 프로젝트에 대한 사용자 지정 배포 단계 만들기를 참조하세요.
시각적 웹 파트 배포 시 SharePoint 페이지 표시 지연
Visual Web 파트를 Windows Vista, Windows 7 또는 Windows Server 2008의 Bin 폴더에 배포할 때 SharePoint 페이지가 표시되는 데 시간이 오래 걸립니다. Bin 디렉터리 같은 최상위 ASP.NET 디렉터리의 파일을 변경하면 전체 웹 애플리케이션이 다시 컴파일됩니다. 이로 인해 SharePoint 페이지가 렌더링되는 데 최대 25초의 지연이 발생할 수 있습니다.
오류 메시지
없음.
해결 방법
이 문제를 해결하려면 다음 단계를 수행합니다.
Microsoft 지원 문서에 설명된 대로 업데이트 KB967535 설치: Windows Vista 및 Windows Server 2008용 IIS 7.0에서 ASP.NET 두 가지 문제를 해결하기 위해 핫픽스를 사용할 수 있습니다.
Web.config 파일에 다음 줄을 추가합니다.
<compilation batch="false" optimizeCompilations="true">
SharePoint 프로젝트 배포가 "솔루션에서 cab 파일을 추출하지 못했습니다."라는 오류로 실패합니다.
SharePoint 프로젝트 항목의 이름에 괄호가 포함되어 있으면 배포할 때 오류가 발생하여 솔루션이 실패합니다.
오류 메시지
배포 단계 '솔루션 추가'에서 오류가 발생했습니다. 솔루션에서 cab 파일을 추출하지 못했습니다.
해결 방법
이 문제를 해결하려면 SharePoint 프로젝트 항목의 이름에 있는 괄호를 제거합니다.
다른 웹 애플리케이션의 사이트에 시각적 웹 파트를 배포할 때 오류가 나타납니다.
시각적 웹 파트의 SiteUrl 속성을 변경하여 현재 배포된 웹 파트가 아닌 웹 애플리케이션의 사이트에 시각적 웹 파트를 처음 배포하면 오류가 발생합니다.
오류 메시지
배포 단계 '솔루션 추가'에서 오류가 발생했습니다. ID가 [#]인 기능이 이 팜에 이미 설치되어 있습니다. force 특성을 사용하여 기능을 명시적으로 다시 설치합니다.
해결 방법
이 오류는 SharePoint에서 시각적 웹 파트 기능이 철회되는 방식으로 인해 발생합니다. 시각적 웹 파트를 성공적으로 배포하려면 F5 키를 선택하여 솔루션을 다시 배포합니다.
중첩된 사용자 컨트롤을 배포할 때 경고가 나타납니다.
이 경고는 사용자 컨트롤이 포함된 시각적 웹 파트 또는 시각적 웹 파트 또는 다른 사용자 컨트롤이 포함된 사용자 컨트롤과 같이 중첩된 사용자 컨트롤이 있는 SharePoint 솔루션을 배포할 때 발생합니다. 이 경고는 도구 상자에서 끌어 디자이너에 컨트롤을 추가하거나 Source 뷰에서 @Register 지시문을 사용하여 컨트롤을 추가할 때 발생합니다.
오류 메시지
경고 1 요소 '[Control Name]'이(가) 알려진 요소가 아닙니다. 이 문제는 웹 사이트에 컴파일 오류가 있거나 web.config 파일이 없는 경우에 발생할 수 있습니다.
해결 방법
Visual Studio 프로젝트 시스템에서 중첩된 사용자 컨트롤을 인식하지 못하는 경우 IntelliSense를 제공할 수 없으며 경고를 내보낸다. 프로젝트가 빌드되지 않고 디자이너가 닫혀 다시 열리지 않거나 자동 철회 옵션이 활성화되어 디버깅 후 SharePoint 하이브에서 사용자 컨트롤이 철회되는 경우 프로젝트 시스템은 중첩된 사용자 컨트롤을 인식하지 못합니다.
이 경고를 제거하려면 프로젝트를 빌드한 다음 디자이너를 닫은 다음 다시 열거나 프로젝트에 대한 자동 철회 옵션을 사용하지 않도록 설정합니다. 이렇게 하려면 프로젝트 속성 대화 상자의 SharePoint 탭에서 디버깅 후 자동 취소 확인란의 선택을 취소합니다.