패키지 매니페스트

Unity는 패키지 매니페스트 파일(package.json)을 사용하여 특정 패키지의 특정 버전에 관한 정보를 관리합니다. 패키지 매니페스트는 항상 패키지의 루트에 위치하며, 패키지에 관한 중요 정보(예: 등록 이름, 버전 숫자 등)를 담고 있습니다. 또한 UI에 표시되는 사용자 친화적 이름, 패키지에 대한 간략한 설명, 패키지와 호환되는 가장 낮은 Unity 버전 등과 같이 사용자에게 전달할 유용한 정보를 정의합니다.

패키지 매니페스트는 JSON(JavaScript Object Notation) 구문을 사용하여 패키지 콘텐츠를 설명합니다. 파일의 포맷은 npm의 package.json 포맷과 유사하지만, 일부 프로퍼티에 대해 다른 시맨틱을 사용합니다.

패키지 관리자는 이 매니페스트를 판독하여 패키지 콘텐츠, 콘텐츠 언패킹 방법, Package Manager 창에서 사용자에게 표시할 정보를 알아낼 수 있습니다. 매니페스트는 이러한 정보를 일련의 필수, 의무 및 옵션 프로퍼티에 저장합니다.

필수 프로퍼티

꼭 필요한 프로퍼티입니다. 이러한 프로퍼티가 없으면 패키지가 퍼블리시될 때 레지스트리가 해당 패키지를 거부하거나, 패키지 관리자가 패키지를 페치하거나 로드할 수 없습니다.

의무 프로퍼티

기술적으로는 선택 사항인 프로퍼티입니다. 패키지 관리자는 값이 유효하지 않거나 누락된 경우에도 프로젝트에 이 속성을 여전히 설치할 수 있습니다. 하지만 패키지를 쉽게 검색하고 사용자에게 더 나은 경험을 제공하려면 이러한 프로퍼티에 값을 지정하는 것이 좋습니다.

옵션 프로퍼티

선택 사항인 프로퍼티입니다. 즉, 생략할 수 있지만, 포함할 경우 유효한 값을 지정해야 합니다.

패키지 매니페스트 예시

{
  "name": "com.[company-name].[package-name]",
  "version": "1.2.3",
  "displayName": "Package Example",
  "description": "This is an example package",
  "unity": "2019.1",
  "unityRelease": "0b5",
  "documentationUrl": "https://example.com/",
  "changelogUrl": "https://example.com/changelog.html",
  "licensesUrl": "https://example.com/licensing.html",
  "dependencies": {
    "com.[company-name].some-package": "1.0.0",
    "com.[company-name].other-package": "2.0.0"
 },
 "keywords": [
    "keyword1",
    "keyword2",
    "keyword3"
  ],
  "author": {
    "name": "Unity",
    "email": "unity@example.com",
    "url": "https://www.unity3d.com"
  }
}