언리얼 턴키용 Google Drive 구성

언리얼 턴키와 함께 사용할 Google Drive API 구성 및 SDK 호스팅 방법

Choose your operating system:

Windows

macOS

Linux

언리얼 턴키 용으로 Google Drive 를 구성하는 것은 Perforce나 로컬 저장소를 사용하는 것보다 복잡하지만 초기 구성만 완료하면 SDK 파일을 저장하고 유지 관리할 수 있는 공용 공간을 만들 수 있습니다. 이렇게 하려면 먼저 조직에 다음과 같은 리소스를 구성해야 합니다.

  • Google Drive가 활성화된 조직용 Google 계정

  • Google Drive API 가 활성화되고 OAuth 2.0 크리덴셜 로 구성된 Google Cloud Platform

  • Google Drive 폴더 및 필수 크리덴셜을 가리키는 턴키 매니페스트 파일

이 문서는 조직에서 사용할 위와 같은 리소스를 구성하는 프로세스를 안내합니다.

1. 필수 구성

이 가이드는 조직에서 사용할 Google Drive 계정이 있는 것으로 가정합니다. 계정을 구성하는 방법에 대한 내용은 Google 문서를 참고하세요.

또한 이 가이드는 지원되는 플랫폼에 대한 필수 SDK 패키지를 생성하여 .zip 파일에 압축해 놓은 것으로 가정합니다. 플랫폼에 따라 전체 SDK 또는 플래시 SDK 생성 방법이 다릅니다. 일부 패키지는 받을 때부터 이미 압축되어 있으며, 이 경우 아무런 변경 없이 Google Drive에 업로드할 수 있습니다. 하지만 일부 콘솔의 SDK는 추가 작업이 필요합니다.

SDK 제공자로부터 받은 파일에서 전체 또는 플래시 SDK 파일을 생성하는 방법은 턴키 명령줄에서 Help 명령을 참고하세요. 이 명령을 사용하면 SDK 환경설정 방법뿐만 아니라 적절한 버전 번호 지정 규칙도 확인할 수 있습니다.

.zip 파일은 명명 규칙이 필요 없지만 일관된 압축 포맷과 명명 규칙을 선택하면 쉽게 참조할 수 있으므로 권장합니다. 또한 Google Drive에서는 단일 압축 파일을 다운로드하는 것이 여러 개의 파일을 다운로드하는 것보다 훨씬 빠르기 때문에 SDK 파일을 Google Drive에 업로드하기 전에 압축하는 것을 강력하게 권장합니다.

2. Google Drive API 구성

우선 Google Drive API가 활성화된 앱을 구성하여 사용자가 Google Drive 폴더와 여기에 포함되어 있는 파일을 액세스할 수 있도록 허용해야 합니다. 또한 권한을 부여받은 사용자만 Drive 폴더에 액세스할 수 있도록 안전한 크리덴셜을 구성해야 합니다.

