코드 패키징

Package your C# code into compression files before you deploy as a live Cloud Code module.

읽는 시간 1분

최근 업데이트: 7달 전

모듈을 배포하려면 코드를 아카이브로 패키징해야 합니다. 아카이브는 모듈을 배포하는 데 사용하는 저작(authoring) 방법에 따라 .ccm 파일이거나 .zip 파일일 수 있습니다. .ccm 파일은 확장자가 .ccm으로 변경된 ZIP 파일입니다.

UGS CLI를 사용하여 배포하려면 코드를 .ccm 파일로 패키징해야 합니다.
Cloud Code 관리자 API는 .ccm 파일 또는 .zip 파일을 수용합니다.

x64 Linux에서 실행할 패키징 어셈블리만 아카이브에 포함되어야 합니다. 스토리지 제한을 확인하려면 Cloud Code 제한을 참고하십시오.

중요

중요: 이 작업은 고급 워크플로입니다. 대부분의 사용 사례에서 Unity 에디터나 UGS CLI를 사용하여 자동 패키징으로 모듈을 배포하고 이 단계를 건너뛸 수 있습니다.

R2R 컴파일

모듈 프로젝트의 어셈블리를 생성할 때 R2R(Ready to Run) 컴파일을 활성화할 수 있습니다. 이렇게 하면 모듈에서 콜드 스타트(cold start) 시간이 약간 개선되지만, 첫 번째 호출 후 응답 시간은 개선되지 않습니다. 이 옵션으로 인해 어셈블리의 크기도 늘어납니다. 자세한 내용은 ReadyToRun 컴파일에 관한 Microsoft 기술 자료(영문)를 확인하십시오.

어셈블리 생성

이 포맷으로 어셈블리를 생성하려면 아래 섹션에 설명된 대로 .NET CLI(커맨드 라인 인터페이스) 또는 JetBrains Rider나 Microsoft Visual Studio 같은 IDE를 사용합니다. Cloud Code 모듈 엔드포인트가 포함된 메인 모듈 프로젝트에 대해서만 어셈블리를 생성해야 합니다.

참고

참고: .NET 6.0을 사용하는 것이 좋습니다.

.NET 커맨드 라인 인터페이스 사용

.NET CLI로 어셈블리를 생성하려면

dotnet publish

커맨드를 사용합니다. 자세한 내용은 dotnet publish에 관한 Microsoft 기술 자료(영문)를 참고하십시오.


dotnet publish -c Release -r linux-x64 -p:PublishReadyToRun=true

<PublishReadyToRun>

설정을 추가하여 프로젝트에서 타겟 플랫폼과 R2R 컴파일을 지정할 수 있습니다.


<PropertyGroup><PublishReadyToRun>true</PublishReadyToRun></PropertyGroup>

다음 커맨드를 사용하여 모듈을 퍼블리시합니다.


dotnet publish -c Release -r linux-x64

기본적으로

bin/Release/net6.0/linux-x64/publish

폴더에 어셈블리가 생성됩니다.

Microsoft Visual Studio 사용

Microsoft Visual Studio를 사용하여 어셈블리를 생성할 수 있습니다. 이렇게 하려면 다음 단계를 따릅니다.

모듈의 C# 프로젝트를 오른쪽 클릭하고 메뉴에서 Publish를 선택합니다.
Publish 페이지에서 다음 단계를 진행합니다.
1. Folder를 타겟으로 선택하고 Next를 선택합니다.
2. Folder를 특정 타겟으로 선택하고 Next를 선택합니다.
3. Finish를 선택합니다.
4. Publish profile creation progress 페이지에서 Close를 선택합니다.
5. Publish 창의 Publish 탭에서 Show all settings를 선택합니다.
6. 타겟 런타임을
```
linux-x64
```
  로 설정합니다.
7. (선택 사항) PublishReadyToRun을 활성화해야 합니다.
8. Publish를 선택합니다.

자세한 내용은 Microsoft 기술 자료에서 자습서: Visual Studio를 사용하여 .NET 콘솔 애플리케이션 퍼블리시(영문)를 확인하십시오.

JetBrains Rider 사용

JetBrains Rider를 사용하여 어셈블리를 생성할 수 있습니다. 이렇게 하려면 다음 단계를 따릅니다.

Run > Edit Configurations... 를 열거나 내비게이션에서 Edit Configurations를 선택합니다.
+ > Add New Configuration을 선택합니다.
Publish to folder 구성 유형을 선택합니다.
Target runtime을
```
linux-x64
```
로 설정합니다.
(선택 사항) Enable ReadyToRun compilation을 활성화합니다.
Apply를 선택하여 구성을 저장합니다.
모듈을 퍼블리시할 준비가 되었으면 툴바에서 생성한 실행 구성을 선택한 다음 Run을 선택합니다.

자세한 내용은 JetBrains Rider 기술 자료 폴더에 .NET 애플리케이션 퍼블리시(영문)를 확인하십시오.

어셈블리 패키징

어셈블리를 생성한 후 아카이브에서 압축합니다. UGS CLI를 사용하여 배포하려는 경우 아카이브 확장자를 .ccm으로 설정하면 됩니다.

참고

참고: Windows의 파일 탐색기를 사용하는 경우 아카이브 확장자를 .ccm으로 변경하려면 일반 파일 이름 확장자를 활성화해야 합니다.

아카이브의 구조는 다음과 같습니다.


MyModule.ccm├─ MyModule.dll├─ MyModule.deps.json├─ Dependency1.dll├─ Dependency2.dll└─ ...

기본적으로 Cloud Code NuGet 패키지의 종속성이 여기에 포함됩니다.

참고

참고: 생성된 어셈블리에는 .pdb 파일도 포함됩니다. 이러한 파일은 행 숫자로 스택 트레이스를 생성하는 데 필요합니다. 하지만 모듈을 실행하는 데는 필요하지 않습니다.

그런 다음 UGS CLI 또는 Cloud Code 관리자 API를 사용하여 아카이브를 배포할 수 있습니다.

기술 자료

Development

User Acquisition

Monetization

산업 분야