# UGS 패키지 버전 가이드

> Keep your UGS packages up-to-date with recommended minimum versions for each service.

최신 UGS 기능과 업데이트를 활용하기 위해 Unity는 UGS 서비스의 베타 버전을 사용하는 모든 프로젝트를 최신 출시 버전으로 업그레이드할 것을 권장합니다.

## 사용할 패키지 버전##package-versions-to-use

프로젝트에 설치된 패키지 버전을 각 서비스에 대한 최소 권장 버전과 비교합니다. 아래에 나열된 최소 버전보다 낮은 버전의 패키지는 권장되지 않으며 업데이트해야 합니다.

| 서비스 이름         | 패키지 이름                            | 최소 버전 |
| -------------- | --------------------------------- | ----- |
| 분석             | com.unity.services.analytics      | 4.0.1 |
| Authentication | com.unity.services.authentication | 2.0.0 |
| Cloud Code     | com.unity.services.cloudcode      | 2.0.0 |
| Cloud Save     | com.unity.services.cloudsave      | 2.0.0 |
| Economy        | com.unity.services.economy        | 2.0.2 |
| Lobby          | com.unity.services.lobby          | 1.0.1 |
| Relay          | com.unity.services.relay          | 1.0.2 |
| Remote Config  | com.unity.remote-config           | 3.0.0 |

## 프로젝트에 권장 서비스 패키지 설치##install-recommended-service-packages-in-your-project

위에 나열된 서비스는 Unity 에디터 버전 2020.3 이상과 호환됩니다. 그러나 특정 에디터 버전에 따라 [Package Manager](https://docs.unity3d.com/2021.2/Documentation/Manual/upm-ui.html) 창에서 서비스 패키지를 설치할 수 없을 수도 있습니다. 다음 표는 각 서비스가 완벽하게 호환되도록 하기 위해 사용할 에디터 릴리스를 보여 줍니다.

| 에디터 연도         | UGS 릴리스 패키지를 지원하는 버전                                                                                           |
| -------------- | -------------------------------------------------------------------------------------------------------------- |
| 2019.4(LTS)    | 2019.4.40f1 이상**참고**: Unity 2019에서는 Analytics와 Authentication만 검증된 릴리스를 제공합니다. 다른 UGS 서비스는 이 버전에서 테스트되지 않았습니다. |
| 2020.3(LTS)    | 2020.3.36f1 이상**참고**: 이 버전에서는 모든 UGS 패키지가 검증되었습니다.                                                             |
| 2021.3(LTS)    | 2021.3.5f1 이상                                                                                                  |
| 2022.1(테크 스트림) | 2022.1.4f1 이상                                                                                                  |
| 2022.2(테크 스트림) | 2022.2.0a17 이상                                                                                                 |

**참고**: 에디터 버전 2021.3, 2022.1 또는 2022.2에서 Package Manager 창에 Analytics 및 Remote Config 패키지의 지원 버전이 보이지 않으면 아래의 업그레이드 시나리오를 참고하십시오.

## 업그레이드 시나리오##upgrade-scenarios

### 내 에디터 버전이 UGS 릴리스 패키지를 지원하는 경우##my-editor-version-supports-ugs-release-packages

이 시나리오에서는 Unity 에디터의 [Package Manager 레지스트리](https://docs.unity3d.com/Manual/upm-ui-install.html)에서 모든 패키지를 다운로드하고 설치할 수 있습니다. Package Manager를 사용하여 패키지를 다운로드하고 설치하려면 다음을 수행합니다.

1. Unity 에디터에서 **Window** > **Package Manager**를 엽니다.
2. Package Manager에서 **Unity Registry** 목록 뷰를 선택합니다.
3. 패키지 이름을 검색하거나 레지스트리 목록에서 이름을 찾습니다.
4. 패키지를 선택하고 **Install**을 클릭합니다.

검색창에 ‘services’를 입력하면 Remote Config를 제외한 모든 서비스에 대한 결과가 표시됩니다.

에디터 버전 2022.1 이상에서는 Package Manager의 **Services** 탭에서 모든 서비스를 찾을 수 있습니다.

### 내 에디터 버전이 UGS 릴리스 패키지를 지원하지 않는 경우##my-editor-version-does-not-support-ugs-release-packages

에디터 버전 2020.3 이상에서 프로젝트에 패키지를 설치하는 가장 쉬운 방법은 다음 코드를 사용하여 [프로젝트 매니페스트에 직접 포함](https://docs.unity3d.com/Manual/upm-manifestPrj.html)하는 것입니다.

```plaintext
{
    "dependencies": {
        "com.unity.services.analytics": "4.0.1",
        "com.unity.services.authentication": "2.0.0",
        "com.unity.services.cloudcode": "2.0.0",
        "com.unity.services.cloudsave": "2.0.0",
        "com.unity.services.economy": "2.0.2",
        "com.unity.services.lobby": "1.0.1",
        "com.unity.services.relay": "1.0.2",
        "com.unity.remote-config": "3.0.0"
    }
}
```

**참고:** Analytics와 Authentication은 에디터 버전 2019.4와 호환되는 유일한 서비스입니다. 다른 UGS 서비스는 이 특정 버전에 대해 검증되지 않았습니다.

### Analytics와 Remote Config를 업그레이드하고 싶지만 Package Manager에서 보이지 않는 경우##i-want-to-upgrade-analytics-and-remote-config-but-cant-see-them-in-the-package-manager

다음 코드를 패키지 매니페스트에 추가할 수 있습니다.

```plaintext
"com.unity.services.analytics": "4.0.1",
"com.unity.remote-config": "3.0.0"
```

또는 다음 버전을 사용하여 [패키지 이름으로 수동 설치](https://docs.unity3d.com/Manual/upm-ui-quick.html)할 수 있습니다.

| 이름                           | 버전    |
| ---------------------------- | ----- |
| com.unity.services.analytics | 4.0.1 |
| com.unity.remote-config      | 3.0.0 |