WinGet 매니페스트 작성
런타임
Dumplings 모듈 명령어와 호스트 측 스킬 스크립트를 PowerShell 7.4 이상(pwsh)으로 실행합니다. 특정 자체 포함 게스트 수집기가 별도로 명시하지 않는 한 Windows PowerShell 5.1은 지원되지 않습니다.
워크플로우
현재 단계에 필요한 참조 문서를 읽으십시오.
- 패키지 선택: Identity, source-index 중복 조회, 공식 소스 검색, 아티팩트 선택, 릴리스 날짜 증거
- 매니페스트 구성: 모델 및 파일, 설치 프로그램 필드, 종속성, 기본값 및 반환 코드, 프로그램 및 기능, 형식 지정 및 유효성 검사
- 로컬라이제이션: 로캘 모델, 로캘 ID, 로캘 콘텐츠 및 릴리스 정보
- 완료: 제출, PR 검사에서 유효성 검사 로그
- 공유 헬퍼 API:
$use-dumplings-functions를 사용하여 소스 검색, 리디렉션, 응답 디코딩, 임시 파일, HTML 또는 Markdown 처리, YAML 및 브라우저 증거를 처리하십시오. - 설치 프로그램 제품군 지침: 분석기의 설치 프로그램 제품군 경로 테이블로 시작한 다음, 선택한 제품군 워크플로우를 열어 정적 파서 명령어, 스위치, ARP 소유권 및 VM 예외를 확인하십시오.
- 대형 작업 기록: 일시적 증거
설치 프로그램 증거에는 $analyze-winget-installer를 사용하고, 첫 번째 패키지 버전이 승인된 후 또는 명시적으로 구성된 신뢰할 수 있는 대기 패키지 참조가 첫 번째 PR 병합을 기다리는 동안 $author-dumplings-task를 사용하십시오.
점진적 작성
식별자, 버전, 기본 로캘 및 필요한 설치 프로그램 필드를 알게 되면 작업 중인 다중 파일 매니페스트를 생성하고 저장하십시오. 기존 패키지의 경우 논리적 모델을 사용하여 새 버전 리프를 만드십시오. 이 초안을 기준으로 연구 및 VM 검증을 계속하십시오.
아티팩트 선택, 구문 분석, 로캘 연구, 릴리스 정보 및 VM 검증을 통해 새로운 사실이 확립될 때마다 매니페스트를 저장하십시오. 각 수정 전에 현재 논리적 모델을 읽고 diff를 검사하십시오. 해결되지 않은 선택적 필드는 생략하십시오. 배치를 처리할 때는 연구 기간 동안 각 패키지의 초안을 유지하십시오. 초기 저장 및 구조 변경 후 전체 세트의 형식을 지정하고 유효성을 검사한 다음, 제출 전에 엄격한 최종 검토를 수행하십시오.
비협상적 규칙
공식 게시자 소스를 사용하십시오. 다운로드 수집기, 미러, 재패키저 또는 검색 결과 다운로드 사이트를 사용하지 마십시오. 웹사이트와 리포지토리를 상호 확인한 후 신뢰하십시오.
알 수 없는 설치 프로그램을 호스트에서 실행하지 마십시오. 항목을 최종 확정하거나 제출하기 전에 정확한 아티팩트와 작성된 스위치를 사용하여 VM 검증을 완료하십시오. 유일한 링크가 로그인을 요구하거나, 이메일로 전송되거나, 비공식적이거나 의심스럽거나, 안정적인 대체 수단 없이 세션에 종속된 경우 중단하십시오. Windows 보안 드라이버 게시자 동의 대화 상자로 인해 차단되는 등 무인 실행이 불가능한 설치 프로그램은 거부하십시오.
호스트 또는 VM 보안 소프트웨어가 실행 파일을 바이러스 또는 맬웨어로 플래그하면 즉시 해당 패키지 워크플로우를 중단하고 사용자에게 경고하십시오. 맬웨어 경고 시 중지를 따르십시오.
게시자 ID, 법적 이름, URL, 릴리스 정보, 버전, 레지스트리 메타데이터 또는 스위치를 임의로 생성하지 마십시오. 해당하는 선택적 필드를 생략하기 전에 모든 신뢰할 수 있는 권위 있는 소스를 검색하십시오.
현재 작성은 스키마 1.12.0과 고정된 Dumplings 헤더를 사용합니다.
Moniker를 자동으로 추가하지 마십시오. 현재 UnsupportedOSArchitectures를 작성하지 마십시오. 알려진 설치 프로그램 스위치, 모드 및 반환 코드가 WinGet 기본값과 동일한 경우 생략하십시오.
출력 규율
작성 내내 완전한 논리적 모델을 사용하십시오. Save-WinGetManifest 또는 문서화된 모델 API로 각 증거 기반 수정본을 저장한 다음 오프라인으로 유효성을 검사하십시오. Format-WinGetManifest는 격리된 문서용으로만 사용하십시오. 문서 간 최적화를 수행하거나 누락된 증거를 확립할 수 없습니다.
전체 소스, 설치 프로그램, VM 및 유효성 검사 레코드를 일시적 증거 트리에 보존하십시오. 작업에서 결정 사항, 해결되지 않은 진단 및 증거 경로만 보고하십시오.