Perforce

Perforce 프레임워크

다양한 앱과 후크에 의해 사용되는 공통 Perforce 기능
제공: Shotgun Software
최신 버전: v0.1.15(알파)
버전 번호의 경우 유의적 버전 표준을 따릅니다.
시스템 이름: tk-framework-perforce

개요

이 프레임워크는 다른 앱 및 후크가 Perforce와 통합하는 데 사용할 수 있는 공통 Perforce 액션 및 유틸리티 기능을 제공합니다. 또한 게임 구성에서 이러한 통합을 위해 사용되는 기본 앱 후크 세트가 포함됩니다.

실험 단계의 프레임워크!

이 프레임워크의 최신 릴리즈는 v0.1.15입니다. 즉, 인터페이스가 아직 실험 단계입니다. 업데이트 간 역호환성을 깨뜨리지 않기 위해 최선을 다하고 있지만 버전 번호가 0으로 시작하는 경우가 여전히 종종 발생합니다. 프레임워크가 1.0에 도달하면 주 버전 번호가 변경되더라도 인터페이스 간의 연결이 끊어지지 않습니다. 이 규칙에 대한 자세한 정보는 유의적 버전 표준 가이드라인을 참조하십시오.

개요 동영상

다음 동영상은 해당 기능에 대한 간략한 개요를 보여 줍니다.

 

설명서

현재 이 프레임워크의 설명서를 만들고 있으니 그때까지는 Perforce를 Shotgun Pipeline Toolkit에 어떻게 통합했는지 다음 페이지에서 간략한 개요를 참조하십시오.

프레임워크에 무엇이 포함되어 있습니까?

단순히 Perforce API를 래핑한 것이 아니라 Perforce 프레임워크는 P4Python을 통합한 다음 대화상자를 통해 커넥션 열기, 최신 버전 체크아웃 등 공통된 기능을 제공하는 유틸리티 기능 세트를 통합합니다. 연결된 P4Python 인스턴스는 Perforce 명령에 보다 직접적으로 액세스하기 위해 언제든 획득할 수 있습니다.

P4Python

툴킷 Perforce 통합은 Perforce에서 제공하는 표준 P4Python 모듈을 사용합니다. 이 프레임워크에는 툴킷이 연동되는 다양한 운영 체제 및 응용프로그램을 위한 P4Python 버전이 포함됩니다. 그런데 사용자에게 필요한 버전이 포함되어 있지 않은 경우에는 이 프레임워크가 Python 경로에서 해당 버전을 바로 로드합니다(가능한 경우).

참조

(곧 제공 예정...)

 

설치 및 업데이트

최신 버전으로 업데이트

프로젝트에 이 항목이 이미 설치되어 있는 경우 최신 버전을 얻으려면 update 명령을 실행할 수 있습니다. 특정 프로젝트와 함께 제공되는 tank 명령을 탐색하여 다음과 같이 실행할 수 있습니다.

> cd /my_tank_configs/project_xyz
> ./tank updates

또는 스튜디오 tank 명령을 실행하고 업데이트 확인을 실행할 프로젝트 이름을 지정할 수 있습니다.

> tank Project XYZ updates

협업 및 개선

Shotgun Pipeline Toolkit에 액세스할 수 있다면 모든 앱, 엔진 및 프레임워크가 저장 및 관리되는 Github에서 그 소스 코드에도 액세스할 수 있습니다. 이러한 항목을 자유롭게 개선하여 향후 독립적인 개발을 위한 기반으로 사용하고 변경 후 다시 풀 리퀘스트를 제출하거나, 아니면 그냥 조금만 손을 보고 어떻게 빌드되었는지, 툴킷이 어떻게 작동하는지 확인해 보십시오. 이 코드 리포지토리는 https://github.com/shotgunsoftware/tk-framework-perforce에서 액세스할 수 있습니다.

특별 요구 사항

  • 이 기능을 이용하려면 Shotgun Pipeline Toolkit Core API 버전 v0.14.61 이상이 필요합니다.
 

구성

아래는 사용되는 모든 구성 설정을 요약한 것입니다. 해당 설정은 이 앱 또는 엔진을 사용하려는 환경 파일에서 정의해야 합니다.

hook_get_perforce_user

유형: hook

기본값: get_perforce_user

설명: 지정된 Shotgun 사용자 이름에 대한 Perforce 사용자 이름을 반환하는 후크 지정

hook_store_publish_data

유형: hook

기본값: store_publish_data

설명:

호스트

유형: str

설명: Perforce에 연결할 때 가장하기 위한 호스트 컴퓨터의 이름. 보통 빈 채로 둡니다!

서버

유형: str

설명: 연결할 Perforce 서버. 형식: 'protocol:server:port'. 예: 'tcp:perforce:1666'

hook_get_shotgun_user

유형: hook

기본값: get_shotgun_user

설명: 지정된 Perforce 사용자 이름에 대한 Shotgun 사용자 이름을 반환하는 후크 지정

hook_store_review_data

유형: hook

기본값: store_review_data

설명:

server_aliases

유형: list

설명: Perforce 서버의 별칭 목록 - Perforce 서버가 이동되었거나 새 프로토콜, 이름 또는 포트가 제공된 경우에는 이 목록에 원본을 추가하면 툴킷이 이전 서버로 퍼블리싱된 게시를 계속 사용할 수 있습니다. 현재 서버는 항상 'server' 설정에 지정되어 있어야 합니다.

hook_load_publish_data

유형: hook

기본값: load_publish_data

설명:

hook_load_review_data

유형: hook

기본값: load_review_data

설명:

 
팔로우

0 댓글

댓글을 남기려면 로그인하세요.