언리얼 턴키용 Google Drive 구성하기

언리얼 턴키와 함께 사용할 Google Drive API를 구성하고 SDK를 호스팅하는 방법을 살펴봅니다.

언리얼 턴키 용으로 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 또는 Flash SDK 생성 방법이 다릅니다. 일부 패키지는 받을 때부터 이미 압축되어 있으며, 이 경우 아무런 변경 없이 Google Drive에 업로드할 수 있습니다. 하지만 일부 콘솔의 SDK는 추가 작업이 필요합니다.

SDK 제공자로부터 받은 파일에서 Full 또는 Flash 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 Console(https://console.developers.google.com/projectcreate)을 방문하여 서비스 이용약관에 동의 합니다.

  2. Project Name, Organization, Location 필드를 작성한 다음 Create 를 클릭합니다.

    image_0.png

  3. 그러면 Google Cloud dashboard 로 이동되며, 프로젝트가 구성되었다는 것을 알려주는 알림 이 표시됩니다. 이 알림에서 Select Project 를 클릭합니다.

    image_1.png

  4. API 패널에서 Go to APIs overview 를 클릭합니다. 그러면 APIs & Services 페이지가 열립니다.

    image_2.png

  5. 'APIs & Services' 상단에서 Enable APIs and Services 를 클릭합니다. 그러면 API Library 가 열립니다.

    image_3.png

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

    image_4.png

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

    image_5.png

  8. Google Drive API의 'APIs & Services' 페이지가 열립니다. Create Credentials 버튼을 클릭합니다. 그러면 프로젝트에 크리덴셜을 추가할 수 있는 양식이 열립니다.

    image_6.png

  9. 다음과 같은 세팅을 사용하여 양식을 작성합니다.

    image_7.png

    번호

    세팅

    값

    1

    Which API are you using?

    Google Drive API

    2

    Where will you be calling the API from?

    Other UI

    3

    What data will you be accessing?

    User Data

  10. What credentials do I need? 버튼을 클릭합니다.

    image_8.png

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

    image_9.png

  12. 그러면 OAuth 크리덴셜을 환경설정할 수 있는 새 탭이 열립니다. User Type 은 Internal 를 선택하고 Create 를 클릭합니다.

    image_10.png

  13. 앱 등록을 편집할 수 있는 다른 양식이 열립니다. App Information 섹션에서 Application Name 및 User support email 을 입력합니다. 'User support email'은 조직 구성원들이 문제 해결 창구로 사용할 수 있는 메일 주소여야 합니다.

    image_11.png

  14. Developer Contact Information 로 스크롤을 내려서 조직 내 턴키 드라이브 폴더 관리자의 메일 주소를 입력합니다.

    image_12.png

  15. Save and Continue 버튼을 클릭합니다.

    image_13.png

  16. 현재 탭을 닫고 Credentials 페이지로 돌아가 Refresh 버튼을 클릭합니다. 크리덴셜을 명명 한 다음 Create OAuth Client ID 를 클릭합니다.

    image_14.png

  17. 생성을 마치면 Download credentials 섹션을 사용할 수 있게 됩니다. Download 버튼을 클릭하여 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> 입니다. 

    <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 설치 및 업데이트를 턴키에 요청하여 액세스할 수 있습니다.

언리얼 엔진 문서의 미래를 함께 만들어주세요! 더 나은 서비스를 제공할 수 있도록 문서 사용에 대한 피드백을 주세요.
설문조사에 참여해 주세요
취소