Cómo configurar una conexión de Perforce

Epic Games pone a disposición de los usuarios con licencia las compilaciones de Unreal Engine aprobadas por el control de calidad, así como otros lanzamientos de código especializados, a través de un repositorio de Perforce al que se puede acceder de forma externa. Este es uno de los métodos que usan los usuarios con licencia para obtener primero el motor, así como para actualizar a nuevas versiones a medida que se publican y si lo consideran apropiado. Este documento describe los pasos para configurar Perforce localmente con el fin de conectarse al repositorio de Unreal Engine de Epic Games y sincronizar con una compilación del motor.

Política de conectividad

Ten en cuenta que solo un usuario autorizado debe iniciar sesión en la cuenta de Perforce. El inicio de sesión de múltiples usuarios en la misma cuenta constituye una infracción de las condiciones de servicio de Perforce.

Las instrucciones de Epic Games indican que un solo usuario o una automatización debe usar la cuenta para sincronizar las compilaciones del motor con tu repositorio de Perforce local y debe permitir que tu personal acceda con sus propias cuentas individuales de Perforce con licencia de tu empresa.

Si aún no tienes una licencia de Perforce para tu equipo, es gratis hasta para 5 usuarios o puedes explorar las opciones de licencia.

El proceso completo para descargar compilaciones o versiones de Unreal Engine desde el repositorio de Perforce de Epic Games se detalla en la página Cómo descargar Unreal Engine con Perforce.

Instalación y configuración

Configuración de P4V

El cliente P4V es el cliente actual proporcionado por Perforce. Proporciona acceso a archivos versionados a través de una interfaz gráfica y también incluye herramientas para fusionar y visualizar la evolución del código.

El instalador completo de P4V se puede descargar desde la página de descargas de Perforce. Consulta la documentación sobre P4V de Perforce para obtener instrucciones sobre cómo instalar y configurar P4V.

Codificación de caracteres

Si almacenas archivos Unicode como texto en Perforce, se añadirá un 0xd para que coincida con el final de línea local; por lo que el final de línea Unicode 0x0a 0x00 0x0d 0x00 se convertirá en 0x0a 0x0d 0x00 0x0d 0x00 y la interrumpirá. Sin embargo, al hacerlo, dejará tu versión local sin cambios (y en funcionamiento). Sincroniza con una versión anterior y luego vuelve al encabezado para ver el problema.

Perforce define UTF-8 como Unicode. Lo ideal es usar UTF-16, siempre que nadie lo convierta accidentalmente a ASCII. La versión binaria también funciona bien, siempre que no falte la fusión o múltiples extracciones.

Unreal Engine cargará ASCII o UTF-16 con BOM, siempre que sean archivos válidos.

Configuración de Perforce para la distribución de Unreal Engine

Tu equipo dispondrá de una cuenta individual en el servidor de Perforce P4 de Epic Games desde la que podrás descargar el código fuente de Unreal Engine. Sigue las instrucciones que se indican a continuación con el fin de configurar un proceso para compartir compilaciones con tu equipo. 

Configuración inicial e importación

1. Crea tu propio servidor P4 (local).

2. Crea un repositorio de transmisión en ese servidor para importar, por ejemplo: //UE5

3. Crea una transmisión para la versión concreta que vayas a importar desde Epic, por ejemplo: //UE5/Release-5.6.0

   1. No añadas ningún archivo a esta transmisión local. Los añadirás a continuación en un paso separado.

4. Crea un espacio de trabajo en el servidor de Perforce P4 de Epic Games (consulta Cómo descargar Unreal Engine con Perforce) y sincroniza los datos que quieras.

   1. Define la carpeta raíz del espacio de trabajo en algo como: c:\UE5\release-5.6

   2. Ten en cuenta la última lista de cambios con la que estás sincronizando (consulta la pestaña del historial en P4V con la transmisión seleccionada).

5. Crea una nueva conexión en P4V a tu propio servidor de Perforce P4.

6. Crea un espacio de trabajo para tu nueva transmisión (//UE5/Release-5.6.0).

7. Establece que la raíz del espacio de trabajo sea la misma carpeta que tu espacio de trabajo en el servidor de Epic Games Perforce P4 (en este ejemplo, c:\UE\release-5.6).

8. Haz clic derecho en la carpeta raíz y selecciona Marcar para añadir.

9. Ve a la carpeta de listas de cambios pendientes y envía la lista de cambios.

   1. En la descripción, anota el número concreto de la lista de cambios que sincronizaste desde el servidor de Epic Games

Cómo obtener e importar una nueva instantánea de Epic Games

Este es un proceso habitual que utiliza los espacios de trabajo que has creado anteriormente. Es un subconjunto modificado de los pasos anteriores, y este proceso de trabajo asume que todavía tienes tus espacios de trabajo tal y como los configuraste anteriormente. Importarás los cambios más recientes.

1. Conéctate al servidor de Perforce P4 de Epic Games.

   1. Selecciona el espacio de trabajo que has creado anteriormente.

   2. Haz clic en Obtener el más reciente para actualizar los archivos.

   3. Fíjate en la última lista de cambios con la que te has sincronizado.

2. Conéctate a tu servidor de Perforce P4 local.

3. Selecciona el espacio de trabajo que has creado anteriormente.

4. Haz clic derecho en la carpeta raíz y selecciona Conciliar trabajo sin conexión.

5. Ve a la carpeta de listas de cambios pendientes y envía la lista de cambios.

   1. En la descripción, anota el número concreto de la lista de cambios que sincronizaste desde el servidor de Epic Games.

Asistencia

Problemas de conexión

Si por alguna razón no puedes conectarte al repositorio de Perforce, envía un correo electrónico a [email protected] o comparte una publicación en Asistencia a profesionales de Epic.