이 섹션에서는 API 및 OAuth 2.0 크리덴셜 활성화 프로세스를 단계별로 안내합니다.

  1. Google Developer Consolehttps://console.developers.google.com/projectcreate을 방문하여 서비스 약관에 동의 합니다.

  2. 프로젝트 이름 , 조직위치 필드를 작성한 다음 만들기 를 클릭합니다.

    image_0.png

  3. 그러면 Google Cloud 대시보드 로 이동하며, 프로젝트가 구성되었다는 것을 알려주는 알림 이 표시됩니다. 이 알림에서 프로젝트 선택 을 클릭합니다.

    image_1.png

  4. APIs 패널에서 API 개요로 이동 을 클릭합니다. 그러면 API 및 서비스 페이지가 열립니다.

    image_2.png

  5. 'API 및 서비스' 페이지 상단에서 API 및 서비스 사용 설정 을 클릭합니다. 그러면 API 라이브러리 가 열립니다.

    image_3.png

  6. Google Drive API 를 선택합니다. Google Workspace 섹션에서 찾을 수 있습니다.

    image_4.png

  7. 이 API 페이지에서 활성화 버튼을 클릭합니다.

    image_5.png

  8. Google Drive의 API 및 서비스 페이지가 열립니다. 사용자 인증 정보 만들기 버튼을 클릭합니다. 그러면 프로젝트에 크리덴셜을 추가할 수 있는 양식이 열립니다.

    image_6.png

  9. 다음과 같이 양식을 작성합니다.

    image_7.png

    번호

    세팅

    1

    어떤 API를 사용 중이신가요?

    Google Drive API

    2

    어디에서 API 를 호출하실 건가요?

    기타 UI

    3

    액세스할 데이터는 무엇인가요?

    사용자 데이터

  10. 어떤 인증 정보가 필요한가요? 버튼을 클릭합니다.

    image_8.png

  11. 그러면 OAuth 동의 화면을 구성할 수 있는 팝업이 표시됩니다. 동의 화면 구성 옵션을 클릭합니다.

    image_9.png

  12. 그러면 OAuth 크리덴셜을 구성할 수 있는 새 탭이 열립니다. 사용자 유형(User Type)내부 를 선택하고 만들기 를 클릭합니다.

    image_10.png

  13. 앱 등록을 편집할 수 있도록 다른 양식이 열립니다. 앱 정보 섹션에서 앱 이름사용자 지원 이메일 을 입력합니다. 사용자 지원 이메일은 조직 구성원들이 문제 해결 창구로 사용할 수 있는 메일 주소여야 합니다.

    image_11.png

  14. 개발자 연락처 정보 로 스크롤을 내려서 조직 내 턴키 드라이브 폴더 관리자의 메일 주소를 입력합니다.

    image_12.png

  15. 저장 후 계속 버튼을 클릭합니다.

    image_13.png

  16. 현재 탭을 닫고 사용자 인증 정보 페이지로 이동하여 새로고침 버튼을 클릭합니다. 사용자 인증 정보(크리덴셜)를 명명 한 다음 OAuth 클라이언트 ID 만들기 를 클릭합니다.

    image_14.png

  17. 생성을 마치면 사용자 인증 정보 다운로드 섹션을 사용할 수 있게 됩니다. 다운로드 버튼을 클릭하여 client_id.json 파일을 다운로드합니다. 이 파일은 조직의 Google Drive 액세스를 사용자에게 제공하는 데 필요합니다.

지금까지 구성한 크리덴셜을 통해 애플리케이션은 공유 드라이브에 액세스하여 파일을 다운로드할 수 있습니다.

3. Google Drive 크리덴셜 제공

Google Drive에서 파일을 검색하려면 해당 파일을 액세스할 수 있는 보안 크리덴셜을 제공해야 합니다. 이 정보는 <Studio_GoogleDriveCredentials> 세팅의 TurnkeyManifest.xml 파일에 포함되어 있습니다.

  1. 이전 섹션에서 생성한 client_id.json 파일을 엔진이 설치되어 있는 Engine/Build/Turnkey 폴더로 옮깁니다. 모든 사용자가 사용할 수 있도록 조직의 버전 관리 시스템에 파일을 추가합니다.

  2. 이 폴더에 있는 TurnkeyManifest.xml 파일을 열어서 파일 맨 위에 다음 구문을 추가합니다.

    <Studio_GoogleDriveCredentials>$(ThisManifestDir)/client_id.json</Studio_GoogleDriveCredentials>
  3. 조직의 버전 관리 시스템에서 매니페스트를 저장 및 업데이트합니다.

이제 애플리케이션에서 제공된 크리덴셜을 사용하여 Google Drive에 연결합니다.

사용자가 Google Drive에 처음 연결하면 사용자 인증을 위한 웹 페이지가 열립니다. 그동안 턴키가 일시 정지되고 인증을 대기하고 있다는 메시지를 표시합니다. 하지만 경우에 따라서는 새 브라우저 창이 열렸는지 직접 확인해야 할 수도 있습니다. 이 단계를 완료하면 Google Drive에서 사용자의 로그인 정보를 캐싱하여 이후 로그인 시 해당 정보를 사용합니다.

4. Google Drive에 SDK 업로드

이제 드라이브 액세스에 필요한 크리덴셜을 생성하고 할당했으므로 파일을 저장할 Google Drive 폴더 구조를 구성해야 합니다.

  1. 조직에서 사용할 공유 드라이브를 생성하여 SdkInstallers 로 명명합니다.

  2. 이 드라이브 안에 앞으로 지원할 플랫폼별로 폴더를 생성합니다. 이러한 폴더의 이름은 TurnkeyManifest.xml 매니페스트 파일에 나열되어 있는 것과 일치해야 합니다.

  3. 각 플랫폼의 폴더에서 호스팅할 SDK 버전별로 하위 폴더를 생성합니다.

  4. 각 SDK 버전별로 `Install.zip`으로 명명된 .zip 파일을 생성합니다. 해당 플랫폼과 Google Drive의 버전 폴더에 이 파일을 저장합니다.

이 단계까지 마쳤으면 이제 SDK를 조직 내에 배포할 준비가 끝난 것입니다.

$fileexpansion: 접두사 및 파일 확장 변수 $[ExpVersion]을 통한 자동 파일 검색 기능을 사용하고 있는 경우, 버전 폴더의 이름이 해당 플랫폼에서 사용하는 버전 번호 지정 규칙과 일치하는지 확인합니다. 이 정보는 'Help' 턴키 명령줄을 사용하여 확인할 수 있습니다.

5. 매니페스트 파일 생성

마지막으로, 턴키 매니페스트가 Google Drive의 파일을 가리키도록 편집해야 합니다.

  1. 엔진이 설치된 Engine/Build/Turnkey 폴더에 있는 TurnkeyManifest.xml 파일을 엽니다.

  2. 사용 가능한 SDK의 관련 <FileSource> 정보를 추가합니다. 예를 들어 다음은 TurnkeyManifest_Win64.xml`에 대해 유효한 `입니다.

    <FileSource>
        <Platform>Win64</Platform>
        <Type>Full</Type>
        <Version>$(ExpVersion)</Version>
        <Name>Win64 v.($ExpVersion)</Name>
        <Source>fileexpansion:googledrive:/SdkInstallers/Win64/$[ExpVersion]/Install.zip</Source>
    </FileSource>

    Source 경로에 fileexpansion:$[ExpVersion] 캡처 변수가 포함되어 있기 때문에 턴키에서는 Win64 폴더에서 사용할 수 있는 모든 버전 폴더를 탐색하고 유효한 각 버전 번호별로 FileSource 오브젝트를 생성합니다. 각 FileSource 오브젝트는 $(ExpVersion)을 검색된 버전 번호로 대체합니다.

    매니페스트의 포맷 지정 방법에 대한 자세한 내용은 조직에서 사용할 턴키 구성 문서를 참고하세요.

  3. 각 매니페스트를 SdkInstallers 드라이브의 해당 플랫폼 폴더에 업로드합니다.

  4. 기본 TurnkeyManifest.xml 파일이 `Engine/Build/Turnkey`에 저장되었고, 조직의 버전 관리 시스템에서 업데이트되어 엔진을 설치한 모든 사용자가 해당 파일을 액세스할 수 있는지 확인합니다.

    매니페스트가 생성된 후에는 턴키 시작 시 Google Drive에서 SDK 파일을 검색할 수 있습니다.

6. 최종 결과

이 가이드에 나와 있는 단계를 잘 따랐다면 이제 플랫폼 SDK를 업로드 및 액세스할 수 있는 공유 드라이브가 준비되었을 것입니다. 조직의 관리자는 SDK를 추가 및 제거하거나 매니페스트를 편집할 수 있으며, 언리얼 엔진 사용자는 SDK 설치 및 업데이트를 턴키에 요청하여 액세스할 수 있습니다.